Claude Code Commands 是存放在 .claude/commands/<name>.md 的用户触发型工作流入口，通过 14 个 frontmatter 字段控制模型、权限、上下文隔离等行为，并可编排 Agent 和 Skill 完成复杂任务。本文完整收录 75 条官方内置命令并分组说明。

Claude Code Commands 完全指南：14 个配置字段与 75 条官方命令

什么是 Command

Command 是 Claude Code 中用户主动触发的工作流入口，存放在 .claude/commands/<name>.md，通过 /command-name 调用。与 Subagents 和 Skills 的区别：

• Command：用户显式触发，适合作为编排多步工作流的入口；content 在用户调用前不注入上下文
• Skill：Claude 可自动调用，content 在 session 启动时注入上下文供语义匹配
• Subagent：独立上下文运行，适合自主多步任务

Command 特别适合：需要用户交互（AskUserQuestion）的工作流、需要按序编排 Agent 和 Skill 的流程、以及不希望 content 常驻上下文的场景。

14 个 Frontmatter 字段

字段	类型	必填	说明
name	string	否	显示名和 /slash-command 标识符。省略时使用目录名
description	string	推荐	命令说明，显示在自动补全中
when_to_use	string	否	额外触发提示，会追加到 description，算入 1536 字符上限
argument-hint	string	否	自动补全时显示的提示（如 [issue-number]、[filename]）
disable-model-invocation	boolean	否	设为 true 防止 Claude 自动调用此命令
user-invocable	boolean	否	设为 false 则从 / 菜单隐藏，仅作为后台知识
paths	string/list	否	限制自动激活的文件 glob 模式，仅在操作匹配文件时自动加载
allowed-tools	string	否	此命令激活时无需提示即可执行的工具
model	string	否	执行此命令时使用的模型（如 haiku、sonnet、opus）
effort	string	否	调用时的思考深度：low/medium/high/max
context	string	否	设为 fork 则在隔离的 subagent 上下文中运行此命令
agent	string	否	context: fork 时使用的 subagent 类型，默认 general-purpose
shell	string	否	!`command` 块使用的 shell：bash（默认）或 powershell
hooks	object	否	仅作用于此命令的生命周期钩子

动态内容注入：!command

Command 文件支持在 SKILL.md 中用 !`shell-command` 语法注入动态输出：

---
name: git-status
description: 查看当前 git 状态
---

当前 git 状态：
!`git status`
!`git log --oneline -10`

Claude 调用时会执行这些 shell 命令，将输出注入提示词，模型只看到结果。

75 条官方内置命令

认证（Auth）

命令	说明
/login	登录 Anthropic 账号
/logout	退出登录
/setup-bedrock	配置 Amazon Bedrock 认证（需 CLAUDE_CODE_USE_BEDROCK=1）
/setup-vertex	配置 Google Vertex AI 认证（需 CLAUDE_CODE_USE_VERTEX=1）
/upgrade	打开升级页面切换到更高套餐

配置（Config）

命令	说明
/color [颜色]	设置当前 session 的提示栏颜色（red/blue/green/yellow/purple/orange/pink/cyan）
/config	打开设置界面，调整主题、模型等偏好。别名：/settings
/focus	切换 focus 视图，只显示最后一条提示、工具调用摘要和最终回复
/keybindings	打开或创建快捷键配置文件
/permissions	管理工具权限的允许/询问/拒绝规则。别名：/allowed-tools
/privacy-settings	查看和更新隐私设置（Pro/Max 订阅用户可用）
/sandbox	切换沙箱模式（仅支持的平台）
/statusline	配置状态栏
/stickers	订购 Claude Code 贴纸
/terminal-setup	配置终端快捷键（Shift+Enter 等），适用于 VS Code/Alacritty/Warp
/theme	更改颜色主题（含无障碍 daltonized 主题）
/tui [default|fullscreen]	切换终端 UI 渲染模式，fullscreen 启用无闪烁 alt-screen TUI
/voice	切换推按说话语音输入（需 Claude.ai 账号）

上下文（Context）

命令	说明
/context	以彩色网格可视化当前上下文用量，显示优化建议
/cost	显示 token 用量统计
/extra-usage	配置超出速率限制后的额外用量
/insights	生成会话分析报告（项目区域、交互模式、摩擦点）
/stats	可视化日用量、会话历史、连续使用天数和模型偏好
/status	打开设置界面的 Status 标签，显示版本、模型、账号等信息
/usage	显示套餐用量限制和速率限制状态

调试（Debug）

命令	说明
/doctor	诊断安装和配置问题，按 f 让 Claude 修复报告的问题
/feedback [report]	提交反馈。别名：/bug
/heapdump	写入 JavaScript 堆快照到桌面，用于诊断内存问题
/help	显示帮助和可用命令
/powerup	通过交互式课程发现 Claude Code 功能
/release-notes	查看变更日志（交互式版本选择）
/tasks	列出和管理后台任务。别名：/bashes

导出（Export）

命令	说明
/copy [N]	复制最后一条回复到剪贴板；指定 N 复制第 N 条；含代码块时显示选择器
/export [filename]	将当前对话导出为纯文本

扩展（Extensions）

命令	说明
/agents	管理 agent 配置
/chrome	配置 Claude in Chrome 设置
/hooks	查看工具事件的 hook 配置
/ide	管理 IDE 集成状态
/mcp	管理 MCP 服务器连接和 OAuth 认证
/plugin	管理 Claude Code 插件
/reload-plugins	重新加载所有活跃插件，无需重启即可应用更改
/skills	列出可用 skills

记忆（Memory）

命令	说明
/memory	编辑 CLAUDE.md 文件，启用/禁用自动记忆，查看自动记忆条目

模型（Model）

命令	说明
/effort [low|medium|high|xhigh|max|auto]	设置模型思考深度，不带参数时显示交互滑块
/fast [on|off]	切换快速模式
/model [model]	选择或切换 AI 模型，当前回复完成前立即生效
/passes	与朋友共享一周 Claude Code 使用权（账号资格限制）
/plan [description]	进入 Plan Mode；可附带描述立即开始规划任务
/ultraplan <prompt>	在 ultraplan session 中起草计划，在浏览器审核后远程执行或发回终端

项目（Project）

命令	说明
/add-dir <path>	为当前 session 添加工作目录
/diff	打开交互式 diff 查看器，查看未提交变更和每轮 Claude 的变更
/init	初始化项目，生成 CLAUDE.md（设 CLAUDE_CODE_NEW_INIT=1 启用交互式流程）
/review	在当前 session 本地审查 PR；深度云端审查见 /ultrareview
/security-review	分析当前分支待提交变更的安全漏洞
/team-onboarding	从 Claude Code 使用历史生成团队入职指南（分析最近 30 天）
/ultrareview [PR]	在云端沙箱中对指定 PR 进行多代理深度代码审查

远程（Remote）

命令	说明
/autofix-pr [prompt]	在云端启动 session，监控当前分支 PR 并在 CI 失败或有评论时自动推送修复
/desktop	在 Claude Code Desktop 中继续当前 session（macOS/Windows）。别名：/app
/install-github-app	为仓库设置 Claude GitHub Actions 应用
/install-slack-app	安装 Claude Slack 应用
/mobile	显示下载 Claude 移动应用的二维码。别名：/ios、/android
/remote-control	让当前 session 可从 claude.ai 远程控制。别名：/rc
/remote-env	配置 --remote 启动的 web session 默认远程环境
/schedule [description]	创建/更新/列出/运行 Routine（云端定时任务）。别名：/routines
/teleport	将 claude.ai 上的 web session 拉回本地终端
/web-setup	将 GitHub 账号连接到 Claude Code on the web

会话（Session）

命令	说明
/branch [name]	在当前位置创建对话分支。别名：/fork
/btw <question>	提一个旁路问题，不加入对话历史
/clear	清空对话历史释放上下文。别名：/reset、/new
/compact [instructions]	压缩对话，可带聚焦指令（如 /compact 聚焦在 auth 重构，丢弃测试调试内容）
/exit	退出 CLI。别名：/quit
/recap	按需生成当前 session 的一行摘要，不影响进行中的对话
/rename [name]	重命名当前 session；不带参数则自动从对话历史生成
/resume [session]	通过 ID 或名称恢复对话，或打开 session 选择器。别名：/continue
/rewind	回滚对话和代码到之前某个状态，或从所选消息生成摘要。别名：/checkpoint、/undo

实战案例：Weather Orchestrator Command

以下是 Command → Agent → Skill 编排模式的 Command 层实现：

---
description: 获取迪拜天气并生成 SVG 天气卡片
model: haiku
---

# Weather Orchestrator Command

## 工作流

### 第一步：询问用户偏好
使用 AskUserQuestion 工具询问用户希望显示摄氏度还是华氏度。

### 第二步：获取天气数据
使用 Agent 工具调用 weather-agent：
- subagent_type: weather-agent
- prompt: 获取迪拜当前温度（[用户选择的单位]）

### 第三步：生成天气卡片
使用 Skill 工具调用 weather-svg-creator skill

调用方式：

claude
/weather-orchestrator

Command 作为"总调度"：处理用户交互 → 委托 Agent 执行数据获取 → 调用 Skill 生成输出。

FAQ

Q: Command 和 Skill 有什么核心区别？ A: 最大区别是上下文注入时机。Skill 的 content 在 session 启动时就注入到上下文中供语义匹配；Command 的 content 只在用户显式触发（/command-name）时才注入。因此 Command 适合不需要 Claude 自动判断何时执行的入口流程，而 Skill 适合"当用户说 X 时我就知道该干什么"的场景。

Q: 如何让 Command 在隔离上下文中运行？ A: 在 frontmatter 中加 context: fork，可选配 agent: <type> 指定 subagent 类型。这样 Command 的执行不会在主会话留下中间步骤的痕迹。

Q: argument-hint 怎么传递参数？ A: 在 Command 文件正文中用 $ARGUMENTS 引用完整参数字符串，或用 $0、$1 引用位置参数。例如 /review 123 中 $0 就是 123。

Q: 内置命令可以被覆盖吗？ A: 可以在 .claude/commands/ 中创建同名文件来覆盖内置命令行为。但要注意覆盖内置命令可能影响 Claude 的预期功能。