1. 为什么需要一份自己的 Claude Code 命令手册刚接触 Claude Code 的人十有八九会经历同一个阶段装完之后对着终端发呆知道这东西能改代码、能跑命令但真到用的时候脑子里只有一句帮我看看这个文件然后就没有然后了。等过了一两周看到别人在群里晒自己的工作流——三分钟重构一个模块、自动跑测试、批量改配置——才发现差距不在模型本身而在命令和快捷键的熟练度上。Claude Code 这类终端里的 AI 编程助手本质上是一个对话式命令行工具。它的能力上限很大程度上取决于你能不能把意图准确地翻译成它能理解的指令以及你能不能用快捷键把重复操作压缩到几秒钟。这跟当年学 Vim 是一个道理会i、Esc、:wq就能活但真正拉开效率的是ciw、%、宏录制这些进阶操作。这篇内容整理的是我在实际项目里高频使用的 Claude Code 指令、快捷键组合以及几套已经跑顺的工作流。适合三类人看刚装好 Claude Code 还没摸清门道的新手、用了一段时间但总觉得差点意思的中级用户、以及想把 AI 助手嵌进团队协作流程的开发者。全文不涉及任何安装破解类内容只讲怎么把已经能用的工具用出效率。需要先说明一点Claude Code 的版本迭代比较快命令和快捷键在不同版本间可能有细微差异。下面提到的所有操作建议你先在自己的环境里验证一遍再固化进肌肉记忆。我踩过的坑会单独标出来避免你重复走弯路。2. 会话控制类指令把对话当成可管理的对象2.1 启动、恢复与退出别每次都从零开始很多人用 Claude Code 的习惯是用完就关下次重开这其实浪费了大量上下文。Claude Code 的会话是可以恢复的关键在于你有没有用对启动参数。最基础的启动就是直接在项目根目录敲claude。但这里有个细节启动目录决定了它的默认工作范围。如果你在~/projects下启动它会把整个目录当成上下文候选区扫描范围过大反而拖慢响应。我的做法是永远cd到具体项目根目录再启动让它的视野聚焦在当前工程上。恢复上一次会话用claude --continue简写-c它会接着最近一次对话继续。如果你同时维护多个项目想指定恢复某个特定会话用claude --resume简写-r它会列出历史会话让你选。这个功能在排查昨天那个 bug 改到一半的场景下特别有用。退出会话有两个层次输入/exit或者按CtrlD是正常退出会话记录会保留而CtrlC连按两次是强制中断适合它卡在某个长任务里出不来的时候。我一般优先用/exit因为强制中断偶尔会让会话状态不完整下次--continue时上下文会有点乱。提示如果你在会话里改了代码但还没保存退出前先确认一下。Claude Code 不会自动帮你 commit它只是修改文件版本控制还是得你自己来。2.2 上下文管理/clear和/compact的使用时机这是新手最容易忽略、老手最依赖的一组命令。/clear是清空当前会话的上下文相当于开一个新对话但不用退出程序。什么时候用当你完成一个独立任务、准备切换到完全不相关的另一个任务时。比如你刚让 Claude Code 帮你写完一个 API 接口接下来要处理前端样式问题这两个任务没有共享上下文留着旧对话只会干扰它的判断。/compact则是压缩上下文。当对话很长、token 快撑满的时候它会总结之前的对话内容保留关键信息释放空间。这个命令的精髓在于时机不要等到它提示上下文快满了才用而是在一个阶段性任务完成后主动压缩。我的经验是当一轮对话超过二三十轮交互就该考虑/compact了。这里有个反直觉的点/compact之后Claude Code 对早期细节的记忆会变模糊。所以如果你正在处理一个需要精确记住某个函数签名的任务压缩前最好把关键信息用/memory存进CLAUDE.md或者手动记下来。2.3 会话内的斜杠命令清单Claude Code 的斜杠命令是会话内的元操作不涉及具体代码任务而是控制工具本身。下面这张表是我整理的高频命令按使用频率排序命令作用典型使用场景/help查看所有可用命令忘了某个命令怎么拼/clear清空上下文切换到不相关的新任务/compact压缩上下文对话过长、token 吃紧/memory编辑 CLAUDE.md 记忆文件固化项目规范、常用约定/config查看和修改配置调整模型、权限等/cost查看本次会话消耗控制使用成本/review请求代码审查提交前自查/init初始化项目记忆文件新项目第一次使用/init值得单独说。在一个新项目里第一次运行它Claude Code 会扫描项目结构生成一份初始的CLAUDE.md里面包含项目类型、目录结构、构建命令等基础信息。这份文件是后续所有对话的背景知识写得好不好直接决定它理解项目的准确度。3. 快捷键体系把重复操作压缩到肌肉记忆里3.1 输入区编辑快捷键像用 Vim 一样改 promptClaude Code 的输入框支持一套类 Emacs 的编辑快捷键如果你习惯了 Vim 或终端操作上手会很快。核心的几个CtrlA/CtrlE跳到行首 / 行尾。改长 prompt 时比按方向键快得多。CtrlU/CtrlK删除光标前 / 后的所有内容。写错了想重来一个组合键搞定。CtrlW删除光标前的一个单词。改措辞时特别顺手。CtrlY粘贴刚才删除的内容。配合CtrlU和CtrlK用相当于有了剪切板。OptionEnterMac或AltEnter输入换行而不发送。写多行 prompt 必备。这里有个坑不同终端模拟器对Option键的处理不一样。在 iTerm2 里需要在设置里把 Option 键映射为Esc否则OptionEnter会被识别成别的。我一开始怎么按都换不了行折腾了半小时才发现是终端设置的问题。3.2 历史与补全↑键之外的高效检索按↑翻历史命令是最基础的但 Claude Code 的历史检索支持前缀匹配。你输入几个字符再按↑它只会翻出以这几个字符开头的历史记录。比如输入重构再按↑就能快速找到之前所有以重构开头的 prompt。Tab键用于补全文件路径和命令。当你输入引用文件时Tab会列出当前目录下的候选文件。这个功能在大型项目里能省不少打字时间也避免路径拼错。CtrlR是反向搜索历史跟 bash 的CtrlR逻辑一致。输入关键词它会实时匹配历史记录。我经常用它来找上周那个改数据库连接的 prompt。3.3 中断与撤销Esc和CtrlC的正确用法Claude Code 正在生成回复时按Esc可以中断生成。这个操作很常用——当你发现它理解偏了、正在往错误方向写代码时及时打断比等它写完再纠正要省 token。CtrlC按一次是清空当前输入按两次是退出程序。这个设计跟很多终端工具一致但要注意它不会撤销已经执行的代码修改。如果 Claude Code 已经改了文件你按CtrlC只是退出文件改动还在。撤销得靠 git。注意养成让 Claude Code 改代码前先 commit的习惯。这样任何改动都能用git diff查看、用git checkout回滚。我吃过亏——有一次它批量重命名了几十个文件我发现方向错了但没有 commit只能手动一个个改回来。4. 文件引用与上下文注入让 AI 看到该看的东西4.1引用精确指定文件而不是让它猜Claude Code 最强大的能力之一是文件引用。在 prompt 里用加上文件路径就能把指定文件的内容注入上下文。比如src/utils/parser.js 这个文件的错误处理有问题帮我看看这比帮我看看 parser 文件要精确得多。后者会让它去猜是哪个文件可能扫描一堆无关内容既慢又费 token。引用支持目录。输入src/components/会把整个目录下的文件纳入上下文。但要慎用——目录太大时token 消耗会飙升。我的原则是能引用具体文件就不引用目录能引用目录就不引用整个项目。还有一个技巧后面可以跟通配符。比如src/**/*.test.js能匹配所有测试文件。这在帮我统一改一下所有测试的断言风格这类任务里特别好用。4.2 图片与截图引用视觉上下文的价值Claude Code 支持直接粘贴图片。在 Mac 上用CtrlV在 Linux 上用CtrlShiftV就能把剪贴板里的截图贴进 prompt。这个功能在几个场景下价值极高UI 还原贴一张设计稿截图让它按图写组件。报错排查贴一张终端报错截图比手打错误信息准确。流程图理解贴一张架构图让它理解模块关系。我实测下来截图里的文字识别准确率很高但复杂的图表关系它理解得一般。所以贴架构图时最好再用文字补充说明关键的数据流向。4.3CLAUDE.md项目级的持久记忆CLAUDE.md是 Claude Code 的项目说明书。放在项目根目录每次会话启动时会自动加载。它的内容会作为系统提示的一部分影响它对项目的理解。一份好的CLAUDE.md应该包含项目技术栈和版本比如React 18 TypeScript 5 Vite目录结构说明哪个目录放什么构建、测试、lint 命令代码规范命名约定、格式化规则常用约定比如所有 API 请求走src/api/下的封装用/init可以生成初始版本但自动生成的往往比较粗糙。我的做法是生成后手动补充尤其是代码规范和常用约定这两块自动生成的内容基本没用得自己写。/memory命令可以在会话中直接编辑CLAUDE.md。当你发现 Claude Code 反复犯同一个错误比如总是用错某个工具函数就把它写进CLAUDE.md下次就不会再犯。5. 高效工作流把零散命令串成流水线5.1 新项目上手工作流从陌生代码到能改接手一个陌生项目时我的标准流程是这样的cd到项目根目录运行claude。输入/init生成初始CLAUDE.md。让它总结这个项目的架构和主要模块同时用引用package.json或pom.xml等依赖文件。根据它的总结手动补充CLAUDE.md里的规范部分。挑一个简单任务试手比如给某个函数加注释验证它对项目的理解是否准确。这个流程走下来大概十几分钟但能省掉后面大量的它怎么又理解错了的返工时间。关键是第 3 步——让它先讲一遍它理解的项目结构你能立刻发现它的认知偏差。5.2 重构工作流小步快跑 及时验证重构是 Claude Code 的强项但也是最容易翻车的场景。我的做法是严格小步走先 commit 当前状态保证有回滚点。用引用要重构的文件说明重构目标比如把这个类拆成三个职责单一的类。让它先给出重构方案不要直接改代码。方案确认后再让它执行。改完后立刻跑测试。测试通过再 commit。重复下一轮。第 3 步是关键。直接让它改它可能按自己的理解大改一通方向错了就白费。先要方案你能在它动手前纠正方向。5.3 调试工作流从报错到修复的闭环调试场景下Claude Code 的价值在于它能同时看代码、跑命令、分析输出。我的流程把报错信息完整贴进 prompt截图或文字都行。用引用报错涉及的源文件。让它分析可能的原因并给出验证方法。按它给的方法跑命令验证。把验证结果贴回去让它给出修复方案。这个闭环里第 3 步的给出验证方法很重要。好的调试不是直接猜答案而是先设计实验缩小范围。Claude Code 在这方面比人快因为它能瞬间列出所有可能的原因。5.4 批量修改工作流通配符 脚本化当需要改几十个文件的同一处模式时别一个个来。用通配符引用 明确指令src/**/*.js 把所有 console.log 替换成 logger.debug注意保留原有的参数如果改动逻辑复杂让它先写一个脚本你 review 后再执行。这样比它直接改文件更可控也方便复用。6. 踩坑记录那些文档里不会写的细节6.1 上下文超长时的表现与应对Claude Code 的上下文窗口是有限的。当对话很长时你会观察到几个信号响应变慢、开始忘记早期说过的约定、重复问已经回答过的问题。这时候别硬撑用/compact压缩或者/clear重开。我遇到过一次极端情况一个会话里改了十几个文件到后面它开始把不同文件的函数名搞混。当时没意识到是上下文问题以为是模型能力不行。后来/clear重开同样的任务一次就过了。上下文污染是真实存在的别把工具的问题当成自己的能力问题。6.2 权限确认的打断与批量授权Claude Code 执行命令前会请求确认这是安全设计。但频繁确认会打断心流。在/config里可以配置允许列表把常用的只读命令如ls、cat、git status加入白名单减少打断。但要注意别把写操作加入白名单。rm、git push、数据库写操作这些必须保持人工确认。我见过有人图省事全放行结果 Claude Code 跑了个git reset --hard半天工作没了。6.3 版本升级后的命令变化Claude Code 迭代快升级后偶尔会有命令改名或行为变化。升级后第一件事是跑/help看一遍命令列表对比一下有没有变化。另外升级后建议在新项目里先跑个小任务验证别直接上生产项目。6.4 与 IDE 插件的配合如果你用 VS CodeClaude Code 有对应的插件。插件版和终端版共享配置和CLAUDE.md但快捷键体系不同。插件版更贴近编辑器操作习惯终端版更适合批量任务和脚本化。我的用法是日常小改用插件大重构和批量任务用终端。7. 把命令变成条件反射整理这份手册的过程中我最大的体会是Claude Code 的效率瓶颈从来不在模型而在使用者的指令词汇量。同样一个任务新手可能要来回五六轮才说清楚熟手一轮就到位。差距就在这些命令、快捷键、工作流的熟练度上。我的建议是别一次性全背下来。挑三五个最常用的比如引用、/clear、/compact、CtrlA/E先用一周形成肌肉记忆后再加新的。工具的价值在于用起来不假思索而不是知道多少命令。最后分享一个我自己的小习惯在CLAUDE.md里专门开一节叫本项目常用 prompt把那些反复用到的指令模板记下来。比如新增 API 接口时按src/api/xxx.js的模板写包含参数校验和错误处理。这样每次不用重新组织语言直接引用就行。这个习惯帮我省下的时间比任何快捷键都多。