Claude Code 入门指南：终端里的最强 AI 编程助手

---

什么是 Claude Code？

Claude Code 是 Anthropic 推出的 终端原生 AI 编程代理（AI Coding Agent）。它不是 VS Code 插件，也不是 Web 界面——它直接跑在你的终端里，能读你的文件、写你的代码、跑你的命令，像一个懂编程的同事一样跟你协作。

简单说：你在终端敲命令，它帮你写代码。

---

为什么是 Claude Code？

现在 AI 编程工具不少，Cursor、GitHub Copilot、Windsurf……Claude Code 跟它们有什么不一样？

特性	Claude Code	Cursor / Copilot
运行方式	终端原生	IDE 插件 / Web 界面
能做什么	读写文件、执行命令、Git 操作、浏览器测试	补全代码、解释代码
上下文窗口	200K tokens（可读整个项目）	通常 8K-16K
多文件编辑	✅ 一次修改几十个文件	❌ 一次改一个文件
终端交互	✅ 能看到编译错误、测试结果	❌ 只看到编辑器里的代码
Git 集成	✅ 自动创建分支、提交 PR	❌ 基本没有
自主程度	高（你给目标，它规划执行）	低（你写代码，它补全）

Claude Code 不是来补全你的代码的——它是来帮你写代码的。

---

核心能力一览

🔧 读写文件

读文件、改文件、创建文件——它是你的文件系统操作员：

→ 把 src/utils.py 中的 parse_date 函数重构一下，拆成 parse_date 和 format_date 两个函数
✓ 已读取 src/utils.py（285行）
✓ 已创建 src/utils.py（更新）
✓ 已更新 import 引用

📦 运行命令

在终端里执行命令并读取输出——它能编译、测试、部署：

→ 帮我跑一下测试，看看重构有没有破坏原有功能
✓ 运行 pytest tests/test_utils.py
✓ 全部 12 个测试通过 ✅

🌿 Git 操作

自动管理分支和提交：

→ 把这个改动提交，推送到远程，创建 PR
✓ 已创建分支 fix/login-bug
✓ 已提交 3 个文件
✓ 已推送到 origin
✓ PR 链接：https://github.com/xxx/pull/42

🔍 项目级理解

200K 上下文窗口，可以一次性读取整个项目：

→ 这个项目用的是哪个 Web 框架？数据库是什么？
  ✓ 框架：FastAPI（检测到 main.py 中的 APIRouter）
  ✓ 数据库：PostgreSQL（检测到 SQLAlchemy 配置）
  ✓ ORM：SQLAlchemy 2.0 + Alembic 迁移

🤖 自主规划执行

给它一个目标，它能自己规划步骤并执行：

→ 帮我给 user.py 添加邮箱验证功能
  ✓ 分析现有 User 模型（3个文件）
  ✓ 添加 email_verified 字段（数据库迁移）
  ✓ 实现验证码发送逻辑（接入 SendGrid）
  ✓ 添加验证端点（API 路由）
  ✓ 编写单元测试（5个测试用例）

---

快速上手

安装

npm install -g @anthropic-ai/claude-code

安装完成后，在你项目目录里敲：

cd your-project
claude

就进入对话模式了。

常用命令速查

命令	说明
claude	进入交互模式
claude "帮我在 main.py 里加一个健康检查接口"	直接执行任务
claude -p "这个项目用了什么技术栈？"	一次性问答
/help	查看所有斜杠命令
/cost	查看当前会话的费用
/clear	清空对话历史

最佳使用姿势

写新功能：

→ 帮我添加一个用户密码重置功能。用户在登录页点击"忘记密码"，
  输入邮箱后会收到重置链接，点击链接后可以设置新密码。

修 Bug：

→ 用户反馈说提交表单时会报 500 错误。帮我查一下错误日志里对应的请求，
  找到问题并修复。

代码审查：

→ 审查一下 feature/payment 分支上的改动，找出潜在的安全问题和性能问题

写测试：

→ 给 services/payment.py 中的所有函数写单元测试，覆盖率要到 90% 以上

---

与其他 AI 编程工具的对比

工具	适合场景	不适合场景
Claude Code	从零构建项目、大规模重构、全项目级理解	只想补全一行代码、不爱用终端的用户
Cursor	日常编码补全、单文件修改、习惯 GUI 的用户	需要执行命令、跨多个文件的重构
GitHub Copilot	快速代码补全、写模板代码	项目级理解、复杂多步任务
Codex CLI	与 Claude Code 类似，OpenAI 生态用户	—

---

一些实用技巧

1️⃣ 设定项目的 CLAUDE.md

在项目根目录创建 CLAUDE.md，Claude Code 会自动读取作为项目级指引：

# CLAUDE.md

## 项目规范
- 使用 TypeScript + React
- 测试框架：Vitest
- 代码风格：ESLint + Prettier
- 包管理器：pnpm

## 常用命令
- 开发：pnpm dev
- 测试：pnpm test
- 构建：pnpm build

这样 Claude Code 每次操作前都会先看这个文件，风格更匹配。

2️⃣ 利用 /cost 监控费用

每次会话结束后敲 /cost，可以看到当前会话消耗了多少 token、多少费用。

3️⃣ 复杂任务分步骤

对于复杂任务，先让 Claude Code 出方案，再执行：

→ 我想给项目加一个缓存层，你有什么方案建议？
（Claude Code 会给出方案）
→ 选方案二吧，先实现 Redis 缓存层

4️⃣ 和 Git 深度配合

Claude Code 会自动为每次改动创建分支、提交、写 commit message。你可以在 .claude/settings.json 中配置是否自动推送。

---

总结

Claude Code 是目前终端 AI 编程代理中体验最成熟的选择之一。它的核心优势不是"代码补全有多快"，而是"它能像一个真正的开发者一样在终端里工作"——读文件、写代码、跑测试、提 PR，一条龙完成。

如果你是：

• 全栈开发者 → Claude Code 帮你搞定从后端到前端的全套改动
• 开源项目维护者 → Claude Code 帮你审查 PR、写文档、修 Bug
• 技术管理者 → Claude Code 帮你快速验证技术方案、写原型代码

可以试试。装好之后，进项目目录敲个 claude，就知道我说的是什么感觉了。

---

相关资源

• Claude Code 官方文档
• Anthropic 官网
• 我的课程设计文档生成 Skill —— Claude Code 配合这个 Skill 可以自动生成标准格式的 Word 文档