1. 为什么我要整理这份 Claude Code 速查手册用 Claude Code 有一段时间了从最初把它当成一个能跑命令的聊天窗口到后来真正把它嵌进日常开发流里中间踩的坑不算少。最典型的一个场景是明明知道有个命令能解决当前问题但就是想不起来叫什么于是切出去翻文档、翻聊天记录一来一回十分钟没了。这种工具在手上却用不顺的憋屈感相信每个刚上手 Claude Code 的人都经历过。这份手册就是在这种背景下攒出来的。它不打算把官方文档翻译一遍而是按我实际会怎么用来组织哪些命令是每天都要敲的哪些快捷键能省下大量鼠标操作CLAUDE.md这个文件到底该怎么写才不浪费 token以及怎么把零散的命令串成一条顺手的工作流。核心关键词就几个Claude Code、命令、快捷键、工作流、CLAUDE.md全文围绕它们展开。适合谁看如果你刚装好 Claude Code还在摸索阶段这份手册能帮你跳过最混乱的头几天如果你已经用了一阵子但总觉得效率没提上来那大概率是工作流没搭对后面几节应该能给你一些启发。我不假设你是命令行高手涉及基础操作的地方会补一句说明但也不会啰嗦到把cd都解释一遍。需要提前说明的是Claude Code 迭代很快命令和快捷键会随版本变化。我下面写的内容基于我当前使用的版本如果你发现某个命令不生效第一件事是敲/help看当前版本支持什么而不是怀疑自己记错了。这个习惯本身就值得养成。2. 高频命令全拆解从安装到日常操作2.1 安装与首次启动别在第一步卡住安装 Claude Code 的方式取决于你的系统环境。主流做法是通过包管理器安装比如在 macOS 上常用 Homebrew在 Linux 上则可能用 npm 全局安装。具体命令会随发布渠道调整我这里给的是通用思路先确认你的 Node.js 版本满足要求通常需要较新的 LTS 版本再执行安装命令最后用claude --version验证是否装好。# 确认 Node 环境 node -v npm -v # 全局安装具体包名以官方为准 npm install -g anthropic-ai/claude-code # 验证安装 claude --version首次启动会在终端里引导你完成认证配置。这一步的坑在于很多人装完之后直接在项目根目录敲claude结果发现它读取的上下文乱七八糟。原因是 Claude Code 会以当前工作目录为基准去理解项目所以启动前先cd到你的项目根目录这个习惯能省掉后面很多它怎么理解错了的困惑。提示如果你在 Windows 上通过 WSL 使用注意项目路径要放在 WSL 能访问的文件系统里放在 Windows 挂载盘下偶尔会有文件监听延迟的问题。2.2 会话内核心命令斜杠命令是主力Claude Code 的交互分两类一类是直接输入自然语言让它干活另一类是以斜杠开头的内置命令。后者才是提效的关键因为它们绕过了理解意图这一步直接触发确定行为。命令作用我的使用频率/help查看当前版本支持的所有命令每次升级后必看/clear清空当前会话上下文每天多次/compact压缩上下文保留要点长会话必备/model切换使用的模型按任务复杂度切换/resume恢复之前的会话中断后继续/init初始化项目配置文件新项目第一次/compact和/clear的区别值得单独说。/clear是彻底清空适合切换到完全不相关的新任务/compact是把已有对话压缩成摘要保留关键信息但释放 token 空间。我早期的错误是长会话里一直不清理结果响应越来越慢、越来越健忘后来养成习惯一个任务告一段落就/compact一次跨任务就/clear。/model的切换逻辑也值得琢磨。简单任务用轻量模型响应快、成本低复杂重构或架构设计再切到强模型。我一般默认用中等档位遇到需要深度推理的场景手动切上去任务完成再切回来。这个动作看起来小但一天下来省的时间和额度相当可观。2.3 文件与上下文操作命令Claude Code 真正好用的地方在于它能直接读写你的项目文件。相关命令和操作方式包括用引用具体文件比如src/utils/parser.js让它聚焦到某个文件用#引用某个符号或函数快速定位直接说读取 xxx 目录下的所有配置文件它会自己遍历这里有个实操心得引用文件时尽量精确到文件而不是整个目录。你让它读整个src它会塞进大量无关内容既慢又容易跑偏。我通常的做法是先一两个核心文件让它理解结构再按需追加。另外涉及批量修改时先让它列出你打算改哪些文件、每个文件改什么确认无误再让它动手。这个先出方案再执行的习惯帮我避免过好几次误改。2.4 版本升级与维护命令Claude Code 更新频繁保持版本较新能拿到新命令和修复。升级方式取决于你的安装方式npm 装的用npm update -g其他渠道按对应方式。升级后第一件事是/help对照一下看看有没有新增或改名的命令。注意升级前如果手头有正在进行的复杂会话先/compact或记下关键上下文避免升级后会话状态丢失。3. 快捷键与终端操作把鼠标放下的那些瞬间3.1 终端内的通用快捷键Claude Code 跑在终端里所以终端本身的快捷键全都适用。这些是提效的地基很多人却忽略了Ctrl C中断当前生成它还在输出但你不想等了直接掐断Ctrl D退出会话Ctrl L清屏但不清上下文视觉上清爽上/下方向键翻阅历史输入Ctrl R反向搜索历史命令找之前敲过的东西极快Ctrl C这个我要重点提。很多人不知道生成过程中可以随时打断傻等着它把一大段没用的内容输出完。实际上你一看方向不对立刻Ctrl C然后补充说明重新提问效率差好几倍。3.2 输入编辑快捷键在输入框里编辑长指令时这些快捷键能救命快捷键作用Ctrl A光标移到行首Ctrl E光标移到行尾Ctrl U删除光标前所有内容Ctrl K删除光标后所有内容Ctrl W删除光标前一个单词Option 方向键按单词移动光标macOS写复杂指令时我经常写到一半发现开头写错了这时候Ctrl A跳回行首改比用鼠标拖选快得多。Ctrl U清空重写也比一个个退格强。3.3 多行输入与换行默认情况下回车是发送但写多行指令时你需要换行。常见做法是Shift Enter或Option Enter视终端配置而定插入换行而不发送。如果你经常写多行 prompt建议在终端配置里把发送键改成Ctrl Enter之类避免误发。提示不同终端模拟器对组合键的支持不一样。如果你按Shift Enter没反应去终端设置里查一下键位映射或者用\加回车的方式强制换行。3.4 与编辑器联动的快捷键思路Claude Code 常和 VS Code、JetBrains 系列配合用。虽然它本身是终端工具但你可以把终端嵌在编辑器里然后用编辑器的快捷键快速切换焦点。比如在 VS Code 里用Ctrl 呼出终端改完代码直接切过去让它 review。这种编辑器改、终端问的来回切换比在纯终端里操作舒服很多。4. CLAUDE.md让每次对话都站在同一起跑线4.1 CLAUDE.md 到底是什么CLAUDE.md是放在项目根目录的一个 Markdown 文件Claude Code 启动时会自动读取它把它作为项目的背景说明。你可以把它理解成给 AI 看的项目 README——但比 README 更聚焦于怎么在这个项目里干活。没有它的时候每次新会话你都得重复交代这个项目用什么技术栈、代码风格是什么、测试怎么跑、哪些目录别动。有了它这些信息一次写好之后每次对话它都心里有数。这是工作流里投入产出比最高的一件事。4.2 该写什么、不该写什么我踩过的坑是一开始把 CLAUDE.md 写成了项目文档塞了一大堆架构说明、业务背景结果每次对话都消耗大量 token 在无关信息上。后来精简成干活必需的几类内容技术栈与版本语言、框架、关键依赖的版本目录结构约定哪个目录放什么哪些是生成物不要改代码风格命名规范、格式化工具、lint 规则常用命令怎么跑测试、怎么构建、怎么启动本地服务禁区哪些文件或操作绝对不要碰不该写的详细的业务逻辑说明需要时临时相关文件即可、大段的架构图描述、和当前开发无关的历史决策。4.3 一份可直接抄的 CLAUDE.md 模板# 项目说明 ## 技术栈 - 语言TypeScript 5.x - 框架React 18 Vite - 包管理pnpm - 测试Vitest ## 目录约定 - src/componentsUI 组件每个组件一个目录 - src/utils纯函数工具必须有单测 - src/api接口封装不要在这里写业务逻辑 - dist构建产物禁止手动修改 ## 代码风格 - 使用 2 空格缩进 - 组件用函数式 Hooks - 提交前跑 pnpm lint 和 pnpm test ## 常用命令 - 开发pnpm dev - 测试pnpm test - 构建pnpm build ## 禁区 - 不要修改 package.json 里的依赖版本除非我明确要求 - 不要动 .env 文件 - 不要自动提交 git这份模板的关键在于禁区部分。AI 很勤快你不说它可能顺手就把依赖升级了、把配置改了。明确划出红线能省掉很多回滚的麻烦。4.4 分层配置全局与项目级除了项目根目录的CLAUDE.md你还可以有用户级的全局配置放一些跨项目通用的偏好比如回答尽量简洁代码注释用中文之类。项目级的覆盖全局的这样既能保持个人习惯一致又能针对具体项目微调。提示CLAUDE.md也会被读进上下文所以它越长留给实际任务的 token 越少。定期回顾精简删掉过时内容是个好习惯。5. 高效工作流搭建把命令串成流水线5.1 一个新任务的起手式我现在的标准起手式是这样的先cd到项目根目录启动 Claude Code然后第一句话不是直接派活而是让它先熟悉现场。比如先读一下 CLAUDE.md然后看一下 src 目录结构告诉我你理解的项目概况这一步花不了多少时间但能确认它有没有正确加载配置、有没有理解错项目。确认无误后再派具体任务返工率明显下降。这个先对齐再干活的思路是我从无数次它理解偏了里总结出来的。5.2 任务拆解与分步执行大任务不要一句话丢给它。比如重构整个用户模块直接说它大概率会给你一个似是而非的大改。我的做法是拆成几步先让它分析现有用户模块的结构和问题输出一份分析基于分析让它给出重构方案我确认按方案分文件逐个改每改完一个我 review最后跑测试验证每一步之间用/compact压缩上下文保持会话清爽。这种分步走的方式可控性远高于一把梭。5.3 上下文管理节奏上下文管理是工作流的核心。我的节奏是单个小任务完成 →/compact切换到不相关任务 →/clear会话变得迟钝或开始忘事 → 立即/compact或/clear重开判断该清理了的信号它开始重复问你已经说过的事、回答变得笼统、响应变慢。这时候别硬撑清理重来往往更快。5.4 与版本控制配合Claude Code 能改文件所以和 git 配合要格外小心。我的铁律是让它改代码前先确保工作区是干净的没有未提交的改动。这样万一它改坏了git diff一看便知git checkout一键回滚。另外我从不让它自动提交。改完我自己看 diff、自己写 commit message。AI 写的 commit message 往往抓不住重点而且提交这个动作应该由人把关。5.5 一个完整的日常流程示例把上面这些串起来我一天里典型的一段是这样的# 1. 进入项目 cd ~/projects/my-app # 2. 确认工作区干净 git status # 3. 启动 claude # 4. 会话内先对齐 # 读 CLAUDE.md看 src 结构说下项目概况 # 5. 派任务 # 帮我给 utils/date.ts 加一个格式化函数要求... # 6. review 改动 # 退出后 git diff 检查 # 7. 满意则提交不满意则回滚重来这套流程跑顺之后我处理日常小任务的速度大概提升了一倍主要省在反复交代背景和改错了难回滚这两件事上。6. 常见问题与排查技巧实录6.1 命令不生效怎么办最常见的原因是版本不对。某个命令在你当前版本还没上线或者已经改名。排查顺序先/help看当前支持列表再确认版本号最后考虑升级。别急着怀疑自己记错工具迭代快是常态。6.2 它总是理解错项目结构八成是CLAUDE.md没写好或者启动目录不对。检查两点启动时是不是在项目根目录CLAUDE.md里的目录约定是不是和实际一致。如果项目有多个子项目考虑在每个子项目根目录各放一份配置。6.3 响应越来越慢、越来越健忘典型的上下文过载。/compact或/clear。如果清理后还慢可能是任务本身太大拆小。6.4 改错了文件怎么恢复前提是你用了 git 且工作区干净。git diff看改动git checkout -- file恢复单个文件git checkout .恢复全部。这也是为什么我反复强调改之前先提交或确保干净。6.5 常见问题速查表现象可能原因处理方式命令报未知版本不支持/help确认升级理解错结构配置缺失/目录不对检查 CLAUDE.md 和启动目录响应变慢上下文过载/compact或/clear改错文件未做版本保护git diff 后 checkout 恢复快捷键无效终端键位冲突查终端键位映射设置token 消耗快CLAUDE.md 过长精简配置按需引用文件6.6 几条踩坑换来的经验第一别把 Claude Code 当搜索引擎用。问它某某 API 怎么用不如直接查文档它的价值在于结合你的项目上下文干活。第二指令要具体。优化一下这个函数不如把这个函数里的嵌套循环改成提前返回减少缩进层级。第三养成 review 习惯。它给的代码不一定对尤其是涉及边界条件的地方自己过一遍再合并。7. 我个人的一些使用体会用到现在我最大的感受是Claude Code 的效率上限不取决于它多聪明而取决于你多会带它。同样一个工具有人用起来磕磕绊绊有人用起来行云流水差别就在工作流和配置上。CLAUDE.md写得好、上下文管得勤、任务拆得细这三点做到体验完全不一样。还有个小心得把常用的 prompt 片段存成自己的模板比如review 代码时按这个格式输出重构时先给方案再动手需要时直接粘贴。这比每次现想要快得多也让它的输出更稳定。工具是死的用法是活的多攒一些自己的套路比背命令表有用得多。