1. 为什么需要一份真正能用的 Claude Code 速查手册刚接触 Claude Code 的人十有八九会经历同一个阶段装完之后对着终端发呆知道这东西能干活但不知道从哪敲第一行命令。网上搜到的资料要么是官方文档的机翻要么是零散的截图拼凑真正能让人照着敲就能跑起来的内容少得可怜。我自己从第一次在终端里敲下claude到现在中间踩过的坑足够写一本小册子——权限弹窗卡住、上下文莫名其妙被截断、CLAUDE.md 写了等于没写、快捷键和系统输入法打架。这些问题官方文档里不会告诉你只有真正天天用它写代码的人才知道。这份速查手册要解决的就是这个问题。它不是官方文档的搬运而是把 Claude Code 的高频指令、快捷键组合、工作流设计思路这三块内容揉在一起按照实际干活时会怎么用的顺序重新组织。不管你是刚装好 Claude Code 想跑通第一个任务的新手还是已经用了一段时间但总觉得效率没拉满的老用户都能从里面找到能直接抄作业的东西。需要先说明一点Claude Code 的版本迭代很快命令和快捷键在不同版本之间可能有细微差异。我下面写的内容基于我实际使用中验证过的稳定版本如果你发现某个命令不生效第一件事是敲claude --version确认版本号然后对照官方 changelog 看有没有 breaking change。这个习惯能帮你省下大量排查时间。另外Claude Code 本质上是跑在终端里的 AI 编程助手它的能力边界取决于你给它的上下文和权限。理解这一点后面所有的命令和快捷键才有意义——它们都是在帮你更精准地控制给什么上下文和放什么权限。2. 安装与首次启动那些文档里没写的细节2.1 安装方式的选择逻辑Claude Code 的安装方式主要有两种npm 全局安装和原生安装脚本。很多人上来就随便选一个结果后面遇到权限问题或者版本冲突才后悔。我的建议是分场景选如果你日常用 Node.js 生态开发直接走 npm 全局安装最省事因为你的环境里本来就有 Node版本管理也熟悉。命令是npm install -g anthropic-ai/claude-code装完之后claude命令直接可用。如果你不想让 Claude Code 依赖 Node 环境或者你机器上的 Node 版本比较乱用原生安装脚本更干净。官方提供了一键安装脚本装完之后是一个独立的二进制文件不跟你的 Node 版本纠缠。这里有个坑要提前说不要用 sudo 装 npm 全局包。我见过太多人因为npm install -g报权限错误就顺手加了 sudo结果后面 Claude Code 读写项目文件时权限全乱套改都改不回来。正确的做法是配置 npm 的全局目录到用户目录下或者直接用 nvm 管理 Node 版本从根上避免权限问题。2.2 首次启动的认证流程装完之后第一次敲claude它会引导你完成认证。这个过程本身不复杂但有几个细节值得注意认证方式通常是通过浏览器完成授权终端会给你一个链接。如果你在远程服务器或者没有图形界面的环境里操作需要手动把链接复制到本地浏览器打开然后把授权码粘贴回终端。这个流程走一次之后凭证会缓存在本地后续启动就不需要重复认证了。注意如果你在多个环境比如本地机器和远程开发机都用 Claude Code每个环境都需要单独认证一次。凭证不共享这是安全设计不是 bug。认证完成后你会进入 Claude Code 的交互界面。第一次进去建议先敲/help看看当前版本支持的所有命令因为不同版本的命令集会有差异。这个动作花不了十秒钟但能帮你避免照着旧教程敲命令结果报错的尴尬。2.3 项目初始化CLAUDE.md 到底该写什么Claude Code 启动时会自动读取项目根目录下的CLAUDE.md文件把它作为系统提示的一部分。这个文件是你跟 Claude Code 之间最重要的契约写得好不好直接决定了它干活的质量。很多人第一次写 CLAUDE.md 就是随便扔几句这是一个 React 项目就完事了然后抱怨 Claude Code 不懂项目结构。问题出在CLAUDE.md 不是项目介绍而是操作指令。你应该在里面写的是这个项目用什么命令跑测试代码风格有什么硬性要求哪些目录不要动提交信息的格式是什么这类可执行的规则。我自己的 CLAUDE.md 通常包含这几块内容# 项目约定 ## 技术栈 - 前端React 18 TypeScript Vite - 后端Node.js Fastify - 测试Vitest Playwright ## 常用命令 - 开发pnpm dev - 测试pnpm test - 类型检查pnpm typecheck - 格式化pnpm format ## 代码规范 - 组件文件用 PascalCase工具函数用 camelCase - 禁止使用 any必要时用 unknown 类型守卫 - 所有导出函数必须有 JSDoc 注释 ## 禁区 - 不要修改 src/generated/ 下的文件这些是自动生成的 - 不要动 .env 和任何密钥相关文件 - 提交前必须跑通 pnpm typecheck 和 pnpm test这样写的好处是Claude Code 每次启动都会带着这些约束工作不需要你反复提醒。实测下来一份好的 CLAUDE.md 能让 Claude Code 的输出质量提升一个档次因为它不用猜你的项目约定直接照着执行就行。3. 高频命令拆解从会话管理到代码操作3.1 会话生命周期相关的命令Claude Code 的会话管理是很多人忽略的一块但它直接影响到你的上下文利用效率。核心命令有这么几个命令作用使用场景/clear清空当前会话上下文切换到不相关的任务时/compact压缩上下文保留摘要上下文快满但还想继续当前任务/resume恢复之前的会话中断后想接着上次的进度/exit退出当前会话收工这里重点说/compact。Claude Code 的上下文窗口是有限的当你跟它来回对话很多轮之后上下文会被占满这时候它会开始遗忘早期的内容。/compact的作用是把之前的对话压缩成一段摘要释放出空间同时保留关键信息。我的经验是当你感觉 Claude Code 开始重复问已经回答过的问题时就是该 compact 的信号。/resume也值得单独提一下。Claude Code 会把会话历史存在本地你可以用/resume列出之前的会话并选择恢复。这个功能在跨天开发同一个任务时特别有用——不用重新解释背景直接接着上次的上下文继续。3.2 代码操作类命令这类命令是你日常用得最多的直接决定了 Claude Code 能不能高效地帮你改代码。/init是初始化项目的命令它会扫描你的项目结构自动生成一份 CLAUDE.md 草稿。我建议新项目第一次用 Claude Code 时先跑/init然后在它生成的草稿基础上修改比从零写快得多。但要注意/init生成的内容偏通用你必须手动补充项目特有的约定和禁区。/review用来让 Claude Code 审查代码。你可以直接敲/review让它看当前改动也可以指定文件或目录。实测下来/review对发现潜在 bug 和代码风格问题挺有效但它不会替你做决定——最终改不改还是你自己判断。/diff显示当前的代码改动。这个命令在你想确认 Claude Code 到底改了什么的时候特别有用。我养成的习惯是每次让 Claude Code 改完代码先敲/diff看一眼改动范围确认没有误伤再继续。3.3 权限与安全相关命令Claude Code 默认会在执行敏感操作前征求你的同意比如写文件、跑命令。这个机制是保护你的但频繁弹窗也会打断心流。相关命令/permissions查看和修改当前的权限设置/allowed-tools配置哪些工具可以免确认执行我的建议是不要图省事把所有权限都放开。正确的做法是把高频且安全的操作加入白名单比如读文件、跑测试命令而写文件、执行任意 shell 命令这类操作保持确认。这样既不影响效率又不会让 Claude Code 在你不知情的情况下搞出大动作。提示如果你在 CI 环境或者脚本里用 Claude Code可以用--dangerously-skip-permissions跳过所有确认但这是有风险的只在你完全信任当前任务和代码库的前提下用。4. 快捷键与交互技巧把终端用出 IDE 的感觉4.1 核心快捷键组合Claude Code 的快捷键设计思路是让你尽量不离开键盘。下面这些是我每天都在用的快捷键功能备注CtrlC中断当前操作长任务跑飞了用它CtrlD退出会话等同于/exitCtrlL清屏保留上下文只清显示Esc取消当前输入敲错了不用全删上箭头调出历史输入重复命令时省事Tab自动补全命令和文件路径都支持CtrlC值得单独说。Claude Code 在执行长任务时比如跑一整套测试如果你发现它方向不对直接CtrlC中断然后补充说明再让它继续。这比等它跑完再纠正要省时间得多。4.2 多行输入与粘贴技巧Claude Code 的输入框默认是单行回车提交但很多时候你需要输入多行内容比如粘贴一段错误日志或者写一段多行指令。这时候有几个技巧用\结尾再回车可以换行继续输入直接粘贴多行文本Claude Code 会自动识别并保留换行如果粘贴的内容特别长建议先存成文件然后用文件名的方式引用引用文件是个高频技巧。你可以在输入里用src/utils/helper.ts的方式让 Claude Code 直接读取指定文件不用手动复制粘贴内容。这个在让它改某个具体文件时特别方便。4.3 与终端环境的配合Claude Code 跑在终端里所以终端本身的一些能力它也能用上。比如用!开头可以直接执行 shell 命令输出会进入上下文用#开头可以快速添加一条记忆到 CLAUDE.md管道和重定向在 Claude Code 的输入里也基本可用!这个用法我经常用来快速给 Claude Code 喂信息。比如!git log --oneline -20直接把最近 20 条提交记录拉进上下文然后问它根据这些提交帮我总结一下最近的改动方向。比手动复制粘贴快得多。5. 高效工作流设计把 Claude Code 嵌进日常开发5.1 新功能开发的标准流程我自己的新功能开发流程是这样的每一步都有明确的目的先让 Claude Code 读代码用引用相关文件让它先理解现有实现。这一步不能省否则它给的方案可能跟你的代码风格完全不搭。让它出方案再动手明确说先给我方案不要改代码。等它给出思路后你判断合不合理不合理就让它调整。小步改频繁看 diff让它一次只改一个文件或一个函数改完立刻/diff确认。不要让它一口气改十个文件出了问题你都不知道从哪查。改完立刻跑测试用!直接跑测试命令把结果喂回给它。测试挂了就让它修修完再跑。这个流程的核心逻辑是把大任务拆成小步骤每一步都验证。Claude Code 能力很强但它不是神一口气给它太大的任务出错概率会显著上升。5.2 调试场景下的用法调试是 Claude Code 最能发挥价值的场景之一。我的做法是先把错误信息完整贴给它包括堆栈。然后让它分析可能的原因列出排查方向。接着按它的建议逐个验证把验证结果反馈回去。这个来回过程通常两三