每条带交叉核查 verdict · 不是另一份 README 摘录
对齐 Claude Code v2.1.207 · 112/112 条深度指南已核查 · 最后更新 2026-07-12
Claude Code 命令 Cheatsheet 2026
112/112 命令已完成深度核查 · 100% 通过来源核验 · drift 跟踪到 v2.1.207速查表覆盖全部 244 个命令(含未核查)。
本页是 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 命令
111 个会话内打 / 触发,控制 Claude Code 自身行为(模型、记忆、上下文、子代理)。
| 命令 | 语法 | 用途 | 核查 | 复制 |
|---|---|---|---|---|
| /add-dir | — | 为当前会话添加工作目录以用于文件访问 | 已核查4 个来源 | |
| /advisor | /advisor [model|off] | 开关 advisor 工具——在任务关键时刻咨询第二个模型获取指导。接受 opus / sonnet / fable(v2.1.170+)或完整 model ID;不带参数则打开选择器。需 v2.1.98+。 | 已核查2 个来源 | |
| /agents 已移除 | — | 管理代理的配置和设置选项 | 已核查5 个来源 | |
| /allowed-tools 已移除 | — | 已重命名为 /permissions | — | |
| /approved-tools | — | 新增 /approved-tools 斜杠命令用于管理工具权限 | — | |
| /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 | — | 孵化一个在旁观看你编码的交互式小生物。 | — | |
| /bug | — | 提交前需输入描述，不再使用 model-refusal 文本作为 GitHub issue 标题。 | — | |
| /cd | /cd <path> | 将当前会话整体迁移到一个新的工作目录,保留对话的 prompt cache(区别于只额外挂目录的 /add-dir)。需 v2.1.169+。 | 已核查2 个来源 | |
| /checkup | — | /doctor 的别名 | — | |
| /chrome | — | 配置 Claude 在 Chrome 浏览器中的设置 | 已核查4 个来源 | |
| /claude-api | /claude-api [migrate|managed-agents-onboard] | 加载项目语言的 Claude API 参考和代理文档 | 已核查5 个来源 | |
| /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。 | — | |
| /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 个来源 | |
| /desktop | — | 在 Claude Code Desktop 应用中继续会话 | 已核查5 个来源 | |
| /diff | /diff | 打开交互式 diff 查看器显示未提交更改 | 已核查4 个来源 | |
| /doctor | — | 诊断并验证 Claude Code 的安装和设置 | 已核查4 个来源 | |
| /effort | /effort [level|auto] | 设置模型工作难度级别从低到最高 | 已核查4 个来源 | |
| /env | — | 为会话设置环境变量，同时应用于 Bash 和 PowerShell 工具命令。 | — | |
| /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> | 派生一个继承完整对话的后台 forked subagent 处理你的指令,你可继续手头工作,其结果完成后回传当前会话。需 v2.1.161+;早于该版本 /fork 仅是 /branch 的别名。 | 已核查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 配置 | — | |
| /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 个来源 | |
| /output-style 已弃用 | — | 已弃用，请使用/config代替，输出style现在在session start时固定以支持prompt caching | — | |
| /permissions | — | 管理工具权限的允许、询问和拒绝规则 | 已核查6 个来源 | |
| /plan | /plan [description] | 直接从提示进入计划模式执行任务 | 已核查5 个来源 | |
| /plugin | — | 管理Claude Code的插件配置 | 已核查5 个来源 | |
| /plugin install | — | 修复了在REPL中marketplace插件local sources安装失败的问题 | — | |
| /plugin list | — | 新增命令以列出已安装的插件 | — | |
| /plugins | — | 修复关闭 /plugins 面板对话框后在记录中遗留 '(no content)' 行的问题 | — | |
| /poll | — | Remote Control 的轮询命令，定期(现为每 10 分钟)拉取远程指令。 | — | |
| /powerup | — | 通过快速交互课程发现Claude Code功能 | 已核查4 个来源 | |
| /proactive | — | /loop 的别名，按设定间隔反复运行某个 prompt 或 slash 命令。 | — | |
| /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 | — | 修复语言改动在按 Escape 后被撤销 | — | |
| /setup-bedrock | — | 配置 Amazon Bedrock 认证和模型 | 已核查4 个来源 | |
| /setup-vertex | — | 配置 Google Vertex AI 认证和模型 | 已核查5 个来源 | |
| /share | — | 修复了上传时 Esc、Ctrl-C 和 Ctrl-D 不工作的问题 | — | |
| /simplify | /simplify [target] | 独立 cleanup-only review skill:四个 review agent 并行检查代码复用、简化、效率与抽象层级并直接应用修复(不查 correctness bug,查 bug 用 /code-review)。v2.1.154+ 起为独立 skill;更早等价于 /code-review --fix。 | 已核查2 个来源 | |
| /skills | — | 列出可用 skills 和隐藏不需要的 | 已核查5 个来源 | |
| /stats | — | 打开统计标签显示使用情况 | 已核查5 个来源 | |
| /status | — | 打开设置界面显示版本模型和连接 | 已核查5 个来源 | |
| /statusline | — | 配置 Claude Code 的状态行显示信息 | 已核查4 个来源 | |
| /t | — | 在当前 prompt 中临时禁用 thinking mode。 | — | |
| /tag 已移除 | — | 为会话打标签/命名,便于之后从不同目录恢复到对应会话(已于 v2.1.92 移除)。 | — | |
| /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> | 在ultraplan会话中草稿计划 | 已核查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 个来源 | |
| /vim 已移除 | — | 切换Vim和Normal编辑模式 | 已核查5 个来源 | |
| /voice | /voice [hold|tap|off] | 开启或配置语音听写模式 | 已核查5 个来源 | |
| /web-setup | — | 连接GitHub账户以使用网页版功能 | 已核查4 个来源 | |
| /workflows | /workflows | 会话内管理面板:列出本会话正在运行或已完成的 dynamic workflow,用于监控进度、查看结果、暂停、停止与重启。需 v2.1.154+。 | 已核查2 个来源 |
CLI 子命令
39 个终端里 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 config 已弃用 | — | 新增 claude config 子命令（Unshipped 状态） | — | |
| claude daemon status | claude daemon status | 打印后台会话主管的状态 | 已核查5 个来源 | |
| claude doctor | — | 修复无效 MCP 配置项被无声丢弃的问题，现在会显示警告 | — | |
| claude --help | — | 现在列出 `--remote-control` 参数 | — | |
| claude install | claude install [version] | 安装或重新安装本地二进制文件 | 已核查3 个来源 | |
| claude logs | claude logs <id> | 打印后台会话的最近输出 | 已核查5 个来源 | |
| claude mcp | claude mcp | 配置 MCP 服务器 | 已核查4 个来源 | |
| claude mcp add | — | 新增交互式 MCP 设置向导，可通过 claude mcp add 命令启动 | — | |
| claude mcp add-from-claude-desktop | — | 修复了当服务器名称包含不支持字符时卡住的问题，无效名称现被报告而剩余服务器继续导入 | — | |
| claude mcp add-json | — | 新增 claude mcp add-json 子命令用于以 JSON 字符串形式添加 MCP 服务器 | — | |
| claude mcp get | — | 不再 spawn 已通过 .claude/settings.json 自批准的 .mcp.json server | — | |
| claude mcp list | — | 不再 spawn 已通过 .claude/settings.json 自批准的 .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 | — | 改进了对错别字的建议提示功能和长列表截断 | — | |
| claude mcp serve | — | 修复 `claude mcp serve` 工具调用因 outputSchema 验证失败的问题 | — | |
| claude plugin details | — | 现在显示 LSP servers | — | |
| claude plugin disable | — | 现在在其他已启用的插件依赖该插件时拒绝禁用操作，并提供可复制的禁用链提示 | — | |
| claude plugin enable | — | 新增 enable 子命令用于启用插件 | — | |
| claude plugin init | — | 新增 CLI 子命令在 .claude/skills 目录下初始化新插件 | — | |
| claude plugin install | — | 修复安装 marketplace ref 不存在的插件的问题 | — | |
| claude plugin marketplace remove | — | 现在接受 --scope 参数（user|project|local） | — | |
| claude plugin prune | — | 新增子命令用于移除孤立的自动安装插件依赖 | — | |
| claude plugin tag | — | 新增命令用于为插件创建版本验证的 release git tags | — | |
| claude plugin update | — | 改进 `claude plugin update` 在无法刷新 marketplace 时显示警告 | — | |
| claude plugin validate | — | 修复跳过 source 为 "." 的本地 plugin 以及在第一个 error class 后停止的问题 | — | |
| claude project purge | claude project purge [path] [--dry-run] [-y] [-i] [--all] | 删除项目的所有本地 Claude Code 状态 | — | |
| claude remote-control | claude remote-control [--name <name>] | 启动 Remote Control 服务器 | — | |
| claude respawn | claude respawn <id> [--all] | 重启后台会话 | — | |
| claude rm | claude rm <id> | 从列表中移除后台会话 | — | |
| claude stop | claude stop <id> | 停止后台会话 | — | |
| claude ultrareview | claude ultrareview [target] | 非交互式运行代码审查，输出发现结果到标准输出 | — | |
| claude update | claude update | 更新到最新版本 | — |
Hook 事件
28 个事件钩子,settings.json 配置后由 Claude Code 自动触发的外部脚本。
| 命令 | 语法 | 用途 | 核查 | 复制 |
|---|---|---|---|---|
| ConfigChange | — | 在会话期间配置文件发生变化时触发。 | — | |
| CwdChanged | — | 在工作目录发生改变时触发,用于反应式地管理环境。 | — | |
| Elicitation | — | 在 MCP 服务器于工具调用中请求用户输入时触发,可拦截并覆盖 elicitation 响应。 | — | |
| ElicitationResult | — | 在用户回应 MCP elicitation、响应回传之前触发,用于处理 elicitation 结果。 | — | |
| FileChanged | — | 在被监视的文件发生改变时触发,用于反应式地管理环境。 | — | |
| InstructionsLoaded | — | 在 CLAUDE.md 或 .claude/rules/*.md 文件加载进上下文时触发。 | — | |
| MessageDisplay | — | 在助手消息文本即将显示时触发,允许转换或隐藏该文本(仅展示、不阻断)。 | — | |
| Notification | — | 在 Claude Code 发送通知时触发(支持 matcher 匹配通知类型)。 | — | |
| PermissionDenied | — | 在自动模式分类器拒绝某次工具调用后触发,用于在权限被拒时做反应处理。 | — | |
| PermissionRequest | — | 在工具权限对话框弹出时触发,可自动审批或拒绝该权限请求。 | — | |
| PostCompact | — | 在上下文 compaction 完成之后触发,用于压缩后的收尾处理。 | — | |
| PostToolUse | — | 在某次工具调用成功执行后触发,可阻止结果或通过 updatedToolOutput 替换工具输出。 | — | |
| PostToolUseFailure | — | 在某次工具调用执行失败后触发,用于在工具出错时做记录或处理。 | — | |
| PreCompact | — | 在上下文 compaction 开始之前触发,可通过 exit code 2 或 decision:block 阻止压缩。 | — | |
| PreToolUse | — | 在某次工具调用执行之前触发,可阻止、放行、改为询问或通过 updatedInput 修改工具输入。 | — | |
| SessionEnd | — | 在会话终止时触发,用于做清理或收尾(可输出 systemMessage)。 | — | |
| SessionStart | — | 在会话启动或经 resume/clear/compact 恢复时触发,可初始化环境、注入上下文或设置会话标题。 | — | |
| Setup | — | 在以 --init、--init-only 或 --maintenance flag 启动时触发,用于仓库的一次性设置与维护。 | — | |
| Stop | — | 在主 agent 完成响应、本回合即将结束时触发，可阻止停止或注入 additionalContext 让其继续。 | — | |
| StopFailure | — | 在本回合因 API 错误(限流、鉴权失败等)而结束时触发。 | — | |
| SubagentStart | — | 在 subagent 被派生启动时触发。 | — | |
| SubagentStop | — | 在 subagent 完成响应、其子任务即将结束时触发,可阻止停止或反馈 additionalContext。 | — | |
| TaskCompleted | — | 在某任务即将标记为完成时触发,可返回 continue:false 停止对应 teammate。 | — | |
| TaskCreated | — | 在通过 TaskCreate 创建任务时触发,用于对新任务做拦截或处理。 | — | |
| TeammateIdle | — | 在 agent team 中某 teammate 即将进入空闲时触发,可返回 continue:false 停止该 teammate。 | — | |
| UserPromptSubmit | — | 在用户提交 prompt、Claude 处理之前触发,可阻止该 prompt 或注入 additionalContext。 | — | |
| WorktreeCreate | — | 在 agent worktree 隔离创建 worktree 时触发,用于执行自定义 VCS 设置。 | — | |
| WorktreeRemove | — | 在 agent worktree 隔离移除 worktree 时触发,用于执行自定义 VCS 清理。 | — |
启动参数
66 个claude 启动参数,改全局默认行为(模型、超时、目录、权限等)。
| 命令 | 语法 | 用途 | 核查 | 复制 |
|---|---|---|---|---|
| --add-dir | --add-dir <directories> | 为 Claude 添加额外的工作目录以读写文件 | — | |
| --agent | --agent <name> | 为当前会话指定一个 agent（覆盖默认设置） | — | |
| --agents | --agents <json> | 通过 JSON 动态定义自定义子 agent | — | |
| --all | claude agents --json --all | 扩大命令作用范围到“全部”。claude agents --json --all 一并打印已完成的后台会话；claude respawn --all 重启每个运行中的会话；claude project purge --all 清理所有项目状态。 | — | |
| --append-system-prompt | --append-system-prompt <text> | 在默认系统提示的末尾追加自定义文本 | — | |
| --background | — | 修复了在 help 中未被列出的问题 | — | |
| --bare | --bare | 最小化模式，跳过自动发现以加快脚本调用启动 | — | |
| --bg | --bg <prompt> | 在后台启动会话并立即返回，打印会话 ID 和管理命令 | — | |
| -c | claude -c | 继续当前目录中最近的会话 | — | |
| --channels | --channels <entries> | 指定 MCP 服务器通道，Claude 应在此会话中监听通知 | — | |
| --chrome | --chrome | 启用 Chrome 浏览器集成以进行网络自动化和测试 | — | |
| --client-id | — | 用于 claude mcp add，配置 MCP 服务器的 OAuth 客户端 ID。 | — | |
| --client-secret | — | 用于 claude mcp add，配置 MCP 服务器的 OAuth 客户端密钥。 | — | |
| -cn | — | 搭配 claude --bg 使用，为后台会话设置会话名称。 | — | |
| --console | claude auth login --console | claude auth login 的子标志：改用 Anthropic Console 按 API 用量计费登录，而非 Claude 订阅账号。 | — | |
| --continue | --continue | 加载当前目录中最近的对话（包括添加此目录的会话） | — | |
| --dangerously-skip-permissions | --dangerously-skip-permissions | 跳过权限提示，等同于 --permission-mode bypassPermissions | — | |
| --debug | --debug [categories] | 启用调试模式并可选择性过滤类别 | — | |
| --disable-slash-commands | --disable-slash-commands | 禁用此会话的所有 Skill 和命令 | — | |
| --disabled | — | 用于 /plugin list，过滤只显示已禁用的插件。 | — | |
| --disallowedTools | --disallowedTools <rules> | 拒绝规则，从模型上下文中移除 Tool 或拒绝特定匹配 | — | |
| --effort | --effort <level> | 为当前会话设置处理难度级别（low/medium/high/xhigh/max） | — | |
| --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> | 当默认模型过载时自动故障转移到指定模型 | — | |
| --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后退出 | — | |
| --json | claude agents --json | 以 JSON 数组打印会话/结果供脚本消费。claude agents 下列出活动后台会话（加 --all 含已完成），ultrareview 下输出原始 findings 负载。 | — | |
| --json-schema | --json-schema <schema> | 获取与JSON Schema匹配的验证JSON输出 | — | |
| --maintenance | --maintenance | 在会话前运行维护Setup hooks（仅打印模式） | — | |
| --max-budget-usd | --max-budget-usd <amount> | 设置API调用的最大花费金额限制 | — | |
| --max-turns | --max-turns <number> | 限制Agent回合数（仅打印模式） | — | |
| --mcp-config | --mcp-config <file|string> | 从JSON文件或字符串加载MCP服务器 | — | |
| --mcp-debug | — | 启动时开启，输出 MCP 服务器错误的更多调试信息。 | — | |
| --model | --model <model-name> | 为当前会话设置模型 | — | |
| -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+。 | — | |
| --output-format | --output-format <format> | 为打印模式指定输出格式 | — | |
| -p | claude -p "<query>" | 通过 SDK 查询然后退出 | — | |
| --permission-mode | --permission-mode <mode> | 以指定的权限模式开始会话 | — | |
| --permission-prompt-tool | --permission-prompt-tool <tool> | 指定MCP工具处理非交互模式权限提示 | — | |
| --plugin-dir | --plugin-dir <path> | 从目录或ZIP存档加载插件 | — | |
| --plugin-url | --plugin-url <url> | 从URL获取插件ZIP存档 | — | |
--print | 打印响应而不使用交互模式 | — | ||
| --remote-control | --remote-control [name] | 启动启用Remote Control的交互式会话 | — | |
| --remote-control-session-name-prefix | --remote-control-session-name-prefix <prefix> | 设置Remote Control会话名称前缀 | — | |
| --replay-user-messages | --replay-user-messages | 重新发出stdin中的用户消息到stdout进行确认 | — | |
| --resume | --resume <session-id-or-name> | 恢复特定会话或显示交互式会话选择器 | — | |
| --safe-mode | claude --safe-mode | 以“全部自定义项禁用”方式启动，排查损坏的配置：CLAUDE.md、skills、plugins、hooks、MCP server、自定义命令/agent、输出样式、工作流、主题、键位、状态栏、LSP、自动记忆均不加载；认证、模型选择、内置工具与权限照常工作（区别于 --bare）。需 v2.1.169+。 | — | |
| --session-id | --session-id <uuid> | 为对话使用特定的会话ID | — | |
| --setting-sources | --setting-sources <sources> | 指定要加载的设置源列表 | — | |
| --settings | --settings <path-or-json> | 指定设置JSON文件或内联JSON字符串 | — | |
| --strict-mcp-config | --strict-mcp-config | 仅使用指定的MCP服务器配置忽略其他配置 | — | |
| --system-prompt | --system-prompt <text> | 用自定义文本替换整个系统提示 | — | |
| --system-prompt-file | --system-prompt-file <path> | 从文件加载系统提示替换默认值 | — | |
| --teleport | --teleport | 在本地终端中恢复web会话 | — | |
| --tools | --tools <names> | 限制Claude可以使用的内置工具 | — | |
| -w | — | 修复 `claude -w <name>` 在前一个会话的 worktree 清理留下陈旧目录后失败的问题 | — | |
| --worktree | --worktree [name] | 在隔离的git worktree中启动Claude | — |