一句话总结
Claude Code 是 Anthropic 的终端编程 agent。先装好（推荐原生安装器，或 npm install -g @anthropic-ai/claude-code），再用 Claude 的 Pro、Max、Team 或 Enterprise 账号登录——免费的 Claude.ai 账号不含 Claude Code（2026 年 6 月已核实）。第一次别上来就说”把仓库清理一下”。正确做法：写一份简短的 CLAUDE.md，开 Plan Mode 让它先出方案再动文件，然后一次只执行一个命名好的步骤、每步 commit。第一次 session 应该收尾在一个被审过的小 PR，而不是一坨 40 文件、根本看不过来的 diff。
Claude Code 是什么，跟别的工具差在哪
Claude Code 是一个命令行 agent，能在终端里读、写、运行你的代码。它只跑 Anthropic 自家模型——Pro 上是 Sonnet 4.6（日常主力），Max 套餐再加 Opus 4.7。它和内联补全类工具的心智模型完全不同：
| 工具 | 它在做什么 | 适合 |
|---|---|---|
| GitHub Copilot | 编辑器里的内联自动补全 | 单行 / 单块补全 |
| Cursor | AI 原生 IDE，聊天 + 内联改 | 带图形 diff 的文件级改动 |
| Claude Code | 驱动 shell、能跑测试的 agent | 跨多文件、多步骤的改动 |
如果一次内联补全就够，先看 agent vs 自动补全。该用 Claude Code 的场景：改动跨多文件、需要它跑测试、或要先读仓库再改——跨文件改名、依赖升级、给老代码补测试、脚本化重构。只想在浏览器里反复改原型、不碰终端，改看 Claude Artifacts 进阶工作流。
到底要花多少钱（截至 2026 年 6 月）
用消费档账号登录时没有按 session 计费的 API 表——Claude Code 是打包进订阅的，受用量上限约束，而不是按 token 出账：
| 套餐 | 价格（美元/月） | 含 Claude Code？ | 模型 | 大致额度 |
|---|---|---|---|---|
| 免费 | $0 | 否 | — | 仅 Claude.ai 网页聊天 |
| Pro | $20（年付折合 $17/月） | 是 | Sonnet 4.6 | 每周约 40-80 小时 Sonnet |
| Max 5x | 起步 $100 | 是 | Sonnet 4.6 + Opus 4.7 | Pro 的 5 倍 |
| Max 20x | $200 | 是 | Sonnet 4.6 + Opus 4.7 | Pro 的 20 倍 |
用量按 5 小时滚动窗口计，上面再叠一层每周上限；Pro 每周大约能用 40-80 小时 Sonnet 4.6（重型重构烧得比轻量编辑快）。Opus 4.7 只对 Max 套餐开放。如果你更想按 token 付费，可以改用 Anthropic API 或 Amazon Bedrock / Google Vertex 授权——API 价位下 Opus 4.7 是每百万 token 输入 $5 / 输出 $25，Sonnet 4.6 是 $3 / $15。最新数字见官方 Claude Code 介绍 和 Anthropic 定价页。
开始前准备
- 先看系统要求。 Claude Code 需要 macOS 13.0+、Windows 10（1809+）或 Ubuntu 20.04+/Debian 10+，内存 4 GB 以上。走 npm 这条路还要 Node.js 18 或更高；原生安装器自带二进制，不依赖 Node。
- 先让仓库变绿。 测试过、lint 过、能 build。Claude Code 会放大仓库现状——包括坏的地方。
- 挑一个小而低风险的目标。 给糟糕名字的函数改名、给一个模块加测试、把一个文件迁到新模式。不要整库。
- 把当前工作 commit 或 stash 掉，让 agent 的 diff 对着一条干净基线一眼看清。
具体步骤：从安装到第一个 PR
- 安装。 现在推荐走原生安装器：
Windows PowerShell 用curl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iex。想走 npm？跑npm install -g @anthropic-ai/claude-code（千万别加sudo）。然后用claude --version确认，有问题就跑claude doctor。 - 登录。 在项目目录里跑
claude，按浏览器提示登录。用你的 Pro/Max 账号；免费档在这里会被拒。 - 生成 CLAUDE.md。 在 session 里跑
/init斜杠命令——Claude 会扫一遍仓库，起草一份带 build/test 命令和约定的CLAUDE.md。再把它精简到要点：语言/框架、测试命令、lint 命令、以及禁碰的路径。该写什么参考 AI 编程上下文管理。哪怕 20 行，也能显著改善 session 质量。 - 动手前先进 Plan Mode。 按
Shift+Tab把权限模式切到 plan（循环顺序是 default → acceptEdits → plan），或启动时直接加claude --permission-mode plan。Plan Mode 下 agent 是只读的：能搜索、能分析，但在你批准前不能写文件。 - 先要计划。 具体的 prompt 远胜”把仓库清理一下”：
对仓库不熟？先做 AI 代码库导览工作流，搞清楚到底在重构什么。为 src/auth.ts 写重构计划：把 JWT 校验抽成独立模块。先别写 代码。列出要改的文件、要新建的文件、要加的测试。 - 审计划，然后直接反推。 看它是否要碰不该碰的文件、漏了测试更新、或范围扩散。直说：“别碰
database.ts，不在范围。” - 一次只执行一个命名好的步骤。 批准一个改动、跑测试、commit，再往下走。安全的最小单位是干净 commit，不是整个任务。
- 收尾闭环。 让 agent 总结改了什么、还有哪些没完成，把这段贴进 PR 描述。
第一次实操（20 分钟）
- 选一个文件里一个明显有味道的函数——太长、名字不清、没测试。
- 让 Claude Code 先为现有行为加测试。跑一遍确认通过。
- 再让它做一个命名好的小重构：“拆成
validate/transform/save三段。” 再跑测试，仍应通过。 - Commit。记下哪里顺、哪里出乎意料、哪些 prompt 值得写进
CLAUDE.md。
每次 session 后的检查
- 每个 agent 步骤后跑一次测试套件。干净通过是改动是否安全的唯一客观信号。
- 前三次 session 逐行读 diff。形成信任后才能略读，之前别略。
- 留心范围外的改动——
git diff main确认影响面。 - 重读
CLAUDE.md，把这次希望提前写好的那条约束补上。agent 犯同样的错两次，就加一条禁令。
FAQ
- 必须付费才能用 Claude Code 吗？: 是。截至 2026 年 6 月，免费的 Claude.ai 账号不含 Claude Code。最便宜的路径是 Claude Pro，$20/月（年付折合 $17/月），跑 Sonnet 4.6；要用 Opus 4.7 得上 Max 套餐（$100 或 $200/月）。
- Claude Code 和 Cursor 有什么区别？: Cursor 是带内联改动的 AI 原生 IDE；Claude Code 是驱动 shell、能跑测试的 agent。体感差异大，参见 Claude Code vs Cursor。
- 没 CLAUDE.md 能用吗？: 能，但真项目质量掉得快。跑一次
/init再精简结果，哪怕 20 行也比没有强。 - 会跑破坏性命令吗？: 默认会先问。前几次别开全自动接受，每条命令都看。
- agent 卡住或撞到额度怎么办？: 取消、缩范围、重启。看到「Claude is at capacity」别狂点 retry——会让冷却时间更长（Claude 重试触发频控）。
- 新手该用哪个模型？: 日常重构就用 Pro 默认的 Sonnet 4.6。只在更难的架构推理上，且额外额度划算时，才换 Opus 4.7（Max 套餐）。
容易踩的坑
- 跳过 Plan Mode 直接要代码——拿到一坨没法审的 diff。
- 没
CLAUDE.md——agent 每次重新发明你的项目约定和风格。 - 让它直接提交——再好的 diff 也藏一行静默的错。
- 任务给太大（“整个模块重构”）而不是命名好的小步。
- 卡在「Claude is at capacity」就不停 retry——会让冷却时间更长（Claude 重试触发频控）。
- 把 Claude Code 的输出当作架构权威——它执行快，但”到底该不该这么做”不够稳。
相关阅读
标签: #AI 编程 #教程 #Claude Code