Claude Code Feature Flags 完全列表

4 阅读5分钟

feature() 是 Bun 编译期的死代码消除机制,来自 bun:bundle 内置模块。值为 true 的代码路径会在打包时保留,为 false 的会被完全剥离,产生零运行时开销的条件编译。

import { feature } from 'bun:bundle'

// feature('VOICE_MODE') 为 false 时,这行在构建产物中完全不存在
const voiceCommand = feature('VOICE_MODE')
  ? require('./commands/voice/index.js').default
  : null

平台/构建模式 (Platform / Build Target)

Flag说明
IS_LIBC_GLIBC运行在 glibc Linux 环境
IS_LIBC_MUSL运行在 musl libc Linux 环境(如 Alpine)
NATIVE_CLIENT_ATTESTATION原生客户端硬件 attestation
DAEMON守护进程模式(后台常驻)
BYOC_ENVIRONMENT_RUNNERBYOC (Bring Your Own Cloud) 环境运行器

会话与远程 (Session / Remote)

Flag说明
SSH_REMOTESSH 远程会话支持 (claude ssh)
DIRECT_CONNECTcc:// URL 直连会话
CCR_AUTO_CONNECTCCR (Claude Code Remote) 自动连接
CCR_MIRRORCCR 镜像模式
CCR_REMOTE_SETUPCCR 远程设置命令
BG_SESSIONS后台会话
BRIDGE_MODEIDE 桥接模式(VS Code / JetBrains 集成)
DAEMON守护进程模式

订阅源 / 渠道 (Channel / Distribution)

Flag说明
ALLOW_TEST_VERSIONS允许安装/使用测试版本
AUTO_THEME自动主题切换(跟随系统)
FILE_PERSISTENCE文件持久化存储
STREAMLINED_OUTPUT精简输出模式
COMPACTION_REMINDERS会话压缩提醒
NEW_INIT新的初始化流程
DOWNLOAD_USER_SETTINGS下载用户远程设置
UPLOAD_USER_SETTINGS上传用户远程设置
SLOW_OPERATION_LOGGING慢操作日志
PERFETTO_TRACINGPerfetto 性能追踪

AI 模式 (Kairos / Assistant)

Kairos 是 Anthropic 内部的项目代号,代表 Claude 的 AI 主导交互模式。

Flag说明
KAIROS核心 AI/Assistant 模式(Claude 主动引导交互)
KAIROS_BRIEF简报模式(Kairos 的简洁版本)
KAIROS_CHANNELS频道/通道系统
KAIROS_DREAMClaude 主动发起行为("做梦"机制)
KAIROS_PUSH_NOTIFICATION推送通知
KAIROS_GITHUB_WEBHOOKSGitHub Webhook 集成(如订阅 PR)
PROACTIVE主动模式(Claude 不等待输入主动行动,Kairos 的旧称)

静默模式/非交互 (Non-Interactive / Automation)

Flag说明
UNATTENDED_RETRY无人值守模式下的重试机制
HARD_FAIL严格失败模式(遇到错误直接终止而非降级)

多 Agent 与协作 (Multi-Agent / Teammates)

Flag说明
COORDINATOR_MODE协调器模式(多 agent 编排)
TEAMMEM团队记忆(共享 memory)
FORK_SUBAGENTFork 子 agent 机制
QUICK_SEARCH快速搜索(子 agent 搜索模式)
BUILTIN_EXPLORE_PLAN_AGENTS内置的 Explore / Plan 专用 agent 类型
COWORKER_TYPE_TELEMETRYcoworker 类型遥测
AGENT_TRIGGERSAgent 触发器(CronCreate 等定时触发)
AGENT_TRIGGERS_REMOTEAgent 远程触发器
AGENT_MEMORY_SNAPSHOTAgent 内存快照
BASH_CLASSIFIERBash 命令分类器(判断安全风险)
TRANSCRIPT_CLASSIFIER对话记录分类器(判断 handoff 需求)
VERIFICATION_AGENT验证 agent(审查另一个 agent 的输出)
VOICE_MODE语音交互模式

内存与上下文 (Memory / Context)

Flag说明
EXTRACT_MEMORIES自动记忆提取(从对话中提取持久记忆)
MEMORY_SHAPE_TELEMETRY记忆形状遥测
CACHED_MICROCOMPACT缓存微压缩
CONTEXT_COLLAPSE上下文折叠(长上下文压缩)
REACTIVE_COMPACT响应式压缩
HISTORY_SNIP历史裁剪(精简历史记录)
HISTORY_PICKER历史拾取器
BREAK_CACHE_COMMAND缓存击穿命令
PROMPT_CACHE_BREAK_DETECTION提示缓存断裂检测
REVIEW_ARTIFACT审查产物

MCP 与工具系统 (MCP / Tools)

Flag说明
MCP_RICH_OUTPUTMCP 富输出(结构化结果显示)
MCP_SKILLSMCP 技能集成
CHICAGO_MCP"Chicago" MCP 服务器(项目代号)
WEB_BROWSER_TOOL网页浏览器工具
MONITOR_TOOL监控工具
OVERFLOW_TEST_TOOL溢出测试工具
TERMINAL_PANEL终端面板工具
UDS_INBOXUnix Domain Socket 收件箱(点对点通信)
BUDDYBuddy 彩蛋(陪伴精灵)
TREE_SITTER_BASHTree-sitter Bash 解析(语法分析)
TREE_SITTER_BASH_SHADOWTree-sitter Bash 影子模式(并行验证)

技能与模板 (Skills / Templates)

Flag说明
SKILL_IMPROVEMENT技能改进(自动优化 skill)
EXPERIMENTAL_SKILL_SEARCH实验性技能搜索
RUN_SKILL_GENERATOR技能生成器运行
TEMPLATES模板系统
WORKFLOW_SCRIPTS工作流脚本
HOOK_PROMPTSHook 提示词系统
MESSAGE_ACTIONS消息操作

自托管 / 企业 (Self-Hosted / Enterprise)

Flag说明
SELF_HOSTED_RUNNER自托管运行器
SHOT_STATS命中统计数据
ABLATION_BASELINE消融实验基线(A/B 测试对照)
ENHANCED_TELEMETRY_BETA增强遥测 Beta
ANTI_DISTILLATION_CC反蒸馏保护(Claude Code)
COMMIT_ATTRIBUTION提交归属追踪
TOKEN_BUDGETToken 预算控制
NATIVE_CLIPBOARD_IMAGE原生剪贴板图片支持

构建与集成 (Build / Integration)

Flag说明
LODESTONELodestone 集成(应用程序协议注册/深度链接)
BUILDING_CLAUDE_APPS构建 Claude Apps 模式
ULTRA PLAN (ULTRAPLAN)超长步骤规划模式
ULTRATHINK超长思考模式
BASH_CLASSIFIERBash 命令分类器
POWERSHELL_AUTO_MODEPowerShell 自动模式
TORCHTorch 命令(Claude Code 诊断/调试工具)
CONNECTOR_TEXT连接器文本模式
AWAY_SUMMARY离开摘要(用户不在时生成摘要)

使用模式分布

这些 flag 在代码库中按以下模式使用:

1. 条件导入(最常用)

const someModule = feature('SOME_FLAG')
  ? require('./path/to/module.js').default
  : null

2. 条件注册

if (feature('SOME_FLAG')) {
  commands.register(someCommand)
  tools.register(someTool)
}

3. 条件执行

if (feature('SOME_FLAG') && condition) {
  // 只有 flag 和环境条件同时满足才执行
}

4. 组合表达式

feature('KAIROS') || feature('KAIROS_BRIEF')
feature('DAEMON') && feature('BRIDGE_MODE')

当前构建中实际激活的 flag

从代码行为反推,当前公开发布的 CLI 版本中大概率激活的 flag:

激活状态Flag
✅ 激活SSH_REMOTE(claude ssh 子命令可见)
✅ 激活FORK_SUBAGENT(fork 子命令可见)
✅ 激活AGENT_TRIGGERS(cron 工具可用)
✅ 激活TRANSCRIPT_CLASSIFIER(自动模式切换)
✅ 激活MCP_RICH_OUTPUT
✅ 激活AUTO_THEME
❌ 未激活KAIROS / PROACTIVE(公开版无主动模式)
❌ 未激活BRIDGE_MODE
❌ 未激活DAEMON(外部无守护进程模式)
❌ 未激活VOICE_MODE
❌ 未激活COORDINATOR_MODE

注:确切激活状态由 Anthropic 的构建配置决定,以上是基于代码行为的推断。


参考

  • 定义位置:bun:bundle(Bun 内置,非项目内实现)
  • 使用文件:src/main.tsx, src/commands.ts, src/tools.ts, src/QueryEngine.ts, src/setup.ts, src/context.ts
  • 构建时完全消除死代码,零运行时开销