一句话总结
Claude Code 是 Anthropic 的命令行编程 agent。它住在你的终端里,能跨整个仓库读文件、改文件、跑命令,是一个任务一个任务地干活,而不是只给你一段代码片段。它只跑 Anthropic 自家模型——Claude Opus 4.7 和 Sonnet 4.6(截至 2026 年 6 月)。要用它得有付费的 Claude 套餐:Pro 每月 20 美元(按年付折合每月 17 美元,现在还附带 Claude Cowork),或 Max 每月 100 美元(5 倍额度)和 200 美元(20 倍)。免费的 Claude.ai 套餐不含 Claude Code。最稳的循环是:用 /init 生成 CLAUDE.md,大改动前用 Shift + Tab 切到规划模式,每轮都审 /diff,提交前先跑测试。
Claude Code 到底是什么
Claude Code 是一个终端 agent。你在项目里跑一条命令 claude,之后 Claude 就能读你的文件、跨多个文件提出并应用改动、运行你的构建和测试命令,然后把结果反馈给你——全程不用离开命令行。
有两个名字经常被搞混,先说清楚:
- Claude Code:Anthropic 的命令行 AI 编程 agent,能在终端里读、写、运行代码(通过扩展也能在 VS Code 或 JetBrains 里用,背后驱动的是同一个 CLI)。
- Claude.ai:Anthropic 的网页 / 桌面端对话助手。适合问一次性的问题,但它没法直接动你的仓库。
Claude Code 只跑 Anthropic 模型。截至 2026 年 6 月,阵容是 Claude Opus 4.7(最强,在 SWE-bench Verified 上以 87.6% 排第一)和 Claude Sonnet 4.6(速度更快的主力)。会话中随时用 /model 切换。Pro 套餐默认 Sonnet 4.6,Max 套餐默认 Opus。
这篇适合谁看
熟悉终端的开发者:你能 cd 进目录、看懂 git diff、不用查就会跑 npm test 之类的命令。如果这些还不熟,先补这块——Claude Code 默认你能自己驾驭命令行。
什么时候适合用
多文件改动、需要多步(读、改、跑、修)的 agent 任务,以及探索一个陌生代码库时,优先用 Claude Code。如果只是问一个小问题或写个用完即弃的片段,直接开 Claude.ai 对话更快。
价格与开通(2026 年 6 月)
你需要一个付费的 Claude 订阅。免费的 Claude.ai 不解锁 Claude Code。
| 套餐 | 价格(美元 / 月) | 额度(相对 Pro) | 能拿到什么 |
|---|---|---|---|
| Pro | 20(按年折合 17) | 基准 | Claude Code + Claude Cowork;默认 Sonnet 4.6 |
| Max 5x | 100 | 5 倍 | 更高额度,默认 Opus,优先体验新功能 |
| Max 20x | 200 | 20 倍 | 重度日常 agent 工作的最高额度 |
有两点容易踩坑。第一,Claude Code 和 Claude.ai 对话共用同一份额度——在网页里聊得多,就会吃掉终端 agent 能用的那一份。第二,Team Standard(每席 20 美元)不含 Claude Code;含它的最低档是 Team Premium(每席 100 美元,最少 5 席)、Enterprise,或者任意个人 Pro / Max 套餐。你也可以不订阅,改用 Anthropic API key(Console 账号)按量付费。最新数字请看 Claude 价格页。
安装
Anthropic 推荐的方式是原生安装脚本(后台自动更新)。系统要求:macOS 13+、Windows 10 1809+,或 Ubuntu 20.04+ / Debian 10+,内存 4 GB。
# macOS、Linux、WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
更喜欢用包管理器?macOS 上 brew install --cask claude-code,Windows 上 winget install Anthropic.ClaudeCode,或者用 npm 全局包(需要 Node.js 18+):
npm install -g @anthropic-ai/claude-code
npm 安装千万别加 sudo——会引发权限问题。如果遇到 EACCES 报错,用 nvm 这类 Node 版本管理器,或把 npm 的全局目录指到你自己拥有的目录。装好后确认版本,再跑一次健康检查:
claude --version
claude doctor
第一次跑 claude 会弹出浏览器让你登录。完整选项见官方安装文档。
60 秒跑通第一个任务
cd进项目根目录(有package.json、pyproject.toml、Cargo.toml或.git的那一层)。- 跑
claude,在浏览器里完成登录。 - 输入
/init生成CLAUDE.md。 - 给它一个小而具体的任务:
给 src/server.ts 加一个 /health 端点,返回 200 和构建 SHA。先给我计划,别急着改代码。
快捷键指南
Claude Code 的快捷键会受终端、IDE、系统和版本影响。最稳的做法是:在会话里按 ? 看当前环境可用快捷键;如果 Shift + Enter 不能换行,先跑 /terminal-setup。
| 快捷键 / 输入 | 作用 | 什么时候用 |
|---|---|---|
? | 显示当前环境快捷键帮助 | 忘了按键、换了终端、刚装好时先看 |
Ctrl + C | 取消当前输入或中断生成 | Claude 跑偏、命令执行太久、想重新提问 |
Esc | 中断 Claude 当前回复或工具调用 | 想保留已完成部分,但马上改方向 |
Esc 然后再按 Esc | 打开 rewind / checkpoint 菜单 | 需要回到前面某一步,或撤回一段会话/代码状态 |
Shift + Tab | 切换权限模式:默认、自动接受编辑、Plan 等 | 从”先规划”切到”允许改文件”,或反过来收紧权限 |
Ctrl + R | 搜索历史输入 | 找回之前写过的长 prompt 或命令 |
↑ / ↓ | 浏览历史输入;多行输入时也会移动光标 | 快速复用上一条任务描述 |
Ctrl + O | 打开详细 transcript 视图 | 想看 Claude 读了哪些文件、跑了哪些工具 |
Ctrl + L | 重绘终端屏幕 | 终端显示乱了、输出残影时刷新 |
Ctrl + B | 把正在跑的任务放到后台 | 长命令或长任务不想占住当前界面 |
Ctrl + T | 显示 / 隐藏任务列表 | 同时有后台任务、subagent 或长命令时查看进度 |
Ctrl + A / Ctrl + E | 跳到当前行开头 / 结尾 | 编辑长 prompt |
Ctrl + K / Ctrl + U / Ctrl + W | 删除到行尾 / 删除到行首 / 删除前一个词 | 快速改写输入,不用狂按退格 |
Ctrl + Y | 粘回刚才删除的文本 | 误删 prompt 片段时恢复 |
Shift + Enter | 换行输入 | 写多段需求、贴日志、列 checklist |
Ctrl + J | 通用换行输入 | 某些终端不支持 Shift + Enter 时备用 |
\ 然后 Enter | 通用换行输入 | 任何终端都能用的换行方式 |
/ 放在开头 | 打开命令 / skill 菜单 | 找 /plan、/diff、/skills、自定义 skill |
@ + 路径 | 引用文件或目录 | 明确让 Claude 读取某个文件、组件、配置目录 |
! 放在开头 | 进入 shell mode,把命令输出带回上下文 | 让 Claude 看到 npm test、git status、日志输出 |
macOS 用户如果想用 Option + P 切模型、Option + T 切 thinking、Option + O 切 fast mode,可能需要在终端里把 Option 配成 Meta。iTerm2、Apple Terminal、VS Code 的设置位置不一样;如果按键没反应,优先检查终端设置。
工作循环,一步一步来
1. 从正确目录启动
先进入项目根目录,再运行:
claude
根目录通常是有 package.json、pyproject.toml、Cargo.toml、.git 的那层。不要从 src/、app/、components/ 这种子目录启动,否则 Claude 容易只看到局部结构。
2. 先初始化项目记忆
第一次进仓库先跑:
/init
它会生成或更新 CLAUDE.md。这份文件建议写:
- 项目是什么、主要技术栈是什么。
- 常用命令:安装、开发、测试、构建、格式化。
- 目录结构:页面、组件、API、脚本、测试分别在哪里。
- 不能碰的文件:生产配置、迁移文件、大型生成产物、密钥相关文件。
- 代码风格:命名、组件组织、错误处理、测试习惯。
之后可以用 /memory 查看或编辑当前生效的 CLAUDE.md。
3. 大改动前先规划,并搞清楚权限模式
大改动不要一上来就让它写代码。按 Shift + Tab 可以循环切换本次会话的权限模式,状态栏会显示当前在哪一档:
- default(默认)——每次改文件、每条命令前都问你。
- acceptEdits(自动接受编辑)——改文件和基础文件系统命令不再询问,但其他 Bash 命令仍会提示。适合”改完就看
git diff”的快循环。 - plan(规划)——Claude 只研究并提出方案,不动任何东西。批准计划后退出规划模式,开始改代码。
还有一个 auto 模式(需要 Claude Code v2.1.83+):由一个独立的分类器模型在每个动作执行前先审一遍,挡掉任何超出你要求、想擅自升级的操作——比 bypassPermissions 安全得多。bypassPermissions 会完全关掉检查,只应该在用完即弃的容器或 worktree 里跑。
切到规划模式,给它一个限定范围的任务:
给登录页加忘记密码流程,先读相关文件并提出实现计划,不要改代码。
你要检查三件事:
- 它读的文件对不对。
- 它的计划有没有越界,比如顺手重构无关模块。
- 它是否列出了验证方式,比如单测、构建、手动检查路径。
如果计划太大,直接让它拆小:“只做 UI,不接 API”、“只改这 2 个文件”、“先写测试,不实现”。
4. 用 /skills 和具体 /skill-name
很多人会说”用 /skill”,但当前更稳的理解是:
- 输入
/可以打开所有可用命令、内置 workflow、插件命令和 skill。 - 输入
/skills可以查看当前会话可用的 skills。 - 具体执行某个 skill 时,通常输入它自己的斜杠名字,比如
/security-review、/simplify、/claude-api,具体以你的/菜单显示为准。 - 自定义 skill 一般放在
.claude/skills/<name>/SKILL.md,调用名通常就是/<name>。
什么时候用 skill:
- 任务有固定流程,比如安全审计、发布检查、API 迁移、文档生成。
- 需要附带参考文档、脚本、模板,而不是一段简单 prompt。
- 团队希望所有人按同一套检查清单执行。
什么时候不用 skill:
- 只是一次性小问题,直接 prompt 更快。
- 只想复用一句短指令,用自定义 slash command 或 prompt 模板就够。
5. 执行时给边界
批准计划后,给 Claude 一个窄任务:
按刚才计划执行第 1 步。只修改 src/routes/auth 和 src/components/auth 里的文件。不要提交。完成后列出改动文件和验证命令。
好边界通常包含:
- 允许改哪些目录或文件。
- 禁止改哪些目录或文件。
- 本轮只做哪一步。
- 完成后要跑什么验证。
- 不要自动 commit,除非你明确要求。
6. 审 diff,再继续
每完成一轮,先看:
/diff
重点看三类问题:
- 是否改了不相关文件。
- 是否引入了新的依赖、配置或环境变量。
- 是否只是让代码”看起来更完整”,但没有覆盖真实路径。
如果 diff 不对,可以用 Esc 中断,或 Esc + Esc 打开 rewind。轻微问题可以直接说:“保留 A,撤回 B,只修 C”。
7. 用测试和构建收尾
让 Claude 跑验证前,先明确命令:
运行 npm test 和 npm run build。如果失败,先解释失败原因,不要直接大改。
如果项目没有测试,至少让它做:
git diff --check检查空白错误。- 类型检查或构建。
- 关键页面 / API 的手动检查清单。
- 列出无法验证的部分,让你人工确认。
8. 长任务要会清上下文
上下文变长后,优先用:
/context看上下文被什么占住。/compact压缩当前会话,并加一句重点:“保留已改文件、待办、验证结果、不要保留闲聊。”/clear开新任务,保留CLAUDE.md项目记忆。/resume回到之前会话。
一个实用习惯:每完成一个阶段,让 Claude 写一段状态:
请总结当前状态:已改文件、关键决策、测试结果、剩余待办、下一步建议。控制在 20 行内。
9. 推荐的新手顺序
claude进入项目。/init生成CLAUDE.md。- 按
Shift + Tab切到规划模式再动手。 - 批准一个小步骤。
- 用
/diff审改动。 - 跑测试 / build。
- 手动 commit。
- 再进入下一步。
最费时间的三个错误
- 从子目录启动。 在仓库根目录跑
claude,别在src/里跑——否则 agent 只看到局部结构,会改错文件。 - 不写
CLAUDE.md。 没有它,每次会话都要重新猜你的技术栈和约定,而且经常猜错。 - 不审就让它提交。 每一轮都先看
/diff。不审就提交是回归 bug 的头号来源。
FAQ
Q:Claude Code 多少钱? A:它包含在付费 Claude 套餐里:Pro 每月 20 美元(按年付折合每月 17 美元),或 Max 每月 100 美元(5 倍额度)和 200 美元(20 倍),数据截至 2026 年 6 月。免费的 Claude.ai 套餐不含它。你也可以用 Anthropic API key 按量付费。注意 Claude Code 和 Claude.ai 对话共用一份额度,网页里聊得多会减少终端 agent 能用的部分。
Q:Claude Code 用哪个模型,能换吗?
A:只跑 Anthropic 模型——Claude Opus 4.7(最强)和 Sonnet 4.6(更快)。Pro 默认 Sonnet 4.6,Max 默认 Opus。随时用 /model 切换。它跑不了 GPT-5.5 或 Gemini;想用那些就改用 Cursor 这种支持多模型的 IDE。
Q:一定要会命令行吗?
A:基本的终端操作是必须的。你要在项目根目录跑 claude、切换目录、看懂 diff 输出。如果 cd、git status、ls 还不熟,先补这块。
Q:CLAUDE.md 是干什么的?
A:它是 Claude Code 每次运行都会读的项目说明书——代码约定、构建和测试命令、目录结构、以及哪些文件别碰。用 /init 生成,用 /memory 编辑。
Q:Claude Code 会自动帮我提交吗?
A:只有你明确要求时才会。默认它只改文件、不提交。保持这个习惯,先审 /diff,把它的产出当成新人提的 PR 来看。
Q:这和直接在 Claude.ai 聊有什么区别? A:Claude.ai 是网页对话,碰不到你的仓库。Claude Code 是住在终端里的 agent,能读写文件、跑命令。一次性问题用 Claude.ai,真实代码库里的多文件改动用 Claude Code。
相关阅读
标签: #Claude #教程 #Claude Code