如果你每天在终端里敲claude然后只是像聊天一样描述需求那你其实只用了这个工具十分之一的能力。真正把 Claude Code 用成“团队实习生”的人靠的不是模型提示词写得有多花哨而是对三类指令的熟练组合CLI 启动命令、会话内 Slash 命令、环境变量与配置项。这篇文章我把日常实战中真正用得上的 100 条常用指令整理成一份速查手册覆盖安装、初始化、会话控制、文件操作、代码重构、Git 提效、权限管理、模型切换和自动化场景。适合刚装好 Claude Code 的新手也适合用了两三个月但还停留在“聊天改代码”阶段的固定用户。我按 2025 年常见的 Claude Code 2.x 版本来写版本迭代很快个别命令在你当前版本里可能改了名字遇到这种情况以claude --help和对话内的/help为准不用死记硬背。1. 先弄清指令的三种形态后面一百条才不白看很多人觉得 Claude Code 难记是因为把三种完全不同的“指令”混在一起看。实际上它们分别控制不同层面的东西理解之后规律非常清晰。1.1 CLI 命令终端里的“启动参数”这一类在 shell 里执行决定你以什么方式启动 Claude Code、用什么模型、以什么权限运行、输出什么格式。典型例子是claude --continue、claude -p ...、claude --model sonnet。它们解决的是“这次会话怎么开始”的问题适合写脚本、做自动化、从 CI 或编辑器终端里快速调用。1.2 Slash 命令对话内部的“遥控器”进入会话后以/开头的命令负责管理当前会话本身。比如/status看状态、/context看上下文占用、/compact压缩历史、/rewind回退到之前的操作节点。它们解决的是“对话进行到一半怎么继续”的问题我每天在会话里用得最多的就是这一组。1.3 配置项与环境变量不显眼但决定上限第三类是claude config set写入的配置以及ANTHROPIC_MODEL、ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL这类环境变量。它们不会频繁出现在键盘上但长期影响模型选择、API 地址、密钥来源和成本。很多用户抱怨“每次都要手动选模型”“换个项目又得重新配”本质是没有把这一类指令用好。把这三类分开记再对照下面的一百条你会有一种“原来如此”的感觉。2. 安装、认证与基础诊断前 20 条先跑通每次换电脑、换版本、遇到莫名其妙的问题最早用到的就是这 20 条。里面既有安装命令也有启动方式和认证入口。2.1 安装、升级与卸载第 1~8 条编号指令什么时候用1node -v安装前检查 Node 版本版本太低会直接失败2npm install -g anthropic-ai/claude-code官方推荐的全局安装方式3claude --version查看当前版本排查问题时先报这个4claude --update自动更新到最新版5npm uninstall -g anthropic-ai/claude-code卸载旧版或重装前清理6which claude确认命令安装路径排查 PATH 问题7claude doctor自动诊断安装、认证、网络、配置等环境8claude --help查看当前版本支持的全部 CLI 参数node -v看起来不起眼但它是我见过安装失败最常见的原因。Claude Code 官方对 Node 版本有底线要求如果你还在用 Node 16 甚至更老装的时候不会立刻报错一启动就各种奇怪问题。先把 Node 升到 18 以上再继续比事后排查省时间得多。claude doctor是很多人忽略的救命命令。它会把安装、登录状态、API 连通性、配置合法性一次检查完。如果你看到类似 “unable to connect to anthropic services” 的报错不要上来就重装先跑claude doctor再看是不是网络出口没放行api.anthropic.com。这类问题多半是环境问题不是 Claude Code 本身坏了。2.2 启动与认证第 9~20 条编号指令什么时候用9claude在当前目录启动交互式会话10claude 你的问题一条命令完成简单问答不进入交互模式11claude -p 你的问题全自动的非交互模式适合脚本和管道12claude --continue继续最近的会话13claude --resume列出历史会话并选择恢复14claude --model sonnet 你的问题临时指定模型执行一次任务15/login在会话内完成账号登录或重新认证16/logout退出当前账号17claude config list查看当前生效的全部配置18claude config get theme查看单项配置的值19claude config set -g theme dark修改全局配置-g表示写入用户级20claude config set -g model sonnet设置默认模型省得每次加--model第 9 到第 11 条是三种最基础的启动姿势。第 9 条适合长时间开发第 10 条适合临时问问题第 11 条适合脚本调用比如git diff | claude -p 帮我写提交信息这种管道用法后面会专门展开。第 12 和第 13 条的区别要记清楚--continue是无脑接着最近一次会话走--resume会给你一个历史会话列表让你挑。早上开始干活时我通常用claude --continue接上昨天没做完的任务。认证部分第一次使用会走一次登录流程之后如果提示认证过期先进会话敲/login不要在多个窗口里重复登录反而容易把 token 搞乱。claude config set这套命令在 Windows、macOS、Linux 上通用唯一区别是 Windows 里查命令路径用where.exe claudemacOS 和 Linux 用which claude。VSCode 的集成终端、Claude Code 桌面端也都复用同一套 CLI所以这些命令在哪个入口都成立。3. 会话与上下文20 条指令让 AI 不“失忆”Claude Code 最大的优势是能记住长上下文但这也会成为最大的坑。会话越长上下文占用越高AI 的反应会变慢、变笨甚至开始“忘记”最早的需求。这一组指令就是用来管理对话生命周期的。3.1 会话状态与上下文压缩第 21~30 条编号指令什么时候用21/status查看当前会话状态、模型、token 消耗22/context查看上下文占用比例判断是否该压缩23/compact把当前历史压缩成摘要释放上下文24/clear清空当前会话历史重新开始25/rewind回退到指定操作节点相当于对话级后悔药26/resume在会话内恢复之前的对话27/model查看或切换当前会话使用的模型28/init生成项目级CLAUDE.md让 AI 记住项目规范29/memory写入长期记忆跨会话保留你的偏好30/add-dir把一个目录整体加入上下文每天开始工作时我的第一件事不是直接丢需求而是先/status看这次会话用的什么模型、还剩多少额度再/context看上下文占用。如果占用已经超过 80%就直接claude --continue开新会话而不是硬着头皮在一个旧会话里继续堆。/compact和/clear千万别搞混。/compact是把已有历史压缩成摘要AI 还能记住大概脉络适合任务还没做完但上下文快满的情况。/clear是彻底清空适合换个完全不相关的需求。压缩之前我习惯先让 AI 输出一份“当前进度清单”确认关键结论已经落到某个文件或者/memory里再执行压缩这样即使摘要丢细节核心决策也留得住。/rewind是我最爱的命令之一。它回退的是对话节点不是 git 提交。比如 AI 改错了思路、写了一段不该写的代码你可以回退到它动手之前的那个节点重新引导。但要注意/rewind不会自动撤销已经写入磁盘的文件修改回退之后那些文件改动还在需要你自己用编辑器或 git 处理。3.2 上下文扩展与会话退出第 31~40 条编号指令什么时候用31/add-file把具体文件加入上下文让 AI 精读32/config打开当前项目的配置文件进行编辑33/permissions查看当前会话的权限状态34/allowed-tools查看当前允许的工具白名单35/mcp管理 MCP 服务器查看连接状态36/help查看当前版本所有 Slash 命令37claude --session-id id用指定会话 ID 启动适合接续特定任务38claude --continue 接着完成之前的任务带指令继续最近会话39claude -p ... --output-format json非交互模式输出结构化 JSON适合脚本解析40CtrlC/CtrlD中断当前输出或退出会话/add-file和/add-dir用得越精确token 浪费越少。不少人的习惯是直接说“你读一下这个项目”Claude Code 会扫描大量文件上下文一下子就满了。更聪明的做法是先用/status看项目结构再按需/add-file把关键文件加进去。上下文就像你的短期记忆别让它装无关紧要的东西。第 37 到第 39 条适合自动化场景。在 CI 脚本里我常用claude -p 运行测试并修复失败用例 --output-format json这样返回的结果可以被下游脚本解析而不是一大段人类可读文本。第 40 条CtrlC是按错了请求时的救命稻草长输出来不及看先中断再重新组织指令比干等省时间。4. 文件、代码与重构20 条高频“边界指令”这一组不是 Slash 命令而是你直接输入给 Claude Code 的自然语言指令。我故意把它们也收进“常用指令”是因为实际开发中这些边界指令比任何命令都重要。AI 代码能力的上限不取决于模型而取决于你有没有把边界划清楚。4.1 只看不改的信息收集第 41~50 条编号指令什么时候用41先只读不要修改任何文件给我一份项目结构说明新接手项目时先建立全局认知42读取 src/utils/date.ts让 AI 精读单个文件43搜索仓库里所有 TODO/FIXME按文件分组列出找历史遗留问题44找出 src 下没有被引用的导出死代码清理前的分析45比较 a.ts 和 b.ts列出差异代码差异对比46清理未使用的 import保持原有命名风格小范围代码整理47将 utils/slack.ts 中的 send 函数加上可选重试带明确路径的修改需求48只改 config 模块其他一行都不要动严格控制改动范围49先列出改动清单确认后再动手大改动前的安全确认50按依赖关系拆分这个 300 行函数保留公开签名复杂函数重构第 41 条是我每次接手新仓库的第一句话。“先只读”三个字能避免 AI 自作主张改文件。Claude Code 本身有权限系统但你还是要在指令层面加上这层保险因为权限只决定“能不能做”不决定“该不该做”。第 49 条配合权限模式非常好用。当我让 AI 做一个跨多文件的重构时会先让它“只列方案不写代码”我会在旁边标注哪些方案可行再让它进入执行。这会多花一轮交互但省掉大量返工。真正在一线写过代码的人都知道AI 写代码最大风险不是写得不对而是方向一开始就错了等它写完几十处再回退代价太大。第 50 条的关键词是“保留公开签名”。重构类需求AI 往往会顺手改掉接口名、参数顺序导致调用方连锁报错。把这个边界写进指令比事后 review 有效得多。4.2 修改、测试与交付第 51~60 条编号指令什么时候用51为 xxx 增加错误处理不要改变正常路径加固异常分支52在关键分支加结构化日志提升可观测性53为 Button 组件补测试覆盖 disabled 和 loading组件测试补充54运行 npm test只关注失败的用例缩小测试关注范围55修复刚才测试里失败的那个用例不要顺手重构修 bug 时避免引入无关改动56用 TypeScript 严格模式重写这段代码类型收紧57这段代码复杂度为什么高给 3 个方案并选一个让 AI 先分析再执行58生成 README 的快速开始部分文档生成59按字母序整理 import但不要用 formatter 改其他格式限定格式改动范围60删除不再使用的文件之前先检查引用并告诉我删除操作前的安全检查第 51、55、59 这类“不要改变其他东西”的指令是控制 AI 执行边界的核心。我给 Claude Code 提修改类需求时几乎固定带着三个词范围、风格、禁止项。范围指改哪个文件哪个函数风格指保持原有命名和代码风格禁止项指“不要顺手重构”“不要格式化无关代码”。缺少任何一个都可能得到一个“看起来很好但破坏了你项目”的 diff。第 54 条和第 55 条放在一起用效果最好。先让它跑测试拿到失败信息然后只修失败用例不要顺手做任何额外优化。很多开发者让 AI 修测试结果它把被测试的业务代码也重构了测试是绿了业务逻辑却变了。修 bug 和重构是两件事永远拆开。5. Git、测试与自动化第 61 到 80 条Claude Code 真正的效率爆发点是把它接到 Git 流程里。大部分提交信息、PR 描述、变更风险分析都不该由人手动写应当由 AI 根据 diff 生成人来判断。5.1 Git 信息收集与提交第 61~70 条编号指令什么时候用61git status先看工作区当前状态62git diff查看未暂存的改动63git diff --cached查看已暂存改动64git log --oneline -10快速看最近 10 条提交65git branch --show-current确认当前所在分支66git diffclaude -p 写一条 Conventional Commits 提交信息67git diff main...HEADclaude -p 列出主要改动和风险68claude review 当前分支只讲逻辑风险代码评审限定只看逻辑69claude 把工作区改动按模块拆成多个 commit大量改动时代替手工分拣70claude 为当前分支写 PR 描述包含背景、改动和测试生成 PR 描述草稿第 66 条是我个人最喜欢的管道用法。git diff | claude -p ...的精髓在于Claude Code 能直接读到 diff 内容你不需要复制粘贴不需要给它解释改了什么它自己就能生成提交信息。用-p模式加管道整个过程不会进入交互界面非常适合在命令行里连招。第 67 条是合并分支前的一道保险。main...HEAD表示“从 main 分支分叉点到当前 HEAD 的所有改动”Claude Code 会列出这个分支到底动了什么哪里可能引入回归哪里会影响已有接口。这个习惯帮我挡过不止一次合错代码。第 68 条要特别强调“只讲逻辑风险”不然 AI 会把你十分钟前刚写的话重复一遍还会附带一堆格式建议。你真正需要的是它对边界条件、错误处理、并发冲突这些深度问题的判断。把评审范围收窄输出质量会明显上升。5.2 测试与自动化执行第 71~80 条编号指令什么时候用71claude 运行受影响的测试让 AI 自己判断哪些测试受影响72npm test -- --run src/components/Header.test.tsx手动指定单测文件73claude 修复失败用例保持测试意图不变只修测试不修断言意图74claude -p 扫描项目里疑似硬编码的密钥安全巡检75claude -p 运行测试 --output-format stream-json以实时 JSON 流输出测试过程76claude -p 运行 lint 并输出报告 --verbose详细模式跑静态检查77claude --debug 复现一下这个 bug开启调试模式追踪问题78claude 给脚本加上 --dry-run 参数不要真正执行让 AI 改出安全版本79claude 执行 lint 并修复但不要改公开 API自动修复但守住接口边界80git stash listclaude -p 整理这些 stash 的用途第 75 条的stream-json输出格式特别适合 CI。你可以在 GitHub Actions 或 GitLab CI 里跑一句claude -p 运行测试并修复 --output-format stream-json实时收到每一步事件失败了也能拿到结构化错误信息。这比把一大段终端输出塞进日志里好查得多。第 78 条是我给所有“高风险命令型需求”加的前置条件。凡是涉及删除、批量替换、移动文件的操作我都会让 AI 先加--dry-run参数只看它会做什么再决定要不要真正执行。Claude Code 的权限系统能拦住“它做什么”但拦不住“你自己 5 秒前允许它做什么”所以设计安全命令本身也是一种能力。6. 权限、模型切换与 API 定制最后 20 条保命指令最后这一组看起来不如“改代码”兴奋但在真实项目里最保命。权限管不好轻则 AI 不停弹确认框重则它删掉你不想删的文件。模型切不好成本翻几倍不一定效率和效果还未必对。6.1 权限护栏第 81~87 条编号指令什么时候用81/permissions查看当前会话的权限配置82/allowed-tools查看当前允许的工具白名单83claude --permission-mode plan只出方案不执行适合重构前84claude --permission-mode acceptEdits文件编辑操作免确认减少打断85claude --allowedTools Read,Edit只允许读文件和编辑文件86claude --disallowedTools Bash禁止 AI 执行任何 shell 命令87claude --dangerously-skip-permissions跳过所有权限确认只在可信环境用第 83 条的plan模式是我日常使用率最高的启动参数之一。这个模式下 Claude Code 不会实际改文件、跑命令而是先给你一份完整方案。复杂重构、多文件修改、新功能设计我都先用plan模式跑一遍确认思路对了再用正常模式执行。很多人觉得自己盯着 AI 写就行其实看方案比看代码省力得多。第 87 条--dangerously-skip-permissions是非常危险的一个参数但它确实存在于日常命令里。我的原则是只在你完全信任的脚本、一次性容器、或者你明确知道当前目录不会造成灾难性后果时使用。比如在 CI 里跑一个纯静态检查任务可以跳过权限确认但在本地开发仓库里我几乎不用。人总会犯困、手滑权限系统就是你下班后的第二双眼睛。6.2 模型切换与 API 定制第 88~100 条编号指令什么时候用88claude --model sonnet常规编码任务用性价比型号89claude --model opus高难度架构分析用强推理型号90/model会话进行中临时切换模型91export ANTHROPIC_MODEL...设置默认模型对所有会话生效92export ANTHROPIC_SMALL_FAST_MODEL...指定后台小模型的型号93export ANTHROPIC_API_KEY...使用自己的 API Key94export ANTHROPIC_AUTH_TOKEN...使用兼容服务的 Token95export ANTHROPIC_BASE_URL...自定义 API Base URL96claude config set -g model ...把默认模型写入全局配置97claude config get model查看当前默认模型配置98unset ANTHROPIC_API_KEY清掉当前 shell 里的 Key99env | grep ANTHROPIC检查当前注入了哪些相关环境变量100echo export ANTHROPIC_MODEL... ~/.zshrc source ~/.zshrc持久化默认模型配置模型选择的大原则是常规重构、写测试、改样式、搜索代码这些任务用 sonnet 这类性价比型号完全够用只有涉及复杂架构决策、跨系统调试、大量代码推理时才值得切到 opus。切换指令不复杂难的是克制。把什么都丢给最强模型成本会变成一场灾难。如果你的环境需要接入 DeepSeek 或其他兼容 Anthropic 协议的服务核心不是改 Claude Code 代码而是正确设置环境变量。基本套路是这样export ANTHROPIC_BASE_URLhttps://你的网关地址 export ANTHROPIC_AUTH_TOKEN你的Token export ANTHROPIC_MODELdeepseek-chat第 93 到第 95 条这三个变量是“三件套”ANTHROPIC_API_KEY和ANTHROPIC_AUTH_TOKEN按服务商要求二选一ANTHROPIC_BASE_URL指向兼容地址。升级时如果发现连接失败先env | grep ANTHROPIC看变量有没有被重复注入再claude config get model看默认模型是否真的存在。这类问题十有八九是配置没生效而不是工具坏了。7. 百条之外我更依赖的扩展与组合用法命令本身不是目的组合起来形成工作流才是。这一节记录的扩展用法不属于刚才那一百条的编号范围但我在日常开发中依赖程度不亚于任何一条。7.1 Skills 安装其实不用额外命令Claude Code 的 Skills 本质上是给 Agent 准备的技能包安装方式比想象中简单把SKILL.md放进~/.claude/skills/技能名/或项目的.claude/skills/技能名/目录。比如我想给提交信息定制一个固定风格可以这样建目录mkdir -p ~/.claude/skills/commit-helper touch ~/.claude/skills/commit-helper/SKILL.md然后用编辑器打开SKILL.md写清楚触发词、步骤和输出格式。换新机器时只要备份~/.claude/skills目录所有技能就都带过去了。这比在系统提示词里写一堆规则稳定得多。7.2 我的早晨和收尾组合早晨开工我一般是三连先claude --continue接上昨天会话然后/status看状态再丢一句“把当前进度整理成下一步行动清单”。这样十分钟内就能回到工作状态不用重新回忆上下文。收尾时必做两件事。第一git diff | claude -p 写提交信息生成提交信息第二claude review 当前分支只讲逻辑风险做一轮低成本评审。这两步加起来不到一分钟但能显著减少“三天后回看不知道自己当时在干嘛”的情况。7.3 建议你先背熟的五条如果你现在只想记住一小部分我强烈建议先把这五条练成本能/status看状态、/context看上下文、/compact压缩历史、claude -p做管道输入、claude --permission-mode plan做安全启动。这五条覆盖了安装之后最核心的日常场景。熟练之后再根据你自己的项目类型从前面的一百条里挑出高频项慢慢建立属于你自己的命令集。我在实际项目里踩过的最深的一个坑是一开始把所有希望寄托在“模型更强”上后来才发现把工具本身的各种指令摸透提升比换模型大得多。Claude Code 这类 Agent 工具本质上是在放大你的工作方法而不是替你思考。指令就是你和它之间的沟通协议协议越清晰结果越可控。