跳转到内容

完整清单:所有构建标志与运行时门控

这是我们在 Claude Code 源码中识别出的所有门控机制的完整参考。它们分为四类:构建时特性标志 (Feature Flags)、GrowthBook 运行时标志、环境变量和 API Beta 请求头。

构建时特性标志 (Build-Time Feature Flags)

Section titled “构建时特性标志 (Build-Time Feature Flags)”

这些标志在构建时通过引用 bun:bundle 中定义的 feature() 调用来求值。如果某个标志在构建配置中未启用,则相关代码会被死代码消除 (Tree-shaking) 从最终产物中完全移除 — 在运行时根本不存在。

标志名称类别描述可能仅限 Ant?
AGENT_MEMORY_SNAPSHOT内存代理内存持久化快照
AGENT_TRIGGERS调度定时代理执行
AGENT_TRIGGERS_REMOTE调度远程代理调度
ANTI_DISTILLATION_CC安全反蒸馏内容分类器
AUTO_THEMEUI自动主题检测
AWAY_SUMMARY用户体验离开模式摘要
BG_SESSIONS会话后台会话支持
BRIDGE_MODE基础设施远程桥接协议
BUDDY / BUDDIES用户体验AI 辅导伙伴
BUILDING_CLAUDE_APPS技能Claude API 技能
BUILTIN_EXPLORE_PLAN_AGENTS代理内置代理模板
CCR_MIRROR基础设施云计算资源镜像
CHAT_MODESUI聊天模式选择界面
CONNECTOR_TEXT处理连接器文本摘要
CONTEXT_COLLAPSE性能上下文窗口优化
COORDINATOR_MODE代理多工作者编排
DAEMON基础设施后台守护进程模式
DIRECT_CONNECT基础设施直连 WebSocket 连接
ENHANCED_TELEMETRY_BETA分析增强分析
FORK_SUBAGENT代理缓存优化的子代理分叉
HISTORY_PICKER / HISTORY_SNIP会话会话历史功能
KAIROS后台任务异步/后台任务系统
KAIROS_BRIEF后台任务简要格式化
KAIROS_CHANNELS后台任务MCP 通道通知
KAIROS_DREAM内存自动记忆整合
KAIROS_GITHUB_WEBHOOKS集成GitHub Webhook 集成
KAIROS_PUSH_NOTIFICATION通知推送通知
MCP_RICH_OUTPUTMCP富 MCP 工具输出
MCP_SKILLSMCPMCP 工具技能集成
MESSAGE_ACTIONSUI消息操作按钮
NATIVE_CLIENT_ATTESTATION安全客户端认证验证
NATIVE_CLIPBOARD_IMAGEUI原生剪贴板图片支持
PROACTIVE代理自主执行
PROMPT_CACHE_BREAK_DETECTION性能检测提示缓存失效
REACTIVE_COMPACT性能响应式上下文压缩
REVIEW_ARTIFACT审查产物审查
RUN_SKILL_GENERATOR技能技能生成
SELF_HOSTED_RUNNER基础设施自托管运行器
SSH_REMOTE基础设施SSH 远程执行
TRANSCRIPT_CLASSIFIER权限自动模式权限分类器
ULTRAPLAN规划超详细规划
ULTRATHINK思考扩展思考
UPLOAD_USER_SETTINGS / DOWNLOAD_USER_SETTINGS设置云端设置同步
VERIFICATION_AGENT代理代码验证代理
VOICE_MODE输入语音输入/输出
WEB_BROWSER_TOOL工具浏览器自动化

GrowthBook 标志(以 tengu_ 为前缀)在运行时通过查询 Anthropic 的特性标志服务来求值。即使你的构建中存在相应的代码路径,这些标志也可以根据你的用户账户、组织或 A/B 测试群组在服务端启用或禁用功能。

标志名称用途
tengu_amber_flintAgent Swarms 紧急开关
tengu_amber_quartz_disabled语音模式紧急开关
tengu_amber_stoatExplore/Plan 代理(默认开启)
tengu_ant_model_overrideAnthropic 员工模型覆盖
tengu_auto_mode_config自动模式配置(enabled / opt-in / disabled)
tengu_ccr_bridge_multi_session多会话桥接
tengu_hive_evidence验证代理
tengu_harborMCP 通道/通知
tengu_kairos_cron定时代理执行
tengu_kairos_cron_durable持久化定时任务状态
tengu_malort_pedwayComputer Use MCP 配置
tengu_max_version_config版本紧急开关
tengu_onyx_plover自动记忆整合配置
tengu_otk_slot_v1一次性密钥槽
tengu_remote_backend远程 TUI 后端
tengu_scratch草稿持久化存储
tengu_sedge_lantern离开摘要
tengu_session_memory跨会话记忆
tengu_sessions_elevated_auth_enforcement可信设备要求
tengu_slim_subagent_claudemd只读代理跳过 CLAUDE.md
tengu_surreal_dali远程触发工具
tengu_tool_pear严格工具使用
tengu_transcript_classifier自动模式分类器
tengu_willow_mode上下文优化(off / light / full)

这些环境变量可以在启动 Claude Code 之前在 Shell 中设置。有些是构建时门控,有些是运行时开关。

变量用途
USER_TYPE=ant构建时 Anthropic 员工门控
CLAUDE_CODE_COORDINATOR_MODE=1启用协调器模式
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1启用代理团队
CLAUDE_CODE_PROACTIVE=1启用主动模式
CLAUDE_CODE_UNDERCOVER=1强制隐身模式
CLAUDE_CODE_TEAMMATE_COMMAND=/path自定义队友二进制路径
CLAUDE_CODE_SIMPLE=1协调器简单模式
CLAUDE_CODE_PLAN_MODE_REQUIRED=1要求计划模式
CLAUDE_INTERNAL_FC_OVERRIDES='{}' 特性标志覆盖(JSON 格式)
CLAUDE_CODE_GB_BASE_URL=...GrowthBook 覆盖
CLAUDE_CODE_TERMINAL_RECORDING=1终端录制
MONOREPO_ROOT_DIRAnthropic Monorepo 检测
ALLOW_ANT_COMPUTER_USE_MCP覆盖 Computer Use 门控

这些 HTTP 请求头会发送到 Anthropic API 以解锁服务端 Beta 功能。它们仅在运行内部 (Ant) 构建时才会被包含。

请求头常量用途
CLI_INTERNAL_BETA_HEADER内部 CLI Beta 访问 — 解锁仅限 Ant 的 API 能力
SUMMARIZE_CONNECTOR_TEXT_BETA_HEADER反蒸馏连接器文本处理
AFK_MODE_BETA_HEADER离开键盘模式 — 表示用户当前未在主动关注

这些请求头尤为重要,因为即使你启用了客户端代码路径,API 服务端也会拒绝包含这些请求头的请求,除非你的账户已获得授权。这是一个无法通过修改客户端来绕过的服务端门控。