Claude Code 完全指南：终端里的 AI 编程神器
Claude Code 是 Anthropic 官方推出的终端 AI 编程工具，被誉为超越 Cursor 的存在。本教程详解安装配置、MCP 服务器、Skills 自定义等核心功能。
什么是 Claude Code？
Claude Code 是 Anthropic 官方推出的 CLI 级智能编程工具，可以在任意终端中运行。与其他 AI 编程工具不同，Claude Code 的定位不是聊天助手，而是能够在本地代码仓库中执行高权限、上下文感知的工程任务的 Agent。
为什么选择 Claude Code？
很多人用过 Claude Code 后的评价是：
"用上了 Claude Code，才发现 Cursor 和 Gemini CLI 都是弱智。"
Claude Code 的优势：
- 深度代码理解：能理解整个代码库的结构和依赖
- 终端原生：直接在你熟悉的终端中运行
- MCP 扩展：通过 MCP 协议连接任意外部工具
- Git 集成：完美配合 Git 工作流
- 多 IDE 兼容：可以在任何 IDE 中使用
我用 Claude Code 重构了一个项目
让我真正认识到 Claude Code 威力的，是去年底的一次项目重构。
我有一个老的 Express + JavaScript 项目，大概 5000 多行代码，完全没有类型注解，测试覆盖率为零。手动改的话估计要一周，而且容易改出 bug。
我决定用 Claude Code 来做这件事。在终端里输入：
"把这个项目从 JavaScript 迁移到 TypeScript。保持所有功能不变，添加严格的类型注解，并为核心模块生成单元测试。"
Claude Code 先花了大概 2 分钟"阅读"了整个项目结构，然后开始逐文件修改。看着终端里一个个文件被修改的过程，就像看一个资深开发者在帮你干活。
最让我惊喜的是：它不仅做了类型转换，还发现了好几个潜在的 bug。比如有一个函数可能返回 undefined 但调用方没有处理，在 JavaScript 里运行时不会报错但行为是错的。TypeScript 的类型检查暴露了这些问题，Claude Code 也顺手修复了。
整个过程大概用了 1 个多小时，API 费用大概 $8。相比我手动改一周的时间成本，这个性价比太高了。从那以后，所有大规模重构任务我都交给 Claude Code。
系统要求
| 要求 | 说明 |
|---|---|
| Node.js | >= 18 |
| 操作系统 | macOS、Linux、Windows (WSL2) |
| API Key | Anthropic API Key |
Windows 用户：强烈建议使用 WSL2，原生支持体验较差。
安装 Claude Code
方式一：npm 全局安装
npm install -g @anthropic-ai/claude-code
方式二：使用 npx 直接运行
npx @anthropic-ai/claude-code
验证安装
claude --version
配置 API Key
方式一：交互式配置
claude setup-token
按提示输入你的 Anthropic API Key。
方式二：环境变量
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
添加到 ~/.bashrc 或 ~/.zshrc 中永久生效。
国内替代方案
如果无法访问 Anthropic API，可以使用国内模型：
配置豆包（火山引擎）：
claude config set provider volcengine
claude config set api_key "your-volcengine-key"
配置智谱 AI：
claude config set provider zhipu
claude config set api_key "your-zhipu-key"
基础使用
启动 Claude Code
在项目目录中运行：
cd your-project
claude
进入交互模式后，直接输入你的需求：
> 帮我分析这个项目的结构
> 找出所有使用了 deprecated API 的地方
> 为 src/utils/api.ts 添加单元测试
引用文件
使用 @ 引用特定文件：
> @src/components/Button.tsx 优化这个组件的性能
> @package.json 更新所有过时的依赖
执行命令
Claude Code 可以直接执行终端命令：
> 运行测试并修复失败的用例
> 安装 axios 并创建一个 API 客户端
常用斜杠命令
| 命令 | 说明 |
|---|---|
/clear | 清空当前对话 |
/compact | 压缩对话历史（减少 token 消耗） |
/context | 查看当前上下文 |
/cost | 查看本次会话费用 |
/model | 切换 AI 模型 |
/mcp | 管理 MCP 服务器 |
/help | 显示帮助信息 |
MCP 服务器（重点功能）
MCP（Model Context Protocol）是 Claude Code 的扩展机制，让 AI 可以连接外部工具和服务。
什么是 MCP？
MCP 遵循客户端-服务器架构：
- Claude Code（客户端）可以连接多个 MCP 服务器
- MCP 服务器 提供特定功能（如文件系统、数据库、API 等）
管理 MCP 服务器
# 列出已添加的服务器
claude mcp list
# 添加服务器
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2
# 移除服务器
claude mcp remove my-server
常用 MCP 服务器
文件系统服务器：
claude mcp add filesystem -- npx -y @anthropic-ai/mcp-server-filesystem
GitHub 服务器：
claude mcp add github -e GITHUB_TOKEN=ghp_xxx -- npx -y @anthropic-ai/mcp-server-github
数据库服务器：
claude mcp add postgres -e DATABASE_URL=postgres://... -- npx -y @anthropic-ai/mcp-server-postgres
Skills 自定义
Skills 让你可以创建可复用的 Claude Code 小工具。
创建 Skill
在 ~/.claude/skills/ 目录下创建文件：
# ~/.claude/skills/commit.md
---
name: commit
description: 智能 Git 提交
---
请帮我完成以下步骤：
1. 运行 git status 查看更改
2. 分析更改内容
3. 生成符合 Conventional Commits 规范的提交信息
4. 执行 git add 和 git commit
使用 Skill
> /commit
高级技巧
1. 触发深度思考
使用特定关键词让 Claude 更仔细地思考：
| 关键词 | 效果 |
|---|---|
| think | 基础思考 |
| think hard | 深度分析 |
| think harder | 更深入分析 |
| ultrathink | 最深度思考 |
示例：
> think hard 这个函数有什么潜在的性能问题？
2. 上下文管理
由于上下文窗口有限，合理管理上下文很重要：
# 任务切换时清空上下文
/clear
# 压缩对话保留关键信息
/compact
# 查看当前上下文大小
/context
3. 结合 Git 使用
Claude Code + Git 是最佳搭档：
# 在 AI 修改前先提交
git add . && git commit -m "checkpoint"
# 让 Claude 修改
claude
# 查看 AI 的修改
git diff
# 不满意就回滚
git checkout .
4. 批量处理
> 找出所有 TODO 注释，创建对应的 GitHub Issue
> 为 src/components 下的所有组件添加 PropTypes
> 将所有 .js 文件转换为 .ts
费用控制
查看费用
/cost
省钱技巧
- 及时清空上下文：上下文越长，费用越高
- 使用 /compact：压缩历史对话
- 精确描述需求：减少来回沟通
- 使用国内模型：部分场景可用豆包等替代
Claude Code vs Cursor
| 特性 | Claude Code | Cursor |
|---|---|---|
| 界面 | 终端 CLI | 图形化 IDE |
| 上下文 | 更大窗口 | 相对较小 |
| 扩展性 | MCP 协议 | 内置功能 |
| Git 集成 | 原生支持 | 需手动 |
| 学习曲线 | 需要终端基础 | 更友好 |
| 适合人群 | 终端爱好者 | 视觉编辑者 |
建议：两者可以配合使用，Cursor 做可视化编辑，Claude Code 做批量处理和自动化任务。
常见问题
Q: 提示 API Key 无效？
检查：
- Key 是否正确复制（无空格）
- Key 是否有足够的配额
- 网络是否能访问 Anthropic
Q: 上下文太长导致错误？
/clear # 清空上下文
/compact # 或压缩上下文
Q: 如何在 VS Code 中使用？
安装 Claude Code 扩展，或在 VS Code 终端中直接运行 claude。
总结
Claude Code 是目前最强大的终端 AI 编程工具，特别适合：
- 喜欢终端工作流的开发者
- 需要批量处理代码的场景
- 想要深度定制 AI 行为的用户
学习路径：
- 安装配置，跑通基础流程
- 熟悉斜杠命令
- 尝试 MCP 扩展
- 创建自定义 Skills