跳至内容

命令表面

用户怎样接触 Claude Code 的能力?97 个命令入口构成了系统的操作表面,它们是工具能力向用户暴露的门面——理解命令和工具的区别,是理解这个系统的关键。

可视化对应:Commands 页面

这里的 97 是路径分桶后的入口数。 当前口径来自 ../src/commands/ 第一段路径归一化,并排除了 createMovedToPluginCommand、init、init-verifiers 三个内部 wiring 入口。因此它表示“有效命令入口面”,而不是所有用户在任意上下文下都能看到的 slash 命令数。

命令与工具的关系

    flowchart LR
  subgraph 用户面
    U[用户 /command] --> CMD[命令路由<br>src/commands/]
  end
  subgraph 编排层
    CMD -->|直接绑定| T1[单工具]
    CMD -->|多工具编排| T2[模型选择多工具]
    CMD -->|服务链| S[Service 调用]
    CMD -->|独立路径| I[内部逻辑]
  end
  subgraph 能力面
    T1 --> TOOL[工具系统<br>src/tools/]
    T2 --> TOOL
  end
  

命令 vs 工具

维度命令 (Commands)工具 (Tools)
触发方式用户输入 /command模型决定调用
数量97 个43 个
本质用户入口面系统能力面
权限部分需要认证统一走权限层
位置src/commands/src/tools/

关键认知:看到一个 /commit 命令,并不意味着有一个 CommitTool。命令更像是把多个工具能力编排在一起的产品入口。同样,很多工具(如 FileEditTool)从来不需要用户通过命令显式调用,而是模型在主循环中自动选择。

命令全景

指标数值
命令总数97
分组数7
总文件数189(含分组内部逻辑)

七大分组

1. Setup & Config(22 命令,73 files)

安装、认证、模型选择、插件管理、权限设置和环境配置。

命令功能
/login /logout认证管理
/config读写配置项
/model切换模型(Sonnet / Opus)
/mcpMCP 服务器管理
/permissions权限规则管理
/plugin /reload-plugins插件安装与重载
/theme终端主题切换
/upgrade版本升级
/install安装到系统
/install-github-app安装 GitHub App
/install-slack-app安装 Slack App
/terminalSetup终端配置
/add-dir添加工作目录
/remote-env /remote-setup远程环境配置
/sandbox-toggle沙箱开关
/privacy-settings隐私设置
/rate-limit-options速率限制选项
/output-style输出风格
/oauth-refreshOAuth 刷新

2. Daily Workflow(23 命令,44 files)

面向日常编码、恢复会话、计划、总结和任务推进。

命令功能
/plan进入计划模式(只分析不执行)
/compact手动触发上下文压缩
/memory记忆管理
/resume恢复历史会话
/session会话管理
/summary生成会话总结
/status查看当前状态
/tasks任务列表
/skills技能管理
/files查看相关文件
/context上下文信息
/usage用量查看
/help帮助信息
/copy复制到剪贴板
/clear清除上下文
/exit退出
/brief简洁模式
/hooks钩子管理
/onboarding新手引导
/rewind回退操作
/share分享会话
/version版本信息
/voice语音输入

3. Review & Git(10 命令,18 files)

围绕分支、提交、PR、diff、安全审查和问题管理。

命令功能
/review代码审查
/commitGit 提交
/commit-push-pr提交+推送+创建 PR 一条龙
/diff查看差异
/branch分支操作
/issueIssue 管理
/pr_commentsPR 评论处理
/security-review安全审查
/autofix-pr自动修复 PR
/rename重命名

4. Debugging & Diagnostics(18 命令,26 files)

问题诊断、指标观察、缓存调试与内部追踪。

命令功能备注
/doctor环境诊断公开
/cost费用查看公开
/stats使用统计公开
/env环境变量公开
/export导出数据公开
/feedback反馈公开
/release-notes发布说明公开
/ctx_viz上下文可视化feature-flagged
/debug-tool-call工具调用调试feature-flagged
/ant-trace内部追踪feature-flagged
/heapdump堆内存快照feature-flagged
/break-cache缓存打断feature-flagged
/mock-limits模拟限制feature-flagged
/reset-limits重置限制feature-flagged
/bughunterBug 猎手feature-flagged
/passes执行 Passfeature-flagged
/perf-issue性能问题feature-flagged
/insights洞察面板feature-flagged

5. Bridge & Remote(7 命令,12 files)

IDE 桥接、跨设备连接与远程控制。

命令功能
/ideIDE 集成(VS Code / JetBrains)
/bridgeBridge 桥接控制
/bridge-kick断开 Bridge 连接
/desktop桌面应用连接
/mobile移动端连接
/chromeChrome 扩展连接
/teleportTeleport 传送

6. Experimental Surface(13 命令,24 files)

更像产品表面的探索入口,观察产品方向。

命令功能状态
/ultraplan长时间规划(Opus 级模型)feature-flagged
/advisorAI 顾问模式feature-flagged
/thinkback /thinkback-play思维回溯与回放feature-flagged
/fast快速模式(切换到更快模型)公开
/good-claude正面反馈公开
/stickers贴纸系统feature-flagged
/statusline状态行配置feature-flagged
/btw顺便一说feature-flagged
/color颜色配置公开
/effort推理 effort 调节feature-flagged
/extra-usage额外用量追踪feature-flagged
/tag会话标签feature-flagged

7. Agents & Extensions(4 命令,7 files)

子代理管理、Vim 模式和内部迁移命令。

命令功能
/agents子代理管理
/vimVim 模式切换
/keybindings快捷键配置
/backfill-sessions会话数据回填(内部迁移)

命令到工具映射

命令和工具不是一一对应的。一条命令可能编排多个工具,一个工具也可能被多条命令复用。以下是主要命令与底层工具的映射关系:

命令底层工具 / 执行路径映射类型
/planEnterPlanModeTool → ExitPlanModeTool直接绑定
/compactsrc/services/compact/compact.ts直接调用服务
/memorymemdir/*、SessionMemory/*服务编排
/resumeSessionMemory + setCostStateForRestore()多服务协作
/commitBashTool(git 命令) + 模型编排工具 + 模型
/reviewFileReadTool + GrepTool + AgentTool(Verify)多工具编排
/commit-push-prBashTool × 3(commit → push → gh pr create)工具链
/diffBashTool(git diff)单工具
/voicevoice.ts + voiceStreamSTT.ts → 模型输入服务链
/mcpMCPTool 注册/卸载 + 配置写入配置 + 工具
/pluginPluginInstallationManager.ts服务调用
/agentsAgentTool + SendMessageTool + TaskStopTool多工具
/tasksTaskCreateTool / TaskGetTool / TaskListTool工具族
/doctor环境检查脚本(不经过工具系统)独立路径
/costcost-tracker.ts 读取状态读取
/vimsrc/vim/ 模式切换UI 层

读这张表时要注意:

  • “直接绑定"表示命令和工具一一对应
  • “多工具编排"表示命令背后是模型根据上下文自动选择多个工具
  • “服务链"表示命令触发的是一组服务调用,不经过标准工具系统
  • “独立路径"表示命令完全绕过工具和模型,直接执行内部逻辑

这也解释了为什么命令数(97)远多于工具数(43)——命令是面向用户的产品入口,工具是面向模型的能力面;二者之间的映射不是线性的。

Feature-Flagged 命令

在 97 个命令中,有相当一部分受 feature flag 控制,只有特定条件下才会出现。这些命令的存在是系统演化方向的重要信号。

主要的 feature-flagged 入口集中在:

  • 诊断工具:ctx_viz、debug-tool-call、ant-trace、heapdump — 内部调试能力
  • 实验表面:ultraplan、advisor、thinkback — 产品方向探索
  • 远程连接:bridge、desktop、mobile — 跨界面扩展

建议阅读顺序

  1. 工具平面 — 理解命令背后的能力
  2. 运行时流程 — 看命令如何进入主循环
  3. 扩展与信号 — 看实验命令和信号的关系