1. 为什么需要一份趁手的命令速查手册刚接触 Claude Code 那会儿我最常干的事就是一边翻官方文档一边敲命令敲完还得回头确认参数对不对。这种割裂感特别影响思路——本来在琢磨一个重构方案结果注意力全被“那个命令到底叫啥”给带跑了。后来我花了一个周末把自己高频用到的指令、快捷键和工作流配置全部整理成一份速查表贴在副屏上效率直接上了一个台阶。这份手册面向的是已经在用或者准备上手 Claude Code 的开发者不管你是刚装好还没跑通第一条命令的新手还是已经用了一阵但总觉得操作不够顺滑的老用户都能从里面找到能直接抄作业的内容。核心覆盖三块高频指令会话管理、模型切换、上下文压缩、快捷键终端交互、编辑器联动、以及高效工作流CLAUDE.md 配置、多文件协作、版本升级。我不会只列命令了事每条指令背后为什么这么设计、什么场景下用、有什么坑都会一并说清楚。先给一个整体认知Claude Code 本质上是一个跑在终端里的智能编程代理它通过读取你的项目文件、理解上下文、执行命令来帮你完成编码任务。它的交互模式分两种——交互式会话和一次性命令。交互式会话是你输入claude后进入的持续对话环境适合复杂任务一次性命令则是claude -p 你的问题这种直接返回结果就退出的模式适合脚本集成。理解这个区分后面的所有指令你都能找到自己的位置。2. 核心指令全拆解从会话管理到模型切换2.1 会话生命周期管理指令会话管理是日常用得最多的一类指令因为 Claude Code 的上下文窗口是有限的你得知道什么时候该压缩、什么时候该清空、什么时候该恢复之前的会话。启动与恢复是最基础的操作。直接输入claude进入交互式会话这是最常用的入口。如果你之前退出过一个会话想接着聊用claude --continue或者简写claude -c它会自动加载最近一次会话的上下文。我实测下来这个功能在排查一个跨天的问题时特别有用——昨天聊到一半的调试思路今天接着来不用重新解释背景。如果想从一堆历史会话里挑一个恢复用claude --resume或者claude -r它会列出最近的会话让你选。这里有个细节会话列表是按时间倒序排列的最新的在最上面用方向键选择就行。上下文压缩是 Claude Code 里最值得花时间理解的机制。当对话变长上下文快满的时候你可以用/compact指令手动触发压缩。它的原理是把之前的对话历史总结成一段精简的摘要保留关键信息释放上下文空间。我一般会在完成一个阶段性任务后主动执行一次/compact而不是等到系统提示上下文不足才动手。主动压缩的好处是你可以控制压缩的时机确保重要信息不被意外丢弃。注意/compact压缩后的摘要会替换掉原始对话历史所以如果你觉得某段对话特别重要建议先用/export导出再压缩。清空与退出方面/clear会清空当前会话的所有上下文相当于重新开始但不会退出程序。/exit或者直接按CtrlC两次则是完全退出。这里有个容易混淆的点/clear之后你的会话历史还在可以用--resume找回来但如果你在退出时选择了不保存那就真没了。2.2 模型切换与参数调优指令Claude Code 支持在不同模型之间切换这个功能在成本和效果之间做平衡时特别有用。用/model指令可以查看当前使用的模型并切换到其他可用模型。我通常的做法是日常的代码补全和简单问答用轻量模型遇到复杂的架构设计或者疑难 bug 排查时切到更强的模型。切换模型时要注意不同模型的上下文窗口大小可能不一样。如果你从一个窗口大的模型切到窗口小的之前的长对话可能会被截断。所以我的习惯是切换模型前先/compact一次把上下文压到最小再切。温度参数虽然不能直接在会话里调但可以通过配置文件设置。在~/.claude/config.json里可以配置默认的模型和温度值。温度低比如 0.2适合需要精确输出的场景比如生成代码温度高比如 0.8适合头脑风暴和创意类任务。这个配置是全局生效的改完需要重启会话。还有一个容易被忽略的指令是/cost它会显示当前会话的 token 消耗和预估费用。我在跑长任务之前会先看一眼心里有个数。特别是用强模型跑大批量重构的时候这个指令能帮你避免月底看到账单时的心跳加速。2.3 文件与项目操作指令Claude Code 的核心能力之一是直接操作你的项目文件所以文件相关指令必须熟练掌握。/add指令用于把文件添加到当前会话的上下文中。比如/add src/utils/parser.js会让 Claude 读取这个文件的内容后续的对话它就能基于这个文件来回答。我通常会在开始一个任务前把相关的几个核心文件都/add进来这样第一轮对话就能得到比较准确的回答不用来回补充。/drop则是从上下文中移除文件。当你发现某个文件已经不需要了或者上下文太满想腾空间就用它。这里有个经验不要一次性 add 太多文件上下文会被无关代码占满反而影响 Claude 对核心问题的理解。我一般控制在 5 到 8 个文件以内只加跟当前任务直接相关的。/diff指令会显示当前工作区相对于上次提交的所有改动。这个在让 Claude 帮你 review 代码时特别有用——你先/diff让它看到所有改动然后问“这些改动有没有潜在问题”它就能基于完整的 diff 来回答而不是只盯着你贴的那几行。/undo是后悔药。如果 Claude 帮你改代码改坏了用/undo可以撤销最近一次文件修改。但要注意它只能撤销 Claude 自己做的修改你自己手动改的它管不了。而且撤销是按操作顺序来的不能选择性撤销某一次。2.4 信息查询与帮助指令/help不用多说忘了什么指令就用它。但很多人不知道的是/help后面可以跟具体指令名比如/help compact会显示这个指令的详细说明和可用参数。/status显示当前会话的状态信息包括使用的模型、上下文使用百分比、当前工作目录等。我习惯在开始一个复杂任务前先/status看一眼确认模型和上下文余量都合适。/review是一个比较特殊的指令它会触发 Claude 对你当前项目的代码进行一轮自动 review找出潜在问题并给出修改建议。这个适合在提交代码前跑一次当作一道额外的检查关卡。实测下来它对一些常见的边界条件问题和命名不规范问题抓得挺准但复杂的业务逻辑问题还是得靠人。3. 快捷键体系让手指不离键盘3.1 终端交互核心快捷键Claude Code 跑在终端里所以它的快捷键体系跟终端环境紧密相关。掌握这些快捷键能让你在会话中的操作流畅很多。CtrlC是最常用的中断键。当 Claude 正在生成回答你发现它理解偏了想打断按一次CtrlC就能停止生成。但注意连按两次会直接退出程序所以打断的时候按一次就够了等它停下来再输入新的指令。CtrlD是发送 EOF 信号在 Claude Code 里等同于退出。跟CtrlC两次的区别是CtrlD更“干净”它会正常结束会话并保存历史。CtrlL清屏但不清除上下文。这个跟/clear有本质区别——CtrlL只是把终端显示的内容清掉让屏幕干净点对话历史还在/clear是真的把上下文清空了。我经常用CtrlL来整理屏幕特别是在一长串输出之后想看清楚最新的内容。上箭头和下箭头用来翻阅历史输入。这个跟 shell 的历史记录类似但范围仅限于当前会话。如果你想找更早的输入得用CtrlR做反向搜索输入关键词就能匹配到之前发过的内容。Tab键在输入文件路径时有自动补全功能。比如你输入/add src/然后按Tab它会列出src/下的所有文件和目录供你选择。这个在项目结构比较深的时候特别省事。3.2 编辑器联动快捷键Claude Code 虽然跑在终端但它跟编辑器的联动能力很强。最常用的场景是你在编辑器里选中一段代码想问问 Claude 这段代码有什么问题。在 VS Code 里如果你装了 Claude Code 的扩展可以用CmdEscMac或CtrlEscWindows/Linux快速打开 Claude Code 面板。选中代码后按这个快捷键选中的内容会自动带入 Claude 的上下文。在终端里用 Claude Code 时CtrlV粘贴是常规操作但如果你粘贴的是多行代码Claude Code 会自动识别并保持格式。我试过直接粘贴一个 200 行的函数它完整接收了没有出现格式错乱。还有一个很实用的快捷键是CtrlO它会打开一个文件选择器让你快速把文件加入上下文效果等同于/add但操作更快。我一般在项目里来回切换文件的时候用这个比手敲路径快得多。3.3 会话导航与搜索快捷键当会话变长往上翻找之前的内容会很麻烦。CtrlU和CtrlD在有些终端里是翻页用的但在 Claude Code 的交互模式下更推荐用/search指令来搜索历史对话内容。输入/search 关键词它会列出所有匹配的对话片段你可以直接跳转到对应的位置。Esc键在 Claude 生成回答时按一下效果跟CtrlC类似也是中断生成。区别是Esc更轻量不会触发退出逻辑。我一般打断用Esc彻底停止用CtrlC。如果你同时开了多个 Claude Code 会话比如一个在跑重构一个在写测试可以用CtrlZ把当前会话挂起到后台然后用fg命令切回来。这个跟 Linux 的作业控制是一样的逻辑多任务并行的时候很实用。4. 高效工作流搭建从 CLAUDE.md 到多文件协作4.1 CLAUDE.md 配置文件的正确写法CLAUDE.md 是 Claude Code 的项目级配置文件放在项目根目录下Claude 在每次会话开始时会自动读取它。这个文件的作用是告诉 Claude 这个项目的背景信息、编码规范、常用命令等相当于给 Claude 一份“项目入职指南”。我见过很多人把 CLAUDE.md 写成了一篇冗长的文档什么信息都往里塞结果反而稀释了关键信息。我的经验是CLAUDE.md 要短而精只放 Claude 每次都需要知道的核心信息。具体来说包含这几块就够了项目概述一两句话说明这个项目是干什么的技术栈是什么。目录结构关键目录的用途说明让 Claude 知道代码该放哪里。编码规范命名约定、缩进风格、注释要求等。常用命令构建、测试、部署的命令Claude 需要执行时会用到。注意事项有哪些坑不能踩哪些文件不能动。一个实际的 CLAUDE.md 例子# 项目概述 这是一个基于 Node.js 的 REST API 服务使用 Express 框架和 PostgreSQL 数据库。 # 目录结构 - src/routes/ 路由定义 - src/models/ 数据模型 - src/services/ 业务逻辑 - tests/ 测试文件 # 编码规范 - 使用 2 空格缩进 - 函数名用 camelCase常量用 UPPER_SNAKE_CASE - 每个导出函数必须有 JSDoc 注释 # 常用命令 - npm run dev 启动开发服务器 - npm test 运行测试 - npm run lint 代码检查 # 注意事项 - 不要修改 .env 文件 - 数据库迁移文件在 migrations/ 目录不要手动改这个文件我一般控制在 50 行以内超过这个长度就说明有些信息不该放这里应该放到具体的代码注释或者单独的文档里。提示CLAUDE.md 支持嵌套你可以在子目录里也放 CLAUDE.mdClaude 会同时读取根目录和当前工作目录下的配置。这个特性适合 monorepo 项目每个子包可以有自己独立的配置。4.2 多文件协作与上下文管理策略Claude Code 最强大的能力之一是跨文件理解和修改代码但前提是你得把正确的文件放进上下文。我的策略是按任务阶段动态调整上下文而不是一次性把所有相关文件都加进来。具体操作上我会把任务拆成几个阶段。比如一个“给用户模块添加邮箱验证功能”的任务我会这么分第一阶段先/add用户模型文件和现有的验证逻辑文件让 Claude 理解现有的数据结构。问它“基于现有的用户模型添加邮箱验证字段需要改哪些地方”得到方案后再进入下一阶段。第二阶段/add路由文件和控制器文件让 Claude 基于第一阶段的方案生成具体的代码修改。这时候可以把第一阶段不太相关的文件/drop掉腾出上下文空间。第三阶段/add测试文件让 Claude 生成对应的测试用例。同时用/diff让它看到前两个阶段的所有改动确保测试覆盖了所有修改点。这种分阶段的方式比一次性把所有文件都加进来效果要好得多。我实测过一次性加 15 个文件的时候Claude 的回答质量明显下降因为它要处理的噪音太多了。控制在 5 到 8 个文件回答的准确率和针对性都高很多。还有一个技巧是用/compact做阶段切换。每完成一个阶段执行一次/compact把之前的对话压缩成摘要然后开始下一阶段。这样上下文里始终保留着关键决策信息但不会被细节撑爆。4.3 版本升级与安装配置工作流Claude Code 的版本更新比较频繁保持最新版本能用到最新的功能和模型。升级方式取决于你当初的安装方式。如果你是用 npm 全局安装的升级命令是npm update -g anthropic-ai/claude-code如果你是用原生安装脚本装的重新跑一遍安装脚本就会自动升级到最新版。升级完成后用claude --version确认版本号。安装过程中有几个常见的坑。权限问题是最常见的特别是在 Linux 和 Mac 上npm 全局安装可能需要 sudo但用 sudo 装完之后又会出现权限归属问题。我的建议是配置 npm 的全局目录到用户目录下避免用 sudomkdir -p ~/.npm-global npm config set prefix ~/.npm-global export PATH~/.npm-global/bin:$PATH这样装出来的包都在用户目录下不会有权限问题。记得把export PATH那行加到你的.bashrc或.zshrc里否则每次开新终端都要重新设置。网络问题是另一个常见障碍。如果你在公司内网或者网络环境受限的情况下安装可能会遇到下载超时。这时候可以配置 npm 的镜像源或者用代理环境变量。具体怎么配取决于你的网络环境核心思路是确保 npm 能正常访问包仓库。安装完成后第一次运行claude会引导你完成认证配置。按照提示操作就行认证信息会保存在本地后续不需要重复登录。4.4 与外部工具链的集成工作流Claude Code 可以跟很多外部工具配合使用形成更完整的工作流。我日常用得最多的几个集成场景与 Git 的集成是最基础的。Claude Code 可以直接执行 git 命令所以你可以在会话里让它帮你git diff、git log、甚至git commit。我通常会让它先/diff看一下改动然后根据改动内容生成 commit message确认没问题后再执行提交。这样比手动写 commit message 快而且描述更准确。与测试框架的集成也很实用。你可以在 CLAUDE.md 里配好测试命令然后直接让 Claude “跑一下测试看看有没有问题”。它会执行npm test或你配置的命令读取输出然后分析失败原因。我试过让它根据测试失败信息自动修复代码对于简单的断言失败和类型错误修复成功率挺高的。与代码检查工具的集成类似。配置好 lint 命令后让 Claude 跑 lint 并修复报告的问题。不过要注意有些 lint 规则是团队约定Claude 可能会“好心”改掉一些不该改的地方。我的做法是让它先列出所有问题我确认哪些需要修再让它动手。与数据库工具的集成在开发阶段很有用。你可以让 Claude 直接执行 SQL 查询来验证数据或者生成迁移脚本。但生产环境的数据库连接信息千万不要放进 CLAUDE.md这是安全红线。5. 常见问题与排查技巧实录5.1 安装与启动阶段的典型问题问题一安装后运行claude提示命令找不到。这个几乎都是 PATH 没配好。先确认安装位置npm 全局安装的话用npm root -g看全局包路径然后检查这个路径下的bin目录有没有加到 PATH 里。如果是原生安装安装脚本通常会提示你把某个路径加到 PATH照着做就行。问题二启动时报认证失败。先检查网络连接是否正常然后确认认证信息是否过期。可以尝试删除本地的认证缓存文件重新登录。缓存文件的位置在~/.claude/目录下具体文件名跟版本有关删之前建议先备份整个目录。问题三启动后界面显示异常出现乱码或者排版错乱。这通常是终端不支持某些字符导致的。检查你的终端类型和字体设置确保支持 UTF-8 编码。如果是 Windows 的 cmd 或 PowerShell建议换用 Windows Terminal兼容性好很多。5.2 会话过程中的高频故障问题四上下文满了但/compact之后感觉 Claude 变“笨”了。这是压缩的固有代价——摘要不可能保留所有细节。我的应对策略是在/compact之前把关键决策和结论手动记下来压缩后如果发现 Claude 忘了重要信息直接把笔记贴给它。另外压缩的时机很重要不要在任务做到一半的时候压缩最好在阶段切换时做。问题五Claude 修改了不该改的文件。这个我踩过好几次坑。根本原因是上下文里包含了那些文件Claude 觉得它们跟任务相关就顺手改了。预防措施是在 CLAUDE.md 里明确写出“不要修改”的文件列表同时在/add文件时只加真正需要的。如果已经改坏了用/undo撤销或者用 git 恢复。问题六生成的代码风格跟项目不一致。检查 CLAUDE.md 里的编码规范是否写清楚了。如果写了但还是不对可能是规范描述不够具体。比如“使用 2 空格缩进”不如“使用 2 空格缩进不要用 Tab函数之间空一行”来得明确。规范越具体Claude 执行得越准确。问题七执行命令时卡住不动。有些命令会等待用户输入Claude 执行时就会卡住。遇到这种情况按Esc中断然后检查命令是否需要交互式输入。对于需要交互的命令可以在命令后面加上非交互式的参数或者用echo管道传入输入。5.3 性能与成本优化技巧问题八响应速度慢。影响速度的因素有几个模型选择、上下文大小、网络延迟。切换到轻量模型能明显提速压缩上下文也能减少处理时间。如果网络延迟是瓶颈那就只能忍了或者换个网络环境好的时候用。问题九token 消耗太快。几个优化方向一是控制/add的文件数量和大小大文件可以只加关键部分二是及时/compact避免上下文无限增长三是简单任务用轻量模型别什么都上强模型。我自己的经验是做好这三点token 消耗能降一半以上。问题十/cost显示的费用跟预期不符。检查一下是不是有后台会话在跑。Claude Code 的计费是按实际 token 用量来的如果你开了多个会话同时跑费用会累加。另外/compact本身也会消耗 token因为压缩过程需要模型来处理。5.4 问题速查表问题现象可能原因排查步骤解决方案命令找不到PATH 未配置which claude检查路径将安装目录的 bin 加入 PATH认证失败认证信息过期检查~/.claude/目录删除缓存重新登录界面乱码终端编码问题检查终端 UTF-8 设置换用 Windows Terminal 或 iTerm2上下文满对话过长/status查看使用率执行/compact压缩改错文件上下文包含无关文件检查/add的文件列表/undo撤销调整 CLAUDE.md代码风格不符规范描述不具体检查 CLAUDE.md 编码规范补充更具体的规范说明命令卡住命令需要交互输入观察命令是否等待输入Esc中断改用非交互参数响应慢模型重或上下文大检查模型和上下文大小切轻量模型压缩上下文token 消耗快上下文膨胀/cost查看用量控制文件数量及时压缩费用超预期多会话并行检查是否有后台会话关闭不需要的会话6. 把工具用成自己的手感说了这么多指令和配置最后想聊一个更本质的东西工具的价值不在于功能多全而在于你用得多顺。我见过不少人装了 Claude Code用了几次觉得“也就那样”就放下了。问题往往不是工具不行而是没找到适合自己的使用节奏。我的建议是先从最简单的场景开始——比如让它帮你写一个函数的单元测试或者解释一段你看不懂的代码。用顺了之后再逐步把更复杂的任务交给它。CLAUDE.md 也是一开始不用写得太完整用着用着发现“这个信息每次都要重复说”就把它加进去。让配置跟着你的实际需求长出来而不是一开始就追求大而全。快捷键这块不用刻意去背。你只要记住最常用的那几个——CtrlC中断、/compact压缩、/add加文件——剩下的在用的过程中自然会记住。我到现在也记不全所有快捷键但常用的那几个已经形成肌肉记忆了这就够了。还有一个我自己的小习惯每周花十分钟回顾一下这周用 Claude Code 做了什么哪些操作重复了三次以上就想想能不能用 CLAUDE.md 或者别名来简化。这个习惯坚持了几个月我的工作流已经比刚开始时顺畅了不止一个档次。工具是死的手感是活的多琢磨怎么让自己少敲几个键、少切几次窗口效率自然就上来了。