命令系统

注册于 src/commands/compact/index.ts:

const compact = {
  type: 'local',
  name: 'compact',
  description: 'Clear conversation history but keep a summary in context',
  isEnabled: () => !isEnvTruthy(process.env.DISABLE_COMPACT),
  supportsNonInteractive: true,
  argumentHint: '<optional custom summarization instructions>',
  load: () => import('./compact.js'),
} satisfies Command

The load() 模式对于本地命令来说是通用的——它将繁重的实现模块推迟到实际调用命令之前，从而保持快速启动。 该模块必须导出 { call: LocalCommandCall }:

export const call: LocalCommandCall = async (args, context) => {
  // args = trimmed string after "/compact"
  // context = ToolUseContext + REPL state
  const customInstructions = args.trim()
  // ... runs compaction, returns:
  return { type: 'compact', compactionResult, displayText }
}

The LocalCommandCall 签名总是收到 (args: string, context: LocalJSXCommandContext) — 一个原始参数字符串（命令名称后面的所有内容）和一个丰富的上下文对象，其中包括消息、setMessages、选项和中止控制器。

注册于 src/commands/help/index.ts:

const help = {
  type: 'local-jsx',
  name: 'help',
  description: 'Show help and available commands',
  load: () => import('./help.js'),
} satisfies Command

加载的模块导出 { call: LocalJSXCommandCall }:

export const call: LocalJSXCommandCall = async (
  onDone,
  { options: { commands } },
) => {
  return <HelpV2 commands={commands} onClose={onDone} />
}

请注意 颠倒论证顺序 与本地命令相比： (onDone, context, args)。 这 onDone 回调接受可选的字符串结果加上选项，例如 shouldQuery, display， 和 nextInput。 什么时候 onDone() 触发后，REPL 会拆除组件并恢复正常输入。

The /model 命令使用相同的模式，但为其描述添加了一个计算的 getter，因此它始终反映当前选定的模型名称：

export default {
  type: 'local-jsx',
  name: 'model',
  get description() {
    return `Set the AI model (currently ${renderModelName(getMainLoopModel())})`
  },
  argumentHint: '[model]',
  get immediate() {
    return shouldInferenceConfigCommandBeImmediate()
  },
  load: () => import('./model.js'),
}

提示命令定义 getPromptForCommand 而不是 load。 他们返回一个数组 ContentBlockParam 命令触发时成为第一个用户转动的对象：

const command = {
  type: 'prompt',
  name: 'commit',
  description: 'Create a git commit',
  allowedTools: ['Bash(git add:*)', 'Bash(git status:*)', 'Bash(git commit:*)'],
  contentLength: 0,  // 0 = dynamic (computed at call time)
  progressMessage: 'creating commit',
  source: 'builtin',
  async getPromptForCommand(_args, context) {
    const promptContent = getPromptContent()
    const finalContent = await executeShellCommandsInPrompt(
      promptContent, context, '/commit'
    )
    return [{ type: 'text', text: finalContent }]
  },
} satisfies Command

The executeShellCommandsInPrompt 助手扫描提示 !`shell cmd` 反引号模式并在文本到达模型之前将其替换为实时 shell 输出。 就是这样 /commit 内联当前 git status, git diff HEAD，最近登录会自动提示。

allowedTools 限制模型在此命令执行期间可以调用哪些工具 - 一个安全层，可防止模型调用声明列表之外的任何内容。

技能（从 Markdown 文件加载的提示类型命令）从四个地方到达： getSkills(cwd):

• skillDirCommands — 加载自 .claude/skills/ 在项目或用户主页中。 这些是您或您的团队编写的 SKILL.md 文件。
• pluginSkills - 已安装插件中捆绑的技能（例如 /plugin install frontend-design@claude-plugins-official).
• bundledSkills — 技能编译到 Claude Code 二进制文件本身中（在启动时通过同步注册 getBundledSkills()).
• builtinPluginSkills - 来自始终启用的内置插件的技能，通过 getBuiltinPluginSkillCommands().

如果任何源加载失败，则会捕获并记录错误，但其余部分继续 - 技能加载故意是非致命的。

命令子集仅存在于 Anthropic 内部版本中。 它们被声明在 INTERNAL_ONLY_COMMANDS 并且仅附加到 COMMANDS() when process.env.USER_TYPE === 'ant':

export const INTERNAL_ONLY_COMMANDS = [
  backfillSessions,
  breakCache,
  bughunter,
  commit,
  commitPushPr,
  mockLimits,
  bridgeKick,
  // ...many more
].filter(Boolean)

// Inside COMMANDS():
...(!process.env.IS_DEMO && process.env.USER_TYPE === 'ant'
  ? INTERNAL_ONLY_COMMANDS : [])

这意味着像这样的命令 /commit and /bughunter 实际上，公共二进制文件中不存在它们 - 它们被 Bun 的捆绑程序消除了死代码。

The LocalJSXCommandOnDone 回调比看起来更丰富。 完整签名：

type LocalJSXCommandOnDone = (
  result?: string,
  options?: {
    display?: 'skip' | 'system' | 'user'  // default: 'user'
    shouldQuery?: boolean               // send messages to model after done
    metaMessages?: string[]            // model-visible but hidden from UI
    nextInput?: string                 // pre-fill the input box
    submitNextInput?: boolean          // auto-submit nextInput
  }
) => void

这意味着 JSX 命令可以在关闭时自动将预先编写的消息注入到模型管道中 - 例如 模型选择器可以在模型选择后自动提交确认。

当 Claude Code 在非交互（无头）模式下运行时（例如 claude -p "..."), 本地命令可以声明 supportsNonInteractive: true 保持可用。 /compact and /cost 两者都这样做。 由于没有终端 TUI，JSX 命令在无头模式下始终被阻止。

提示命令声明 disableNonInteractive: true 当它们依赖于交互状态（例如活动会话消息）时。 执行繁重模型工作的内置提示命令通常在两种模式下都可以工作。