Feature Flag清单——89个功能开关全览
Claude Code源码中有89个Feature Flag，它们是代码里的"秘密开关"，控制着各种功能的启用与禁用。这份清单整理了所有89个Flag，按功能域分类，方便查阅。
Flag成熟度分布
89个Flag按引用次数的成熟度分布：
| 引用次数 | Flag数量 | 成熟度阶段 | 说明 |
|---|---|---|---|
| 100+ | 2 | 深度集成期 | 核心功能，稳定运行 |
| 30-99 | 6 | 全面织入期 | 主要功能，广泛使用 |
| 10-29 | 12 | 模块集成期 | 独立模块，基本完整 |
| 3-9 | 27 | 初步实现期 | 初步开发，功能可用 |
| 1-2 | 42 | 原型探索期 | 原型阶段，实验性质 |
阵营1：自主Agent与后台运行（18个）
核心Flag
KAIROS — 154处引用 后台自主Agent模式，Claude Code向"后台智能体"演进的旗舰功能。
- 终端焦点感知（检测用户是否在看终端）
- 定时唤醒（Tick机制）
- 简报通信（Brief模式）
- 多频道通信（Channels）
- GitHub Webhook订阅
主要Flag
PROACTIVE — 35处引用 主动工作模式，Agent可以在用户不主动请求时自主执行任务。
COORDINATOR_MODE — 28处引用 跨Agent协调模式，支持复杂项目的多Agent协作。
BG_SESSIONS — 22处引用 后台会话管理，支持会话在后台持续运行。
AGENT_TRIGGERS — 18处引用 定时触发器，按时间或事件触发Agent执行。
其他Flag
| Flag | 引用 | 说明 |
|---|---|---|
| KAIROS_FOCUS | 15 | 焦点感知细分 |
| KAIROS_TICK | 14 | Tick唤醒细分 |
| KAIROS_BRIEF | 12 | 简报通信细分 |
| KAIROS_CHANNELS | 11 | 频道通信细分 |
| AGENT_TRIGGERS_REMOTE | 8 | 远程触发器 |
| KAIROS_DREAM | 7 | KAIROS专用记忆整合 |
| PROACTIVE_SUGGESTIONS | 6 | 主动建议 |
| COORDINATOR_V2 | 5 | 协调者模式V2 |
| BG_SESSIONS_PERSIST | 4 | 后台会话持久化 |
| KAIROS_WEBHOOKS | 3 | Webhook订阅细分 |
阵营2：远程控制与分布式执行（14个）
核心Flag
BRIDGE_MODE — 28处引用 远程控制模式，通过网络协议远程控制Claude Code实例。
- 桥接协议：远程控制通信
- UDS_INBOX：Unix Domain Socket通信
- SSH_REMOTE：SSH远程连接
主要Flag
DAEMON — 24处引用 守护进程模式，Claude Code作为后台服务运行。
UDS_INBOX — 19处引用 Unix Domain Socket通信，本地进程间通信。
SSH_REMOTE — 16处引用 SSH远程连接，通过SSH隧道控制远程实例。
其他Flag
| Flag | 引用 | 说明 |
|---|---|---|
| CCR_MIRROR | 9 | Bridge Mode子模式 |
| DAEMON_AUTO_START | 8 | 守护进程自动启动 |
| BRIDGE_V2 | 7 | Bridge协议V2 |
| REMOTE_CONTROL | 6 | 远程控制细分 |
| DISTRIBUTED_AGENTS | 5 | 分布式Agent |
| UDS_BROADCAST | 4 | UDS广播 |
| SSH_TUNNEL | 3 | SSH隧道细分 |
阵营3：上下文管理与性能优化（17个）
核心Flag
TRANSCRIPT_CLASSIFIER — 107处引用
智能权限分类器，实现auto权限模式的核心组件。
- 介于
plan（全部确认）和auto-accept（全部接受）之间 - AI判断操作风险等级
- 安全操作自动放行，危险操作请求确认
主要Flag
CONTEXT_COLLAPSE — 20处引用 精细化上下文折叠，选择性折叠不重要的工具结果。
CACHED_MICROCOMPACT — 18处引用 缓存感知微压缩，优化缓存命中率的微压缩策略。
TOKEN_BUDGET — 15处引用 Token预算追踪，精细化token使用监控。
PROMPT_CACHE_BREAK_DETECTION — 14处引用 缓存中断检测，追踪提示词变化导致的缓存失效。
其他Flag
| Flag | 引用 | 说明 |
|---|---|---|
| CONTEXT_COMPRESSION | 12 | 上下文压缩细分 |
| SMART_COMPACT | 11 | 智能压缩 |
| TOKEN_ESTIMATION | 10 | Token估算优化 |
| CACHE_OPTIMIZATION | 9 | 缓存优化细分 |
| MICROCOMPACT_V2 | 8 | 微压缩V2 |
| TRANSCRIPT_ANALYSIS | 7 | 会话记录分析 |
| CONTEXT_PRIORITIZATION | 6 | 上下文优先级 |
| CACHE_WARMING | 5 | 缓存预热 |
| PROMPT_OPTIMIZATION | 4 | 提示词优化 |
| PERFORMANCE_MONITORING | 3 | 性能监控 |
阵营4：记忆与知识管理（9个）
核心Flag
TEAMMEM — 51处引用 团队记忆系统，跨会话记忆共享和团队知识库。
- 自动记忆提取
- 敏感信息保护（Secret Guard）
- 记忆同步
主要Flag
EXTRACT_MEMORIES — 23处引用 自动记忆提取，每轮对话结束自动分析并提取值得持久化的信息。
EXPERIMENTAL_SKILL_SEARCH — 14处引用 实验性技能搜索，增强的技能发现和检索能力。
SKILL_IMPROVEMENT — 11处引用 技能自动改进，基于使用反馈自动优化技能。
其他Flag
| Flag | 引用 | 说明 |
|---|---|---|
| MEMORY_V2 | 8 | 记忆系统V2 |
| TEAMMEM_SYNC | 7 | 团队记忆同步 |
| KNOWLEDGE_GRAPH | 6 | 知识图谱 |
| MEMORY_PRUNING | 5 | 记忆修剪优化 |
| SECRET_GUARD | 4 | 敏感信息保护细分 |
阵营5：UI/UX与平台能力（31个）
核心Flag
VOICE_MODE — 46处引用 语音输入模式，支持语音转文字输入。
- 流式语音转文字
- Push-to-talk快捷键（空格键）
主要Flag
WEB_BROWSER_TOOL — 18处引用 内置浏览器，基于Bun WebView API的内嵌浏览器。
TERMINAL_PANEL — 16处引用 终端面板，增强的终端界面。
CHICAGO_MCP — 15处引用 Computer Use MCP集成，支持MCP协议的工具集成。
POWERSHELL_AUTO_MODE — 12处引用 PowerShell自动模式，Windows平台PowerShell优化。
UI/UX其他Flag
| Flag | 引用 | 说明 |
|---|---|---|
| RICH_RENDERING | 11 | 富文本渲染 |
| IMAGE_VIEWER | 10 | 图片查看器 |
| DIFF_VIEWER | 9 | 差异查看器 |
| PROGRESS_INDICATORS | 8 | 进度指示器 |
| NOTIFICATIONS | 7 | 通知系统 |
| THEME_CUSTOMIZATION | 6 | 主题定制 |
| KEYBOARD_SHORTCUTS | 5 | 快捷键系统 |
| COMMAND_PALETTE | 4 | 命令面板 |
| CONTEXT_MENU | 3 | 上下文菜单 |
| TOOLTIPS | 3 | 工具提示 |
平台能力Flag
| Flag | 引用 | 说明 |
|---|---|---|
| BUN_WEBVIEW | 14 | Bun WebView支持 |
| WINDOWS_OPTIMIZATION | 10 | Windows平台优化 |
| MACOS_INTEGRATION | 9 | macOS系统集成 |
| LINUX_SUPPORT | 8 | Linux支持优化 |
| WSL_INTEGRATION | 7 | WSL集成 |
| CONTAINER_MODE | 6 | 容器模式 |
| REMOTE_DEVELOPMENT | 5 | 远程开发 |
| MULTI_WORKSPACE | 4 | 多工作区 |
| SESSION_TABS | 3 | 会话标签页 |
实验性Flag（精选）
以下Flag处于原型探索阶段（1-2处引用），可能不稳定：
| Flag | 说明 |
|---|---|
| TREE_SITTER_BASH | Tree Sitter Bash解析 |
| TREE_SITTER_BASH_SHADOW | Bash解析阴影模式 |
| ABLATION_BASELINE | 消融实验基线 |
| LLM_ROUTING | LLM路由实验 |
| AGENT_SPECULATION | Agent推测执行 |
| CODE_GENERATION_V2 | 代码生成V2 |
| TEST_GENERATION | 测试生成 |
| DOC_GENERATION | 文档生成 |
| REFACTOR_SUGGESTIONS | 重构建议 |
| CODE_REVIEW_ASSISTANT | 代码审查助手 |
| DEBUGGING_ASSISTANT | 调试助手 |
| DEPLOYMENT_INTEGRATION | 部署集成 |
| MONITORING_DASHBOARD | 监控面板 |
| ANALYTICS_ENHANCED | 增强分析 |
| CUSTOM_THEMES | 自定义主题 |
| PLUGIN_SYSTEM | 插件系统 |
| EXTENSION_API | 扩展API |
| SCRIPTING_ENGINE | 脚本引擎 |
| WORKFLOW_AUTOMATION | 工作流自动化 |
| TEMPLATE_SYSTEM | 模板系统 |
用户可配置的Flag
以下Flag可通过环境变量或设置文件启用：
环境变量配置
# 功能开关
export CLAUDE_CODE_COORDINATOR_MODE=true
export CLAUDE_CODE_VOICE_ENABLED=true
export CLAUDE_CODE_ALWAYS_THINKING=true
export CLAUDE_CODE_EFFORT_LEVEL=high
settings.json配置
{
"voiceEnabled": true,
"alwaysThinkingEnabled": true,
"experimentalSkills": true
}
Flag之间的依赖关系
某些Flag之间存在依赖关系：
DAEMON → 需要 BRIDGE_MODE
KAIROS_DREAM → 可独立于 KAIROS
CCR_MIRROR → BRIDGE_MODE的子模式
AGENT_TRIGGERS_REMOTE → AGENT_TRIGGERS的扩展
COORDINATOR_V2 → 需要 COORDINATOR_MODE
PROACTIVE_SUGGESTIONS → 需要 PROACTIVE
CONTEXT_COLLAPSE → 需要 CACHED_MICROCOMPACT
依赖设计原则：
- 子功能可独立于父功能启用
- 硬依赖用
&&表达 - 软关联用
||表达
构建配置与Flag
公开构建
绝大多数Flag为false，只有基础功能启用。
内部构建（ant）
USER_TYPE === 'ant'时启用：
- KAIROS
- 实验性技能
- A/B测试功能
- 内部工具
实验构建
特定Flag组合用于A/B测试：
TREE_SITTER_BASHvsTREE_SITTER_BASH_SHADOWABLATION_BASELINE：消融实验基线
如何查看当前Flag状态
# 在Claude Code中查看
/flags
# 或检查环境变量
echo $USER_TYPE
# 查看设置文件
cat ~/.claude/settings.json
Flag演进趋势
从89个Flag的分布可以看出Claude Code的发展方向：
- 后台自主化：KAIROS相关Flag数量最多，说明这是重点方向
- 智能化权限：TRANSCRIPT_CLASSIFIER深度集成，智能决策是趋势
- 团队协作：TEAMMEM和COORDINATOR_MODE，多Agent协作是重点
- 跨平台：UI/UX阵营Flag数量多，平台适配是长期工作
- 实验性探索：47%的Flag在原型阶段，大量功能在探索中
这对用户的意义
预判发展方向
- KAIROS相关Flag最多 → 后台自主Agent是未来重点
- VOICE_MODE引用多 → 语音交互会不断完善
- 记忆系统Flag少但集中 → 记忆功能是基础设施，会稳定迭代
理解实验性功能
- 1-2处引用的Flag：非常实验性，可能随时变化
- 10-29处引用的Flag：相对成熟，可以尝试
- 100+处引用的Flag：核心功能，稳定可靠
配置建议
- 生产环境：只使用成熟Flag（30+引用）
- 个人探索：可以尝试中等成熟度Flag（10-29引用）
- 实验测试：可以接受原型Flag（1-2引用），但要有心理准备
这份清单涵盖了Claude Code的89个Feature Flag。理解这些Flag，你就能：
- 预判Claude Code的发展方向
- 理解实验性功能的实现机制
- 合理配置高级功能
- 在自己的项目中应用类似的技术
