用 Claude Code 之前我其实对终端里的 AI 工具是有点不屑的——图形界面不香吗但真正上手用了两个月之后我的态度完全变了。这个工具不是简单的“在终端里聊天”它把 AI 辅助编程做成了像 Git 一样顺手的日常操作。不过正因为它的大部分能力都藏在命令行交互里很多人装完之后只会用最基础的对话完全不知道后面还有一整套命令、快捷键和可编排的工作流。这篇东西就是我自己整理的一份 Claude Code 命令速查手册高频指令、快捷键、工作流搭建全都按实操场景拆开讲。先说清楚这篇文章适合谁。如果你已经装过 Claude Code但总觉得用起来“差点意思”那这里面的内容能帮你把效率拉满如果你只是听说过这个工具、还没动手安装那从安装到配置的步骤我也全写了如果你以前用过其他 AI 编程工具、想迁移过来我会重点说清楚 Claude Code 和它们的本质差异。不管你是哪一类读者我希望你看完之后能直接照着操作不用再去翻各种零散的文档。1. Claude Code 到底是个什么角色1.1 它解决的到底是一个什么问题Claude Code 是 Anthropic 推出的终端原生 AI 编程助手它跑在命令行里能够读取项目文件、修改代码、执行终端命令、操作 Git并且基于你的整个项目上下文来理解需求、给出结果。注意“整个项目”这四个字这是它和 Web 端聊天机器人最本质的区别你在网页上粘一段报错模型只能根据你贴的那一小段去猜而 Claude Code 会自己搜代码定位到相关文件看一眼上下文然后告诉你问题其实不在报错行而在某个函数的调用参数上。这个“工作目录 工具调用 上下文感知”的组合才是它真正的价值。所以别把它当成一个“终端版聊天窗口”它更像一个住进你项目仓库里的结对程序员。你的任务是下指令它负责翻代码、改代码、跑命令验证结果。理解了这一点后面所有命令和工作流的设计逻辑就都好懂了——你会发现每个指令都是围绕“更高效地指挥这个结对程序员”来设计的。1.2 终端版、桌面版、VS Code 扩展怎么选最近“claude code桌面版”“claude code for vs code”“vscode配置claude code”这些词被搜得很多说明很多人第一反应是去找图形界面。但实际上Claude Code 的核心能力全部集中在命令行这个壳里桌面版和 VS Code 插件本质上是在复用同一套终端能力只是外层包装不同。我个人的建议是如果你主要做后端、脚本、运维类的工作直接老老实实用终端版它的响应速度和快捷键手感是最完整的如果你日常就在 VS Code 里写前端、调试那可以装 VS Code 扩展把 AI 会话侧边栏和编辑器集成在一起但要注意扩展的管理面板可能没有终端版那么全。桌面版适合不爱折腾终端、喜欢独立窗口的用户但它能做的事并不会比命令行多出什么黑科技。别在选型上花太多时间先用顺手的方式跑起来后面再迁移成本也不高。2. 从零开始安装、登录与基础配置2.1 安装的几种方式Ubuntu 和 Windows 各有什么说法安装 Claude Code 最主流的两种方式一是用 npm 全局安装二是用官方提供的安装脚本。npm 方式适合本来就有 Node.js 环境的开发者npm install -g anthropic-ai/claude-code装完直接在终端敲claude就能进交互界面。如果你用的是 Ubuntu 或者别的 Linux 发行版并且没有现成的 Node 环境可以走官方脚本安装它会自动处理好依赖。Windows 那边很多人在搜“windows怎么用命令解压tar”说明有人下载了压缩包不知道下一步怎么搞——其实 Windows 上更省事的方式是先装好 Node.js然后直接用 npm 安装避免手动解压和配置 PATH 的麻烦事。安装完成后可以先验证一下版本claude --version如果输出版本号说明安装成功。这里有个小经验装完之后别急着登录账号先确认自己想要的是“终端版纯命令交互”还是“配合编辑器使用”这会影响你后面要不要再装扩展但不影响命令本身的用法。2.2 登录与鉴权的细节安装完成后在项目目录里直接敲claude首次启动会引导你登录 Anthropic 账号。登录成功后Claude Code 会在本地保存一份凭证之后在同一个环境里就不用反复登录了。这里有一个很实际的坑如果你在公司电脑和个人电脑之间来回切换或者用远程开发环境凭证是不会自动同步的每台机器都要各自登录一次。另外如果你同时用了多个 API 服务商或者代理配置建议把鉴权相关的环境变量写进配置文件而不是每次启动都手动设置。我一般会在项目的.claude/settings.json里维护权限和环境变量配置这样团队协作的时候每个人拉下来就能用一致的环境。2.3 项目级配置与全局配置Claude Code 有全局配置和项目配置两层。全局配置位于用户主目录下的.claude文件夹项目配置则放在当前项目的.claude目录里。两者覆盖之后项目配置优先级更高。你可以用/config命令打开配置文件进行修改也可以直接手改 JSON。配置里最常用的是三类权限模式、环境变量、模型偏好。权限模式决定 Claude Code 在执行命令、修改文件时需要不需要你确认环境变量用于注入 API Key、内部服务地址这类信息模型偏好则是默认使用哪个模型版本。我的建议是个人开发环境可以放宽权限减少打断团队项目必须收紧权限防止 AI 在你不知情的情况下改了不该改的文件。2.4 在线升级与版本管理“claude code在线升级最新版本”也是高频搜索词。升级方式很简单在项目里或全局直接执行claude --update如果你是用 npm 安装的也可以执行npm update -g anthropic-ai/claude-code。这里有个细节值得注意升级后如果发现之前好用的命令没了或者快捷键不对劲先别急着回滚很可能是新版改了交互逻辑。我在一次升级之后就遇到过权限审批机制变更旧配置文件里的参数名不兼容导致命令全部要求手动确认。排查方法是在全局配置里搜旧参数名改成新版本兼容的写法。注意升级前如果正在有未保存的会话建议先把关键对话内容导出或者用/resume记住会话 ID再执行升级。升级不会丢历史会话但极端情况下可能影响运行中的进程。3. 高频指令速查手册3.1 Slash 指令日常用的其实就这几个进入claude交互界面之后输入/会弹出所有可用指令的提示。我不建议背全列表真正高频的 Slash 指令大概就这几个指令作用使用场景/init初始化项目生成 CLAUDE.md 项目记忆文件新项目开始让工具熟悉项目结构/compact压缩当前会话上下文保留关键摘要会话太长导致上下文溢出时/clear清空当前会话重新开始话题完全切换不想保留任何旧状态/resume恢复历史会话中断之后重新接上之前的工作/model切换会话使用的模型版本想换一个更强的模型处理复杂任务/vim切换 Vim 模式习惯 Vim 操作键位的人/status查看当前会话和工具调用状态排查响应异常时/help查看完整命令帮助任何时候忘了用法其中/init是很多人忽略但其实非常关键的一个。它不只是“初始化项目”这么简单它会在项目根目录生成一个CLAUDE.md这个文件相当于项目的“记忆卡片”告诉 Claude Code 这个项目的技术栈、目录结构、代码风格约定。之后每轮会话它都会参考这份记忆。我强烈建议每个新项目进来第一件事就是执行/init并手动补充一些团队规范进去。3.2 让 Claude Code 直接执行终端命令热搜词里有一条“claude code如何直接执行终端命令”这确实是新手最容易困惑的地方。Claude Code 本身不是一个普通的终端解释器你不能像在 shell 里那样直接敲ls、git、npm之类的命令期待它原样执行。正确的做法是在对话里用自然语言提出需求比如“帮我看看当前目录有哪些文件”“运行一下测试”“把最新的代码提交到 Git”Claude Code 会自己判断需要执行哪些终端命令并且在你确认之后执行。执行时的权限审批也很讲究。默认情况下它会列出将要执行的命令等你按y确认或者按n拒绝。如果觉得每次都确认太烦可以在权限设置里允许特定命令自动执行比如测试命令、格式化命令这种低风险的可以直接放行而像rm -rf、git push --force这类危险操作我建议永远保留手动确认不要为了提高效率把安全底线赔进去。还有一个非常实用的小技巧在对话中你直接说“不要问我直接跑”这类的指令配合权限配置可以让它在一个多步骤流程里连续执行命令比如自动跑测试、失败了自动看日志、再修复代码、最后重新测试。这就是后面要说的“轻量级工作流”的一个雏形。3.3 上下文管理compact、clear、resume 的正确用法“dify工作流 上下文超长”被很多人搜索说明大家在使用各类 AI 工作流产品时都遇到过长上下文的问题。Claude Code 在这方面给出了三种不同力度的解决方案很多人分不清我展开说说。/compact是“压缩”而不是“清空”。它的原理是用一个总结模型把当前对话的关键内容提炼成摘要替换掉原始的长上下文从而释放上下文窗口。适合的场景是你正在做一个复杂度很高的任务已经进行了几十轮对话但它处于中间状态你不想从头再来只是想腾出空间继续追加新需求。需要注意的是压缩之后细节可能会丢失比如某个文件里某一行具体的代码如果压缩时没有记录到摘要里后面它可能就“忘”了。所以压缩前我会让 Claude Code 把当前进展写进一个笔记文档或者压缩后主动追问一句“基于目前的内容我们的核心目标是什么”来验证它没有糊弄人。/clear是真正的“清空重来”。它会丢弃当前会话的全部上下文。适用场景是话题已经彻底结束准备开启一个完全无关的新任务。很多人习惯每开一个新任务就/clear这是对的因为残留上下文不仅浪费窗口还可能造成前后逻辑冲突。清空之后再开始新任务Claude Code 依然会读 CLAUDE.md 和项目文件所以项目级记忆不会丢。/resume则是“恢复”工具。你用/resume加会话 ID就能把之前中断的对话完整接回来。我经常在早上终端重启后用历史列表找回昨天没干完的活儿。注意它和/clear是相反的一个是保存现场一个是销毁现场。这三者的组合逻辑就是任务中途嫌窗口不够用用/compact任务做完了换新活儿用/clear临时中断想接着干用/resume。3.4 模型切换与初始参数/model用来切换当前会话使用的模型。不同的模型版本在编程任务上的表现有差异我一般会在三种情况下切换一是任务复杂度突然变高需要更强的推理能力二是发现当前模型在某个固定模式上反复出错换个版本可能绕过这个坑三是在做一些轻量任务时切到更快的模型省时省 token。启动 Claude Code 时还可以带参数比如claude --continue会自动恢复最近一次会话claude --resume id指定恢复某个会话claude --model 模型名直接指定启动时的模型。如果你是写脚本或者做自动化调用的这些启动参数比进入交互界面之后再用/model更顺手。比如我把“恢复昨天的会话并继续”写成了一个别名每天上班敲一下就直接接着干省掉了很多来回操作。4. 快捷键与交互操作技巧4.1 终端里的基础交互键位Claude Code 的界面本身就是终端交互式所以日常操作基本符合终端直觉回车发送、上下方向键切换历史输入、CtrlC中断当前生成。这里我踩过一个实实在在的坑在生成过程中按CtrlC中断它会退回到等待输入的状态但有时候你以为已经中断了实际上正在执行的外部命令还在跑所以中断之后我会习惯性再看一眼状态栏。方向键和 Tab 在自动补全场景下特别好用。当你输入一个 Slash 指令或者路径时Tab 可以补全方向键可以在候选项里切换。如果你是从 IDE 转过来的用户一开始可能会忍不住用鼠标去点但相信我习惯键盘操作之后效率提升非常明显。4.2 Vim 模式在 AI 终端里用 Vim 键位“vim命令”是相关搜索里的高频词说明 Vim 用户在开发者里占比真心不低。Claude Code 内置了 Vim 模式用/vim就能切换。切换之后你的输入框就变成了一个轻量级的 Vim 编辑区域i进入插入模式Esc回到普通模式h/j/k/l移动光标dd删除行甚至支持可视模式选中。我实际用下来最舒服的场景是写多行复杂提示词的时候。默认模式下要输入多行内容得另想办法但在 Vim 模式下你可以自由移动、修改、复制粘贴写一份上百字的任务描述变得像编辑代码一样精准。不过要说句实话如果你是 Vim 零基础不建议为了用这个功能去现学 Vim先默认模式用着等哪天觉得指点光标太慢再切过来。4.3 多行输入、粘贴错乱与输入法问题很多人第一次用 Claude Code 时都会遇到一个尴尬在终端粘贴一大段内容发现格式全乱尤其是从网页或者 PDF 里复制过来的代码。这里有一个经验先把内容粘贴到本地编辑器里规整一下再复制进终端或者直接在输入框里用\n来显式表达换行避免缩进错乱。中文输入法在终端里也容易出问题尤其是分段时按回车确认了候选词结果不小心把整个对话发送了。我后来养成的习惯是打中文时先盯着输入法状态栏确认候选词上屏之后再去按回车如果一段话比较长我会先在别处打完再粘进来。这个坑看起来很小但实际发生频率比想象中高尤其是手速快的时候。4.4 快捷键冲突排查Claude Code 运行在终端里所以“快捷键不起作用”很多时候不是它的问题而是终端模拟器先截胡了。比如某些终端会把CtrlC映射成复制某些终端管理器会占用Alt组合键。遇到这种情况我建议先去终端自己的快捷键设置里查一查是否有冲突把终端层面的全局快捷键改掉或关掉再回到 Claude Code 里测试。还有一个常见来源是系统级的输入法切换快捷键比如Ctrl空格这类组合很容易在你想切换输入法的时候把 Claude Code 的某个操作误触发了。排查方法很简单先换一个干净的终端试一下如果问题消失那就是终端配置的锅如果问题还在再回头检查 Claude Code 的配置和版本。5. 高效工作流编排从单条命令到系统化协作5.1 CLAUDE.md给 AI 一张项目“说明书”工作流的核心不是命令本身而是“让 AI 始终处于正确的上下文里”。CLAUDE.md就是这个上下文的载体。它支持全局、用户级、项目级三层项目根目录的优先级最高。一个合格的CLAUDE.md应该包含项目简介和技术栈、目录结构说明、常用命令和启动方式、代码风格约定、以及“哪些事 AI 不能做”。我见过很多团队把CLAUDE.md写得像一本毕业论文动辄几百行这其实是错的。Claude Code 每次会话都会加载这份文件太长会白白占用上下文。我的建议是控制在五十行以内写“别人接手项目必须知道的最少信息”即可。详细内容放在独立文档里在需要的时候再让它去读而不是全部塞进记忆文件。5.2 Hooks 自动化让 AI 在关键节点自动执行动作Claude Code 的 Hooks 机制是工作流高级玩法里的重头戏。Hooks 允许你定义一些事件触发器比如用户发出每一条会话消息之前、AI 执行某个工具之前、回答结束之后在这些节点上自动运行一段脚本。看起来很抽象我举个例子你就懂了你可以配置一个 PreToolUse 的 Hook在 Claude Code 准备修改文件前先自动跑一遍 lint或者配置一个 Stop Hook让它在每次回答结束后自动执行测试然后把测试结果写回对话里。这套机制最适合的落地场景是“提交代码前的自动化串联”AI 改完代码自动格式化自动跑单测失败了自动修复全过了再提交。这一整套流程如果手工操作需要来回盯好几轮配置好 Hooks 之后基本就是甩手掌柜。但注意 Hooks 脚本本身要足够健壮因为一旦脚本报错可能会导致整个任务链路中断所以我在上线任何 Hook 之前都会先手动执行一遍脚本确认没毛病。5.3 子代理与多角色协作如果你经常处理“既要做架构设计、又要写实现、还要写测试”的大任务把整个任务丢给一个会话往往效率不高。Claude Code 支持子代理机制你可以让它拆分成不同角色的子代理分别负责不同的任务面。比如一个子代理专注梳理代码库里现有的接口一个子代理负责根据这些接口写实现方案另一个子代理负责补测试和文档。我在实际项目里是这样用的先让主会话梳理清楚需求和约束然后委派子代理去执行互不依赖的独立工作最后再回收结果统一审查。这样做的最大好处是职责清晰主会话不会被浩如烟海的中间过程淹没始终能把握全局。子代理模式的配置和维护成本比单会话高适合那种单会话明显“忙不过来”的大项目小任务不要滥用否则光协调子代理的时间比自己做还久。5.4 与 VS Code 深度联动“vscode配置claude code”的搜索热度一直很高这里我给出一个比较成熟的用法。先在 VS Code 扩展市场安装 Claude Code 扩展安装后可以在侧边栏打开会话面板终端里能做的事这里大部分都能做但多了一个好处选中代码片段可以直接发送到会话里作为上下文AI 的回答也可以直接插入到当前文件里。这种“选中–提问–插入”的循环特别适合处理局部代码改进需求。我的配置建议是在 VS Code 里把 Claude Code 面板当成“局部重构工具”处理单个文件、单个函数级别的任务把真正的终端版 Claude Code 留给大型跨文件重构、多步骤业务流程。两种方式各有各的适用区间混着用效率最高。如果遇到扩展面板的快捷键跟编辑器内置快捷键冲突可以在 VS Code 的键盘快捷方式设置里单独改掉这个问题不大但很影响手感。5.5 轻量级工作流不需要复杂配置的日常模式不少人在搜“轻量级工作流”“工作流搭建有哪些应用”其实在日常使用 Claude Code 时不需要搞出上面那种复杂的 Hooks 体系几个简单的提示词策略就能形成非常高效的工作流。第一个是“先讲后做”模式。在下达修改任务之前先让它“描述一下你打算怎么改改哪些文件为什么这么改”你确认思路没问题之后再说“按这个思路执行”。这可以避免它一上来就大刀阔斧乱改。第二个是“三步验收”模式。让它在完成一次修改之后自检三步改了哪些文件、有没有破坏原有测试、有没有更新相关文档。把这三步写成每次任务都要遵循的固定模板手工把工作流编码进提示词里。第三个是“失败复盘”模式。它跑完测试报错了别急着让它重试先让它分析报错原因、可能的修复方案再执行修复。这套逻辑本质上就是把你在团队里带新人的思路教给它。这三个模式都不需要任何插件和配置只需要你在第一次会话时把规则讲清楚或者写进 CLAUDE.md 让它一直记住。对大多数人来说它们带来的效率提升比那些复杂的自动化配置还要大。6. 常见问题与排查笔记6.1 上下文超长报错、卡顿怎么办聊到一半它突然不记得几分钟前说的内容或者响应明显变慢多半是上下文窗口快满了。最简单的判断方法是看提示当接近上限时CLAUDE.md 的加载都会受影响。解决办法分三档立刻用/compact压缩压缩后还觉得内容缺失就/resume拉回去重新对话实在抢救不回来就直接/clear重开。但这里我想多说一句上下文溢出很多时候不是“窗口不够大”而是“流程设计有问题”。如果你把整个项目的历史决策、所有文件内容都堆在会话里再大的窗口也不够用。正确的思路是让长任务保持“精瘦”——重要信息沉淀到文档里让 AI 按需去读而不是全程揣在兜里。这和“dify工作流 上下文超长”这类问题的解法是一致的少就是多。6.2 权限审批被频繁打断默认权限模式下每次执行命令都要你确认多步骤任务会变得极其啰嗦。解决思路不是一味放宽而是分级授权低风险命令自动放行中等风险命令需要确认高风险命令永远强制确认。你可以通过claude交互界面里的/permissions相关配置来精确控制也可以在.claude/settings.json里手动配置允许规则。我自己踩过的坑是为了图省事把某个项目权限全部放开结果某次它执行了一个我没有预想的命令等发现已经晚了。所以我现在的铁律是危险命令绝不放开宁可多按几次确认键。6.3 升级后老配置失效前面提到过版本升级后可能出现配置不兼容。这种情况的排查步骤是先看官方变更日志确认哪些配置项被改了再备份旧配置改成新格式最后用/status验证新配置是否被正常加载。如果你不太确定旧配置里哪些参数还能用最稳妥的办法是新建一个最小配置一步步把参数加回来直到问题复现再回头检查。6.4 别把 Claude Code 的工作流和其他产品混淆很多人搜“coze工作流”“comfyui工作流”“dify工作流”这些确实是“工作流”概念但和 Claude Code 是完全不同的产品。Coze、Dify 这类偏向于低代码的 AI 应用编排平台ComfyUI 则是图形化的 Stable Diffusion 工作流工具。Claude Code 的定位是一个终端原生的编程助手它的工作流是围绕代码库操作、命令执行、版本控制这些开发场景来组织的。弄清楚这个区别很重要因为你解决问题的思路会完全不同如果你在配置低代码平台的业务流程你需要的是可视化编排工具而不是在终端里折腾如果你要的是一套开发提效的工作流那 Claude Code 的命令、快捷键、Hooks 子代理这些能力才是你真正要找的东西。两边的词汇虽然都带“工作流”三个字但底层逻辑互不相通混着搜只会浪费时间。6.5 问题排查速查表现象大概率原因处理办法响应变慢、忘记早前内容上下文接近上限/compact压缩或/clear重开命令被拒绝执行权限配置过严设置分级权限低风险命令放行粘贴内容错乱终端转义或输入法干扰先在编辑器规整再粘贴快捷键无响应终端或系统快捷键占用检查终端快捷键和输入法设置升级后配置异常配置格式不兼容按新版本格式重写配置无法恢复历史会话会话 ID 丢失或版本不支持用历史列表查找确认升级后再试最后说点个人体会断断续续用 Claude Code 小半年要说有什么最大感受那就是“不要神化工具也不要低估工具”。它不会替你做架构决策也不会把烂代码变成好代码但它能把你从大量机械劳动里解放出来——查文档、找 bug、写测试、整理改动这些原本占据开发者大半天的活儿现在几句话就能看到结果。关键在于你怎么指挥它命令背得熟只是基础真正拉开差距的是你有没有一套稳定、可复用、适配自己项目的工作流。我个人最推荐的做法是从 5.5 节里的三种轻量级模式开始试养成习惯了再逐步引入 Hooks 和子代理一步步把日常工作流搭建起来。最后再分享一个小技巧如果你刚开始用不妨把自己常用的任务模板写进 CLAUDE.md让它每次都能按你习惯的步骤来这个投入产出比比研究任何冷门命令都高得多。