1. 为什么需要一份趁手的命令速查手册刚接触 Claude Code 的那几天我最大的感受不是“这工具真强”而是“我到底该敲哪个命令”。终端里光标一闪一闪脑子里却一片空白——想切换模型得翻文档想压缩上下文得回忆斜杠命令想让它读某个文件又忘了引用语法。这种状态持续了大概一周直到我狠下心把高频操作全部整理成一张速查表贴在显示器旁边效率才真正起来。Claude Code 本质上是把大模型能力塞进了终端工作流。它不像 IDE 插件那样有满屏按钮所有交互都靠命令、快捷键和配置文件驱动。这意味着上手门槛确实存在但一旦把常用指令肌肉记忆化你会发现它比任何图形界面都快——手指不用离开键盘上下文不用来回切换代码、文档、脚本全在同一个终端会话里流转。这篇内容适合三类人刚装好 Claude Code 还在摸索基础操作的新手用了一阵但总觉得效率没拉满的中级用户以及想把它嵌进团队工作流、需要统一规范的技术负责人。我会把高频指令、快捷键、CLAUDE.md 配置、工作流编排这几块拆开讲透每个操作都配上我实际踩过的坑和验证过的参数。你不需要从头到尾读一遍完全可以当成手册用到哪块翻哪块。2. 安装与首次配置把地基打牢2.1 安装路径选择与版本管理Claude Code 的安装方式直接决定了后续升级和排障的难易度。目前主流有三条路npm 全局安装、原生二进制安装、以及通过包管理器如 Homebrew安装。我实测下来如果你日常 Node.js 环境本来就干净npm 全局装最省事但如果机器上已经有一堆全局包建议走原生二进制避免依赖冲突。npm 方式npm install -g anthropic-ai/claude-code装完之后用claude --version验证。这里有个细节npm 全局安装的包升级时直接npm update -g anthropic-ai/claude-code就行但如果你用的是 nvm 管理 Node 版本切换 Node 版本后需要重新安装因为全局包是绑定在具体 Node 版本下的。我踩过这个坑——切了 Node 版本后敲claude提示 command not found排查了十分钟才反应过来。原生二进制安装更适合不想折腾 Node 环境的用户下载对应平台的可执行文件放到 PATH 目录里赋权即可。这种方式的升级需要手动替换二进制文件但胜在干净、启动快。注意无论哪种方式安装完成后务必在项目根目录跑一次claude确认能正常启动。如果卡在登录环节先检查网络代理配置是否影响了 API 连通性。2.2 首次启动必做的三件事第一次进 Claude Code别急着让它写代码。先把这三件事做了后面能省很多事。第一确认模型和权限模式。启动后输入/model可以看到当前使用的模型根据任务复杂度切换。日常改 bug、写脚本用默认模型足够遇到架构设计、复杂重构再切到更强的模型。权限模式方面/permissions可以查看和修改当前会话的权限级别新手建议先用默认的询问模式等熟悉了再放开自动执行。第二初始化 CLAUDE.md。在项目根目录敲/initClaude Code 会自动扫描项目结构生成一份 CLAUDE.md 草稿。这份文件是它理解你项目的“说明书”后面我会专门用一章讲怎么写好它。第三跑一次/doctor。这个命令会检查环境依赖、API 连通性、配置文件完整性有问题它会直接告诉你缺什么。我见过不少人卡在“命令没反应”的状态其实跑一下/doctor就发现是 API key 没配好。2.3 配置文件的位置与优先级Claude Code 的配置分三层全局配置用户目录下的.claude文件夹、项目配置项目根目录的.claude文件夹、以及会话内临时配置。优先级是项目配置覆盖全局配置会话内命令覆盖两者。全局配置适合放个人偏好比如默认模型、主题、快捷键映射。项目配置适合放团队规范比如 CLAUDE.md、允许执行的命令白名单、MCP 服务器配置。我通常会把团队共用的东西全放项目配置里提交到 Git这样新人 clone 下来就能直接用统一的工作流。3. 高频斜杠命令把常用操作压进肌肉记忆3.1 会话管理类命令斜杠命令是 Claude Code 里使用频率最高的一类操作。它们以/开头在输入框里敲/会自动弹出候选列表支持模糊搜索。/clear是我用得最多的命令没有之一。它会清空当前会话的上下文但保留 CLAUDE.md 的配置。什么时候用当你完成一个独立任务、准备开始下一个不相关的任务时敲一下/clear避免旧上下文干扰新任务。我见过有人一个会话里从早用到晚结果模型被前面几千行无关代码带偏回答质量断崖式下跌。/compact和/clear的区别值得说清楚。/compact是压缩上下文把之前的对话总结成摘要保留适合任务还没做完但上下文快满了的情况。/clear是彻底清空适合任务切换。判断标准很简单新任务和旧任务有没有关联有关联用/compact没关联用/clear。/resume用来恢复之前的会话。如果你不小心关了终端或者想回到昨天那个调试到一半的会话敲/resume会列出历史会话让你选。这个功能在排查长周期问题时特别有用。/cost显示当前会话的 token 消耗和费用估算。养成定期看一眼的习惯能帮你建立对 token 消耗的直觉。我刚开始用时完全没概念一个下午烧掉的钱够买两杯咖啡后来学会用/compact控制上下文长度成本直接降了一半。3.2 上下文与文件操作类命令/add用来把文件或目录加入当前上下文。比如/add src/utils/会把整个 utils 目录的文件内容读进来。这里有个坑别一次性 add 太多文件上下文窗口是有限的塞太多反而让模型抓不住重点。我的经验是单次 add 不超过 5 个文件大文件先 add 再让它自己按需读取。/drop是/add的反操作把不需要的文件从上下文里移除。当你发现模型开始引用一些不相关的旧文件时用/drop清理一下。/diff查看当前工作区相对于 Git HEAD 的改动。这个命令在让 Claude Code 改代码之前特别有用——先/diff确认当前状态干净再让它动手避免它把你的未提交改动一起改乱。/review触发代码审查模式它会逐文件检查改动并给出意见。我通常在提交 PR 之前跑一次让它先过一遍能抓到不少低级错误。3.3 模型与行为控制类命令/model切换模型。不同模型在速度、成本、能力上有差异我的策略是写样板代码、改配置用快模型做架构设计、复杂调试用强模型。切换是即时的不影响当前上下文。/config打开配置面板可以改主题、快捷键、默认行为。这个命令在终端里会弹出一个交互式界面用方向键选择回车确认。/permissions管理权限。Claude Code 执行 shell 命令、写文件之前会请求许可你可以在这里设置哪些操作自动放行、哪些必须询问。团队协作时建议把常用安全命令如git status、ls、cat加入白名单减少打断。/vim切换 Vim 编辑模式。如果你习惯 Vim 键位敲一下/vim输入框就变成 Vim 操作逻辑。这个对 Vim 老用户是刚需对不熟 Vim 的人反而是负担按需开启。3.4 命令速查表命令用途使用频率备注/clear清空上下文极高任务切换时必用/compact压缩上下文高长任务中途使用/model切换模型高按任务复杂度选/add添加文件到上下文高单次不超过5个/diff查看工作区改动高改代码前必看/review代码审查中提交前跑一次/resume恢复历史会话中意外关闭后使用/cost查看消耗中定期检查/init初始化CLAUDE.md低新项目一次/doctor环境诊断低出问题时用/permissions权限管理低配置一次/vimVim模式低按习惯开启4. 快捷键与终端交互技巧4.1 输入框内的编辑快捷键Claude Code 的输入框支持一套类 Emacs 的编辑快捷键即使你不开 Vim 模式也能用。这些键位在长时间写 prompt 时能省不少事。CtrlA跳到行首CtrlE跳到行尾。这两个键在修改长 prompt 时特别顺手比按方向键快得多。CtrlU删除光标到行首的内容CtrlK删除光标到行尾的内容。我经常用CtrlU快速清空写了一半的 prompt 重新组织。CtrlW删除光标前的一个单词AltD删除光标后的一个单词。这两个在调整措辞时很有用。CtrlY粘贴之前删除的内容相当于一个简易的剪贴板。多行输入用CtrlJ换行或者直接按ShiftEnter取决于终端配置。写复杂 prompt 时多行输入是刚需我建议把ShiftEnter配好比CtrlJ直观。4.2 会话控制快捷键CtrlC中断当前生成。当模型开始跑偏、或者你发现 prompt 写错了想重来时按一下CtrlC立即停止。注意是中断不是退出会话还在可以继续输入。CtrlD退出会话。和/exit效果一样但更快。我习惯用CtrlD收尾手指不用离开主键区。CtrlL清屏但保留会话上下文。终端输出太多看不过来时敲一下清屏历史对话还在。这个和/clear完全不同别搞混——CtrlL只是视觉清理/clear是上下文清理。Esc键在生成过程中按一下可以暂停再按一下继续。这个在模型输出太长、你想先看看前面内容时有用。上箭头调出历史输入。和 shell 的历史记录逻辑一样连续按可以往前翻。CtrlR搜索历史输入输入关键词就能找到之前写过的 prompt。我经常用CtrlR找回上周写过的某个复杂 prompt改改就能复用。4.3 终端环境适配要点不同终端模拟器对快捷键的支持有差异。macOS 自带的 Terminal 和 iTerm2 在ShiftEnter的处理上就不一样iTerm2 需要手动配置才能让ShiftEnter正确换行。VS Code 内置终端又是另一套逻辑。我的建议是先确认你用的终端然后查一下它的快捷键配置文档。如果ShiftEnter不生效退而求其次用CtrlJ这个在绝大多数终端里都能用。另一个常见问题是终端主题和 Claude Code 的配色冲突。有些深色主题下Claude Code 的语法高亮会看不清。跑一下/config换个主题或者调整终端本身的配色方案。我试过七八个主题最后固定在某个对比度适中的方案上长时间看眼睛不累。提示如果你在 tmux 或 screen 里跑 Claude Code注意前缀键可能会和 Claude Code 的快捷键冲突。比如 tmux 默认的CtrlB在某些配置下会拦截输入。解决办法是改 tmux 前缀键或者用CtrlA作为前缀。5. CLAUDE.md让模型真正懂你的项目5.1 CLAUDE.md 的作用与加载机制CLAUDE.md 是 Claude Code 的项目记忆文件。每次启动会话时它会自动读取项目根目录的 CLAUDE.md把里面的内容作为系统提示的一部分注入上下文。这意味着你写在里面的规范、约定、项目背景模型每次都会看到不需要重复交代。加载顺序是这样的先读全局的~/.claude/CLAUDE.md再读项目根目录的CLAUDE.md最后读子目录里的CLAUDE.md如果存在。越靠近当前工作目录的优先级越高。这个机制让你可以给不同模块写不同的规范——比如前端目录的 CLAUDE.md 写组件命名规范后端目录的写 API 设计约定。我见过很多人把 CLAUDE.md 当成 README 来写堆了一大堆项目介绍。其实没必要模型不需要知道项目的历史背景它需要知道的是代码风格是什么、目录结构怎么组织、常用命令有哪些、有哪些坑不能踩。写的时候想象你在给一个新入职的同事做交接只讲他干活需要知道的东西。5.2 一份实战验证过的 CLAUDE.md 模板下面这份模板是我在多个项目里迭代出来的你可以直接抄作业再按需调整# 项目规范 ## 技术栈 - 语言TypeScript 5.x - 框架React 18 Vite - 状态管理Zustand - 测试Vitest Testing Library ## 代码风格 - 使用函数式组件禁止 class 组件 - 组件文件用 PascalCase工具函数用 camelCase - 导入顺序React → 第三方库 → 本地模块 → 样式 - 禁止使用 any必要时用 unknown 加类型守卫 ## 目录结构 - src/components/ 存放通用组件 - src/features/ 存放业务模块每个模块自带 hooks 和 utils - src/lib/ 存放纯函数工具 - src/types/ 存放全局类型定义 ## 常用命令 - 开发npm run dev - 测试npm run test - 构建npm run build - 类型检查npm run typecheck ## 注意事项 - 修改 API 层代码后必须跑 typecheck - 新增依赖前先确认是否已有替代方案 - 提交前必须通过 lint 和 test这份模板的关键在于具体。不要写“遵循良好代码风格”这种废话要写“禁止使用 any”这种可执行的规则。模型对具体规则的遵守度远高于模糊描述。5.3 让 CLAUDE.md 持续进化的技巧CLAUDE.md 不是写完就完事的它应该随着项目演进不断更新。我的做法是每次发现模型犯了重复性错误就把对应的规则补进去。比如它老是忘记给新组件写测试我就在 CLAUDE.md 里加一条“新增组件必须附带测试文件”。另一个技巧是用/init生成初稿后手动精简。自动生成的版本通常太啰嗦把明显的东西也写进去了。删掉那些“本项目使用 Git 进行版本控制”之类的常识性内容只留模型真正需要知道的。团队协作时CLAUDE.md 应该提交到 Git并且纳入 code review 流程。每次有人改了规范其他人 review 时能看到。我见过团队因为 CLAUDE.md 没同步导致两个人用不同的代码风格合并时冲突一大堆。6. 高效工作流编排从单点操作到流水线6.1 日常开发工作流拆解把 Claude Code 嵌进日常开发核心思路是“让它做它擅长的你做你擅长的”。我的一天通常是这样流转的早上到工位先/resume回到昨天的会话看看昨天做到哪了。如果任务已经完成/clear开新会话。然后/diff确认工作区干净开始新任务。接到一个新需求我先把相关文件/add进来然后用自然语言描述需求。Claude Code 会先给方案我确认后再让它动手。改完之后/review过一遍没问题就提交。遇到 bug 时我会把报错信息、相关代码文件、以及复现步骤一起丢给它。这里有个技巧不要只贴报错把上下文也带上。比如“这个函数在传入空数组时抛错相关代码在 xxx 文件调用方在 yyy 文件”比单纯贴一个 stack trace 有效得多。6.2 多文件重构的编排策略多文件重构是 Claude Code 的强项但也是最容易翻车的场景。我的策略是分三步走第一步先让它读。把所有涉及的文件/add进来让它通读一遍输出一份重构计划。这一步不要让它改代码只要计划。计划里应该包含改哪些文件、每个文件改什么、改动之间的依赖顺序。第二步逐个文件改。按依赖顺序从底层往上改。每改完一个文件/diff看一眼确认没问题再改下一个。不要一次性让它改完所有文件出了问题很难定位。第三步整体验证。全部改完后跑测试、跑类型检查。如果有问题把报错信息丢回去让它修。这个流程看起来慢但实际比“一把梭”快得多。我试过让它一次性重构五个文件结果改到第三个时上下文乱了前面改的也被带偏最后回滚重来。分步走虽然多几次交互但每步都可控。6.3 把重复操作固化成脚本Claude Code 支持在项目里定义自定义命令。在.claude/commands/目录下放 markdown 文件文件名就是命令名。比如创建一个review-pr.md内容写清楚审查 PR 的步骤之后敲/review-pr就能触发这套流程。我常用的自定义命令有几个/fix-lint自动修复 lint 错误、/gen-test为指定文件生成测试、/update-deps检查并更新依赖。每个命令背后都是一套固定的 prompt 模板省去了每次重新描述的时间。自定义命令的写法很灵活支持参数占位符。比如$ARGUMENTS会被替换成命令后面跟的内容。/gen-test src/utils/format.ts就会把src/utils/format.ts传给命令模板。注意自定义命令文件里的 prompt 要写得足够具体。我见过有人写“帮我修复问题”结果模型完全不知道修什么。好的自定义命令应该像一份操作手册步骤清晰、预期明确。7. 常见问题与排查技巧实录7.1 命令不生效或报错最常见的问题是敲了命令没反应。先跑/doctor它会检查环境依赖和配置。如果/doctor也跑不起来说明安装有问题重新装一遍。如果/doctor正常但某个命令没反应检查是不是拼写错了。斜杠命令支持模糊匹配但拼得太离谱就匹配不到。敲/看候选列表确认命令名。另一个可能是权限问题。某些命令需要特定权限才能执行/permissions里看一下当前权限级别。如果是团队项目可能管理员限制了某些命令。7.2 上下文混乱与模型跑偏模型开始胡言乱语、引用不存在的文件、或者答非所问八成是上下文太乱了。解决办法先/compact压缩如果还不行就/clear重来。预防胜于治疗。我的习惯是每完成一个独立任务就/clear不让上下文无限膨胀。另外/add文件时要克制只加真正相关的。我见过有人把整个node_modules加进去结果模型被几万个文件搞晕了。还有一个隐蔽的坑CLAUDE.md 写得太长也会挤占上下文。如果发现模型对 CLAUDE.md 里的规则遵守度下降可能是文件太长了精简一下。7.3 快捷键冲突与终端适配快捷键不生效先确认终端有没有拦截。比如CtrlW在某些终端里是关闭标签页根本传不到 Claude Code。解决办法是改终端快捷键或者用 Claude Code 的替代键位。ShiftEnter不换行是最常见的问题。iTerm2 需要在 Preferences → Keys 里把ShiftEnter映射成发送\n。VS Code 终端则需要在 settings.json 里配置。如果懒得折腾直接用CtrlJ。Vim 模式下快捷键又是另一套逻辑。开了/vim之后Esc进入普通模式i回到插入模式和真正的 Vim 基本一致。但有些终端会把Esc拦截导致切不回普通模式。这种情况建议关掉 Vim 模式用默认键位。7.4 问题速查表现象可能原因排查步骤解决方案命令无反应安装问题/权限不足跑/doctor重装或调整权限模型答非所问上下文混乱检查/add的文件/compact或/clear快捷键失效终端拦截换终端测试改终端配置或用替代键生成中断网络波动/超时检查网络重试或/resume成本异常高上下文过长跑/cost定期/compactCLAUDE.md 不生效文件位置错误确认在项目根目录移到正确位置自定义命令找不到目录结构错误检查.claude/commands/修正目录或文件名7.5 几个我踩过的坑第一个坑在 monorepo 里CLAUDE.md 的加载位置很关键。我一开始把 CLAUDE.md 放在仓库根目录但实际工作目录在packages/frontend/结果模型读不到根目录的配置。后来在每个 package 下都放了 CLAUDE.md问题才解决。第二个坑/add目录时它会递归读取所有文件包括.gitignore里忽略的。我有次/add了一个包含构建产物的目录上下文瞬间被几万个文件塞满。后来养成习惯/add之前先确认目录里没有大文件或生成文件。第三个坑自定义命令的命名冲突。我定义了一个/test命令结果和内置的测试相关命令冲突了。后来改成/gen-test才正常。建议自定义命令加前缀避免和内置命令撞名。第四个坑会话恢复后模型“失忆”。/resume恢复的是对话历史但如果你在恢复后改了 CLAUDE.md新配置不会自动生效。需要/clear后重新开始或者手动/add新的配置文件。8. 把工具用成习惯Claude Code 这类终端工具最大的价值不在于单次操作有多强而在于它能不能无缝嵌进你的日常工作流。我见过太多人装了一堆工具每个都用两下就吃灰原因就是没形成习惯。形成习惯的关键是降低启动成本。把高频命令练到不用想就能敲出来把 CLAUDE.md 配好让模型一上来就懂你把重复操作固化成自定义命令。这三件事做完你会发现打开终端敲claude变成了一件自然而然的事就像打开编辑器一样。我现在的工作流已经稳定在早上/resume看进度任务切换/clear改代码前/diff提交前/review遇到重复操作就写自定义命令。这套流程跑了大半年效率提升是实打实的。最后分享一个小技巧把这份速查表存成项目里的CLAUDE-COMMANDS.md需要时/add进来让模型自己参考。有时候你忘了某个命令怎么用直接问它“根据 CLAUDE-COMMANDS.md压缩上下文的命令是什么”它会帮你查。工具用工具这才是终端工作流该有的样子。