每条带交叉核查 verdict · 不是另一份 README 摘录
对齐 Claude Code v2.1.316 · 182/182 条深度指南已核查 · 最后更新 2026-11-02
Claude Code 命令 Cheatsheet 2026
182/182 命令已完成深度核查 · 100% 通过来源核验 · drift 跟踪到 v2.1.316速查表覆盖全部 316 个命令（含未核查）。
本页是 Claude Code 全部 slash 命令、CLI 子命令、Hook 事件、启动参数 的速查表，按类型分四节，每条命令一行一句话描述。和其他 cheatsheet 不同的地方是，每条命令带一个交叉核查 verdict —— 我们把官方文档、 GitHub 源码、社区文章三路材料逐条对照，标出哪条断言被官方支持、 哪条只在社区里看到、哪条只是博主推测。点开命令名进详情页，可以看到 完整版本演进史、长文使用指南和来源列表。
数据每次官方 changelog 更新后自动重抽，verdict 跟随 Claude Code 主线 patch 跑 verifier。本页适合打印贴墙、放在新人 onboarding wiki、 或在 sprint planning 时快速对照"我们没用的能力还有哪些"。
常见任务 → 推荐命令
带可信度徽章「我现在想做 X，该用哪个命令？」按场景查。每个推荐命令带一个交叉核查 verdict 徽章 —— 这是参考站的纯命令列表给不了的：你不仅知道用哪个，还知道 这条建议背后的命令文档被官方支持到什么程度。点命令名进详情页。
开新会话 / 会话管理
| 想做的事 | 推荐命令 |
|---|---|
| 第一次在某个项目里用 Claude Code，想生成 CLAUDE.md |
|
| 回到昨天没做完的会话 |
|
| 给当前会话起个好记的名字方便以后跳回 |
|
| 动手前先让 Claude 出方案、理清改动顺序（规划） |
|
上下文管理
代码评审
| 想做的事 | 推荐命令 |
|---|---|
| 在终端里快速 review 当前 diff，迭代中拿反馈 |
|
| 要更细的正确性 + 复用/简化/效率清理建议 |
|
| 专门找有真实利用路径的安全漏洞 |
|
Git & PR
| 想做的事 | 推荐命令 |
|---|---|
| 查看 / 回应 PR 上的评论 |
|
| 让 Claude Code 接入 GitHub 做自动 PR 审查 |
|
| 看本地改了哪些文件 |
|
配置
| 想做的事 | 推荐命令 |
|---|---|
| 改模型 / 主题 / 各类设置 |
|
| 切换使用的模型 |
|
| 配置事件钩子（提交前跑 lint 等） |
|
| 管理权限 / 减少授权弹窗 |
|
| 接入外部工具 / 数据源 (MCP) |
|
| 日常管理记忆 / 给项目加规则 |
排障
| 想做的事 | 推荐命令 |
|---|---|
| Claude Code 行为异常，先做一轮自检 |
|
| 抓详细日志定位问题 |
|
| 怀疑是新版本/插件引入的问题，想要最小化环境启动 |
|
并行任务
| 想做的事 | 推荐命令 |
|---|---|
| 把当前长任务丢后台，腾出终端做别的 |
|
| 让 Claude 拆子任务并行跑，结果别塞满主对话 |
|
| 统一查看所有后台会话的状态 |
|
跨命令横向选型表
高频二选一/三选一几组最容易搞混的命令，集中抽成决策表对照着选。每格内容取自对应命令已核查 的深度指南「同类对比」段（不新造事实），列头命令带 verdict 徽章。
/clear vs /compact vs /rewind
上下文要不要留、能不能回退，三选一。
| /clear已核查 | /compact已核查 | /rewind已核查 | |
|---|---|---|---|
| 做什么 | 彻底清空上下文 | 把历史替换成摘要 | 回到某个自动检查点 |
| 上下文去向 | 全部丢弃，从零开始 | 保留压缩摘要作为新起点 | 恢复到快照时的文件/对话状态 |
| 典型场景 | 换一个完全无关的新任务 | 上下文快满但想接着当前任务做 | 误操作回退；v2.1.191 起可回到 /clear 之前 |
据 compact.md「与 /clear 的根本区别」、rewind.md 检查点与 v2.1.191 恢复 /clear 前能力。
/review vs /code-review vs /security-review
三个审查命令，按目标和运行位置选。
| /review已核查 | /code-review已核查 | /security-review已核查 | |
|---|---|---|---|
| 审查目标 | 快速通用审查 | 正确性 + 复用/简化/效率清理（v2.1.151+） | 高置信度安全漏洞 |
| 运行位置 | 本地会话，单遍 | 本地会话 | 本地，针对待处理变更 |
| 适用时机 | 迭代中快速拿反馈 | 提交前更细的本地审查，无需 GitHub App | 上线前安全专项，带严重级与修复建议 |
据 review.md/code-review.md/security-review.md 各自定位段。注：托管 Code Review（GitHub App、多 agent、inline PR 评论）需 Team/Enterprise。
/plan vs /ultraplan vs /workflows
先规划再动手，还是把大编排交出去——按规划在哪跑、要不要可复用选。
| /plan已核查 | /ultraplan已核查 | /workflows已核查 | |
|---|---|---|---|
| 做什么 | 进只读 plan mode 出执行计划 | 把规划卸载到云端再审阅 | 监控/管理动态工作流（脚本编排数十到上千 agent） |
| 在哪跑 | 本地 CLI（规划期占用终端） | Anthropic 云端（终端仍可用） | 本地后台 runtime |
| 典型场景 | 动手前理清改动范围与顺序 | 大改动想边规划边干别的、想从计划直接出 PR | 大型迁移/全 repo 审计/深度研究等大编排 |
| 前置要求 | 无 | Pro+ 且连 GitHub 仓库（v2.1.91+,research preview） | v2.1.154+;Pro 需在 /config 开 Dynamic workflows |
据 plan.md「同类原语对比」、ultraplan.md 云端规划要求、workflows.md 规模与版本/开关约束。注：/plan 是规划模式，/workflows 是大编排面板，二者解决不同层级问题。
/agents vs /background（并行工作怎么编排）
谁来协调、结果放哪，二选一。
| /agents已核查 | /background已核查 | |
|---|---|---|
| 协调方 | Claude 编排 subagent | 你来协调（配 claude agents 视图） |
| 适用场景 | 侧任务结果会塞满主对话时 | 有几个独立任务想交出去偶尔检查 |
| 结果归属 | subagent 结果隔离，不污染主对话 | 整个会话分离为后台 agent |
据 background.md「跟同类原语对比」（归因官方 agents 页 Choose an approach 列表）。注：token 用量随并行会话数叠加。
过滤下方命令表
Slash 命令
127 个会话内打 / 触发，控制 Claude Code 自身行为（模型、记忆、上下文、子代理）。
| 命令 | 语法 | 用途 | 核查 | 复制 |
|---|---|---|---|---|
| /add-dir | — | 为当前会话添加工作目录以用于文件访问 | 已核查4 个来源 | |
| /advisor | /advisor [model|off] | 开关 advisor 工具——在任务关键时刻咨询第二个模型获取指导。接受 opus / sonnet / fable（v2.1.170+）或完整 model ID；不带参数则打开选择器。需 v2.1.98+。 | 已核查2 个来源 | |
| /agents 已移除 | — | 创建和管理自定义 subagent（让 Claude 生成/管理，或直接编辑 .claude/agents/）。注：v2.1.198 已移除 /agents 的交互式向导面板。 | 已核查5 个来源 | |
| /allowed-tools 已移除 | — | 已重命名为 /permissions | — | |
| /approved-tools | — | 新增 /approved-tools 斜杠命令用于管理工具权限 | — | |
| /artifacts | /artifacts | 列出你拥有或与你共享的 artifacts，可在当前会话中附加、用浏览器打开或复制链接 | 1 处待复核 | |
| /autocompact | /autocompact [auto|<tokens>] | 设置上下文占用达到多少比例（或多少 token）时触发自动压缩 | 1 处待复核 | |
| /autofix-pr | /autofix-pr [prompt] | 启动远程会话自动修复 PR 中的 CI 失败 | 已核查5 个来源 | |
| /background | /background [prompt] | 将当前会话后台运行并释放当前终端 | 已核查5 个来源 | |
| /batch | /batch <instruction> | 并行编排大规模代码库变更和提交 | 已核查6 个来源 | |
| /bg | — | 修复了导致通道连接断开的问题 | — | |
| /branch | /branch [name] | 在当前位置创建对话分支以保留原始会话 | 已核查5 个来源 | |
| /btw | /btw <question> | 提出快速旁问而不添加到对话 | 已核查5 个来源 | |
| /buddy | — | 孵化一个在旁观看你编码的交互式小生物。 | 1 处待复核5 个来源 | |
| /bug | — | 修了 `/bug` 在 Ctrl+O 或 Ctrl+Z 后重新开始报告的问题 | — | |
| /cd | /cd <path> | 将当前会话整体迁移到一个新的工作目录，保留对话的 prompt cache（区别于只额外挂目录的 /add-dir）。需 v2.1.169+。 | 已核查2 个来源 | |
| /checkup | — | 添加了 prompt-audit 子命令，作为 /doctor 的别名 | — | |
| /chrome | — | 配置 Claude 在 Chrome 浏览器中的设置 | 已核查4 个来源 | |
| /claude-api | /claude-api [migrate|managed-agents-onboard] | 加载项目语言的 Claude API 参考和代理文档 | 已核查5 个来源 | |
| /claude-api upgrade | /claude-api [migrate|upgrade|...] | 将项目中的 Anthropic SDK 依赖跨主要版本升级（目前指 Python `anthropic` 包从 0.x 升级到 1.x） | 1 处待复核 | |
| /clear | /clear | 使用空上下文开始新对话并保留前一个 | 已核查5 个来源 | |
| /code-review | /code-review [low|medium|high|max] [--comment] [target] | 检查当前 diff 中的代码正确性缺陷并报告 | 已核查5 个来源 | |
| /color | /color [color|default] | 为当前会话设置提示栏的颜色主题 | 已核查5 个来源 | |
| /commit-push-pr | — | 一键提交、推送并创建 PR，配置 MCP 时还会把 PR URL 发到 Slack。 | 已核查5 个来源 | |
| /compact | /compact [instructions] | 通过汇总对话内容来释放上下文空间 | 已核查5 个来源 | |
| /config | — | 打开设置界面调整主题、模型等偏好 | 已核查5 个来源 | |
| /context | /context | 可视化当前上下文使用情况和优化建议 | 已核查5 个来源 | |
| /copy | /copy | 将最后的助手响应复制到剪贴板 | 已核查5 个来源 | |
| /cost | — | 显示使用成本和计费统计信息 | 已核查5 个来源 | |
| /dataviz | /dataviz [request] | 图表 / 仪表板设计指导（bundled skill）：按数据选图表形式、按角色分配颜色、用内置脚本校验调色板的色盲安全与对比度，并应用标记 / 交互 / 无障碍规则。需 v2.1.198+。 | 已核查3 个来源 | |
| /debug | /debug [description] | 启用调试日志并诊断排查会话问题 | 已核查5 个来源 | |
| /deep-research | /deep-research <question> | bundled workflow：对一个问题并行展开 web 搜索、抓取并交叉核验来源，综合产出一份带引用的研究报告。 | 已核查2 个来源 | |
| /design consent | — | 修复云会话中失败时仍提示使用 /design-login 的问题，改为指向 claude.ai/design/settings。 | — | |
| /design revoke | — | 修复云会话中失败时仍提示使用 /design-login 的问题，改为指向 claude.ai/design/settings。 | — | |
| /design-login | — | 新增提示：独立版 Claude Design（claude.ai/design）将于 2026 年 12 月 14 日关闭。 | — | |
| /design-sync | — | 新增提示：独立版 Claude Design（claude.ai/design）将于 2026 年 12 月 14 日关闭。 | — | |
| /desktop | — | 在 Claude Code Desktop 应用中继续会话 | 已核查5 个来源 | |
| /diff | /diff | 打开交互式 diff 查看器显示未提交更改 | 已核查4 个来源 | |
| /doctor | — | 诊断并验证 Claude Code 的安装和设置 | 已核查4 个来源 | |
| /effort | /effort [level|auto] | 设置模型工作难度级别从低到最高 | 已核查4 个来源 | |
| /env | — | 为会话设置环境变量，同时应用于 Bash 和 PowerShell 工具命令。 | 1 处待复核5 个来源 | |
| /exit | — | 退出 CLI 或从后台会话中分离 | 已核查5 个来源 | |
| /export | /export [filename] | 将当前对话导出为纯文本格式或保存文件 | 已核查5 个来源 | |
| /extra-usage 已弃用 | /extra-usage | /usage-credits 的旧名称：配置达到用量限制后继续工作的额外用量。该命令已更名，现请使用 /usage-credits。 | 已核查2 个来源 | |
| /fast | /fast | 切换快速模式的开启或关闭状态 | 已核查4 个来源 | |
| /feedback | /feedback | 提交反馈、报告错误或分享对话 | 已核查5 个来源 | |
| /focus | — | 切换焦点视图仅显示最后提示和工具摘要 | 已核查5 个来源 | |
| /fork 已弃用 | /fork <directive> | 把当前对话复制进一个全新的后台会话（在 claude agents 里独占一行），继承到此刻为止的完整上下文，你在主会话继续工作。v2.1.212 起为此语义（会话内 subagent 能力已移到 /subtask）；v2.1.221 起 forked 会话使用独立 git worktree。 | 已核查2 个来源 | |
| /goal | /goal [condition|clear] | 设置目标使Claude持续工作直到条件满足 | 已核查5 个来源 | |
| /heapdump | — | 写入堆快照和内存分解以诊断高内存使用 | 已核查4 个来源 | |
| /help | — | 显示帮助信息和可用的所有命令 | 已核查5 个来源 | |
| /hooks | — | 查看和管理工具事件的Hook配置 | 已核查5 个来源 | |
| /ide | — | 管理IDE集成并显示集成状态 | 已核查4 个来源 | |
| /init | — | 使用CLAUDE.md指南初始化项目 | 已核查5 个来源 | |
| /insights | — | 生成分析Claude Code会话的报告 | 已核查5 个来源 | |
| /install-github-app | — | 为仓库设置Claude GitHub Actions应用 | 已核查5 个来源 | |
| /keybindings | — | 打开或创建快捷键配置文件 | 已核查4 个来源 | |
| /less-permission-prompts | — | 新增技能命令，扫描转录内容并提议 allowlist 配置 | — | |
| /list-agents | /list-agents | 列出可发送消息的子代理、agent team 队友及其他 Claude Code 会话及其使用名称 | 1 处待复核 | |
| /login | — | 登录Anthropic账户并验证身份 | 已核查4 个来源 | |
| /logout | — | 登出Anthropic账户并清除会话 | 已核查5 个来源 | |
| /loop | /loop [interval] [prompt] | 重复运行提示直到会话关闭 | 已核查5 个来源 | |
| /mcp | — | 管理MCP服务器连接和OAuth认证 | 已核查4 个来源 | |
| /memory | — | 编辑memory文件并管理自动memory功能 | 已核查4 个来源 | |
| /mobile | — | 显示二维码下载Claude移动应用 | 已核查5 个来源 | |
| /model | /model [model] | 设置当前会话使用的AI模型 | 已核查5 个来源 | |
| /name | — | 修了重复的 `/name` 让 Claude 调用保留 skill 的问题 | — | |
| /output-style 已弃用 | — | 修复 /output-style 保存设置时不询问插件 config.set hook 的问题。 | — | |
| /permissions | — | 管理工具权限的允许、询问和拒绝规则 | 已核查6 个来源 | |
| /plan | /plan [description] | 直接从提示进入计划模式执行任务 | 已核查5 个来源 | |
| /plugin | — | 管理Claude Code的插件配置 | 已核查5 个来源 | |
| /plugin install | — | 改变了此命令刷新过期市场目录并在报告未找到前重试的行为 | — | |
| /plugin list | — | 新增命令以列出已安装的插件 | — | |
| /plugins | — | 修复关闭 /plugins 面板对话框后在记录中遗留 '(no content)' 行的问题 | — | |
| /poll | — | Remote Control 的轮询命令，定期（现为每 10 分钟）拉取远程指令。 | 已核查5 个来源 | |
| /powerup | — | 通过快速交互课程发现Claude Code功能 | 已核查4 个来源 | |
| /proactive | — | /loop 的别名，按设定间隔反复运行某个 prompt 或 slash 命令。 | 已核查5 个来源 | |
| /radio | — | 在浏览器中打开 Claude FM lo-fi 电台 | 已核查3 个来源 | |
| /rate-limit-options | — | 配置 usage limit（用量上限）的斜杠命令 | 2 处待复核 | |
| /recap | — | 生成当前会话的一行摘要 | 已核查4 个来源 | |
| /release-notes | — | 在交互版本选择器中查看变更日志 | 1 处待复核4 个来源 | |
| /reload-plugins 已弃用 | — | 重新加载活跃插件应用待处理变更 | 已核查5 个来源 | |
| /reload-skills | /reload-skills | 重扫 skill 与 command 目录，让会话期间在磁盘上新增或改动的 skill 不必重启即可用；会报告可用/新增/移除数量。需 v2.1.152+。 | 已核查2 个来源 | |
| /remote-control | — | 使此会话可从 claude.ai 远程控制 | 已核查4 个来源 | |
| /remote-env | — | 配置网络会话的默认远程环境 | 已核查5 个来源 | |
| /rename | /rename [name] | 重命名当前会话并在提示栏（prompt bar）显示；不带参数时从对话历史自动生成名称 | 1 处待复核5 个来源 | |
| /resume | /resume [session] | 通过 ID 或名称恢复会话或打开选择器 | 已核查5 个来源 | |
| /review | /review [PR] | 在本地会话中查看和审查 pull request | 已核查5 个来源 | |
| /rewind | — | 将对话和代码倒回到之前的点 | 已核查5 个来源 | |
| /sandbox | — | 切换沙箱模式提高安全性 | 已核查4 个来源 | |
| /schedule | /schedule [description] | 创建更新或运行在云基础设施执行的例程 | 已核查4 个来源 | |
| /scroll-speed | — | 交互式调整鼠标滚轮滚动速度 | 已核查5 个来源 | |
| /security-review | — | 分析待处理变更的安全漏洞风险 | 已核查5 个来源 | |
| /settings | — | 修复 VSCode 中用户命令被 shadow 的 bug | — | |
| /setup-bedrock | — | 配置 Amazon Bedrock 认证和模型 | 已核查4 个来源 | |
| /setup-vertex | — | 配置 Google Vertex AI 认证和模型 | 已核查5 个来源 | |
| /share | — | 修了 `/share` 在 Ctrl+O 或 Ctrl+Z 后重新开始报告的问题 | — | |
| /simplify | /simplify [target] | 独立 cleanup-only review skill：四个 review agent 并行检查代码复用、简化、效率与抽象层级并直接应用修复（不查 correctness bug，查 bug 用 /code-review）。v2.1.154+ 起为独立 skill；更早等价于 /code-review --fix。 | 已核查2 个来源 | |
| /skill | — | 改进了在消息中输入 skill 名称的处理，Claude 现在能将它们识别为 skill | — | |
| /skill-doctor | — | 显示已加载技能中未被使用的技能及其占用的 context 成本，便于清理精简 | 1 处待复核 | |
| /skills | — | 列出可用 skills 和隐藏不需要的 | 已核查5 个来源 | |
| /stats | — | 打开统计标签显示使用情况 | 已核查5 个来源 | |
| /status | — | 打开设置界面显示版本模型和连接 | 已核查5 个来源 | |
| /statusline | — | 配置 Claude Code 的状态行显示信息 | 已核查4 个来源 | |
| /stop | — | 停止当前后台会话并保留记录 | 已核查5 个来源 | |
| /subtask | /subtask <directive> | 派生一个会话内 subagent，继承到此刻为止的完整对话在后台干活，完成后把结果回传当前会话。v2.1.212 新增——即 v2.1.212 之前 /fork 所做的事。 | 已核查2 个来源 | |
| /t | — | 在当前 prompt 中临时禁用 thinking mode。 | 已核查5 个来源 | |
| /tag 已移除 | — | 为会话打标签/命名，便于之后从不同目录恢复到对应会话（已于 v2.1.92 移除）。 | 已核查5 个来源 | |
| /tasks | — | 列出和管理后台任务及相关信息 | 已核查5 个来源 | |
| /team-onboarding | — | 从使用历史生成团队入门指南 | 已核查5 个来源 | |
| /teleport | — | 将当前终端会话推送到网页版 Claude Code (claude.ai/code) | 已核查5 个来源 | |
| /terminal-setup | — | 配置Shift+Enter等终端快捷键 | 已核查4 个来源 | |
| /theme | — | 更改终端配色主题和样式 | 已核查5 个来源 | |
| /todos | — | 修复 /todos 命令覆盖层意外关闭的问题 | — | |
| /tui | /tui [default|fullscreen] | 设置终端UI渲染器并重启会话 | 已核查5 个来源 | |
| /ultraplan | /ultraplan <prompt> | [已于 v2.1.222 移除] 曾把规划阶段卸载到 Anthropic 云端容器生成计划草稿。changelog v2.1.222 "Removed ultraplan feature"，命令及特性不再可用。 | 已核查5 个来源 | |
| /ultrareview | /ultrareview [PR] | 运行深层多agent代码审查 | 已核查5 个来源 | |
| /undo | — | 新增 /rewind 的别名 | — | |
| /update | /update | 立即应用 Claude Code 的待装更新，等价于命令行 claude update，无需等待后台自动检查。 | 已核查2 个来源 | |
| /upgrade | — | 打开升级页面切换计划等级 | 已核查5 个来源 | |
| /usage | — | 显示会话成本和订阅使用统计 | 已核查5 个来源 | |
| /usage-credits | — | 配置 usage credits（原 /extra-usage）：达到计划用量限制后，以额外信用额度继续工作 | 已核查5 个来源 | |
| /verify | — | 通过构建运行确认代码改动 | 已核查5 个来源 | |
| /vim 已移除 | — | 切换Vim和Normal编辑模式 | 已核查5 个来源 | |
| /voice | /voice [hold|tap|off] | 开启或配置语音听写模式 | 已核查5 个来源 | |
| /web-setup | — | 连接GitHub账户以使用网页版功能 | 已核查4 个来源 | |
| /workflows | /workflows | 会话内管理面板：列出本会话正在运行或已完成的 dynamic workflow，用于监控进度、查看结果、暂停、停止与重启。需 v2.1.154+。 | 已核查2 个来源 |
CLI 子命令
57 个终端里 claude 后面跟的子命令，做安装、登录、MCP、daemon 等会话外操作。
| 命令 | 语法 | 用途 | 核查 | 复制 |
|---|---|---|---|---|
| claude agents | claude agents [--cwd <path>] [--json] [--permission-mode] [--model] [--effort] | 打开 Agent 视图监控并发送后台会话 | 已核查5 个来源 | |
| claude attach | claude attach <id> | 附加到后台会话 | 已核查5 个来源 | |
| claude auth | — | 修复凭证过期导致的死锁问题 | — | |
| claude auth login | claude auth login | 登录 Anthropic 账户 | 已核查5 个来源 | |
| claude auth logout | claude auth logout | 从 Anthropic 账户登出 | 已核查5 个来源 | |
| claude auth status | claude auth status [--text] | 显示身份认证状态为 JSON | 已核查5 个来源 | |
| claude auto-mode reset | claude auto-mode reset | 恢复自动模式（Auto Mode）为默认配置，清除用户设置中的自定义规则 | 已核查 | |
| claude config 已弃用 | — | 新增 claude config 子命令（Unshipped 状态） | — | |
| claude daemon status | claude daemon status | 打印后台会话主管的状态 | 已核查5 个来源 | |
| claude daemon stop | — | 停止后台会话监管进程及其托管的会话；加 `--keep-workers` 可保留后台会话 | 已核查 | |
| claude daemon uninstall | — | 修复登录过期或即将过期时运行该命令可能导致登出的问题。 | — | |
| claude doctor | — | 修复空的 .mcp.json 被报告为无效的问题。 | — | |
| claude --help | — | 现在列出 `--remote-control` 参数 | — | |
| claude install | claude install [version] | 安装或重新安装本地二进制文件 | 已核查3 个来源 | |
| claude kill | claude stop <id> | claude stop 的别名：停止一个后台会话 | 1 处待复核 | |
| claude logs | claude logs <id> | 打印后台会话的最近输出 | 已核查5 个来源 | |
| claude mcp | claude mcp | 配置 MCP 服务器 | 已核查4 个来源 | |
| claude mcp add | — | 修复 `-- <command> --background` 形式的命令被当作后台会话启动的问题。 | — | |
| claude mcp add-from-claude-desktop | — | 修复了当服务器名称包含不支持字符时卡住的问题，无效名称现被报告而剩余服务器继续导入 | — | |
| claude mcp add-json | — | 修复了在配置文件无法写入时报告虚假成功的问题 | — | |
| claude mcp get | — | 不再启动被策略检查阻止的 server，而是报告为 blocked。 | — | |
| claude mcp list | — | 修复空的 .mcp.json 被误报为无效，并且不再启动被策略检查阻止的 server。 | — | |
| claude mcp login | claude mcp login <name> [--no-browser] | 从命令行运行某个已配置 remote MCP 服务器的 OAuth 授权流程，无需进入会话打开 /mcp 面板（v2.1.186+）。v2.1.191+ 在无浏览器环境（SSH、无显示服务器的 Linux）自动打印授权 URL 让你粘回 redirect URL;--no-browser 可强制走 URL 提示（需 ssh -t 交互终端）。 | — | |
| claude mcp logout | claude mcp logout <name> | 清除某个 MCP 服务器已存储的 OAuth 凭据，与 claude mcp login <name> 配对使用（v2.1.186+）。 | — | |
| claude mcp remove | — | 修复了从 MCP server 名称和值中打印换行符和终端转义序列的问题 | — | |
| claude mcp serve | — | 修复后台 Bash 结果未标明输出文件，且工具描述承诺的通知实际不会到达的问题。 | — | |
| claude plugin | claude plugin <subcommand> | 管理 Claude Code 插件 | 1 处待复核5 个来源 | |
| claude plugin configure | — | 显示插件的选项及其设置状态，可用 --values-stdin 从标准输入读取新值 | 4 处待复核 | |
| claude plugin details | — | 插件未找到时不再建议运行 claude plugin list（它不显示内置插件），改为指向 /plugin。 | — | |
| claude plugin disable | — | 当写入的 settings 文件无法加载时，禁用插件会显示警告。 | — | |
| claude plugin enable | — | 当写入的 settings 文件无法加载时，启用插件会显示警告。 | — | |
| claude plugin eval | claude plugin eval <plugin> [options] | 运行插件的 eval 测试套件，输出评分并生成可复现的评估结果 | 6 处待复核 | |
| claude plugin init | — | 新增 CLI 子命令在 .claude/skills 目录下初始化新插件 | — | |
| claude plugin install | — | 修复 `constructor` 命名的 marketplace 安装失败的问题，并修复 Windows 上无 GitHub SSH key 时 `owner/repo` 插件源安装失败的问题（现改为通过 HTTPS 重试克隆）。 | — | |
| claude plugin list | claude plugin list [options] | 列出已安装插件及其在各配置范围下的启用/禁用状态，包括插件ID、版本、来源等信息 | 4 处待复核 | |
| claude plugin marketplace add | claude plugin marketplace add <owner>/<repo> | 把本地目录或 Git 仓库注册为插件 marketplace，之后可从中安装插件 | 1 处待复核 | |
| claude plugin marketplace remove | — | 修复了不显示卸载的插件列表的问题 | — | |
| claude plugin marketplace update | — | 更新指定名称的插件 marketplace | 已核查 | |
| claude plugin prune | — | 新增子命令用于移除孤立的自动安装插件依赖 | — | |
| claude plugin tag | — | 新增命令用于为插件创建版本验证的 release git tags | — | |
| claude plugin test | claude plugin test [directory] | 运行 mod（通过代码注册事件处理器的插件）目录下的 .test.ts/.test.tsx 测试文件，无需会话、登录或网络 | 2 处待复核 | |
| claude plugin uninstall | claude plugin uninstall <plugin> [options] | 卸载已安装的插件，可选保留数据目录、清理无用依赖或以 JSON 格式输出结果 | 2 处待复核 | |
| claude plugin update | — | 修复了省略 --scope 时针对项目范围插件失败的问题 | — | |
| claude plugin validate | — | 新增提示，会列出在 organization 管理 Claude Code 时被跳过的 mod hooks。 | — | |
| claude project purge 已弃用 | claude project purge [path] [--dry-run] [-y] [-i] [--all] | 删除项目的所有本地 Claude Code 状态 | 2 处待复核4 个来源 | |
| claude purge | claude purge [path] | 删除某个项目在本地的全部 Claude Code 状态，包括对话记录、任务列表、调试日志、文件编辑历史、提示历史，以及 ~/.claude.json 中该项目的条目 | 2 处待复核 | |
| claude rc | — | 改进了workspace-trust错误消息 | — | |
| claude remote-control | claude remote-control [--name <name>] | 启动 Remote Control 服务器 | 已核查5 个来源 | |
| claude respawn | claude respawn <id> [--all] | 重启后台会话 | 1 处待复核5 个来源 | |
| claude rm | claude rm <id> | 从列表中移除后台会话 | 2 处待复核5 个来源 | |
| claude self-hosted-runner | claude self-hosted-runner <setup|doctor|orchestrator> | 启动运行程序进程，将本机或容器注册为自托管环境节点，在自有基础设施上托管 Claude Code 云会话 | 已核查 | |
| claude self-hosted-runner doctor | — | 改进机器没有 git 凭据时的提示说明。 | — | |
| claude self-hosted-runner setup | — | 改进机器没有 git 凭据时的提示说明。 | — | |
| claude setup-token | claude setup-token | 生成长期有效的 OAuth 令牌 | 已核查4 个来源 | |
| claude stop | claude stop <id> | 停止后台会话 | 已核查5 个来源 | |
| claude ultrareview | claude ultrareview [target] | 非交互式运行代码审查，输出发现结果到标准输出 | 已核查5 个来源 | |
| claude update | claude update | 更新到最新版本 | 已核查5 个来源 |
Hook 事件
37 个事件钩子，settings.json 配置后由 Claude Code 自动触发的外部脚本。
| 命令 | 语法 | 用途 | 核查 | 复制 |
|---|---|---|---|---|
| agent.spawn | — | 在 subagent 或 teammate 被启动或恢复（resume）时运行的 hook 事件，事件数据带有 resume 字段 | — | |
| ConfigChange | — | 在会话期间配置文件发生变化时触发。 | — | |
| CwdChanged | — | 在工作目录发生改变时触发，用于反应式地管理环境。 | — | |
| Elicitation | — | 在 MCP 服务器于工具调用中请求用户输入时触发，可拦截并覆盖 elicitation 响应。 | — | |
| ElicitationResult | — | 在用户回应 MCP elicitation、响应回传之前触发，用于处理 elicitation 结果。 | — | |
| FileChanged | — | 在被监视的文件发生改变时触发，用于反应式地管理环境。 | — | |
| hook_execution_complete | — | 记录 hook 执行完成时的 OpenTelemetry 遥测事件，包含输出大小及超大输出次数等信息 | — | |
| InstructionsLoaded | — | 在 CLAUDE.md 或 .claude/rules/*.md 文件加载进上下文时触发。 | — | |
| MessageDisplay | — | 在助手消息文本即将显示时触发，允许转换或隐藏该文本（仅展示、不阻断）。 | — | |
| Notification | — | 在 Claude Code 发送通知时触发（支持 matcher 匹配通知类型）。 | — | |
| PermissionDenied | — | 在自动模式分类器拒绝某次工具调用后触发，用于在权限被拒时做反应处理。 | — | |
| PermissionRequest | — | 在工具权限对话框弹出时触发，可自动审批或拒绝该权限请求。 | — | |
| PostCompact | — | 在上下文 compaction 完成之后触发，用于压缩后的收尾处理。 | — | |
| PostModelSwitch | — | 模型切换完成后（含自动恢复）触发的 hook 事件，可用于记录或响应模型变更 | — | |
| PostToolUse | — | 在某次工具调用成功执行后触发，可阻止结果或通过 updatedToolOutput 替换工具输出。 | — | |
| PostToolUseFailure | — | 在某次工具调用执行失败后触发，用于在工具出错时做记录或处理。 | — | |
| PreCompact | — | 在上下文 compaction 开始之前触发，可通过 exit code 2 或 decision:block 阻止压缩。 | — | |
| PreModelSwitch | — | 模型切换前触发的 hook 事件，可用于阻止、确认或注解即将发生的模型切换 | — | |
| PreToolUse | — | 在某次工具调用执行之前触发，可阻止、放行、改为询问或通过 updatedInput 修改工具输入。 | — | |
| prompt.submit | — | mod 的 hook 事件，在提交 prompt 时触发，可读取附件媒体字节并重写 prompt | — | |
| session.append | — | 新增 queue door,mod 可以让 transcript 中的 queue 记录与实际发送的 prompt 不同。 | — | |
| SessionEnd | — | 在会话终止时触发，用于做清理或收尾（可输出 systemMessage）。 | — | |
| SessionStart | — | 在会话启动或经 resume/clear/compact 恢复时触发，可初始化环境、注入上下文或设置会话标题。 | — | |
| Setup | — | 在以 --init、--init-only 或 --maintenance flag 启动时触发，用于仓库的一次性设置与维护。 | — | |
| skill.prompt | — | 接收的数据新增 skill 的 frontmatter、source、plugin 名称和文件路径。 | — | |
| Stop | — | 在主 agent 完成响应、本回合即将结束时触发，可阻止停止或注入 additionalContext 让其继续。 | — | |
| StopFailure | — | 在本回合因 API 错误（限流、鉴权失败等）而结束时触发。 | — | |
| SubagentStart | — | 在 subagent 被派生启动时触发。 | — | |
| SubagentStop | — | 在 subagent 完成响应、其子任务即将结束时触发，可阻止停止或反馈 additionalContext。 | — | |
| TaskCompleted | — | 在某任务即将标记为完成时触发，可返回 continue:false 停止对应 teammate。 | — | |
| TaskCreated | — | 在通过 TaskCreate 创建任务时触发，用于对新任务做拦截或处理。 | — | |
| TeammateIdle | — | 在 agent team 中某 teammate 即将进入空闲时触发，可返回 continue:false 停止该 teammate。 | — | |
| turn.start | — | 现在也会接收 subagents 和 teammates 的 turn，可通过 e.agentId 区分（主循环没有该字段）。 | — | |
| user_prompt | — | OpenTelemetry 遥测事件，携带用户提示内容（`prompt` 与 `prompt_text` 字段），并非 hook 事件 | — | |
| UserPromptSubmit | — | 在用户提交 prompt、Claude 处理之前触发，可阻止该 prompt 或注入 additionalContext。 | — | |
| WorktreeCreate | — | 在 agent worktree 隔离创建 worktree 时触发，用于执行自定义 VCS 设置。 | — | |
| WorktreeRemove | — | 在 agent worktree 隔离移除 worktree 时触发，用于执行自定义 VCS 清理。 | — |
启动参数
95 个claude 启动参数，改全局默认行为（模型、超时、目录、权限等）。
| 命令 | 语法 | 用途 | 核查 | 复制 |
|---|---|---|---|---|
| --add-dir | --add-dir <directories> | 为 Claude 添加额外的工作目录以读写文件 | 1 处待复核5 个来源 | |
| --agent | --agent <name> | 为当前会话指定一个 agent（覆盖默认设置） | 2 处待复核5 个来源 | |
| --agents | --agents <json> | 通过 JSON 动态定义自定义子 agent | 4 处待复核5 个来源 | |
| --all | claude agents --json --all | 扩大命令作用范围到“全部”。claude agents --json --all 一并打印已完成的后台会话；claude respawn --all 重启每个运行中的会话；claude project purge --all 清理所有项目状态。 | — | |
| --allow-dangerously-skip-permissions | --allow-dangerously-skip-permissions | 在权限模式循环中添加跳过权限检查选项 | — | |
| --allowedTools | --allowedTools <rules> | 设定无需询问权限即可执行的 Tool 列表 | — | |
| --append-subagent-system-prompt-file | claude -p --append-subagent-system-prompt-file <file> "query" | 从文件读取文本并附加到子代理的系统提示，用于内容过长无法在命令行传递的场景，仅在非交互模式下生效 | — | |
| --append-system-prompt | --append-system-prompt <text> | 在默认系统提示的末尾追加自定义文本 | 1 处待复核5 个来源 | |
| --append-system-prompt-file | --append-system-prompt-file <path> | 从文件加载系统提示文本并追加到默认提示 | — | |
| --ax-screen-reader | --ax-screen-reader | 以屏幕阅读器友好方式输出：纯文本、无装饰边框和动画 | 已核查 | |
| --background | — | 修复发给后台会话的 prompt 或回复以 --background 开头时被当作参数的问题。 | — | |
| --bare | --bare | 最小化模式，跳过自动发现以加快脚本调用启动 | 已核查5 个来源 | |
| --base-dir | — | Windows 启动现在需要显式指定此标志 | — | |
| --bg | --bg <prompt> | 在后台启动会话并立即返回，打印会话 ID 和管理命令 | 3 处待复核5 个来源 | |
| -c | claude -c | 继续当前目录中最近的会话 | — | |
| --channels | --channels <entries> | 指定 MCP 服务器通道，Claude 应在此会话中监听通知 | 1 处待复核5 个来源 | |
| --chrome | --chrome | 启用 Chrome 浏览器集成以进行网络自动化和测试 | 1 处待复核5 个来源 | |
| --client-id | — | 用于 claude mcp add，配置 MCP 服务器的 OAuth 客户端 ID。 | — | |
| --client-secret | — | 用于 claude mcp add，配置 MCP 服务器的 OAuth 客户端密钥。 | — | |
| -cn | — | 搭配 claude --bg 使用，为后台会话设置会话名称。 | — | |
| --configure-git | — | 为 self-hosted runner 配置克隆/提交所用的 Git 认证凭据（含提交签名） | — | |
| --console | claude auth login --console | claude auth login 的子标志：改用 Anthropic Console 按 API 用量计费登录，而非 Claude 订阅账号。 | — | |
| --continue | --continue | 加载当前目录中最近的对话（包括添加此目录的会话） | 已核查5 个来源 | |
| --dangerously-skip-permissions | --dangerously-skip-permissions | 跳过权限提示，等同于 --permission-mode bypassPermissions | 已核查5 个来源 | |
| --debug | --debug [categories] | 启用调试模式并可选择性过滤类别 | 3 处待复核5 个来源 | |
| --debug-file | --debug-file <path> | 将调试日志写入指定文件路径 | — | |
| --defer-shutdown-max-min | — | 收到 SIGTERM 后延迟关闭，继续服务已连接的附加会话，达到指定分钟数后停放剩余会话并退出 | — | |
| --desktop | — | 在 Claude 桌面应用中打开当前目录，或继续现有会话 | — | |
| --disable-slash-commands | --disable-slash-commands | 禁用此会话的所有 Skill 和命令 | — | |
| --disabled | — | 用于 /plugin list，过滤只显示已禁用的插件。 | — | |
| --disallow-tools | — | 用于 `claude plugin eval`，在评测中排除指定的内置工具（如 Agent） | — | |
| --disallowedTools | --disallowedTools <rules> | 拒绝规则，从模型上下文中移除 Tool 或拒绝特定匹配 | — | |
| --effort | --effort <level> | 为当前会话设置处理难度级别（low/medium/high/xhigh/max） | 2 处待复核4 个来源 | |
| --enable-auto-mode 已移除 | --permission-mode auto | 自动模式现在默认在 Shift+Tab 循环中（v2.1.111 版本已移除） | — | |
| --enabled | — | 用于 /plugin list，过滤只显示已启用的插件。 | — | |
| --exclude-dynamic-system-prompt-sections | --exclude-dynamic-system-prompt-sections | 将每台机器的系统提示部分移至第一条用户消息，改善缓存重用 | — | |
| --exec | claude --bg --exec '<command>' | 把一条 shell 命令作为 PTY 支持的后台作业运行，而非启动 Claude 会话。须与 --bg 配合从 shell 启动。 | — | |
| --fallback-model | --fallback-model <model> | 当默认模型过载时自动故障转移到指定模型 | 4 处待复核5 个来源 | |
| --forward-subagent-text | --forward-subagent-text | 在 stream-json 输出流中转发 subagent 的文本与思考内容，便于重建子代理的完整记录 | — | |
| --from-pr | --from-pr <pr-number|url> | 恢复与特定拉取请求相关的会话 | — | |
| --help | claude --help | 打印 CLI 用法摘要后退出。注意官方说明 --help 不会列出每一个 flag，某 flag 不在 --help 里不代表不可用。 | — | |
| --ide | --ide | 启动时自动连接到可用IDE | — | |
| --include-partial-messages | --include-partial-messages | 在输出中包含部分流事件 | — | |
| --init | --init | 在会话前运行Setup hooks（仅打印模式） | — | |
| --init-only | --init-only | 运行Setup和SessionStart hooks后退出 | — | |
| --input-format | --input-format <format> | 为打印模式指定输入格式 | 3 处待复核5 个来源 | |
| --json | claude agents --json | 以 JSON 数组打印会话/结果供脚本消费。claude agents 下列出活动后台会话（加 --all 含已完成），ultrareview 下输出原始 findings 负载。 | 已核查5 个来源 | |
| --json-schema | --json-schema <schema> | 获取与JSON Schema匹配的验证JSON输出 | 已核查5 个来源 | |
| --maintenance | --maintenance | 在会话前运行维护Setup hooks（仅打印模式） | — | |
| --marketplace | /plugin install <plugin> --marketplace <source> | 安装插件时指定市场来源；若该市场尚未添加，则先添加再安装，并经同样的策略检查 | — | |
| --max-budget-usd | --max-budget-usd <amount> | 设置API调用的最大花费金额限制 | 2 处待复核5 个来源 | |
| --max-turns | --max-turns <number> | 限制Agent回合数（仅打印模式） | 已核查5 个来源 | |
| --mcp-config | --mcp-config <file|string> | 从JSON文件或字符串加载MCP服务器 | 4 处待复核5 个来源 | |
| --mcp-debug | — | 启动时开启，输出 MCP 服务器错误的更多调试信息。 | — | |
| --model | --model <model-name> | 为当前会话设置模型 | 已核查5 个来源 | |
| -n | — | 新增短选项用于在startup时设置session display name | — | |
| --name | --name <name> | 设置会话显示名称 | — | |
| --no-browser | claude mcp login <name> --no-browser | claude mcp login 的子标志：SSH 等无浏览器环境下，打印授权 URL 而非自动开浏览器，再把回跳 URL 粘回提示符完成 OAuth。需 v2.1.186+。 | — | |
| --no-chrome | --no-chrome | 禁用此会话的Chrome浏览器集成 | — | |
| --output-format | --output-format <format> | 为打印模式指定输出格式 | 1 处待复核5 个来源 | |
| -p | claude -p "<query>" | 通过 SDK 查询然后退出 | 2 处待复核5 个来源 | |
| --permission-mode | --permission-mode <mode> | 以指定的权限模式开始会话 | 2 处待复核5 个来源 | |
| --permission-prompt-tool | --permission-prompt-tool <tool> | 指定MCP工具处理非交互模式权限提示 | — | |
| --permission-prompts | claude -p --permission-prompts <host|none> "query" | 设置打印模式下由谁回答权限提示，可设为 none 以在无人值守场景下自动拒绝所有交互式提示 | — | |
| --plugin-dir | --plugin-dir <path> | 从目录或ZIP存档加载插件 | 已核查4 个来源 | |
| --plugin-url | --plugin-url <url> | 从URL获取插件ZIP存档 | — | |
--print | 打印响应而不使用交互模式 | 1 处待复核4 个来源 | ||
| --proxy-authorization-command | — | 指定一条命令，其输出用于为出口代理生成 Proxy-Authorization 请求头 | — | |
| --proxy-authorization-file | — | 指定一个文件，其内容用于为出口代理生成 Proxy-Authorization 请求头 | — | |
| --remote-control | --remote-control [name] | 启动启用Remote Control的交互式会话 | — | |
| --remote-control-session-name-prefix | --remote-control-session-name-prefix <prefix> | 设置Remote Control会话名称前缀 | — | |
| --remove-session-state | — | 会话结束时自动删除该会话对应的会话状态目录 | — | |
| --replay-user-messages | --replay-user-messages | 重新发出stdin中的用户消息到stdout进行确认 | — | |
| --restricted | claude --restricted -p "query" | 以受限模式启动：移除执行命令或代码的内置工具和 WebFetch，文件工具限于工作目录，只加载托管设置与 --settings，并拒绝 bypassPermissions | — | |
| --resume | --resume <session-id-or-name> | 恢复特定会话或显示交互式会话选择器 | 已核查4 个来源 | |
| --retire-at | --retire-at <epoch-seconds> | 为 self-hosted runner 指定退役时间点，到点后停止接新任务并优雅释放正在处理的会话 | — | |
| --safe-mode | claude --safe-mode | 以“全部自定义项禁用”方式启动，排查损坏的配置：CLAUDE.md、skills、plugins、hooks、MCP server、自定义命令/agent、输出样式、工作流、主题、键位、状态栏、LSP、自动记忆均不加载；认证、模型选择、内置工具与权限照常工作（区别于 --bare）。需 v2.1.169+。 | — | |
| --scope | claude plugin <install|update|enable|disable> <plugin-name> --scope <user|project|local> | 指定 claude plugin 相关命令（install/update/enable/disable）的作用范围：user（个人）、project（团队共享）或 local（本地忽略） | — | |
| --session-id | --session-id <uuid> | 为对话使用特定的会话ID | — | |
| --setting-sources | --setting-sources <sources> | 指定要加载的设置源列表 | 已核查4 个来源 | |
| --settings | --settings <path-or-json> | 指定设置JSON文件或内联JSON字符串 | 已核查5 个来源 | |
| --shutdown-drain-sec | — | 设置 self-hosted-runner orchestrator 收到 SIGTERM 后，等待进行中的轮询和 spawn hooks 完成的最长秒数 | — | |
| --sparse | — | 修复了 `--sparse` 在 HTTP 仓库上插件安装失败的问题 | — | |
| --strict-mcp-config | --strict-mcp-config | 仅使用指定的MCP服务器配置忽略其他配置 | 1 处待复核5 个来源 | |
| --system-prompt | --system-prompt <text> | 用自定义文本替换整个系统提示 | 1 处待复核5 个来源 | |
| --system-prompt-file | --system-prompt-file <path> | 从文件加载系统提示替换默认值 | 已核查4 个来源 | |
| --system-prompt-snapshot | --system-prompt-snapshot off | 控制系统提示的渲染方式；设为 off 时每次请求都重新渲染系统提示，而不是复用会话记录中已保存的提示 | — | |
| --teleport | --teleport | 在本地终端中恢复web会话 | 已核查5 个来源 | |
| --tmux | --tmux [mode] | 为worktree创建tmux会话 | — | |
| --tools | --tools <names> | 限制Claude可以使用的内置工具 | 2 处待复核5 个来源 | |
| --use-anthropic-git-proxy | --use-anthropic-git-proxy | 通过 Anthropic 提供的 git 代理克隆仓库 | — | |
| -w | — | 修复 `claude -w <name>` 在前一个会话的 worktree 清理留下陈旧目录后失败的问题 | — | |
| --worktree | --worktree [name] | 在隔离的git worktree中启动Claude | 已核查5 个来源 | |
| -y | — | 在执行 `claude plugin install`/`update` 时跳过确认提示，自动确认 | — | |
| --yes | --yes | 跳过命令执行前的确认提示（如与「claude auto-mode reset」搭配使用） | — |