Claude Code我最近用得越来越勤从最初的“试试看”已经变成工作流里离不开的一环。它最强的地方不是能聊而是能真正读代码、改代码、跑命令直接嵌进终端和编辑器。不过很多朋友卡在刚上手那几天看着交互界面不知道怎么开始命令记不住用起来总觉得隔了一层。这篇手册就把我实际工作中高频用到的指令、快捷键和组合打法整理一遍配合具体场景和踩过的坑照着抄就能把效率提起来。1. 环境准备与安装细节1.1 安装与升级的三种方式Claude Code目前官方主推的方式是npm全局安装一行命令就搞定npm install -g anthropic-ai/claude-code装完直接跑claude --version验证是否成功。如果你网络环境比较干净npm装起来非常快一分钟内就能完成。系统里如果已经有旧版本升级也同样是这行命令npm会直接覆盖到最新版本。如果你不太想依赖Node环境官方还提供了原生安装脚本curl -fsSL https://claude.ai/install.sh | bash这个脚本会把Claude Code装成独立二进制文件不走npm好处是不污染全局Node模块适合服务器上不想装多余依赖的场景。实测下来原生版启动速度稍微快一点点但差别不大更多是心理安慰。还有一种就是桌面版和VS Code插件。Claude Code for VS Code是官方插件在扩展市场搜“Claude Code”直接安装里面能跟IDE无缝配合左侧面板可以看会话、上下文和成本统计代码高亮、diff展示都比终端舒服。不过绝大多数指令、快捷键和终端里完全一致所以不管你是终端党还是IDE党下面的内容都能通用。安装完之后第一次运行需要在浏览器里授权登录执行claude会生成一个授权链接点击完成登录后输出一段密钥贴到终端交互界面就出来了。这一步只要做一次后续就免登录直接用。1.2 进入工作目录是第一步很多新手上来就随便找个位置敲claude结果发现它读不到项目文件或者总是莫名其妙接入别的目录。这里有个基本原则先cd到项目根目录再启动Claude Code。cd ~/work/my-awesome-project claude启动后你可以立刻验证它能不能正确感知项目结构直接问一句“这个项目是干什么的”。它如果回答得头头是道说明代码库索引正常如果支支吾吾说“在你的提供信息之外无法判断”八成就是目录不对。这个细节看起来不起眼但直接影响后续所有指令的效果。在正确的目录下启动你后面提到的每个文件、每个函数、每个git提交记录它才能对应得上。2. 高频slash命令与使用场景2.1 会话控制/init、/clear、/compact、/resumeClaude Code的交互界面里几乎所有内置指令都是斜杠开头。最核心的几个会话控制命令我基本每天都要用/init在项目根目录生成CLAUDE.md文件。CLAUDE.md是Claude Code的项目记忆文件相当于给它一份“项目说明书”里面可以写清楚项目结构、技术栈、代码规范、常用命令每次进入会话都会自动加载。新项目入手我第一件事就是跑一下/init让它先扫描项目结构生成个初版然后再手工往里面补规范。/clear清空当前会话历史相当于重新开一局。但注意它不会删除git记录和磁盘上的文件只是上下文干干净净重新从CLAUDE.md读取项目说明开始对话。/compact把当前会话压缩成一段摘要释放被占满的上下文窗口。这是我最依赖的命令之一。长篇多轮对话后模型容易顾此失彼甚至开始胡说八道那个信号就是上下文塞爆了。跑一下/compact它会把前面所有内容浓缩成关键信息摘要保留任务目标、已经做的改动、待办事项然后继续工作。实测下来compact之后再让它改代码准确率明显回升。/resume恢复之前的会话。如果你正在做一件持续时间长的事比如重构一个模块、排查一个隐蔽Bug千万别关掉终端就走。下次回来用claude --resume或者进入界面后/resume它能找到之前的会话列表选一个接着聊。这个对于长期任务的连续性非常关键。四者的关系一句话概括/clear是彻底放下/compact是轻装继续/resume是隔夜再战/init是给新家写门牌。我用的时候通常思路是午饭前跑/compact把上午进度压成摘要下午继续晚上收工跑/clear第二天新开。跨几天的活才会用到/resume。2.2 模型与上下文管理/model、/context、/rewind/context是查看当前上下文占用、会话里的文件引用、token数量排行。我在长会话中会定期用它看看到底是什么占了大头有时候发现某个大文件被反复加载就手动踢掉。/model用来切换模型版本。Claude Code支持在会话中直接切换/model会弹出模型选择列表Opus、Sonnet、Haiku。我的习惯是日常小改动、写测试、重命名变量这类活用Sonnet便宜响应快处理架构问题、审查复杂代码、设计接口用Opus批量简单任务比如格式化文档、注释补全才用Haiku。有些朋友全程Opus怼到底说实话性能和成本都不划算很多场景Sonnet完全够用还快。/rewind配合版本回退使用。Claude Code对文件的每次修改都会产生快照/rewind可以回退到对话历史中的某个检查点。用场景主要是它改了一组文件改到一半我发现方向错了不想要后半段改动但又不愿意整个撤销那就/rewind到那个“分叉”之前的状态重新指定方向。这算是我用的最多的“后悔药”。2.3 代码审查与Git集成/review、/pr-comments/review让Claude Code审查当前工作区的改动看未提交的diff找Bug、安全隐患、风格问题。我每次commit之前都会跑一下比自己肉眼扫代码靠谱得多。跑完之后它会列出问题清单和建议修改方案你可以让它直接改也可以自己动手。/pr-comments更进阶一点它读取当前分支的Pull Request评论针对每一条评论给出代码层面的解答和修改建议。这个功能配合团队协作简直是救星——再也不用挨个打开GitHub网页手动回复评论了。实测下来它能准确对应评论里提到的文件行并给出可行的修复方案甚至直接把补丁给你写出来。Git集成是Claude Code一个很有竞争力的设计。在会话里你可以自然地说“帮我看看最近的3条commit改了什么”、“把我当前分支rebase到main”、“帮我把这几个文件提交一下”它会调用git命令执行并返回结果。但这里有个明显的坑不要让它执行危险git操作除非你明确知道结果。比如git reset --hard这类它会问你要不要执行如果没加白名单权限会弹确认框但一旦你放行了改错了就只能自己兜着。我的规则是提交、查看、暂存这类安全操作用它代劳变基、强推、回滚这类我来下指令它来执行但执行前一定会自己先备份或者确认。2.4 MCP与外部工具连接/mcpMCPModel Context Protocol让Claude Code突破“只看代码”的限制接入外部数据源和工具。在交互界面里运行/mcp可以查看已配置的MCP服务器列表、添加新服务器、测试连接。我目前常用的几个GitHub MCP拉取issue、PR、release信息、数据库MCP查生产库表结构、内部文档MCP检索团队wiki。配置方式在.mcp.json文件里声明支持stdio和SSE两种模式。下面是一个常见的配置文件示例{ mcpServers: { github: { command: npx, args: [-y, modelcontextprotocol/server-github] } } }配好之后在会话里就能直接问“最近有没有关于登录模块的issue提到token过期”Claude Code会通过MCP工具去GitHub查询再结合本地代码分析。这个能力让Claude Code从一个“代码阅读器”升级成“开发助手数据入口”日常排查问题时省去很多在多个工具间来回切换的时间。3. 快捷键、Vim模式与让终端更顺手的小技巧3.1 高频快捷键速查Claude Code交互模式下有一批快捷键我平时几乎天天使用快捷键功能说明Tab补全命令/文件路径输入斜杠命令、文件名时非常有用Esc中断当前生成模型开始长篇大论跑偏时立刻打断CtrlC中断/退出当前操作和终端习惯一致二次确认可退出Claude CodeCtrlD退出交互模式直接退出当前会话CtrlL清屏界面乱七八糟时一键恢复清爽CtrlR搜索历史命令重新使用之前跑过的命令方向键↑/↓翻历史输入找回上一条指令继续编辑两个真正用得多的场景说一下一是模型开始长篇输出但方向不对别等它说完立刻按Esc打断重新组织语言给指令比让它说完再纠正省大量token二是文件路径补全改了半个月代码路径又臭又长用Tab让它联想比我手打快多了。如果是在IDE插件里快捷键大体兼容但很多操作可以直接用鼠标点按钮比如查看diff、接受修改对不习惯终端的人更友好。3.2 开启Vim模式让输入效率翻倍如果你用Vim或者Neovim这个模式你会爱不释手。在会话里输入/vim切换Vim模式后输入框支持Vim键位j/k上下移动、w/b按单词跳转、x删除字符、u撤销、/搜索。这套键位对Vim党来说简直是肌肉记忆直接迁移编辑多行指令时不用再拿着方向键一个一个挪了。不过注意一个容易踩坑的点Vim模式开启后普通文本输入会被解析成命令。如果你本来想正常打字按了i发现没反应那是因为Vim模式默认处于普通模式需要先按i或a进入插入模式才能正常输入。这一点对刚刚从普通键盘操作转过来的用户是最大的障碍我当初也花了半天才适应。如果你不想用Vim模式默认的类Bash编辑模式也很顺手支持CtrlW删除上一个单词、CtrlU清空当前输入等一下实际上这里不只是这个模式终端本身也支持这些操作。记不住Vim键位的话就用Bash模式配方向键完全够用。3.3 高效利用会话标记与输出整理Claude Code在会话中支持用加文本的方式添加标记比如 [任务] 完成登录模块单元测试 [待办] 更新接口文档这些标记会随着/compact和/context保留下来相当于给会话画了路标。我习惯在每次切换子任务时加一行标记这样恢复会话时能迅速定位到之前的思路节点。另外输出中有代码块时Claude Code会自动给出“复制代码块”的快捷操作在IDE插件里更明显终端里则是直接选中代码块按y进行类似yank操作这个细节能有效减少鼠标选中时的误复制。还有一个小习惯关键决策、参数选择这类内容我会直接让它把结论写进CLAUDE.md或者在文件里加注释。为什么因为会话终究会compact会clear唯一能跨会话长期留存的就是磁盘上的文件。Claude Code不会替你记住你不让它记的东西你也不该指望它记——把决策落到文档里才是真正可靠的“长期记忆”。4. 高效工作流实操从需求到提交4.1 核心插件配置与权限管理Claude Code在终端里执行命令时默认需要用户确认。你可能会遇到它提出“我将运行如下命令npm run test是否允许”这种情况。有两种方式减少频繁弹窗/permissions命令交互式调整可以设置自动允许白名单。配置.claude/settings.json文件预设权限规则比如{ permissions: { allow: [ Bash(npm run lint), Bash(git status), Bash(git diff) ], deny: [ Bash(git push --force), Bash(rm -rf *) ] } }这个配置我强烈建议花10分钟设置好。好处是安全的日常命令不再打断思路危险的破坏性命令始终拦住。Bash()括号内是具体的命令模式也可以用通配符匹配一类命令。一开始配置得粗糙没关系遇到新的常用命令就往allow里加。权限管理还有一处容易被忽略Claude Code执行命令前通常会有dry-run或执行计划预览。特别是安装依赖、修改文件的时候它会把要执行的命令完整展示出来等你说“可以”它才动。这里我建议你耐住性子看完再放行——尤其是它会执行的终端命令里有没有包含你没见过的参数这是很多安全问题的根源。另外开启hooks机制之后你可以在.claude/hooks/目录放置一些触发脚本比如在工具调用前自动执行代码格式化、校验diff体积这些高级用法能让工作流更自动化但配置复杂度也会上升新手不必急着上。4.2 提问技巧与上下文管理的实战组合“提示词”决定了Claude Code产出质量的上限。我的经验是直接、具体、给出约束条件。下面一组对比很容易看出差异差的问法“帮我优化一下登录模块的代码。”好的问法“登录函数在src/auth/login.ts里当前问题是在token过期时没有正确处理刷新导致前端拿到401。请在该文件中补充token过期后自动刷新重试的逻辑注意保持现有错误处理方式不变并补充单元测试。”两条指令的区别在于后者告诉它文件、问题、边界、期望输出。Claude Code是能索引整个项目但它不知道你脑子里在想什么——你给的上下文越精确它就越不用猜。另一个提升效率的上下文管理方式是引用文件。在输入框里输入再输入文件名可以直接把该文件加入上下文焦点。要把整个目录纳入参考用src/components这种写法。我用的时候会把要改动的文件和相关依赖文件都显式引用一遍这样在后续对话中它对这些文件的敏感度和准确性会高很多。再补充一点不要试图一次对话解决所有问题。一个需求拆成一连串小任务比甩一个大需求让它自由发挥要稳得多。我的工作流是先让它读README和CLAUDE.md理解项目背景第二步确认需求涉及的文件清单第三步逐文件给出修改方案第四步执行修改并用git diff查验最后跑测试。每一阶段之间可能都会用/compact整理上下文避免中间聊着聊着跑偏。4.3 用plan模式进行任务规划Claude Code的plan模式是我在中期养成的一个好习惯。具体来说就是在权限配置里临时或者永久的把权限设置为plan模式此时Claude不会直接执行变更而是先分析当前代码库产出一份计划等你确认后再动手。进入plan模式的方式是claude --permission-mode plan或者直接在会话中说“先不要改代码告诉我你打算怎么做”。它的重要价值在于让Claude Code先展示它理解的现状和将要执行的步骤而不是你直接一句“帮我改”它就开始刷屏改文件改完你才发现理解完全反了再花两倍时间让它回滚。使用plan模式的结果是大部分返工都能被扼杀在摇篮里。计划确认后再通过/permissions切回默认模式或者直接在同一会话里让它“按刚才的计划执行”。4.4 子代理subagents并行处理复杂任务Claude Code还有子代理机制。简单理解就是可以同时开多个“分身”处理不同任务主会话协调子代理各自干各自的。实际使用中我会让一个子代理去审查测试覆盖率另一个子代理去检查性能瓶颈点主会话负责汇总和分配。不过子代理的配置需要专门设计不是随便聊两句就有的。一般做法是创建.claude/agents/目录下的配置文件给每个子代理定义角色、职责、可用的工具。想快速尝鲜的话可以让Claude Code自己帮你生成一份子代理配置然后逐步调优。但说句实话子代理不是每个项目都必须用。项目小、改动集中一个主会话搞定就行项目大、依赖复杂、要并行探索的方向多的时候子代理的价值才体现出来。新手可以先不管这个等主流程熟悉了再研究一上来就搞子代理容易被配置复杂度劝退。5. 常见问题排查与踩坑实录5.1 它执行了我不想执行的命令怎么办Claude Code在执行bash命令之前会展示将要运行的完整命令并征求许可。但有时候我们着急一看到弹窗就顺手放行结果它跑了个npm install、改了下全局配置、或者动了不该动的分支追悔莫及。我踩过的一个真实坑有一次让它帮忙修复一个编译报错它提示要运行rm -rf node_modules npm install我当时光注意后面那句“重新安装依赖”就放行了结果它把node_modules整个删了重装白等半天不说还因为lock文件版本导致依赖变化。从那以后我养成了“每个命令放行前至少花3秒读一遍”的习惯。另外deny列表里建议至少要有一条{ permissions: { deny: [ Bash(rm -rf *) ] } }防住最危险的情况。如果你想在自己不确定的时候强制它停下来还可以用CtrlC打断当前执行的命令断得干净利落。5.2 上下文超长或回答开始变蠢跑久了、聊多了、项目文件又大模型准确率会肉眼可见地下降开始忽略你前面提过的重要约束、回答越来越笼统、甚至会重复已经讨论过的问题。遇到这种情况第一时间跑/context看上下文占用率。如果占用率已经很高直接/compact压缩当前会话。如果还是感觉它丢失了部分细节就把它一直在提的一些关键约定写进CLAUDE.md下次compact后还能通过重新加载保持。你要是更希望干脆利落地重来就用claude --resume恢复一个更早的会话节点或者干脆/clear重开把刚才需要的背景重新粘贴一遍。这里有个我的实际经验与其在同一个会话里死磕不如保存当前进度清空重来。你手动贴一次背景的成本远小于模型在混乱上下文里瞎猜然后给你错误代码的返工成本。5.3 权限弹窗太频繁怎么办默认情况下它每执行一次bash都要征求同意做个小任务能被弹窗烦死。解决办法不是全放行而是把安全、常用的命令加入白名单。我上面的settings.json示例已经给了一种写法再补充一下如果Shell命令属于项目开发规范内的比如npm run lint、python manage.py test、git status这些完全可以放行。凡是可能产生破坏性效果的例如git push --force、drop table、删除大目录老老实实留在deny里。另外Claude Code的命令确认还有一种“后台运行”的状态就是命令发出去了但还没执行完这时候你可以按CtrlC终止终端进程本身防止它继续跑。我通常会让它在后台跑测试然后同一会话里继续讨论代码逻辑等它跑完再回来收集结果。5.4 生成内容与项目实际情况脱节这种问题多半是因为上下文里缺少关键信息。解决办法是强化文件引用尤其是在讨论某个具体模块时把核心文件、配置文件和依赖清单一次全引进去。此外让Claude Code先阅读相关测试用例而不是只看实现代码——“测试期望什么行为”往往比“代码现在怎么写的”更能帮它理解你的意图。如果它反复给出完全不符合项目技术栈的方案先检查CLAUDE.md对不对。CLAUDE.md写得清楚比如“本项目使用React 18 TypeScript Vite组件测试使用Vitest样式使用CSS Modules”它就很难跑偏。这也是为什么我强调/init后一定要手工补规范的原因——模型不会读心它只能按文档里的描述理解项目。5.5 非交互模式做脚本化任务除了进交互界面之外Claude Code还支持一次性命令式调用。这个对自动化特别实用claude -p 看看 src/utils/date.ts 里有哪些未导出但被测试引用的方法-p 或 --print 表示non-interactive模式模型能力直接在命令行里输出结果不进入交互会话。配上管道符还能把结果交给其他命令处理claude -p 列出当前目录所有测试失败原因 | grep Error这个模式配合CI流水线可以做到提交前自动代码审查、变更摘要自动生成。我的一个常用做法是写完代码准备开PR前用一条claude -p指令自动生成变更说明然后润色一下贴到PR描述里省掉手动整理diff的烦恼。要注意的是非交互模式同样受权限控制默认情况下它不会自动执行bash命令除非你在启动参数里指定了额外的授权flag。这个特性一方面保证了命令行模式的安全性另一方面也意味着有些自动挂测脚本需要事先配好权限。6. 手册速查表格化命令总览为了方便日常快速查找我把最高频的命令整理成一张速查表贴终端旁边就很实用。命令/快捷键作用我的使用频率claude进入交互模式每天claude --resume恢复历史会话每天claude -p ...一次性查询/任务每天/init生成/更新CLAUDE.md新项目必用/clear清空会话上下文高频/compact压缩上下文释放窗口高频/model切换模型版本每天/context查看上下文占用和文件引用高频/rewind回退文件修改快照按需/vim开启Vim键位模式持续开启/mcp管理外部工具连接按需/permissions修改命令权限白名单每周/review审查当前工作区改动提交前必用/pr-comments拉取并解答PR评论团队协作用文件名显式引用文件进入上下文高频添加会话标记长任务用Esc中断生成随时CtrlC终止当前操作随时CtrlD退出会话收工用CtrlL清屏随时这张表里的信息量其实不小但真正每天高频到的也就前面十几条。剩下那些比如MCP配置、子代理、非交互模式属于进阶武器等基础命令形成肌肉记忆之后再吸收也不迟。最后再分享一个我自己的习惯每周抽一个下午把本周常用的复杂指令整理成模板存到一个claude-prompts.md文件里下次需要时直接复制改改就用。这比每次都现场组织语言要省力得多。Claude Code这种工具的价值就在于此你投入时间打磨自己的使用方式回报是远超普通IDE补全的开发效率。