Claude Code 完整使用教程 2026

为什么 Claude Code 与众不同？

大多数 AI 编程工具（Cursor、GitHub Copilot）以 IDE 插件形式存在，而 Claude Code 运行在终端里——这个设计选择背后有深意：

上下文更完整：能直接读取整个代码库，而不只是当前文件

工具调用更自由：可以运行 shell 命令、git 操作、文件系统操作

适合复杂任务：跨文件重构、调试生产 bug、理解大型代码库

一句话定位：Claude Code = 一个真正理解你整个项目的高级工程师

安装与配置

前置要求

Node.js 18+

有效的 Anthropic API Key（申请地址）

安装步骤

bash
全局安装
npm install -g @anthropic-ai/claude-code
或者用 npx 直接运行（无需安装）
npx @anthropic-ai/claude-code

配置 API Key

bash
export ANTHROPIC_API_KEY=sk-ant-xxxxx
永久配置（加到 ~/.zshrc 或 ~/.bashrc）
echo 'export ANTHROPIC_API_KEY=sk-ant-xxxxx' >> ~/.zshrc

核心工作流

1. 启动与基础对话

bash
在项目根目录启动
cd /your/project
claude

Claude Code 会自动扫描项目结构，理解代码库。首次启动会询问是否允许工具权限（文件读写、shell 执行）。

2. 代码审查（Code Review）

真实使用场景：提交 PR 前用 Claude Code 做一遍审查

请审查最近 3 次 commit 的代码变更，重点关注：
潜在的 bug 和边界条件
性能问题
与现有代码风格的一致性
缺少的测试用例

Claude Code 会自动执行 git diff HEAD~3，读取相关文件，给出具体的改进建议。

3. 多文件重构

这是 Claude Code 最强的场景——跨文件的系统性重构：

我需要把项目中所有的 class 组件迁移到 React Hooks。
先帮我列出所有 class 组件文件，然后逐个迁移，
确保功能不变，并更新相关的测试文件。

Claude Code 会先运行 grep -r "extends Component" src/ 找到所有目标文件，然后逐文件完成迁移。

4. 调试生产 Bug

生产环境报错如下：
TypeError: Cannot read property 'userId' of undefined
  at UserService.getProfile (src/services/user.ts:142)
请帮我找到根本原因并修复，同时添加防御性代码防止类似问题。

5. 自动生成测试

为 src/utils/payment.ts 中的 calculateDiscount 函数生成完整的单元测试，
覆盖：正常折扣计算、边界值（0折扣、100%折扣）、无效输入的错误处理。
使用 Jest + TypeScript。

高级技巧

自定义项目上下文（CLAUDE.md）

在项目根目录创建 CLAUDE.md 文件，Claude Code 每次启动都会读取它：

markdown
项目说明
技术栈
Next.js 14 + TypeScript
Prisma + PostgreSQL
测试：Jest + React Testing Library
代码规范
组件使用函数式写法
状态管理用 Zustand
API 路由在 src/app/api/
常用命令
开发：bun dev
测试：bun test

有了这个文件，你就不需要每次对话都重复说明项目背景。

斜杠命令（Slash Commands）

命令作用

/help查看所有可用命令 /clear清除对话历史（节省 token） /compact压缩对话历史 /cost查看本次对话的 token 消耗 /exit退出 Claude Code

Claude Code vs Cursor：如何选择？

维度Claude CodeCursor

界面终端GUI IDE 上下文窗口200k tokens受限 适合场景复杂重构、大型项目日常编码、补全 学习曲线较陡较平缓 价格按 API 用量$20/月

建议：两者不互斥。日常写代码用 Cursor，大型重构/代码审查用 Claude Code。

费用控制技巧

善用 /compact：对话变长后压缩历史，减少重复 token

精确的提问：避免模糊的"帮我优化代码"，说清楚具体需求

CLAUDE.md 替代重复说明：一次写好，每次自动加载

选择合适的模型：简单任务用 Claude Haiku，复杂任务用 Opus

---

延伸阅读

MCP Server 完整指南

Windsurf vs Cursor vs Claude Code 终极对比

AI 编程工具盘点 2026