这篇讲什么
Claude Code 是命令行 agent——它做什么、为什么开发者爱用。
本文涉及的工具 / 概念：
- Claude Code: Anthropic 推出的命令行 AI 编程 agent，能在你的终端里读、写、运行项目代码。
- Claude: Anthropic 的对话式 AI 助手，类似 ChatGPT，支持文件、长文档和工具集成。
这篇适合谁看
熟悉命令行的开发者。
什么时候适合用
多文件改动、agent 任务、代码库探索。
具体步骤
- 按官方指引安装。
- 在项目根目录跑
claude。 - 写一份 CLAUDE.md。
- 第一个任务：“给 src/server.ts 加 /health 端点。“
快捷键指南
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. 用 Plan 模式先让它想清楚
大改动不要一上来就让它写代码。先输入：
/plan 给登录页加忘记密码流程，先读相关文件并提出实现计划，不要改代码。你要检查三件事：
- 它读的文件对不对。
- 它的计划有没有越界，比如顺手重构无关模块。
- 它是否列出了验证方式，比如单测、构建、手动检查路径。
如果计划太大，直接让它拆小：“只做 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。/plan <任务>先看计划。- 批准一个小步骤。
- 用
/diff审改动。 - 跑测试 / build。
- 手动 commit。
- 再进入下一步。
建议的操作流程
CLAUDE.md → 第一条 prompt → 审 diff → 迭代。
容易踩的坑
- 不在项目根目录跑
- 没 CLAUDE.md
- 不审就让它提交
FAQ
Q：Claude Code 第一次跑应该做什么？
A：在项目根目录跑 claude，然后用 /init 生成 CLAUDE.md（写技术栈、常用命令、目录结构、不能碰的文件）。再用 /plan <任务> 让它先列计划不要写代码，看完计划再批准小步骤。
Q：什么时候用 Plan 模式 / Auto-accept / Bypass？
A：陌生任务和敏感 repo 默认 Plan + Ask；批量改文件 / 跑测试循环切 Auto-accept edits；只在隔离 worktree、容器、一次性目录里才考虑 Bypass。Shift + Tab 一档档切。
Q：上下文太长 Claude 开始走神怎么办？
A：/context 看占用、/compact 压缩并加重点提示（“保留已改文件、待办、验证结果”）、新任务用 /clear 但保留 CLAUDE.md。每完成一个阶段让 Claude 写一段 20 行的状态报告。
Q：Claude Code 和 Cursor、Codex 怎么选？ A：Claude Code 是终端原生、长任务和大规模重构上目前最稳；Cursor 在 IDE 内 inline edit / Tab 补全更顺手；Codex 适合云端长任务。三家可以同时用——但默认把 CLAUDE.md 当唯一可信源。
相关阅读
标签: #Claude #教程 #Claude Code