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 的反面(有上下文无工具)