9.9 KiB
9.9 KiB
title, description, keywords
| title | description | keywords | |||||
|---|---|---|---|---|---|---|---|
| Ant 特权世界 - Anthropic 员工专属功能 | 完整记录 Claude Code 身份门控层：USER_TYPE === 'ant' 时解锁的专属工具、命令、API 和代号体系，揭示内外部构建的差异。 |
|
{/* 本章目标：完整记录身份门控层——ant 构建独享的一切 */}
什么是 Ant
USER_TYPE 是一个构建时常量，通过 Bun 打包器的 --define 注入。在 Anthropic 的内部构建中它被设为 'ant'，在公开发布的版本中是 'external'：
// 反编译版本（src/types/global.d.ts 第 63 行）
// Build-time constants BUILD_TARGET/BUILD_ENV/INTERFACE_TYPE — removed (zero runtime usage)
BUILD_TARGET 等构建时常量在反编译版本中已被移除。USER_TYPE 通过 Bun 的 --define 或环境变量注入，Bun 会进行常量折叠——所有 process.env.USER_TYPE === 'ant' 在外部构建中直接变为 false，后续代码被 DCE 移除。但在反编译版本中，这些代码保留完整。
USER_TYPE === 'ant' 在代码库中出现 351+ 次（跨 163 个文件），另有 !== 'ant' 59 次（跨 38 个文件），总计 410+ 处引用，控制着工具、命令、API、UI 等方方面面。
Ant-Only 工具
以下工具仅在内部构建中被加载到工具注册表：
| 工具 | 代码位置 | 用途 |
|---|---|---|
| REPLTool | packages/builtin-tools/src/tools/REPLTool/ |
高级 REPL 模式——在 VM 中包装 Bash/Read/Edit/Glob/Grep/Agent 等工具 |
| SuggestBackgroundPRTool | packages/builtin-tools/src/tools/SuggestBackgroundPRTool/ |
建议在后台创建 PR |
| ConfigTool | packages/builtin-tools/src/tools/ConfigTool/ |
交互式配置编辑器，包含 Gates 标签页用于覆盖 GrowthBook flags |
| TungstenTool | packages/builtin-tools/src/tools/TungstenTool/ |
基于 tmux 的终端面板工具（反编译版中已 stub） |
// src/tools.ts 第 14-24 行——条件导入 + Dead Code Elimination 标记
// Dead code elimination: conditional import for ant-only tools
/* eslint-disable custom-rules/no-process-env-top-level, @typescript-eslint/no-require-imports */
const REPLTool =
process.env.USER_TYPE === 'ant'
? require('@claude-code-best/builtin-tools/tools/REPLTool/REPLTool.js').REPLTool
: null
const SuggestBackgroundPRTool =
process.env.USER_TYPE === 'ant'
? require('@claude-code-best/builtin-tools/tools/SuggestBackgroundPRTool/SuggestBackgroundPRTool.js')
.SuggestBackgroundPRTool
: null
Ant-Only 命令
src/commands.ts 注册了 24+ 个仅在内部构建中可用的斜杠命令（INTERNAL_ONLY_COMMANDS，lines 267-295），在 USER_TYPE === 'ant' && !IS_DEMO 时才加载（line 400-401）：
Beta API Headers
Claude Code 向 API 发送的 beta headers 分布在 src/constants/betas.ts（主注册表）和其他文件中，按可见性分为以下几类：
公开 Headers（所有构建均发送）
| Header | 功能 | 额外条件 |
|---|---|---|
claude-code-20250219 |
Claude Code 标识 | 非 Haiku 时始终发送；Haiku 在 agentic 模式下也发送 |
effort-2025-11-24 |
推理强度控制 | 动态注入 |
task-budgets-2026-03-13 |
任务预算 | 始终通过 addAgenticBetas() 注入 |
fast-mode-2026-02-01 |
快速模式 | 通过 sticky-on latch 动态注入 |
advisor-tool-2026-03-01 |
顾问工具 | 启用 advisor 时动态注入 |
advanced-tool-use-2025-11-20 |
工具搜索（1P） | Claude API / Foundry |
tool-search-tool-2025-10-19 |
工具搜索（3P） | Vertex / Bedrock |
模型能力相关（有条件发送）
| Header | 功能 | 条件 |
|---|---|---|
interleaved-thinking-2025-05-14 |
交错思考模式 | 模型支持 ISP 且未禁用 |
context-1m-2025-08-07 |
1M 上下文窗口 | 模型支持 1M context |
context-management-2025-06-27 |
上下文管理 | Claude 4+ 或 ant 手动启用 |
structured-outputs-2025-12-15 |
结构化输出 | Claude 4.5/4.6 + GrowthBook tengu_tool_pear |
web-search-2025-03-05 |
网页搜索 | Vertex (Claude 4+) / Foundry |
redact-thinking-2026-02-12 |
思维摘要/脱敏 | ISP 模型 + 非交互 + 未强制显示思维 |
prompt-caching-scope-2026-01-05 |
提示缓存作用域 | firstParty/foundry + 全局缓存 |
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
| Header | 功能 | 条件 |
|---|---|---|
afk-mode-2026-01-31 |
AFK 模式（离开键盘自动审批） | feature('TRANSCRIPT_CLASSIFIER') |
其他特殊 Headers
| Header | 功能 | 来源 |
|---|---|---|
oauth-2025-04-20 |
OAuth 订阅者标识 | src/constants/oauth.ts，Pro/Max/Team/Enterprise |
environments-2025-11-01 |
Bridge 环境 API | src/bridge/bridgeApi.ts，仅 Bridge 模式 |
// src/constants/betas.ts — 常量定义
export const TOKEN_EFFICIENT_TOOLS_BETA_HEADER =
'token-efficient-tools-2026-03-28'
export const CLI_INTERNAL_BETA_HEADER =
process.env.USER_TYPE === 'ant' ? 'cli-internal-2026-02-09' : ''
// src/utils/betas.ts 第 315-321 行——TOKEN_EFFICIENT_TOOLS 的实际门控逻辑
if (
process.env.USER_TYPE === 'ant' &&
includeFirstPartyOnlyBetas &&
tokenEfficientToolsEnabled // GrowthBook 'tengu_amber_json_tools' flag
) {
betaHeaders.push(TOKEN_EFFICIENT_TOOLS_BETA_HEADER)
}
cli-internal header 意味着 Anthropic 的 API 服务端也维护着一套 ant-only 的服务端行为——这不仅仅是客户端的门控。token-efficient-tools 进一步需要 GrowthBook flag 开启，说明 Ant 员工内部也有分层灰度。
内部代号体系
Anthropic 有浓厚的"动物命名"文化：
| 代号 | 身份 | 出处 |
|---|---|---|
| Tengu（天狗） | Claude Code 项目代号 | 所有 GrowthBook flags 的 tengu_ 前缀、分析事件名称 |
| Capybara（水豚） | 模型代号 | src/constants/prompts.ts 中被 Undercover Mode 屏蔽的名称 |
| Fennec（耳廓狐） | 已退役模型别名 | src/migrations/migrateFennecToOpus.ts——曾用名已迁移到 Opus |
这些代号通过 Undercover Mode 在公开仓库的 commit 中被严格过滤。
环境变量开关
除了 USER_TYPE，还有一系列精细的环境变量控制各项功能：