把 Claude Code 当聊天窗口用的人大概只发挥了它两成不到的功力。真正让它从“玩具”变成“生产力工具”的不是谁的提示词写得更华丽而是谁脑子里存的指令多、用得准。这篇文章我把自己每天真实在敲的指令全部掏出来分门别类整理成套最后给出一张刚好 100 条的速查表覆盖斜杠指令、终端参数、快捷键和常用自然语言操作既不聊虚的架构也不堆没用的概念打开就能照着敲。我默认你已经在用 Claude Code或者至少装好了准备开始用。如果你还卡在安装、登录、连不上服务这种阶段第 2 节先把环境趟平再往后看。1. 先理清 Claude Code 指令体系的四条线很多人刚开始用 Claude Code 会犯同一个错以为指令只有/开头的那些。其实日常使用的“指令”至少分成四条线理解了这条线后面的速查表才看得懂。第一条线是斜杠指令也就是在对话里直接敲/开头的命令。它们作用在会话内部管的是“当前这轮对话怎么处理”清空历史用/clear压缩上下文用/compact切换模型用/model查看费用用/cost。这类指令数量不算多但每条都是高频中的高频是每天手速最快的几个按键。第二条线是终端参数和子命令也就是你在 Shell 里输入claude时携带的那些参数。它们决定的是“这次程序以什么方式启动”是用交互模式还是非交互模式是继续上次会话还是重新开一个是允许自动编辑还是每次询问。这条线最容易被忽略但恰恰是在自动化、脚本、CI 场景里的命根子。第三条线是快捷键。Claude Code 的键盘操作继承了终端工具一贯的克制风格数量不多但每个都关键。比如中断生成、允许工具执行、切换到全允许模式这些动作如果不走快捷键交互效率会断崖式下跌。第四条线是最容易被忽略的自然语言指令。Claude Code 本质上是个编码代理它最擅长的不是机械地执行命令而是听懂你的意图。所以“打开 src/index.js 看前 80 行”“找出所有调用 formatDate 的文件”“把这两个函数合并成一个”这些话本身就是指令。很多人只会写开场提示词后面事无巨细全靠打字不习惯用自然语言做局部的、精准的指令这样效率反而低了。四条线合在一起才构成完整的“Claude Code 指令体系”。下面我按工作顺序一条一条把这四条线拆开讲。2. 开工前必跑的安装与检查指令以及连接问题怎么排先把地基打牢。我见过太多人连claude doctor都没跑过遇到问题就蒙圈。2.1 安装、升级、环境自检安装本身很简单一条命令的事npm install -g anthropic-ai/claude-code装完先确认版本并且养成定期升级的习惯claude --version claude update这里要提醒一句claude update这个动作我一开始总忘。Claude Code 的迭代速度极快有时候头一天还在用的指令第二天更新后就有了新参数或者旧参数改了名。我踩过一次坑某次升级后--continue的行为变了我没注意到版本号还以为是 bug折腾半天才发现是自己用的老参数没跟上新版本的语义。所以每周至少跑一次claude update真的很有必要。环境自检是很多人的盲区claude doctor这条命令会检查安装状态、登录状态、环境变量、配置文件位置输出一份诊断报告。遇到任何诡异问题先跑它大部分时候问题当场就暴露了。如果claude doctor提示没问题但依然用不了那基本可以断定是网络层或者账号层的问题继续往 2.3 走。2.2 登录与密钥配置安装完成后第一件正事是登录claude首次运行会引导你完成登录流程。背后实际生效的方式有两种浏览器登录得到临时凭证或者直接用 API Key。API Key 的方式更适合服务器环境export ANTHROPIC_API_KEYsk-ant-your-key-here claude会话内也可以随时处理登录状态用斜杠指令/login /logout/login的作用是重新认证或者切换账号/logout则是登出。我一般在团队公用服务器上干完活会主动/logout避免把凭证留在公共环境这个习惯建议你也有。2.3 “无法连接 Anthropic 服务”的通用排查链路很多新手经常会碰到标题里那个报错unable to connect to anthropic services fail。这个报错在不同版本里措辞略有差异比如failed to connect、request failed之类但本质都一样客户端没能和 Anthropic 服务端建立起正常的通信链路。我自己的排查顺序是固定的一套每次照着走基本几分钟能定位claude doctor看基础环境有没有问题。claude --version确认版本号不是太老、不是太新刚升级。检查网络出口是不是正常最简单的方式是直接在终端里探测一下比如ping api.anthropic.com或者用curl试着拉一次接口。如果连基本的网络请求都到不了对端那问题十有八九不在 Claude Code 本身。检查环境变量里有没有残留的ANTHROPIC_API_KEY或者ANTHROPIC_BASE_URL。如果之前配过别的服务商地址现在忘了清除请求就会打到错误的地方。用env | grep ANTHROPIC看一下最直观。重新登录一次/logout然后/login有时是凭证过期但客户端没给出明确提醒。如果是刚升级完版本后突然连不上而你的网络完全正常那多数是版本本身的问题优先去看官方更新说明或者临时降回上一个稳定版本继续把手头事干完。不要反复重装重装解决不了这类问题。3. 每天扑进项目里最常用的一批指令会话、文件与编辑这部分是我每天敲得最多的地方。熟练之后你会发现自己不再盯着屏幕等回复而是像开车一样变道、跟车、按喇叭一系列动作全凭肌肉记忆。3.1 开启、继续、恢复会话日常开始工作就两条路claude进一个新会话默认读取当前目录上下文。如果今天要接着昨天没干完的活别开新的用继续claude -c-c等价于--continue会直接接上最近一次会话的历史继续。如果开了太多会话想指定某个用claude -r claude --resume 12345678-r会给出一个会话列表让你挑--resume后面跟会话 ID 直接精准回到那一次对话。这个功能对“隔了好几天才回来的考古现场”尤其好用。3.2 会话生命周期管理会话开久了上下文会越来越臃肿处理速度下降、理解变形。这种时候别硬撑三件套直接上/clear清空当前上下文重新开始一个干净会话。Claude Code 会忘掉之前所有对话内容但项目文件还在重启对话不受影响。/compact不清空而是把历史压缩成摘要。适合还想保留当前任务脉络但上下文已经太长的情况。压缩之后它能记住关键结论但细节会丢失一些使用前心里要有数。/rewind回退到之前的某个状态。如果发现自己刚才让它干了一堆错误操作别手动纠正了直接/rewind回到出错之前。这个功能是我重度依赖项它相当于给对话上了一道存档。查看上下文占用情况也有一个专门指令/context能显示当前上下文里有哪些文件、多少字符、大致占比。我一般每半小时就扫一眼一旦发现某个大文件占了太多上下文空间立刻考虑是不是要把那个文件从上下文里赶出去给真正重要的代码腾位置。费用控制也是一天要看好几次的事/cost显示当前会话累计 token 消耗和费用。价格焦虑人士的定心丸也是估算一个任务花多少钱的最快方式。3.3 文件导航、检索与编辑的高频话术代码操作里有那么几句自然语言是我用成千上万次总结出来的万能话术直接照着说就行先说看文件“打开 src/utils/date.ts先看前 120 行完整贴给我。”“不要贴代码只用三句话告诉我这个文件是干什么的。”“把 src/server 这个目录下的所有文件用目录树的形式列出来标出每个文件的作用。”再说检索“在仓库里找到 defineStore 这个函数的所有定义和调用位置。”“搜索所有用到 getUserInfo 的文件按调用链整理成列表。”“把 package.json 里的依赖和 scripts 整理成我要看的摘要。”最后说编辑这是重头戏。Claude Code 之所以比普通聊天强就是因为它能直接改文件“把 utils/request.ts 里的超时时间从 5000 改成 10000其他任何地方都不要动。”“把这两个函数拆成一个工具类保持外部调用不变。”“在 README 里加一节 Quick Start内容照抄现有注释的风格。”用自然语言下指令有一个原则要养成说清范围。只说“帮我优化一下代码”它可能给你重写一遍但如果说“只优化 utils/date.ts 中的 parseDate 函数保持入参出参不变”它就会框定在准确的边界里改改动可控得多。3.4 权限批准从每步确认到放心自动Claude Code 执行写文件、跑命令这类高危操作前会向你请求权限。交互中你按几个键就能控制节奏y允许当前这一次操作。A允许当前这一类操作后面不再询问accept always。R拒绝当前操作。E进入编辑模式手动改写它要发出的工具调用。还有个容易被忽略的快捷键是ShiftTab它会在工具的权限模式之间循环切换从“每次都问”切到“只允许编辑类操作”再切到别的模式。切到什么模式直接决定你接下来是“用人肉控制台”还是“半自动驾驶”用熟之后能明显减少坐在屏幕前机械按 y 的次数。如果你已经足够信任它也能直接在启动时指定权限模式claude --permission-mode acceptEdits这个模式会自动允许它改文件但执行 shell 命令时还是会问。我自己的日常配置就是这种安全性和效率取了一个稳定平衡点。4. 让 Claude 记得住、看得懂、会自查规则、记忆与审查如果你只把 Claude Code 当成一个“一次性问答机器”那确实不太需要这部分。但如果你要它在同一个项目里连续工作几个月就必须让它记住项目约定并且有能力自查输出质量。4.1 用 CLAUDE.md 把项目约定写进它脑子里Claude Code 会在每次启动时自动读取项目里的CLAUDE.md文件把它当作长期记忆。这个机制适合放什么放那些“你希望每次对话它都默认知道”的事项目技术栈是什么主语言、框架、包管理器。代码风格规范缩进、命名、注释语言。目录结构约定业务代码放哪、工具函数放哪、测试放哪。常见注意事项“不要动 migrations 目录”“改 schema 前先看设计文档”。手动创建一份太慢了直接用它的初始化能力/init/init会扫描当前项目结构结合已有的代码和 README自动生成一份初始的CLAUDE.md。我自己用下来的体验是它生成的骨架比想象中靠谱你只需要再人工补几条只有项目老人知道的“潜规则”进去就行。全局和项目级的记忆是分层的~/.claude/CLAUDE.md存的是所有项目通用的偏好项目根目录的CLAUDE.md存的是本项目特有约定。两者不冲突是叠加的关系。4.2 /memory把临时记住的事变成长期规则除了CLAUDE.mdClaude Code 还有一套会话记忆机制/memory有时候你在对话里随口说了一句“以后提交信息都用约定式提交”它当时记住了但新会话开了又忘。/memory就能把这类“临时共识”固化下来写进持久化的记忆文件之后的会话自动加载。我的用法是凡是我们团队在一个会话里达成的新约定比如“测试文件后缀改成 .spec.ts”“所有 API 返回结构统一成 { code, data, msg }”都会顺手让 Claude Code 用/memory记住而不是每次重新交代。这个动作一次几秒钟长期省下来的重复说明时间非常可观。4.3 /review写完就审不用等 Code Review 会议代码改完之后别急着走人。让 Claude Code 自己先审一遍/review它会查看当前未提交的改动给出评审意见包括潜在 bug、边界条件、风格问题、遗漏的错误处理。这个环节相当于多了个“第二双眼睛”而且比人工 Review 快得多。我现在的固定流程是文件改完 →/review→ 根据意见修一轮 → 再/review一次确认干净了才提交。注意/review看的是当前工作区改动如果你已经把代码提交了它默认看不到。所以节奏是先git add但别急着 commit或者干脆保持工作区带改动状态审完再提交。4.4 用 hooks 做自动化自检Claude Code 的 hooks 机制可以把自定义脚本挂到特定事件上。比较实用的事件有这么几类PreToolUse在它调用某个工具前触发适合做“安检”PostToolUse工具执行完后触发适合做“复核”Notification需要中断工作时通知你Stop一轮完整输出结束后触发。hooks 的配置放在.claude/settings.json里。举个例子如果我不希望 Claude Code 不小心执行sudo命令可以做一条PreToolUse规则匹配Bash(sudo*)直接拦截让命令在执行前就被卡掉。这类自动化我一般配置在.claude/settings.local.json里只有自己机器生效不会把个人偏好带进团队仓库。5. 插件化玩法的指令自定义斜杠命令、技能与 MCP 服务用了一段时间后你需要把 Claude Code 长成自己的形状而不是每次重新教它。这个阶段的核心是自定义斜杠命令、Skills、MCP 服务。5.1 自定义斜杠命令把固定流程固化成单词每次都要手打一大段 prompt 来让它“做某某事”其实是懒人的灾难。正确做法是把这段动作固化成你的专属斜杠命令。方法很简单在项目的.claude/commands/目录下新建一个 Markdown 文件文件名就是斜杠命令名。比如建一个deploy.md文件内容写清楚“当用户执行 /deploy 时要做哪些步骤”保存后在 Claude Code 里敲/deploy它就会按文件里的规则去执行。里面还能用$ARGUMENTS接收你传给这个斜杠命令的参数写一些变量化的处理逻辑。哪个场景适合自定义我举几个自己已经固化的例子/changelog根据 git log 生成本周变更日志/refactor读取指定文件按项目重构规范给出重构方案并实施/help-dir生成当前目录的说明文档/test给当前改动文件补单元测试。这些本质上是把高频、固定、带约束的任务从“每次打 50 个字”压缩成“一个斜杠命令”。5.2 Skills给 Claude Code 装上“专属知识包”Skills 和自定义斜杠命令的区别在于斜杠命令是你主动触发的一次性动作Skills 更像是一个常驻的技能包Claude Code 会在你在对话中自然遇到相关问题时就尝试使用它。技能文件一般放在.claude/skills/目录下每个技能是一个子目录里面有一份SKILL.md描述这个技能的触发场景、使用步骤、注意事项还可以附带脚本、模板、规则文件等资源。配置好后通过/skills查看当前加载了哪些技能也可以主动在斜杠指令里选择让 Claude Code 调用某个技能。我在团队里最常用的做法是给“代码迁移”“依赖升级”“日志分析”这类既有方法论又包含大量检查步骤的场景单独写技能写一次全队复用。它最大的价值不是单个步骤神奇而是把“老师傅的操作习惯”变成了“可被自动触发的标准流程”少了每次重新摸索的时间。5.3 MCP 服务把外部工具接进来MCP 是让 Claude Code 能访问外部工具和数据的标准接口。有人用它连数据库有人连文件系统有人连浏览器自动化工具。Claude Code 自带一套 MCP 管理子命令claude mcp add 服务名 -- 启动命令 claude mcp list claude mcp get 服务名 claude mcp remove 服务名add把服务注册进来list查看所有服务get看某个服务的配置详情remove移除。也可以在项目根目录建.mcp.json文件手动声明服务后一种方式更适合放进 Git 仓库和团队共享。我不建议一开始就接一堆 MCP 服务先徒手跑一段时间发现“哪类操作 Claude Code 需要反复借助外部数据才能完成”再有针对性地去接。服务接太多了每次启动的上下文也很浪费上下文就是钱。6. 100 条常用指令速查表按场景整理下面这张表就是我日常用的全部家底按场景分组编号。前面几节已经展开讲过的这里只留关键词和适用场景方便你复制、检索、贴到自己的笔记里。6.1 安装、更新与登录01–14序号指令什么时候用01npm install -g anthropic-ai/claude-code全局安装 Claude Code02claude --version查看当前版本03claude update升级到最新版04claude doctor环境自检排查安装/配置问题05claude在项目目录启动交互式会话06/login登录或重新认证07/logout登出当前账号08export ANTHROPIC_API_KEYsk-ant-...设置 API Key 后启动09claude --model sonnet用 Sonnet 模型启动会话10claude --model opus用 Opus 模型启动复杂任务首选11claude --model haiku用 Haiku 模型快而省12ANTHROPIC_MODELsonnet claude通过环境变量指定默认模型13claude -c/claude --continue继续最近一次会话14claude -r/claude --resume 12345678从会话列表或指定 ID 恢复会话6.2 会话生命周期与上下文管理15–30序号指令什么时候用15/clear清空当前会话上下文16/compact压缩历史摘要保留主线17/rewind回退到之前的某一个操作节点18/context查看上下文占用、已读文件、字符量19/cost查看当前会话 token 费用20/status查看会话状态和错误信息21/export导出当前会话内容22/model会话内切换模型23/help查看斜杠指令帮助24/init初始化 CLAUDE.md25/memory查看/管理记忆26/add-dir把目录加进当前上下文27/config打开配置文件28Esc中断当前工具操作29CtrlC终止当前输出30/vim切换 Vim 风格键盘导航6.3 文件、检索与编辑31–52序号指令什么时候用31“打开 src/utils/date.ts贴前 120 行”固定范围看文件32“用三句话说出这个文件是干什么的”快速理解文件33“把 src 目录列成树状结构”梳理项目结构34“找到 getUserInfo 的所有定义和调用位置”检索函数35“搜索所有用到 formatDate 的文件”按引用反向搜索36“把 package.json 的依赖整理成摘要”快速了解依赖37“把超时时间从 5000 改成 10000其他地方不动”精准改单个值38“把两个函数拆成一个工具类外部调用不变”重构函数39“给 utils/request.ts 加注释风格照旧”按现有风格补注释40“在 README 里加 Quick Start 一节”补充文档41“对比这两个文件的差异并总结”文件对比42“把这段报错贴进去解释原因并修复”报错排查43“列出 src 下所有测试文件名”测试文件检索44“找出所有 console.log列出行号和内容”定位调试残留45“重命名这个函数所有引用处同步改”联动重命名46“把这段逻辑提取成公共函数”去除重复代码47“检查这个文件有没有未处理的异常”代码质量检查48“把 utils 目录下的 TODO 全部列出来”找待办标记49“给当前改动写一份变更说明”生成改动摘要50“这个项目的测试怎么跑”问项目运行方式51“把改动文件按 git status 列出来并解释”结合 Git 理解改动52“按函数调用关系画一个 ASCII 图表”依赖关系可视化6.4 权限、安全与确认53–64序号指令什么时候用53y允许当前这一次工具调用54A当前会话始终允许同类调用55R拒绝当前工具调用56E编辑工具调用参数后再执行57ShiftTab循环切换工具权限模式58claude --permission-mode acceptEdits允许自动改文件命令仍需确认59claude --permission-mode plan只做规划不执行操作60claude --dangerously-skip-permissions跳过全部权限确认实验室用61claude --allowedTools Bash(git*)白名单放行指定工具62claude --disallowedTools Bash(sudo*)黑名单禁止指定工具63claude --permission-prompt-tool Bash(git status)只对指定工具弹确认64/permissions查看当前权限配置6.5 模型、规则与配置65–78序号指令什么时候用65CLAUDE.md项目根目录项目级长期记忆66~/.claude/CLAUDE.md全局通用规则67RULES文件追加约束规则68.claude/settings.json团队共享配置69.claude/settings.local.json个人本地配置70.gitignore里加.claude/settings.local.json防止个人配置入库71claude --system-prompt ...附加系统角色提示词72claude --settings启动时查看配置信息73claude -p ...非交互式一次性执行74claude -p ... --max-turns 8限制最多执行 8 轮75claude -p ... --include-partial-messages流式输出部分消息76claude -p ... --verbose输出完整日志77claude -p ... --debug调试模式运行78claude -p ... -o json输出 JSON 格式供脚本解析6.6 自动化钩子、技能与 MCP79–91序号指令什么时候用79/hooks打开钩子配置向导80PreToolUse钩子事件在工具调用前拦截检查81PostToolUse钩子事件工具执行后复核82Notification钩子事件需要人工确认时通知83Stop钩子事件输出结束后触发后续动作84/skills查看当前已加载的技能85claude install-skill安装技能包86.claude/skills/xxx/SKILL.md手动创建技能定义87.claude/commands/deploy.md自定义斜杠命令文件88$ARGUMENTS在自定义命令中接收参数89claude mcp add name -- cmd注册 MCP 服务90claude mcp list查看已注册的 MCP 服务91claude mcp remove name移除 MCP 服务6.7 Git 工作流与 CI 场景92–100)序号指令什么时候用92git diffclaude -p 写一条 git commit 信息93git log --oneline -10claude -p 整理最近的变更94claude -p 审查当前工作区改动代码审查不进交互界面95claude -p 把 src 下所有 TODO 列出 -o json脚本化提取待办96claude --session-id id在 CI 中指定会话标识97echo ...claude -p ...98cat error.logclaude -p 归纳三类主要错误99claude -p ... --model opus复杂一次性任务用更强模型100cd /project claude -c进项目目录后继续上个会话用这张表的时候记住几件事斜杠指令在交互模式内输入终端参数在启动时输入快捷键是运行中直接按键盘那几颗键。剩下的自然语言指令不用死记理解“范围明确 输出明确”的说话方式你就能自己造出第 101 条、102 条。最后补一句我自己的体会指令背得再熟也代替不了理解。真正把工具用顺的人其实是把每条指令背后的“为什么”想通了知道什么时候该清上下文、什么时候该开新会话、什么时候该给自己加权限。这份清单只是把路铺好怎么走得看你自己。
