vault backup: 2026-06-09 23:15:17

2026-06-09 23:15:17 +08:00
parent 31fd89aafe
commit e92c0327d9
111 changed files with 7276 additions and 8846 deletions
@@ -1,12 +1,17 @@
 ---
-title: "Ant 特权世界 - Anthropic 员工专属功能"
-description: "完整记录 Claude Code 身份门控层：USER_TYPE === 'ant' 时解锁的专属工具、命令、API 和代号体系，揭示内外部构建的差异。"
-keywords: ["Ant 特权", "USER_TYPE", "身份门控", "内部功能", "Anthropic 员工"]
+tags: [ant-特权, USER_TYPE, claude-code, 身份门控, 内部功能]
+create time: 2026-06-09 22:30
 ---

-{/* 本章目标：完整记录身份门控层——ant 构建独享的一切 */}
+# Ant 特权世界 - Anthropic 员工专属功能

-## 什么是 Ant
+## 概述
+
+`USER_TYPE` 是 Claude Code 的身份门控层——构建时常量通过 Bun 的 `--define` 注入，内部构建为 `'ant'`，公开版本为 `'external'`。代码库中 410+ 处引用控制着 4 个专属工具、24+ 个斜杠命令、多个 beta headers 和一整套环境变量开关。
+
+## 正文
+
+### 什么是 Ant

 `USER_TYPE` 是一个构建时常量，通过 Bun 打包器的 `--define` 注入。在 Anthropic 的内部构建中它被设为 `'ant'`，在公开发布的版本中是 `'external'`：

@@ -19,7 +24,7 @@ keywords: ["Ant 特权", "USER_TYPE", "身份门控", "内部功能", "Anthropic

 `USER_TYPE === 'ant'` 在代码库中出现 **351+ 次**（跨 163 个文件），另有 `!== 'ant'` 59 次（跨 38 个文件），总计 **410+ 处引用**，控制着工具、命令、API、UI 等方方面面。

-## Ant-Only 工具
+### Ant-Only 工具

 以下工具仅在内部构建中被加载到工具注册表：

@@ -45,58 +50,53 @@ const SuggestBackgroundPRTool =
    : null
 ```

-## Ant-Only 命令
+### Ant-Only 命令

 `src/commands.ts` 注册了 **24+** 个仅在内部构建中可用的斜杠命令（`INTERNAL_ONLY_COMMANDS`，lines 267-295），在 `USER_TYPE === 'ant' && !IS_DEMO` 时才加载（line 400-401）：

-<AccordionGroup>
-  <Accordion title="调试类">
-    - `breakCache` — 清除缓存
-    - `ctx_viz` — 可视化上下文窗口使用情况
-    - `debugToolCall` — 调试工具调用
-    - `env` — 显示环境变量
-    - `mockLimits` — 模拟速率限制
-    - `resetLimits` — 重置速率限制
-    - `resetLimitsNonInteractive` — 重置速率限制（非交互式）
-  </Accordion>
-  <Accordion title="实验类">
-    - `bughunter` — Bug 猎人模式
-    - `goodClaude` — 质量评估工具
-    - `antTrace` — 追踪分析
-    - `perfIssue` — 性能问题诊断
-  </Accordion>
-  <Accordion title="工作流类">
-    - `commit` — 快速提交
-    - `commitPushPr` — 一键提交+推送+创建 PR
-    - `issue` — 创建 GitHub Issue
-    - `autofixPr` — 自动修复 PR 中的问题
-    - `share` — 分享会话
-    - `summary` — 生成摘要
-    - `subscribePr` — 订阅 PR（需要 `KAIROS_GITHUB_WEBHOOKS` feature flag）
-    - `forceSnip` — 强制截断历史（需要 `HISTORY_SNIP` feature flag）
-    - `ultraplan` — 超级规划（需要 `ULTRAPLAN` feature flag，单独注册于 `commands.ts:396`）
-  </Accordion>
-  <Accordion title="基础设施类">
-    - `backfillSessions` — 回填会话数据
-    - `bridgeKick` — 重启 Bridge 连接
-    - `oauthRefresh` — 刷新 OAuth Token
-    - `teleport` — 传送到指定上下文
-    - `onboarding` — 新手引导
-    - `agentsPlatform` — Agents 平台管理
-    - `version` — 内部版本详情
-    - `initVerifiers` — 初始化验证器
-  </Accordion>
-</AccordionGroup>
+**调试类**
+- `breakCache` — 清除缓存
+- `ctx_viz` — 可视化上下文窗口使用情况
+- `debugToolCall` — 调试工具调用
+- `env` — 显示环境变量
+- `mockLimits` — 模拟速率限制
+- `resetLimits` / `resetLimitsNonInteractive` — 重置速率限制

-<Note>
-这些命令在 `IS_DEMO` 模式下也会被隐藏，防止在演示环境中暴露内部功能。
-</Note>
+**实验类**
+- `bughunter` — Bug 猎人模式
+- `goodClaude` — 质量评估工具
+- `antTrace` — 追踪分析
+- `perfIssue` — 性能问题诊断

-## Beta API Headers
+**工作流类**
+- `commit` — 快速提交
+- `commitPushPr` — 一键提交+推送+创建 PR
+- `issue` — 创建 GitHub Issue
+- `autofixPr` — 自动修复 PR 中的问题
+- `share` — 分享会话
+- `summary` — 生成摘要
+- `subscribePr` — 订阅 PR（需要 `KAIROS_GITHUB_WEBHOOKS` feature flag）
+- `forceSnip` — 强制截断历史（需要 `HISTORY_SNIP` feature flag）
+- `ultraplan` — 超级规划（需要 `ULTRAPLAN` feature flag）
+
+**基础设施类**
+- `backfillSessions` — 回填会话数据
+- `bridgeKick` — 重启 Bridge 连接
+- `oauthRefresh` — 刷新 OAuth Token
+- `teleport` — 传送到指定上下文
+- `onboarding` — 新手引导
+- `agentsPlatform` — Agents 平台管理
+- `version` — 内部版本详情
+- `initVerifiers` — 初始化验证器
+
+> [!info]
+> 这些命令在 `IS_DEMO` 模式下也会被隐藏，防止在演示环境中暴露内部功能。
+
+### Beta API Headers

 Claude Code 向 API 发送的 beta headers 分布在 `src/constants/betas.ts`（主注册表）和其他文件中，按可见性分为以下几类：

-### 公开 Headers（所有构建均发送）
+**公开 Headers（所有构建均发送）**

 | Header | 功能 | 额外条件 |
 |--------|------|----------|
@@ -108,7 +108,7 @@ Claude Code 向 API 发送的 beta headers 分布在 `src/constants/betas.ts`（
 | `advanced-tool-use-2025-11-20` | 工具搜索（1P） | Claude API / Foundry |
 | `tool-search-tool-2025-10-19` | 工具搜索（3P） | Vertex / Bedrock |

-### 模型能力相关（有条件发送）
+**模型能力相关（有条件发送）**

 | Header | 功能 | 条件 |
 |--------|------|------|
@@ -120,20 +120,20 @@ Claude Code 向 API 发送的 beta headers 分布在 `src/constants/betas.ts`（
 | `redact-thinking-2026-02-12` | 思维摘要/脱敏 | ISP 模型 + 非交互 + 未强制显示思维 |
 | `prompt-caching-scope-2026-01-05` | 提示缓存作用域 | firstParty/foundry + 全局缓存 |

-### Ant-Only Headers
+**Ant-Only Headers**

 | Header | 功能 | 条件 |
 |--------|------|------|
 | **`cli-internal-2026-02-09`** | 内部 CLI 功能 | `USER_TYPE === 'ant'` + CLI 入口 |
 | **`token-efficient-tools-2026-03-28`** | Token 高效工具 | `USER_TYPE === 'ant'` + GrowthBook `tengu_amber_json_tools` |

-### Feature Flag Gated
+**Feature Flag Gated**

 | Header | 功能 | 条件 |
 |--------|------|------|
 | **`afk-mode-2026-01-31`** | AFK 模式（离开键盘自动审批） | `feature('TRANSCRIPT_CLASSIFIER')` |

-### 其他特殊 Headers
+**其他特殊 Headers**

 | Header | 功能 | 来源 |
 |--------|------|------|
@@ -159,9 +159,10 @@ if (
 }
 ```

-`cli-internal` header 意味着 Anthropic 的 API 服务端也维护着一套 ant-only 的服务端行为——这不仅仅是客户端的门控。`token-efficient-tools` 进一步需要 GrowthBook flag 开启，说明 Ant 员工内部也有分层灰度。
+> [!info]
+> `cli-internal` header 意味着 Anthropic 的 API 服务端也维护着一套 ant-only 的服务端行为——这不仅仅是客户端的门控。`token-efficient-tools` 进一步需要 GrowthBook flag 开启，说明 Ant 员工内部也有分层灰度。

-## 内部代号体系
+### 内部代号体系

 Anthropic 有浓厚的"动物命名"文化：

@@ -173,38 +174,50 @@ Anthropic 有浓厚的"动物命名"文化：

 这些代号通过 Undercover Mode 在公开仓库的 commit 中被严格过滤。

-## 环境变量开关
+### 环境变量开关

 除了 `USER_TYPE`，还有一系列精细的环境变量控制各项功能：

-<AccordionGroup>
-  <Accordion title="功能禁用开关">
-    - `CLAUDE_CODE_SIMPLE` — 简化模式（禁用高级功能）
-    - `CLAUDE_CODE_DISABLE_THINKING` — 禁用 thinking
-    - `DISABLE_INTERLEAVED_THINKING` — 禁用交错思考
-    - `DISABLE_COMPACT` — 禁用消息压缩
-    - `DISABLE_AUTO_COMPACT` — 禁用自动压缩
-    - `CLAUDE_CODE_DISABLE_AUTO_MEMORY` — 禁用自动记忆
-    - `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` — 禁用后台任务
-    - `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` — 禁用实验性 beta headers
-    - `USE_API_CONTEXT_MANAGEMENT` — 上下文管理工具清除（需 ant）
-  </Accordion>
-  <Accordion title="功能启用开关">
-    - `CLAUDE_CODE_VERIFY_PLAN` — 启用 VerifyPlanExecutionTool
-    - `ENABLE_LSP_TOOL` — 启用 LSP 语言服务器工具
-    - `CLAUDE_CODE_UNDERCOVER` — 强制启用 Undercover Mode
-    - `CLAUDE_CODE_TERMINAL_RECORDING` — 启用终端录制（asciicast）
-    - `CLAUDE_CODE_ABLATION_BASELINE` — 启用基线对照模式
-  </Accordion>
-  <Accordion title="环境配置">
-    - `CLAUDE_CODE_REMOTE` — 远程执行模式（自动增加堆内存限制）
-    - `CLAUDE_CODE_COORDINATOR_MODE` — 启用 Coordinator 模式
-    - `CLAUDE_INTERNAL_FC_OVERRIDES` — GrowthBook flag 覆盖（ant-only）
-    - `IS_DEMO` — 演示模式（隐藏内部命令和敏感信息）
-    - `CLAUDE_CODE_ENTRYPOINT` — 入口类型标识（`cli` | 其他）
-  </Accordion>
-</AccordionGroup>
+**功能禁用开关**

-<Note>
-`ABLATION_BASELINE` 特别有趣——它同时关闭 thinking、compaction、auto-memory 和 background tasks，用于测量这些高级功能对 AI 表现的**因果影响**。这是一个严肃的"科学对照实验"工具。
-</Note>
+| 变量 | 作用 |
+|------|------|
+| `CLAUDE_CODE_SIMPLE` | 简化模式（禁用高级功能） |
+| `CLAUDE_CODE_DISABLE_THINKING` | 禁用 thinking |
+| `DISABLE_INTERLEAVED_THINKING` | 禁用交错思考 |
+| `DISABLE_COMPACT` | 禁用消息压缩 |
+| `DISABLE_AUTO_COMPACT` | 禁用自动压缩 |
+| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | 禁用自动记忆 |
+| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 禁用后台任务 |
+| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | 禁用实验性 beta headers |
+| `USE_API_CONTEXT_MANAGEMENT` | 上下文管理工具清除（需 ant） |
+
+**功能启用开关**
+
+| 变量 | 作用 |
+|------|------|
+| `CLAUDE_CODE_VERIFY_PLAN` | 启用 VerifyPlanExecutionTool |
+| `ENABLE_LSP_TOOL` | 启用 LSP 语言服务器工具 |
+| `CLAUDE_CODE_UNDERCOVER` | 强制启用 Undercover Mode |
+| `CLAUDE_CODE_TERMINAL_RECORDING` | 启用终端录制（asciicast） |
+| `CLAUDE_CODE_ABLATION_BASELINE` | 启用基线对照模式 |
+
+**环境配置**
+
+| 变量 | 作用 |
+|------|------|
+| `CLAUDE_CODE_REMOTE` | 远程执行模式（自动增加堆内存限制） |
+| `CLAUDE_CODE_COORDINATOR_MODE` | 启用 Coordinator 模式 |
+| `CLAUDE_INTERNAL_FC_OVERRIDES` | GrowthBook flag 覆盖（ant-only） |
+| `IS_DEMO` | 演示模式（隐藏内部命令和敏感信息） |
+| `CLAUDE_CODE_ENTRYPOINT` | 入口类型标识（`cli` | 其他） |
+
+> [!question]
+> `ABLATION_BASELINE` 特别有趣——它同时关闭 thinking、compaction、auto-memory 和 background tasks，用于测量这些高级功能对 AI 表现的**因果影响**。这是一个严肃的"科学对照实验"工具。你认为哪些功能对 AI 编程能力的影响最大？
+
+## 关联笔记
+
+- [[three-tier-gating]] - 三层门禁系统全景
+- [[feature-flags]] - 88 个构建时 Feature Flags
+- [[growthbook-ab-testing]] - GrowthBook A/B 测试体系
+- [[hidden-features]] - 未公开功能深度解析