@zzy1998/claude-code

v999.0.12

Published

14 days ago

Restored Claude Code source tree reconstructed from source maps.

0High
0Medium
0Low

zzy1998

Claude Code 源码还原

从 @anthropic-ai/claude-code npm 包的 source map 中还原的完整 TypeScript 源码，可本地运行

[!WARNING] 本仓库为非官方版本，基于公开 npm 发布包 source map 还原，仅供研究学习。源码版权归 Anthropic 所有。

快速开始

安装 Bun

项目建议使用 Bun 1.3.5，并需要 Node.js ≥ 20.19。

npm install -g [email protected]

Windows PowerShell：

iex "& {$(irm https://bun.com/install.ps1)} -Version 1.3.5"

终端用户使用

npm install -g @zzy1998/claude-code
cc

Linux 上如需避免 cc 与 C 编译器命令冲突，请使用兼容命令 ccli。

本地安装并运行

bun ci            # 安装依赖（需要 Bun ≥ 1.3.5、Node.js ≥ 20.19）
bun run dev       # 启动 CLI
bun run version   # 验证版本

日常安装请使用 bun ci，不要使用普通 bun install，避免依赖重新解析后发生版本漂移。

Codex Claude Proxy 剩余额度提示

当通过 Codex Claude Proxy 调用模型时，CLI 会在每轮对话结束后请求代理的 GET /v1/usage，并在输入框左下角显示：

? for shortcuts · quota 85% · ctx 123k/160k

85% 是当前 Client API Key 的本周剩余额度百分比。CLI 使用现有环境变量连接和鉴权：

$env:ANTHROPIC_BASE_URL = "http://127.0.0.1:8081"
$env:ANTHROPIC_API_KEY = "你的 Client API Key"

也可以使用一条命令写入代理所需的用户级配置：

cc proxy config set <代理地址> <你的密钥>

该命令会将指定的 HTTP 或 HTTPS 代理地址写入 ANTHROPIC_BASE_URL，并同时设置 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY 和 CLAUDE_CODE_AUTO_COMPACT_WINDOW=258000。它会保留 ~/.claude/settings.json 中的其他配置，清除可能覆盖代理模型设置的 ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL 及 ANTHROPIC_MODEL。配置完成后重启 Claude Code 生效。

代理接口返回与 Claude Code 用量接口一致的 Utilization 结构，额度数据位于 seven_day.utilization 和 seven_day.resets_at。示例响应：

{
  "five_hour": null,
  "seven_day": {
    "utilization": 15,
    "resets_at": "2026-07-20T00:00:00.000Z"
  },
  "seven_day_oauth_apps": null,
  "seven_day_opus": null,
  "seven_day_sonnet": null,
  "extra_usage": null
}

seven_day.utilization 表示本周已使用百分比；CLI 将其换算为剩余百分比显示。每轮对话结束后，额度右侧还会显示当前会话的上下文占用和可用窗口，例如 ctx 123k/160k；分母复用自动压缩的有效窗口计算，会应用 CLAUDE_CODE_AUTO_COMPACT_WINDOW 并扣除摘要预留 token。未配置上述环境变量、代理不支持该接口或请求失败时，CLI 不显示额度提示，不影响正常对话。

npm 全局安装

npm install -g @zzy1998/claude-code
cc

Linux 上如需避免 cc 与 C 编译器命令冲突，请使用兼容命令 ccli。

更新/安装依赖

不要直接执行：

```bash bun add xxx


推荐流程如下。

#### 1. 确认要安装的版本

例如要添加：

```text
[email protected]

优先使用 tarball URL 形式：

"turndown": "https://mirrors.cloud.tencent.com/npm/turndown/-/turndown-7.2.4.tgz"

2. 手动写入 package.json

在 dependencies 中添加：

"turndown": "https://mirrors.cloud.tencent.com/npm/turndown/-/turndown-7.2.4.tgz"

不要写成：

"turndown": "*"

也尽量不要写成：

"turndown": "^7.2.4"

否则后续可能发生依赖漂移。

3. 同步 bun.lock

bun install --lockfile-only

4. 验证安装

bun ci
bun run version

命令说明

bun ci：用于日常安装和验证，会严格按照 bun.lock 安装。
bun install --lockfile-only：用于手动修改 package.json 后同步 bun.lock，不会安装依赖。

从源码中发现的 7 大隐藏功能

通过阅读还原后的 1,987 个 TypeScript 源文件，我们发现了大量未公开的隐藏功能。这些功能通过编译开关（feature()）和用户类型（USER_TYPE）进行门控，外部发布版中大部分被裁剪。

1. BUDDY — AI 电子宠物

源码位置：src/buddy/ · 查看完整分析 →

终端里的拓麻歌子！一个完整的虚拟宠物系统。

18 种物种：鸭子、鹅、猫、龙、章鱼、猫头鹰、企鹅、乌龟、蜗牛、幽灵、六角恐龙、水豚、仙人掌、机器人、兔子、蘑菇、果冻、胖猫
5 级稀有度：普通(60%) → 非凡(25%) → 稀有(10%) → 史诗(4%) → 传说(1%)
1% 闪光概率：独立于稀有度，任何宠物都有 1% 概率成为闪光个体
确定性生成：使用账号 UUID + 固定盐值 'friend-2026-401' 经 FNV-1a 哈希 → Mulberry32 PRNG，每人只会得到一只固定的宠物，改配置也没用
外观系统：6 种眼睛样式 + 8 种帽子（皇冠、巫师帽、光环等），common 稀有度没有帽子
交互：/buddy pet 抚摸（爱心动画）、/buddy hatch 孵化、/buddy card 查看卡片
动画：500ms 帧率的 ASCII 精灵动画，气泡对话，窄终端自动退化为表情文字脸（如 =·ω·=）
编译开关：feature('BUDDY')

2. KAIROS — 永不关机的 Claude

源码位置：src/assistant/、src/proactive/、src/services/autoDream/ · 查看完整分析 →

关掉终端 Claude 还在运行的持久助手模式。

跨会话持久运行：通过 .claude/settings.json 的 assistant: true 激活，会话状态持久化到磁盘
每日日志：自动在 <autoMemPath>/logs/YYYY/MM/YYYY-MM-DD.md 记录工作日志
自动做梦（Dream）：距上次整合超 24 小时且有 5+ 新会话时，后台自动启动记忆整合子代理，分四阶段运行：Orient → Gather → Consolidate → Prune
锁机制：.consolidate-lock 文件 + PID 存活检查，防止多进程同时做梦
主动模式（Proactive）：没人说话时自己找活干，没活就调用 SleepTool 等着。接收周期性 <tick> 提示来检查是否有事可做
后台任务：命令超 15 秒自动丢后台，支持持久 cron 任务（permanent: true 不受 7 天过期限制）
编译开关：feature('KAIROS')、feature('KAIROS_BRIEF')、feature('KAIROS_CHANNELS')
远程开关：GrowthBook tengu_kairos、tengu_onyx_plover（Dream 阈值配置）

3. ULTRAPLAN — 云端深度规划

源码位置：src/commands/ultraplan.tsx、src/utils/ultraplan/ · 查看完整分析 →

把难题甩给云端 Opus 独立研究最长 30 分钟。

流程：/ultraplan <prompt> → 创建远程 CCR 会话 → Opus 模型独立研究 → 后台轮询等待（30 分钟超时）→ 浏览器查看/修改方案 → 批准执行或传送回本地
关键词触发：消息中包含 "ultraplan" 自动触发，智能排除引号/路径/标识符中的误触发
传送（Teleport）：src/utils/teleport.tsx 实现本地 ↔ 远程会话传输，支持 Git Bundle 打包代码上下文
完全内部限定：isEnabled: () => "external" === 'ant'，外部版永远不可用
编译开关：feature('ULTRAPLAN')
远程开关：tengu_ultraplan_model（控制使用的模型）

4. Coordinator — 多 Agent 编排模式

源码位置：src/coordinator/ · 查看完整分析 →

主 Claude 变成纯指挥官，Worker 并行执行任务。

角色分离：Coordinator 只有三个工具——派活（Agent）、通信（SendMessage）、停工（Shutdown）
Worker 机制：Worker 在独立子进程中运行，各自拥有完整工具集
核心铁律：系统提示中明确规定"禁止甩锅式委派"——不能把不清楚的需求直接丢给 Worker
任务追踪：基于文件的共享任务列表（~/.claude/tasks/），Coordinator 和 Worker 共同读写
编译开关：feature('COORDINATOR_MODE')
环境变量：CLAUDE_CODE_COORDINATOR_MODE

5. 隐藏命令 & 秘密开关

源码位置：src/commands.ts、src/main.tsx · 查看完整分析 →

隐藏命令、内部命令、编译开关、隐藏 CLI 参数及环境变量统一维护在该文档中。README 的斜杠命令清单仅提供按使用场景分类的速查说明，避免维护两份重复表格。

常见受限能力包括远程控制、持久助手、语音、工作流、宠物和云端深度规划；它们是否可见取决于构建开关、登录方式、套餐资格和服务端策略。

6. Bridge — 远程遥控终端

源码位置：src/bridge/（33 个文件） · 查看完整分析 →

从 claude.ai 或手机直接操控本地 CLI。

WebSocket 实时连接：本地 CLI 通过 WebSocket 与 claude.ai 建立双向通道
完整远程控制：远程端可以发送消息、批准权限、查看输出
进程间通信：跨 Claude 会话的消息传递机制
状态同步：bridgeStatusUtil.ts 实时同步运行状态
权限回调：bridgePermissionCallbacks.ts 远程权限审批
编译开关：feature('BRIDGE_MODE')、feature('DAEMON')

7. 50 个编译开关 + 远程门控

外部发布版是阉割版。Anthropic 通过三层门控控制功能。查看完整分析 →

第一层：编译时开关（`feature()`，约 50 个）

构建时决定代码包含/排除，以下是完整列表：

| 开关 | 说明 | |------|------| | BUDDY | 宠物伴侣系统 | | KAIROS | 持久助手模式 | | KAIROS_BRIEF | 简报模式 | | KAIROS_CHANNELS | 通道通知 | | KAIROS_GITHUB_WEBHOOKS | GitHub Webhook | | ULTRAPLAN | 云端深度规划 | | COORDINATOR_MODE | 多 Agent 编排 | | BRIDGE_MODE | 远程控制桥接 | | VOICE_MODE | 语音交互 | | PROACTIVE | 主动自主模式 | | FORK_SUBAGENT | 子代理分叉 | | DAEMON | 守护进程模式 | | UDS_INBOX | Unix Socket 收件箱 | | WORKFLOW_SCRIPTS | 工作流脚本 | | TORCH | Torch 功能 | | MONITOR_TOOL | 监控工具 | | HISTORY_SNIP | 历史截断 | | ANTI_DISTILLATION_CC | 反蒸馏保护 | | BASH_CLASSIFIER | Bash 命令分类器 | | BG_SESSIONS | 后台会话 | | CACHED_MICROCOMPACT | 缓存微压缩 | | CCR_REMOTE_SETUP | Web 远程设置 | | CHICAGO_MCP | MCP 扩展（Computer Use） | | COMMIT_ATTRIBUTION | 提交归属标注 | | CONNECTOR_TEXT | 连接器文本 | | CONTEXT_COLLAPSE | 上下文折叠 | | COWORKER_TYPE_TELEMETRY | 协作者遥测 | | DOWNLOAD_USER_SETTINGS | 下载用户设置 | | EXPERIMENTAL_SKILL_SEARCH | 实验性技能搜索 | | EXTRACT_MEMORIES | 自动提取记忆 | | FILE_PERSISTENCE | 文件持久化 | | HARD_FAIL | 硬失败模式 | | LODESTONE | Lodestone 功能 | | MCP_SKILLS | MCP 技能系统 | | MEMORY_SHAPE_TELEMETRY | 记忆形状遥测 | | MESSAGE_ACTIONS | 消息操作 | | NATIVE_CLIENT_ATTESTATION | 客户端证明 | | PROMPT_CACHE_BREAK_DETECTION | 缓存中断检测 | | QUICK_SEARCH | 快速搜索 | | REACTIVE_COMPACT | 响应式压缩 | | SLOW_OPERATION_LOGGING | 慢操作日志 | | STREAMLINED_OUTPUT | 精简输出 | | TEAMMEM | 团队记忆同步 | | TEMPLATES | 模板/分类器 | | TERMINAL_PANEL | 终端面板 | | TOKEN_BUDGET | Token 预算 | | TRANSCRIPT_CLASSIFIER | 转录分类器 | | UNATTENDED_RETRY | 无人值守重试 | | UPLOAD_USER_SETTINGS | 上传用户设置 | | BREAK_CACHE_COMMAND | 缓存清除注入 |

第二层：用户类型（`USER_TYPE`）

ant（Anthropic 内部）— 解锁全部功能、20 分钟 GrowthBook 刷新、调试工具、200+ 处专属检查
external（外部用户）— 裁剪版，6 小时 GrowthBook 刷新

第三层：GrowthBook 远程 A/B 测试

| 开关 | 控制内容 | |------|---------| | tengu_kairos | KAIROS 助手模式开关 | | tengu_onyx_plover | 自动做梦阈值（间隔/会话数） | | tengu_cobalt_frost | 语音识别（Nova 3）开关 | | tengu_ultraplan_model | Ultraplan 使用的模型 | | tengu_ant_model_override | 内部用户模型覆盖 | | tengu_session_memory | 会话记忆功能 | | tengu_max_version_config | 自动更新 Kill Switch | | tengu_frond_boric | 数据接收器 Kill Switch | | tengu_herring_clock | 团队记忆路径 | | tengu_sm_config | 会话记忆配置 |

隐藏环境变量速查

| 环境变量 | 说明 | |----------|------| | ANTHROPIC_MODEL | 模型覆盖 | | CLAUDE_CODE_MAX_OUTPUT_TOKENS | 最大输出 token | | CLAUDE_CODE_DISABLE_THINKING | 禁用思考 | | CLAUDE_CODE_PROACTIVE | 主动模式 | | CLAUDE_CODE_COORDINATOR_MODE | 协调器模式 | | CLAUDE_CODE_BRIEF | 简报模式 | | CLAUDE_CODE_USE_BEDROCK | 使用 AWS Bedrock | | CLAUDE_CODE_USE_VERTEX | 使用 Google Vertex | | CLAUDE_CODE_DISABLE_AUTO_MEMORY | 禁用自动记忆 | | CLAUDE_CODE_EXTRA_BODY | API 附加 JSON | | CLAUDE_CODE_SYNTAX_HIGHLIGHT | 语法高亮主题 | | CLAUDE_CODE_IDLE_THRESHOLD_MINUTES | 空闲阈值（默认 75 分钟） | | CLAUDE_INTERNAL_FC_OVERRIDES | GrowthBook 覆盖（仅 ant） |

项目结构

src/                    # 核心源码（1,987 个 TS/TSX）
├── tools/              # 最多 51 个静态内置工具（实际数量受运行条件影响）
├── commands/           # 87 个斜杠命令
├── services/           # API / MCP / analytics / autoDream
├── components/         # 148 个终端 UI 组件（React + Ink）
├── hooks/              # 87 个自定义 Hooks
├── buddy/              # 宠物伴侣系统
├── assistant/          # KAIROS 助手模式
├── coordinator/        # 多 Agent 协调器
├── bridge/             # 远程控制桥接（31 文件）
├── proactive/          # 主动模式
├── vim/                # Vim 模式引擎
├── voice/              # 语音交互
└── ...
shims/                  # 原生模块兼容替代
vendor/                 # 原生绑定源码

工具清单与注入机制

工具注册以 src/tools.ts 的 getAllBaseTools() 为准。当前源码最多注册 51 个静态内置工具，MCP Server 还可动态提供任意数量的工具；“源码中存在”“进入候选池”“本次请求发送给模型”是三个不同阶段，不能直接用源码目录数量推断模型实际可见的工具数。

工具如何进入模型上下文

构建期裁剪：feature('...') 决定某些模块是否被打包；未编入当前构建的工具不可能在运行时启用。
候选池注册：getAllBaseTools() 根据构建特性、USER_TYPE 和环境变量组成静态候选池。
会话级过滤：getTools() 再应用 Simple/REPL 等运行模式、权限中的整工具 deny 规则，以及每个工具的 isEnabled()。
动态合并：assembleToolPool() 合并已连接 MCP Server 的工具；同名时内置工具优先。REPL 通过 useMergedTools() 使用该结果，Coordinator 还会再次缩减工具集。
请求级注入：toolToAPISchema() 调用工具的 prompt()，生成 name、完整操作说明和 input_schema，随后 queryModel() 把它们放入 Anthropic Messages API 的 tools 参数。严格来说，工具定义不是拼接进 system 字符串，而是作为与系统提示词并列的 API 工具定义发送。
延迟加载：启用 ToolSearch 时，MCP 工具以及声明了 shouldDefer: true 的内置工具，初始通常只通过 <system-reminder> 中的 deferred-tools delta（旧路径为 <available-deferred-tools>）告知名称、轻量用途和关键边界；模型先调用 ToolSearch，其完整说明和 JSON Schema 才从后续请求开始进入 tools。若工具搜索关闭，则这些工具直接内联。
运行时补充上下文：团队上下文、团队邮箱、Task V2 提醒、Agent 清单变化和 deferred-tool 名称变化由 src/utils/attachments.ts 作为隐藏的用户消息附件注入，不属于工具 Schema。

description() 主要用于 UI、工具选择器或摘要；模型在 API 工具定义中读到的长说明来自 prompt()。

所有会话都会经过的通用限制

| 限制 | 实际行为 | |---|---| | 整工具 deny 规则 | 若权限配置对某工具名或某个 MCP Server 前缀设置无参数的 deny，该工具会在请求前移除，而不只是调用时拒绝。 | | CLAUDE_CODE_SIMPLE | 普通情况下仅留下 Bash、Read、Edit；若同时处于 Coordinator 模式，还加入 Agent、TaskStop、SendMessage。Simple + REPL 模式则用 REPL 替代底层原语。 | | REPL 模式 | REPL 启用后，REPL_ONLY_TOOLS 中的底层工具不再直接暴露，而由 VM 内的 REPL 包装调用。 | | Coordinator 模式 | 主协调器只保留 Agent、TaskStop、SendMessage、StructuredOutput，以及名称匹配 PR 活动订阅/退订的 MCP 工具。 | | 子 Agent | 使用独立的 worker 权限上下文重新组装工具池，再按同步/后台、内置/自定义 Agent 类型过滤；MCP 工具通常可保留。 | | 工具搜索 | ENABLE_TOOL_SEARCH 未设置时默认为开启；false 或 auto:100 关闭，true 或 auto:0 强制开启，auto/auto:1..99 按延迟工具描述总量阈值决定。 | | 工具搜索兼容性 | CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 会强制关闭；不支持 tool_reference 的模型（默认匹配 Haiku）关闭；ToolSearch 被 deny 时也关闭。自定义 ANTHROPIC_BASE_URL 默认会关闭，但可显式设置非空 ENABLE_TOOL_SEARCH 表示代理兼容。 |

下表中的“直接”表示通过以上过滤后，完整工具说明和参数 Schema 从本次 API 请求直接发送；“按需”表示工具进入候选池后不会立即发送完整 Schema：工具搜索开启时，模型先看到工具名称和轻量用途提示，并在判断当前任务需要该工具时通过 ToolSearch 查询，查询命中后才从后续请求发送完整 Schema；工具搜索关闭时则退化为直接发送。各按需项同时说明通常触发查询的任务时机。

缓存测试结论：在当前代理链路中，首次加载延迟工具会使请求工具数增加并造成一次 Prompt Cache 未命中；工具列表稳定后随即恢复命中。因此延迟工具系统不会持续破坏缓存，但首次加载每种新工具可能产生一次缓存失效。此现象属于当前代理对 defer_loading/tool_reference 的实际处理结果，不应直接等同于 Anthropic 原生 API 的行为。

常规内置工具

| 工具 | 作用 | 进入候选池/启用条件 | 注入时机 | |---|---|---|---| | Agent（旧别名 Task） | 启动同步或后台子代理，支持模型选择和 worktree 隔离；在已有 Team 上下文中传 name 时创建持久队友。 | 基础注册；仍受通用模式、权限和 Agent 类型过滤。 | 直接；启用 fork-subagent 时还会明确禁止延迟。Agent 类型清单默认写入该工具的 prompt()；若 CLAUDE_CODE_AGENT_LIST_IN_MESSAGES 或 tengu_agent_list_attach 开启，则改由 agent_listing_delta 附件动态注入。 | | TaskOutput | 获取后台 Shell、Agent 或远程任务输出；当前已建议改为读取任务返回的输出文件。 | 基础注册。 | 按需：需要等待或查看仍在运行、且没有可直接读取输出文件的后台任务时查询。 | | Bash | 执行 Shell 命令，支持权限、沙箱和后台运行。 | 基础注册。 | 直接。 | | Glob | 按文件名模式查找文件。 | 仅 hasEmbeddedSearchTools() 为 false；含内嵌 bfs 搜索能力的构建不注册。 | 直接。 | | Grep | 使用正则表达式搜索文件内容。 | 与 Glob 相同。 | 直接。 | | Read | 读取文本、图片、PDF、Notebook 等文件。 | 基础注册。 | 直接。 | | Edit | 对现有文件执行精确字符串替换。 | 基础注册。 | 直接。 | | Write | 创建文件或完整覆盖文件。 | 基础注册。 | 直接。 | | NotebookEdit | 插入、替换或删除 Notebook 单元格。 | 基础注册。 | 按需：任务要求修改 .ipynb 的指定单元格（插入、替换或删除）时查询；只读取 Notebook 时仍使用 Read。 | | WebFetch | 获取并分析指定网页。 | 基础注册。 | 按需：用户提供了需要读取、摘取或分析的具体公开 URL 时查询；需要先发现网页时使用 WebSearch。 | | WebSearch | 搜索互联网获取时效信息。 | 基础注册；First-party 和 Foundry 启用，Vertex 仅对 Claude 4 系列启用，其他 Provider 禁用。 | 按需：问题依赖最新资料、当前事件或本地知识中没有的信息，且需要先在互联网上发现来源时查询。 | | Skill | 加载并执行已安装 Skill。 | 基础注册。 | 直接；可用 Skill 清单另由会话提醒注入。 | | TaskStop（旧别名 KillShell） | 停止后台 Shell 或 Agent。 | 基础注册。 | 按需：用户要求取消后台工作，或后台任务已无须继续、阻塞流程或行为异常时查询。 | | AskUserQuestion | 发起结构化单选、多选或澄清问题。 | 基础注册；启用 KAIROS/KAIROS_CHANNELS 且存在远程 channel 时禁用，避免无人操作本地 TUI 对话框。 | 按需：存在无法从代码或上下文确定、且会影响实现方向的需求或选项时查询。 | | EnterPlanMode | 请求进入计划模式。 | 与 AskUserQuestion 使用相同的 channel 禁用条件。 | 按需：准备开展非简单的新功能、多文件修改、架构选择或需求不清的实现任务，需要先研究并取得方案认可时查询。 | | ExitPlanMode | 读取方案文件并请求批准进入实现。 | 与 AskUserQuestion 使用相同的 channel 禁用条件。 | 按需：已处于计划模式、方案文件已经完整写好且不存在未决问题，需要请求用户批准实现时查询。 | | SendMessage | 向队友、团队广播或受支持的本地/远程收件箱发送消息，并处理旧版 shutdown/plan-approval 协议。 | 基础注册；Team 功能当前已成为外部基础能力，isAgentSwarmsEnabled() 恒为 true。 | 直接，明确不延迟，保证控制消息可随时发送和响应。 | | SendUserMessage（源码对象 BriefTool） | 在 Brief/KAIROS 模式中把消息、问题或附件发送给用户。 | 构建必须包含 KAIROS 或 KAIROS_BRIEF；同时需 Assistant 模式已激活或用户主动 opt-in，并通过 tengu_kairos_brief 资格/kill-switch。 | 直接，明确不延迟。 |

TodoWrite 与 Task V2 互斥：交互式会话默认启用 Task V2，因此通常显示 TaskCreate/TaskGet/TaskUpdate/TaskList；非交互式会话默认回退到 TodoWrite，除非显式设置 truthy 的 CLAUDE_CODE_ENABLE_TASKS。

两者解决的问题层级不同：TodoWrite 是由单个 Agent 整体重写的一张轻量会话清单；Task V2 将每项工作保存为带唯一 ID 的独立任务，可单独查询和更新，并支持负责人、阻塞依赖、metadata、磁盘持久化及 Team 共享。保留两套主要是为了让非交互式 CLI 和 SDK 继续兼容旧工具名及输入 Schema，同时让交互式会话和多 Agent 协作使用能力更完整的新任务系统。

TodoWrite 与 Task V2 的使用场景

| 场景 | 使用的工具 | 原因 | |---|---|---| | 普通交互式 Claude Code 会话 | Task V2 | 默认启用，可按任务 ID 精确更新，适合跟踪当前编码任务。 | | Agent Team 协作 | Task V2 | 多个 Agent 需要共享任务、设置 owner、声明 blocks/blockedBy 并避免整体清单相互覆盖。 | | 任务之间存在先后依赖 | Task V2 | 可明确记录阻塞关系，并通过 TaskList 找到已经解除阻塞的工作。 | | 任务需要跨进程读取或恢复 | Task V2 | 每个任务独立持久化到 ~/.claude/tasks/<任务列表ID>/。 | | claude -p、SDK 等非交互式调用 | TodoWrite（默认） | 保持旧版工具名和输入 Schema 兼容，调用方无须立即适配四个 Task V2 工具。 | | 非交互式调用需要任务分派、依赖或持久化 | Task V2 | 设置 truthy 的 CLAUDE_CODE_ENABLE_TASKS 后显式启用新版工具。 | | 单个 Agent 只需展示简单步骤清单 | TodoWrite（仅在其可用的会话中） | 一次提交完整 todos 数组即可更新清单，不需要负责人和依赖模型。 | | 单一、简单、可立即完成的工作 | 两者都不使用 | 工具提示均要求避免为没有跟踪价值的简单任务创建清单。 |

选择原则：由运行模式决定默认工具，不需要人为同时选择。模型应在当前会话提供的工具中使用对应的一套；只有非交互式调用方确实需要 Task V2 能力时，才设置 CLAUDE_CODE_ENABLE_TASKS=1。TodoWrite 每次调用会替换完整数组，更适合单 Agent；Task V2 按任务 ID 增量修改，更适合持久化和协作，但一次完整操作通常需要多次工具调用。

| 工具 | 作用 | 进入候选池/启用条件 | 注入时机 | |---|---|---|---| | TodoWrite | 整体写入或替换当前 Agent 的轻量会话待办清单；适合旧版非交互调用和无需协作的简单进度展示。 | 仅 isTodoV2Enabled() 为 false。 | 按需：旧任务系统可用，且当前工作包含多个值得展示进度、但不需要负责人或依赖关系的步骤时查询。 | | TaskCreate | 创建状态为 pending 的独立结构化任务；适合拆分工作或建立可分派任务。 | isTodoV2Enabled()：交互式会话默认开启；非交互式须设置 truthy 的 CLAUDE_CODE_ENABLE_TASKS。 | 按需：当前工作需要拆成多个可独立跟踪、分派或建立依赖的任务时查询。 | | TaskGet | 获取指定任务的完整描述、负责人和依赖；适合开始工作或更新前确认最新状态。 | 同 TaskCreate。 | 按需：准备开始、接手或修改某个已知任务，需要读取其完整要求和最新依赖时查询。 | | TaskUpdate | 增量更新状态、负责人、依赖和 metadata；适合认领、分派、解除阻塞和完成任务，团队中还可触发分派消息。 | 同 TaskCreate。 | 按需：任务的状态、负责人、描述、依赖或 metadata 发生变化时查询。 | | TaskList | 查看任务概览并发现未认领、可执行或仍被阻塞的任务；适合主 Agent 和队友协调下一步工作。 | 同 TaskCreate。 | 按需：需要查看整体进度、寻找下一项可执行任务或确认阻塞关系时查询。 |

Team 工具（当前实现）

Team 不再受实验开关限制：TeamCreate、TeamDelete 和 SendMessage 都会进入基础候选池。不过，技术上可用不等于模型可随意创建 Team：工具提示要求 Team 必须由用户明确提出，或由模型在开始任何实质执行前通过 AskUserQuestion 提议并取得明确授权；普通、独立的并行调查应优先使用多个一次性 Agent，不能仅因任务较大就创建 Team。

| 工具 | 作用与调用条件 | 注入时机 | |---|---|---| | TeamCreate | 创建持久协作 Team 及共享任务目录。仅在需要队友直接通信、共享任务所有权、动态转派或跨轮次交接，并已获得用户授权时调用；必须先单独成功创建 Team，之后才能创建共享任务或通过 Agent(name, team_name) 启动队友。一个 lead 不能同时领导多个 Team。 | 按需：用户明确要求 Team，或任务确实需要持久的跨代理协调且模型在实质执行前已取得用户授权时查询。成功调用后，返回结果会把活跃 Team 操作契约直接补充给模型；团队上下文随后还会通过附件持续注入。 | | TeamDelete | 清理 Team、任务目录、邮箱和上下文。删除前必须先关闭或移除全部非 lead 注册成员，idle 成员也算；否则拒绝删除。 | 按需：已创建的 Team 完成或废弃，且所有非 lead 成员均已关闭或移除，需要清理团队资源时查询。 | | SendMessage | 按队友名投递，* 表示广播；结构化 shutdown/plan-approval 消息有额外目标限制。 | 直接，无须先经 ToolSearch。Team 创建后，邮箱消息作为附件在后续轮次注入。 | | Agent | 无 name 时是有界的一次性子代理；有活跃 Team 且传入 name 时才进入持久队友分支。队友不能再创建队友，但可省略 name 启动同步子代理。 | 直接。 |

Team 下的 Task ID 解析顺序为：CLAUDE_CODE_TASK_LIST_ID → 进程内队友所属 Team → CLAUDE_CODE_TEAM_NAME → lead 当前 Team → 当前 Session。因而 lead 与队友默认共享同一任务表。

条件构建或条件启用工具

feature('NAME') 是构建期能力：必须由当前发行构建包含，用户仅设置同名环境变量通常不能把已被裁剪的代码重新启用。下表同时列出构建条件与额外运行时条件。

| 工具 | 作用 | 完整启用条件 | 注入时机 | |---|---|---|---| | Config | 修改 Claude Code 配置。 | USER_TYPE === 'ant'。 | 按需：内部用户明确要求读取或修改 Claude Code 配置，且应使用专用配置工具而非手工编辑时查询。 | | SuggestBackgroundPR | 建议使用后台代理处理 PR。 | USER_TYPE === 'ant'，对应模块才会被加载。 | 直接。 | | WebBrowser | 浏览器访问和自动化。 | 构建包含 WEB_BROWSER_TOOL。 | 直接。 | | terminal_capture | 捕获终端面板内容。 | 构建包含 TERMINAL_PANEL。 | 直接。 | | LSP | 使用语言服务器执行诊断和符号查询。 | truthy 的 ENABLE_LSP_TOOL，并通过工具自身 isEnabled()。 | 按需：需要语言服务器提供类型诊断、定义/引用或符号信息，而文本搜索不足以回答时查询。 | | EnterWorktree | 创建并进入会话隔离 worktree。 | isWorktreeModeEnabled() 当前恒为 true；实际调用仍要求用户明确提到 worktree，且当前环境必须是 Git 仓库或配置了 Worktree hooks。 | 按需：仅当用户明确要求在 worktree 中工作，并且需要创建隔离工作目录时查询。 | | ExitWorktree | 离开由本会话创建的 worktree并保留或删除。 | 与 EnterWorktree 一同恒定注册；只对本会话通过 EnterWorktree 创建的 worktree 生效。 | 按需：用户要求离开本会话创建的 worktree，并选择保留或删除该 worktree 时查询。 | | ListPeers | 列出 UDS Inbox 可通信进程。 | 构建包含 UDS_INBOX。 | 直接。 | | verify_plan_execution | 核对计划步骤是否执行。 | CLAUDE_CODE_VERIFY_PLAN === 'true'。 | 直接。 | | REPL | 在受控 VM 中执行代码并包装底层工具。 | USER_TYPE === 'ant' 且 REPL 模块存在；运行时还需 REPL 模式生效。 | 直接；生效后替换一组底层原语。 | | workflow | 执行内置 Workflow 脚本。 | 构建包含 WORKFLOW_SCRIPTS。 | 直接；子 Agent 默认禁止递归调用。 | | Sleep | 在主动/KAIROS 模式暂停并等待事件。 | 构建包含 PROACTIVE 或 KAIROS。 | 直接。 | | CronCreate | 创建会话级或持久定时任务。 | 构建包含 AGENT_TRIGGERS；CLAUDE_CODE_DISABLE_CRON 未开启；tengu_kairos_cron kill-switch 为 true（默认 true）。 | 按需：用户要求按指定时间或周期自动执行提示词/任务时查询。 | | CronDelete | 删除定时任务。 | 同 CronCreate。 | 按需：用户要求取消某个已存在的定时任务时查询。 | | CronList | 列出定时任务。 | 同 CronCreate。 | 按需：用户要查看现有定时任务，或删除前需要确认任务 ID 时查询。 | | RemoteTrigger | 创建或处理远程 Agent 触发器。 | 构建包含 AGENT_TRIGGERS_REMOTE，且 tengu_surreal_dali 为 true、策略 allow_remote_sessions 允许。实际调用还要求 Claude.ai OAuth 和组织 ID 可用。 | 按需：用户要求配置或处理可从远程事件启动 Agent 的触发器时查询。 | | Monitor | 实验性监控能力。 | 构建包含 MONITOR_TOOL 且模块导出真实工具；当前还原源码的 MonitorTool 为 null，因此实际不会注册。 | 直接（存在真实工具时）。 | | send_user_file | 通过 KAIROS/Bridge 向用户发送文件。 | 构建包含 KAIROS，且模块导出真实工具并通过自身运行时条件；当前还原目录仅保留 prompt.ts，无法从本仓库进一步确认实现 gate。 | Bridge 已连接时由延迟判断明确强制直接；其余时机取决于真实工具定义。 | | PushNotification | 发送推送通知。 | 构建包含 KAIROS 或 KAIROS_PUSH_NOTIFICATION。 | 直接。 | | SubscribePR | 订阅 GitHub PR/Webhook 事件。 | 构建包含 KAIROS_GITHUB_WEBHOOKS。 | 直接。 | | PowerShell | 使用独立的权限和路径规则执行 PowerShell。 | 仅 Windows；内部用户默认开启，可用 falsy 的 CLAUDE_CODE_USE_POWERSHELL_TOOL 关闭；外部用户默认关闭，须设置 truthy 的该变量开启。 | 直接。 | | snip | 裁剪会话历史内容。 | 构建包含 HISTORY_SNIP。 | 直接。 | | TestingPermissionTool | 测试工具权限流程。 | 仅 NODE_ENV === 'test'。 | 直接。 | | ToolSearch | 查询延迟工具的完整说明和 Schema。 | isToolSearchEnabledOptimistic() 先允许注册，并在每次模型请求前再检查环境模式、模型兼容性、工具是否被 deny 以及 auto 阈值。 | 工具搜索实际开启时直接；关闭时从请求工具列表移除。 |

MCP 工具与资源辅助工具

MCP Server 连接成功后，通过 tools/list 返回的工具动态加入工具池，通常命名为：

mcp__<服务器名>__<工具名>

MCP 工具默认均为按需：首次公布名称以及可用的轻量用途提示，经 ToolSearch 返回 tool_reference 后，完整 Schema 才在后续请求发送；若服务端通过 _meta['anthropic/alwaysLoad'] 设置 alwaysLoad: true，则改为直接注入。工具搜索关闭时，所有 MCP 工具直接内联。

| 工具 | 启用条件 | 注入时机 | |---|---|---| | ListMcpResourcesTool | 至少一个已连接 MCP Server 声明 capabilities.resources；全局只追加一组资源辅助工具。 | 按需：任务需要发现已连接 MCP Server 提供了哪些可读资源时查询。它虽然列在 getAllBaseTools()，但会被 getTools() 的 special-tools 过滤，随后仅由 MCP 连接流程动态加入。 | | ReadMcpResourceTool | 与 ListMcpResourcesTool 相同。 | 按需：已知或刚列出目标 MCP 资源，需要读取其内容时查询。 | | mcp__* | 对应 MCP Server 已配置、连接成功并通过 tools/list 返回该工具，同时未被权限 deny。 | 默认按需：当前任务与工具名称或轻量用途提示匹配、模型准备调用该 MCP 能力时查询；alwaysLoad: true 时直接。晚连接、断线重连或工具列表变化会通过 MCP/deferred-tools delta 附件更新模型可见名称。 |

因此，更准确的数量表达是：最多 51 个静态注册项，加上 N 个动态 MCP 工具，但每次请求只发送通过全部 gate 且当前需要的子集。

主会话与子 Agent 的注入差异

主 REPL：useMergedTools() → assembleToolPool() → mergeAndFilterTools() → queryModel() → toolToAPISchema() → API tools。
普通同步子 Agent：重新组装 worker 工具池；默认移除 TaskOutput、计划模式工具、AskUserQuestion、TaskStop，外部构建还会移除递归 Agent。
普通后台 Agent：进一步只保留后台白名单中的文件、搜索、Shell、Skill、ToolSearch、worktree 等工具；MCP 工具在基础过滤中例外放行。
进程内 Team 队友：除后台白名单外，还可使用共享的 TaskCreate、TaskGet、TaskUpdate、TaskList 和 SendMessage；可启动同步子 Agent，但不能启动后台 Agent 或继续创建队友。若队友处于 plan 权限模式，可额外获得 ExitPlanMode。
Coordinator：只负责分派和输出，不直接获得常规文件/Shell 工具；worker 再按自己的权限上下文取得执行工具。

关键实现位置：

静态注册和会话过滤：src/tools.ts
工具接口、prompt() 与 description()：src/Tool.ts
主 REPL 合并：src/hooks/useMergedTools.ts
Coordinator 过滤：src/utils/toolPool.ts、src/constants/tools.ts
子 Agent 过滤：src/tools/AgentTool/agentToolUtils.ts
API Schema 生成：src/utils/api.ts 的 toolToAPISchema()
请求级延迟加载：src/utils/toolSearch.ts、src/tools/ToolSearchTool/prompt.ts、src/services/api/claude.ts
动态提醒和上下文附件：src/utils/attachments.ts
MCP 工具和资源辅助工具注入：src/services/mcp/client.ts
Team 生命周期：src/tools/TeamCreateTool、src/tools/TeamDeleteTool、src/tools/SendMessageTool
Task V2 启用和共享任务表：src/utils/tasks.ts

输入框文件引用

在普通 Prompt 模式中，使用 @ 引用项目文件或目录。@ 必须位于输入行开头，或紧跟在空格、换行等空白字符之后；不要与前面的文字直接相连。

请帮我阅读 @src/hooks/useTypeahead.tsx
请查看 @package.json

以下写法不会触发文件补全：

请查看@src/index.ts

输入 @ 后会自动显示候选项；可继续输入文件名前缀，或使用方向键和 Tab 选择。

斜杠命令清单

命令注册以 src/commands.ts 为准；src/commands/ 的文件数量不等于当前构建中可输入的命令数量。下面按常用、高级与集成、受限/实验/内部三组列出，并保留实际命令名及别名。部分命令会受登录状态、套餐、平台、环境变量或编译开关限制。

一、用户常用

| 命令（含别名） | 用途 | |---|---| | /help | 显示帮助与可用命令。 | | /clear、/reset、/new | 清除对话历史并释放上下文。 | | /compact [指令] | 压缩历史对话，并保留摘要。 | | /context | 查看当前上下文占用；交互模式显示彩色网格。 | | /model | 切换当前会话模型。 | | /effort | 设置模型的 effort 等级。 | | /plan | 进入计划模式或查看当前会话计划。 | | /status | 查看 Claude Code 状态。 | | /cost | 显示当前会话的成本与时长。 | | /diff | 查看未提交改动及本轮差异。 | | /copy | 复制最近一条消息内容。 | | /rename | 重命名当前会话。 | | /resume、/continue | 恢复之前的会话。 | | /rewind、/checkpoint | 将代码和/或对话回退到先前状态。 | | /branch | 从当前节点创建会话分支；未启用 FORK_SUBAGENT 时，/fork 是其别名。 | | /exit、/quit | 退出 REPL。 | | /feedback、/bug | 提交 Claude Code 反馈。 | | /theme | 切换终端主题。 | | /vim | 切换 Vim 或普通编辑模式。 | | /color | 设置当前会话提示栏颜色。 | | /btw | 在不打断主任务的情况下发起简短的旁路提问。 | | /stats | 查看 Claude Code 用量统计与活动情况。 | | /release-notes | 查看发行说明。 | | /stickers | 查看贴纸订购信息。 |

二、高级与集成

| 命令（含别名） | 用途 | |---|---| | /add-dir <path> | 将目录添加到工作区。 | | /agents | 管理 Agent 配置。 | | /mcp | 管理 MCP 服务器。 | | /plugin、/plugins、/marketplace | 管理插件与插件市场。 | | /reload-plugins | 使本会话加载待应用的插件改动。 | | /skills | 列出可用的 Skills。 | | /hooks | 查看工具事件 Hook 配置。 | | /permissions、/allowed-tools | 管理工具允许/拒绝规则。 | | /config、/settings | 打开配置面板。 | | /keybindings | 管理快捷键配置。 | | /ide | 管理 IDE 集成并查看其状态。 | | /init | 初始化项目级配置和指导文件。 | | /doctor | 诊断安装与配置问题。 | | /memory | 编辑 Claude 记忆文件。 | | /export | 将当前会话导出至文件或剪贴板。 | | /pr-comments | 获取 GitHub Pull Request 评论。 | | /review | 审查 Pull Request。 | | /security-review | 对当前分支的待处理改动执行安全审查。 | | /tasks、/bashes | 查看和管理后台任务。 | | /mobile、/ios、/android | 显示 Claude 移动端下载二维码。 | | /install-github-app | 为仓库配置 Claude GitHub Actions。 | | /install-slack-app | 安装 Claude Slack App。 | | /login、/logout | 登录或登出 Anthropic 账户。 | | /usage | 显示 Claude.ai 套餐用量限制；仅 Claude.ai OAuth 订阅者可见。通过自定义 ANTHROPIC_BASE_URL 的代理、Bedrock、Vertex、Foundry 或普通 API Key 使用时，该命令会被隐藏；支持 GET /v1/usage 的代理仍可在输入框 footer 显示额度提示。 | | /upgrade | 升级至 Max；受账户资格限制。 | | /output-style | 已弃用；请改用 /config 调整输出样式。 | | /statusline | 配置状态栏显示。 | | /terminal-setup | 执行终端设置/安装引导。 |

三、受限、实验或内部命令

| 命令 | 用途与限制 | |---|---| | /advisor | 选择辅助顾问模型：它可在主模型之外协助回答或分析；仅账户具备该实验资格时显示。 | | /files | 列出本次会话已加入上下文、可供模型参考的文件；仅内部构建可用。 | | /remote-control、/rc | 让 Claude 网页端或移动端连接并操作当前本地终端；当前构建需启用远程控制功能。 | | /session、/remote | 生成远程会话链接和二维码，用其他设备继续或查看当前会话；仅远程会话模式可用。 | | /desktop、/app | 把当前会话转交到 Claude Desktop 应用继续处理；仅部分平台和订阅账户可用。 | | /chrome | 连接、设置或管理 Claude in Chrome 浏览器扩展（Beta）；需满足登录和会话条件。 | | /extra-usage | 在套餐额度耗尽后，设置是否允许按额外用量继续使用；仅符合资格的账户可用。 | | /privacy-settings | 查看或修改数据使用、隐私相关偏好；仅消费者订阅账户可用。 | | /remote-env | 为可传送到远程端的会话选择默认运行环境，例如远程开发环境。 | | /sandbox | 启用或关闭命令执行沙箱，以限制工具可访问的系统资源。 | | /passes | 向他人赠送或分享限时免费使用资格；仅活动符合条件的账户可见。 | | /ultrareview | 将当前分支交给 Web 端进行更深入、耗时更长的缺陷审查；实验性功能。 | | /think-back、/thinkback-play | 查看或播放 Claude Code 的年度使用回顾；仅在活动开启期间可用。 | | /web-setup | 在 Claude 网页端连接 GitHub 并完成 Claude Code 的 Web 使用设置；仅部分 Claude.ai 账户和策略允许时可用。 | | /fork | 将当前任务分叉为独立的子 Agent 会话，用于并行处理；未启用该功能时它只是 /branch 的别名。 | | /buddy | 在终端中启用可互动的 AI 宠物功能；属于实验功能，默认构建通常不提供。 | | /proactive | 让助手在空闲期间自主检查待办、继续合适的工作；需启用持久助手/主动模式实验。 | | /brief | 切换为更精简的回答风格；需启用 KAIROS 助手实验且账户具备资格。 | | /assistant | 开启可跨会话持续工作的持久助手模式；属于 KAIROS 实验功能。 | | /remote-control-server | 在本机启动远程控制服务端，供其他 Claude 客户端连接；仅内部/实验构建可用。 | | /voice | 用语音输入与 Claude 交互；需语音实验、订阅资格和服务端开关均已启用。 | | /peers | 管理本地 Claude 进程之间的消息收件箱和协作通信；仅实验构建可用。 | | /workflows | 管理可复用的工作流脚本：把一组预定义步骤保存为命令，以便重复执行开发流程；仅启用工作流实验时可用。 | | /torch | Anthropic 内部代号功能；源码未提供面向外部用户的稳定用途说明，默认不可用。 | | /heapdump | 将当前 JavaScript 内存快照写入桌面目录，供排查内存泄漏或异常内存占用，不用于日常开发。 | | /ultraplan | 将复杂问题交给云端进行较长时间的独立研究和方案规划；当前外部构建已强制禁用。 |

内部构建（USER_TYPE === 'ant' 且非 Demo）还会注册：/backfill-sessions、/break-cache、/bughunter、/commit、/commit-push-pr、/ctx_viz、/good-claude、/issue、/init-verifiers、/mock-limits、/bridge-kick、/version、/reset-limits、/onboarding、/share、/summary、/teleport、/ant-trace、/perf-issue、/env、/oauth-refresh、/debug-tool-call、/agents-platform、/autofix-pr。其中部分还受各自功能开关约束，不应视为外部可用命令。

REPL 模块说明

src/screens/REPL.tsx 是 CLI 的主交互界面，负责会话状态、用户输入、模型查询、工具权限、消息显示及各类终端弹窗。导入较多，按职责可归纳如下：

| 模块类别 | 主要引入 | 用途 | | --- | --- | --- | | 运行时与 Node API | react/compiler-runtime、bun:bundle、child_process、path、os、fs/promises、crypto | React 编译产物支持、功能开关、子进程、文件路径/临时文件、文件写入及 UUID。 | | React 与 Ink | react、../ink.js、figures | 管理组件状态/副作用，渲染终端 UI，处理键盘输入、终端尺寸、主题、焦点和终端标题。 | | 会话与上下文 | bootstrap/state、sessionStorage、sessionRestore、conversationRecovery、claudemd、plans | 保存/恢复会话、消息、成本、工作树、计划、内存文件与上下文。 | | 模型查询与消息 | query、handlePromptSubmit、utils/messages、messageQueueManager、QueryGuard、queryProfiler | 提交用户输入、调用模型、处理流式响应、维护消息队列、避免并发查询并记录性能。 | | 输入与快捷键 | PromptInput、useSearchInput、inputModes、GlobalKeybindingHandlers、CommandKeybindingHandlers、KeybindingSetup | 输入框、搜索、Vim/输入模式、全局和命令快捷键及快捷键上下文。 | | 消息与全屏显示 | Messages、FullscreenLayout、VirtualMessageList、ScrollKeybindingHandler、messageActions、MessageSelector | 显示会话消息、虚拟滚动、全屏模式、消息选择/复制/编辑等操作。 | | 命令、技能和插件 | commands、useMergedCommands、useSkillsChange、useManagePlugins、performStartupChecks | 聚合斜杠命令，监听技能变化，管理插件并执行启动检查。 | | 工具与权限 | tools、useMergedTools、useCanUseTool、PermissionRequest、PermissionUpdate、SandboxPermissionRequest | 组装工具池，判断工具可用性，展示权限请求并持久化权限更新；处理沙箱权限。 | | MCP 与 IDE | MCPConnectionManager、useMergedClients、ElicitationDialog、useIDEIntegration、useIdeSelection | 连接和合并 MCP 服务，处理 MCP 信息征询，以及 IDE 集成、选区和状态。 | | Agent 与协作 | AgentTool/*、InProcessTeammateTask、LocalAgentTask、useSwarmInitialization、useInboxPoller | 加载/恢复 Agent，管理本地与进程内队友任务、权限同步、收件箱和协作状态。 | | 压缩、令牌与成本 | compact/*、tokenBudget、tokens、cost-tracker、CostThresholdDialog | 计算令牌预算与上下文窗口，执行压缩，记录会话成本并展示成本提醒。 | | 文件与编辑器 | fileHistory、fileStateCache、attachments、editor、exportRenderer | 保存文件快照/回退，缓存读取状态，创建附件，导出消息文本并调用外部编辑器。 | | 通知与提示 | notifications、notifier、hooks/notifs/*、tips/*、IssueFlagBanner | 展示终端/系统通知、设置和网络状态、限流、升级、插件、IDE 等提示。 | | 会话生命周期 | sessionStart、hooks、ExitFlow、gracefulShutdown、preventSleep、backgroundHousekeeping | 执行会话开始/结束钩子，处理退出、后台清理和防止系统休眠。 | | 远程与后台会话 | useRemoteSession、useSSHSession、useDirectConnect、LocalMainSessionTask、useSessionBackgrounding | 提供远程/SSH/直连会话能力，并支持将主会话转入后台。 | | 配置、实验与遥测 | config、analytics/*、diagnosticTracking、sessionTracing、activityManager | 读写用户配置和动态实验配置，采集诊断/会话追踪并维护活动状态。 | | 条件加载模块 | useVoiceIntegration、useFrustrationDetection、coordinatorMode、proactive/*、WebBrowserPanel | 通过 feature(...) 或内部构建条件按需 require，使未启用功能可被构建工具剔除。 | | 其他界面能力 | Spinner、TaskListV2、CompanionSprite、DevBar | 显示加载状态、任务列表、助手形象及开发栏。 |

数据来源

npm 包：@anthropic-ai/claude-code
还原方式：提取 cli.js.map 中的 sourcesContent

声明

源码版权归 Anthropic 所有
仅用于技术研究与学习，请勿用于商业用途
如有侵权，请联系删除