1. 为什么需要一份趁手的命令速查手册刚接触 Claude Code 的那几天我最大的感受不是“这工具真强”而是“我到底该敲哪个命令”。终端里光标一闪一闪脑子里却一片空白——想让它读文件不确定是/read还是直接说路径想切换模型忘了是/model还是/config想恢复上一次会话又记不清/resume后面要不要跟参数。这种状态持续了大概一周直到我逼着自己把所有高频指令、快捷键和典型工作流整理成一张表效率才真正起来。这份速查手册就是那段时间的产物。它面向的是已经在用或准备上手 Claude Code 的开发者尤其是习惯在终端里干活、希望把 AI 编码助手真正嵌进日常流程的人。不管你是刚装好还没跑通第一条命令的新手还是已经能用但总觉得“差点意思”的老用户这里整理的高频指令、快捷键组合和几套实战工作流都能直接抄去用。核心关键词就几个Claude Code、命令、快捷键、工作流、CLAUDE.md全文围绕它们展开不绕弯子。我整理的原则很简单只留真正高频的只写我实际验证过的把“为什么这么设计”讲清楚。因为命令这东西死记硬背记不住理解了背后的逻辑用两次就成肌肉记忆了。2. 核心命令分类速查与选型逻辑2.1 会话管理类命令把上下文当成资产来管Claude Code 最容易被低估的能力是它对会话上下文的持续维护。很多人用完一次就关掉下次重新开等于把之前积累的项目理解全扔了。会话管理类命令就是解决这个问题的。/resume是我用得最频繁的命令之一。它的作用是恢复之前的会话继续在原有上下文里干活。比如你上午让 Claude Code 梳理了一个模块的调用关系下午想接着改这个模块直接/resume就能回到那个状态不用重新解释项目结构。实测下来恢复后的上下文完整度很高之前读过的文件、讨论过的方案都还在。/compact则是上下文快满时的救命命令。Claude Code 的上下文窗口有限聊得久了或者读了大文件之后会提示上下文接近上限。这时候/compact会把之前的对话压缩成摘要保留关键信息腾出空间继续用。我的经验是别等到系统提示才压缩感觉对话超过二三十轮、或者刚读完一个大文件之后主动/compact一次后续响应会更利索。/clear是彻底清空当前会话。什么时候用当你切换到一个完全无关的任务时。比如上午在调 Python 脚本下午要改前端样式两个任务八竿子打不着留着旧上下文反而会干扰模型判断。这时候/clear比/compact更合适直接归零。/model用来切换底层模型。不同模型在速度、推理深度、成本上差异明显。我的习惯是日常改改样式、写写注释用轻量模型够了遇到复杂重构、架构设计切到更强的模型。切换是即时生效的不用重启会话。这几个命令的选型逻辑其实是一句话上下文是资产该留的留该压的压该清的清。很多人效率上不去不是命令不会用是没把上下文当回事。2.2 文件与代码操作类命令让 AI 精准触达目标Claude Code 和普通聊天机器人最大的区别是它能直接读写你本地的文件。但前提是你得告诉它操作哪个文件、怎么操作。直接说文件路径是最自然的方式。比如“帮我看一下src/utils/date.js里的格式化函数”它会自己去读。但更高效的做法是用符号引用文件输入之后会触发文件补全选中的文件会被明确加入上下文。这个动作的意义在于显式引用比模糊描述可靠得多。你说“那个处理日期的文件”它可能找错你src/utils/date.js它一定找对。读取整个目录也是支持的。说“读一下src/components目录下的所有组件”它会批量读取。但这里有个坑目录太大时一次性读进来会瞬间吃掉大量上下文。我的做法是先让它列目录结构确认范围后再读具体文件。比如先说“列出src/components下的文件”看清楚了再决定读哪几个。写入和修改方面Claude Code 默认会在改动前展示 diff让你确认。这个确认环节千万别嫌烦我踩过的坑就是有一次让它批量改十几个文件没仔细看 diff 就确认了结果有个文件的缩进全乱了。后来我养成了习惯批量改动前先让它改一个文件看看效果确认风格对了再放开批量操作。还有一个实用技巧是让它“只读不写”。比如你想让它分析代码但别动文件明确说“只分析不要修改任何文件”。这样它会进入只读模式避免误操作。2.3 终端命令执行类命令边界与安全Claude Code 能直接执行终端命令这是它区别于很多同类工具的核心能力。但正因为能执行命令边界感就特别重要。它执行命令的方式是你提出需求它生成命令展示给你确认你同意后才真正执行。比如你说“看看当前目录下有哪些大文件”它会生成类似du -sh * | sort -rh | head -20的命令展示出来你按确认才跑。这个确认机制是安全底线永远不要跳过。我实际用下来几类命令特别顺手查看类ls、cat、grep、find、构建类npm run build、pytest、Git 操作类git status、git diff、git log。尤其是 Git 相关操作让它先跑git diff看看改了什么再决定要不要提交比自己在终端里敲快得多。但有几类命令我会格外谨慎涉及删除的rm、rm -rf、涉及权限的chmod、chown、涉及系统配置的。这些命令即使它生成了我也会逐字看清楚再确认。有一次它生成了一个rm命令要清理临时文件我一看路径写的是项目根目录下的tmp差点把有用的东西删了。路径一定要核对尤其是相对路径。另外如果你在CLAUDE.md里配置了允许自动执行的命令白名单那些命令就不会再弹确认。这个功能方便但白名单一定要收窄只放真正无风险的只读命令。2.4 配置与扩展类命令把重复劳动固化下来CLAUDE.md是整个 Claude Code 体系里最值得花时间研究的文件。它相当于给项目配了一份“说明书”Claude Code 每次进入这个项目都会先读它从而了解项目结构、技术栈、编码规范、常用命令。我现在的习惯是每接手一个新项目第一件事就是写CLAUDE.md。内容不用多但几个关键点必须有项目是干什么的、目录结构怎么组织、用什么技术栈、代码风格有什么要求、常用命令有哪些。写完之后Claude Code 的表现会有质的提升——它不再需要你反复解释“我们用的是 TypeScript 严格模式”“测试用 vitest 不用 jest”这些它自己就知道了。/config命令用来查看和修改当前配置包括模型选择、权限设置、快捷键绑定等。我一般用它来确认当前生效的配置避免改了某个文件但没生效的情况。/init是初始化项目配置的命令它会引导你生成一份基础的CLAUDE.md。新手可以直接用它起步然后在此基础上补充项目特有的内容。/help不用多说忘了命令就敲它。但我的建议是别把它当拐杖。高频命令就那么十几个用两三天就记住了真正需要查的是那些偶尔用一次的长尾命令。3. 快捷键与交互技巧把手指留在键盘上3.1 终端内的核心快捷键组合Claude Code 跑在终端里所以它天然继承了很多终端快捷键同时又加了自己的交互逻辑。混着用的时候容易乱我整理了一张实际高频的表快捷键作用使用场景Ctrl C中断当前生成发现它理解偏了立刻停Ctrl D退出会话干完活收工Ctrl L清屏输出太多看着乱上/下箭头翻历史输入重复之前的指令Tab补全文件路径引用文件时Shift Tab切换模式在普通/自动接受间切换Esc取消当前输入打了一半不想发了Ctrl C是我用得最多的。Claude Code 生成内容时是流式的如果前两句就发现它跑偏了直接Ctrl C中断比等它生成完再纠正省时间。这个习惯养成后整体交互节奏会快很多。Shift Tab切换模式这个技巧很多人不知道。在“普通模式”下它每步操作都要你确认切到“自动接受模式”后读文件、跑只读命令这类低风险操作就不再弹确认了。我一般在信任度高的项目里会切到自动接受但涉及写文件、执行有副作用的命令时还是会切回普通模式。模式切换是动态的根据当前任务的风险等级来。3.2 与编辑器配合的快捷键思路虽然 Claude Code 是终端工具但很多人是终端加编辑器双开的。这时候快捷键的思路就变成怎么在两者之间快速切换而不打断心流。我的配置是终端和编辑器分屏左边编辑器右边终端。改代码在编辑器里改需要 AI 介入时切到终端。切换用编辑器自带的终端切换快捷键VS Code 里是Ctrl 比用鼠标点快得多。另一个技巧是把 Claude Code 的输出直接复制到编辑器。它生成的代码块选中复制粘到编辑器对应位置。虽然不能一键插入但配合编辑器的多光标和格式化实际速度不慢。如果你用的是支持终端的编辑器可以把 Claude Code 直接跑在编辑器内置终端里这样文件路径的补全、复制粘贴都更顺。我试过在 VS Code 内置终端里跑体验比外置终端好一截尤其是引用文件时补全列表和编辑器是打通的。3.3 输入框里的编辑技巧Claude Code 的输入框支持多行输入。直接回车是发送想换行用Shift Enter或者Ctrl J。这个在写复杂需求时特别有用——你可以把需求分点写清楚而不是挤成一行。粘贴多行文本时它会自动识别。如果你从别处复制了一段代码或报错信息直接粘贴进去它会当成上下文的一部分。我经常把浏览器里的报错栈复制过来让它分析比手打快多了。还有一个细节输入框支持历史搜索。按Ctrl R可以搜索之前输入过的内容找到后直接复用。对于那种“上周写过一条很长的指令现在想再用一次”的场景这个功能省事。4. 高效工作流实战拆解4.1 新项目上手工作流从零到能干活接手一个陌生项目传统做法是翻目录、读 README、找入口文件一圈下来半小时没了。用 Claude Code 可以把这个过程压缩到几分钟。第一步进项目根目录敲/init生成基础CLAUDE.md。它会自动扫描项目结构识别技术栈生成一份初始说明。这份说明不一定完美但作为起点够了。第二步让它梳理项目结构。指令可以这么说“读一下这个项目的目录结构告诉我入口文件在哪、主要模块怎么划分、用了哪些关键依赖。”它会跑ls、读package.json或requirements.txt然后给你一份概览。第三步针对你即将改动的模块让它深入读一遍。比如你要改用户认证就说“读一下认证相关的所有文件梳理一下登录流程”。它会找到相关文件读完给你讲清楚流程。第四步把梳理结果补充进CLAUDE.md。这一步很关键因为下次再进这个项目它直接读CLAUDE.md就能恢复认知不用重新梳理。整套流程走下来大概五到十分钟你对项目的理解已经足够开始干活了。我实测过几个中型项目比纯人工翻代码快三到五倍。4.2 日常编码工作流改、测、提交一条龙日常编码的循环无非是改代码、跑测试、提交。Claude Code 能把这三步串起来。改代码阶段我习惯先描述需求让它给方案确认后再让它改。比如“给formatDate函数加一个时区参数默认用本地时区”。它会先展示改动方案我看了觉得对再让它写入。先看方案再动手比直接让它改完再检查要稳。跑测试阶段直接说“跑一下相关测试”。它会找到测试文件执行测试命令把结果反馈给你。如果有失败它会分析原因。我经常让它“跑测试如果有失败就分析原因并给出修复建议”这样一轮下来问题和方案都有了。提交阶段先让它跑git diff看看改了什么确认无误后让它生成提交信息。它生成的提交信息通常比我自己写的规范尤其是涉及多个文件改动时它能概括得比较准。这个循环里/compact的时机很重要。一般改完一个功能、跑完测试之后如果还要继续下一个功能我会先/compact一次把上一个功能的上下文压缩掉保持清爽。4.3 调试排查工作流把报错变成线索遇到 bug 时Claude Code 的价值在于它能同时看代码、看报错、跑命令验证。我的标准流程是先把报错信息完整贴进去然后说“这是报错相关代码在xxx文件里帮我定位原因”。它会读代码、分析报错、给出可能的原因。如果原因不确定它会建议加日志或者跑某个命令验证。验证环节是它比纯聊天工具强的地方。比如它怀疑是某个变量为空导致的会说“跑一下这个命令看看输出”然后生成命令你确认后执行结果直接反馈给它它继续分析。这个“分析-验证-再分析”的循环比干想快得多。我踩过的一个坑是报错信息贴得不全。有一次只贴了最后一行TypeError它分析半天没找到根因。后来把完整的调用栈贴进去它一眼就看出是上游传参的问题。报错信息越完整定位越快这个道理在人工排查时也成立。4.4 批量重构工作流稳字当头批量重构是最容易出事的场景因为改动面大一处出错可能影响一片。用 Claude Code 做批量重构核心原则是小步验证。我的做法是先让它改一个文件看 diff确认风格和逻辑都对然后让它按同样的模式改剩下的一批但每改一个都展示 diff。如果文件多我会分批比如一次改五个改完跑一次测试没问题再继续。CLAUDE.md在这里的作用很大。如果你在CLAUDE.md里写清楚了编码规范比如“所有函数必须有 JSDoc 注释”“用 const 不用 var”它批量改的时候就会自动遵守省去你反复纠正。还有一个技巧是让它生成改动清单。改之前说“列出所有需要改动的文件和改动点”它会给你一份清单。你审一遍清单确认范围对了再让它动手。这份清单同时也是你后续验证的依据。5. 常见问题与排查技巧实录5.1 命令不生效或报错的排查思路最常见的问题是命令敲了没反应。先确认是不是敲错了/help看一眼正确拼写。如果拼写没错检查当前是不是在会话里——有些命令只能在会话内用在启动参数里用不了。另一个常见情况是权限问题。比如让它读某个文件它说没权限。这时候检查文件权限或者确认当前用户有没有读权限。如果是系统级目录可能需要提权但提权操作要格外谨慎。还有一种是上下文满了导致的异常。表现是响应变慢、答非所问、或者直接报上下文超限。这时候/compact或者/clear一下通常就好了。5.2 上下文管理不当引发的典型症状上下文管理是 Claude Code 使用中最容易出问题的地方我总结了几种典型症状和对策症状可能原因对策响应变慢上下文接近上限/compact压缩答非所问旧上下文干扰/clear清空重来忘记之前约定上下文被压缩掉了重要约定写进CLAUDE.md重复读同一文件上下文里没有缓存正常现象可接受改动风格不一致上下文里混了多个任务一个任务一个会话最后一条特别重要一个会话只干一件事。我早期图省事一个会话里又改后端又改前端结果它把后端的风格带到前端去了。后来严格分开问题就没了。5.3 文件读写相关的坑与规避文件路径是高频出错点。相对路径和绝对路径混用时它可能理解错。我的习惯是引用文件一律用补全这样路径是确定的不会歧义。批量读文件时如果目录里有大文件比如日志、打包产物会瞬间吃掉大量上下文。规避方法是先列目录排除掉明显不需要的文件再让它读。写入文件时如果目标文件已存在它会展示 diff。这里要注意diff 里的删除行要特别留意有时候它会把你不打算删的代码删掉。我一般会扫一眼删除行确认没有误删。还有一个坑是编码问题。如果项目里有非 UTF-8 编码的文件读写可能出乱码。遇到这种情况先确认文件编码必要时转成 UTF-8 再操作。5.4 性能与响应速度优化经验响应速度受几个因素影响模型选择、上下文大小、网络状况。模型越强越慢这是 trade-off。日常小改动用轻量模型复杂任务再切强的这个切换习惯能明显提升整体效率。上下文大小的影响更直接。我实测过同样一个任务上下文干净时响应大概两三秒上下文塞满时能到十几秒。所以勤压缩、勤清空不只是为了省 token也是为了速度。网络状况没法控制但可以规避。如果发现响应特别慢先确认是不是网络问题换个时间段再试。另外读大文件、跑长命令时响应慢是正常的别误判成卡死。6. 把工具用成习惯的几个心得CLAUDE.md值得反复打磨。我现在的做法是每次发现它犯了一个“本可以避免”的错误就把对应的规则补进CLAUDE.md。比如它有一次用了var我就在里面写“一律用 const/let”。积累下来这份文件越来越厚但它的表现也越来越稳。这本质上是在把隐性知识显性化一次投入长期受益。命令不用记全记高频的十几个就够。剩下的用/help查或者干脆用自然语言描述需求它也能理解。工具是为人服务的别本末倒置去背命令。最后分享一个我最近养成的习惯每天收工前让它总结一下当天改了什么、有什么遗留问题然后存成一个笔记。第二天开工时先读这份笔记再/resume恢复会话衔接特别顺。这个习惯坚持了两周明显感觉项目推进更有条理了。