Claude Code 的命令系统,通过 / 前缀在会话内调用,用于控制模型、管理权限、操作上下文、编排 Agent 工作流。

核心机制

两类命令:内置命令(固定逻辑,如 /clear、/model)和 Bundled Skills(提示词驱动,如 /batch、/simplify),后者可以自主编排子任务。

命令只在消息开头识别,后续文本作为参数传入。输入 / 可查看所有可用命令,加字母过滤。

可用性因环境而异:平台、计划、环境不同,可见命令不同。例如 /desktop 仅 macOS/Windows 可见,/upgrade 仅 Pro/Max 可见。

典型工作流中的命令分布

项目初始化:/init 生成 CLAUDE.md,/memory 精调,/mcp 配置 MCP 服务器,/permissions 设置权限规则。

任务执行中:/plan 进入规划模式,/model 和 /effort 调整推理深度,/context 查看上下文占用,/compact 压缩历史,/btw 发送不影响历史的旁注。

并行工作:/agents 管理子 Agent,/tasks 查看后台任务,/background 将会话转为后台 Agent,/batch 将大型变更分解为并行单元。

发布前:/diff 查看变更,/simplify 代码质量优化,/review 或 /security-review 深度审查。

会话管理:/clear 开始新任务(保留项目记忆),/resume 恢复历史会话,/rewind 回滚到检查点。

关键命令速查

命令用途
/compact [instructions]压缩上下文,可指定保留重点
/context [all]可视化上下文占用,显示优化建议
/effort [level|auto]设置推理深度:low/medium/high/xhigh/max
/model [model]切换模型
/plan [description]进入规划模式
/batch <instruction>并行大规模代码变更(Skill)
/background [prompt]将当前会话转为后台 Agent
/rewind回滚代码和对话到检查点
/btw <question>旁注问题,不进入对话历史
/goal [condition]设置目标,Claude 持续工作直到达成
/loop [interval] [prompt]定时循环执行提示(Skill)
/autofix-pr [prompt]在云端自动修复 PR 的 CI 失败和 review 评论
/ultraplan <prompt>云端规划,浏览器审阅后执行
/ultrareview [PR]多 Agent 云端代码审查

MCP 提示词命令

MCP 服务器可以暴露提示词作为命令,格式为 /mcp__<server>__<prompt>,动态发现。

与其他概念的关联

  • skills — 自定义命令的推荐方式,通过 SKILL.md 定义
  • interactive-mode — 键盘快捷键和命令历史
  • cli-reference — 启动时的 CLI flags
  • env-vars — CLAUDE_CODE_FORK_SUBAGENT 等影响命令行为的环境变量

实践要点

  • /batch 需要 git 仓库,会为每个子任务创建独立 worktree 并开 PR
  • /compact 后 CLAUDE.md 和 auto memory 会重新从磁盘加载,对话中的临时指令可能丢失
  • /goal 设置后 Claude 跨 turn 持续工作,clear/stop/off/reset/none/cancel 可提前终止
  • /btw 不能使用工具,只能基于已有上下文回答,是 subagent 的反面(有上下文无工具)