内部用户门控：Ant 模式的隐身斗篷

在深入 Claude Code 源码时，你经常会看到 process.env.USER_TYPE === 'ant' 这样的条件判断。这不是一个普通的环境变量。它是 Claude Code 区分“内部开发者（Ants）”和“外部用户（External）”的核心门控机制。

核心概念

它是一个构建时的静态常量注入。在打包过程中，bundler 会将 process.env.USER_TYPE 替换为字面量（'ant' 或 'external'）。这意味着，如果你拿到的是外部公开版本，所有 if (process.env.USER_TYPE === 'ant') 块里的代码在打包阶段就被“死代码消除（Dead Code Elimination, DCE）”掉了。它既不会出现在你的二进制文件中，也不会占用任何运行内存。

代码里的真实逻辑

Claude Code 至少在 60 多个地方使用了这个门控，主要分布在以下领域：

1. 调试与日志 (src/utils/debug.ts)：
   • Ants 默认开启详细的调试日志。enableDebugLogging 会检查 USER_TYPE === 'ant'。
   • 存在专属的 logAntError 函数，专门捕获仅对内部开发有意义的堆栈信息，而不会干扰普通用户。
2. 模型访问与权限 (src/utils/model/antModels.ts)：
   • 内部用户可以使用尚未公开的、处于 Staging 阶段的模型。
   • getAntModels 如果检测到非 ant 用户，直接返回空数组，彻底切断路径。
3. 模拟系统与测试 (src/services/mockRateLimits.ts)：
   • 为了测试速率限制（Rate Limits）和计费逻辑，代码中内置了一套 Mock 系统。这套系统被严密保护在 USER_TYPE === 'ant' 之下，防止外部用户通过修改本地环境绕过限制。
4. UI 实验性功能 (src/hooks/useIssueFlagBanner.ts)：
   • 如果你在使用中遇到了困难（Friction Signal），Claude Code 会弹出一个“报告问题”的横幅。这个逻辑目前仅对 Ants 开放，用于收集内部测试反馈。
5. 高阶权限模式 (src/utils/permissions/PermissionMode.ts)：
   • auto 模式（全自动执行）在代码层面对外部用户是受限的。isExternalPermissionMode 强制排除了 auto 模式，除非你是 Ant。

踩坑指南

• 不是普通的环境变量：你不能简单地在本地运行 export USER_TYPE=ant 来解锁这些功能。由于 bundler 的 DCE 特性，外部发布的二进制文件中根本没有这部分代码逻辑。
• 优雅的单源码架构：这种模式允许 Anthropic 在同一个 Git 仓库中同时开发商业版和内部工具，而无需维护多个分支。所有的差异化逻辑都通过构建参数（Build Args）在编译阶段确定。

接下来看什么

如果你对这种“双重身份”的实现感兴趣，建议去看 src/services/analytics/growthbook.js。你会发现，静态的 USER_TYPE 和动态的功能开关（GrowthBook）经常配合使用，实现更细粒度的控制。

源码锚点

• src/utils/envUtils.ts (基础工具函数)

📄 src/utils/envUtils.tsL7-12 of 184

export const getClaudeConfigHomeDir = memoize(
  (): string => {
    return (
      process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), '.claude')
    ).normalize('NFC')
  },

• src/utils/debug.ts:259 (logAntError)

📄 src/utils/debug.ts — 259 (`logAntError`)L258-268 of 269

export function logAntError(context: string, error: unknown): void {
  if (process.env.USER_TYPE !== 'ant') {
    return
  }

  if (error instanceof Error && error.stack) {
    logForDebugging(`[ANT-ONLY] ${context} stack trace:\n${error.stack}`, {
      level: 'error',
    })
  }
}

• src/utils/model/antModels.ts:35 (getAntModelOverrideConfig)

📄 src/utils/model/antModels.ts — 35 (`getAntModelOverrideConfig`)L34-42 of 65

export function getAntModelOverrideConfig(): AntModelOverrideConfig | null {
  if (process.env.USER_TYPE !== 'ant') {
    return null
  }
  return getFeatureValue_CACHED_MAY_BE_STALE<AntModelOverrideConfig | null>(
    'tengu_ant_model_override',
    null,
  )
}

• src/services/mockRateLimits.ts:809 (setMockSubscriptionType)

📄 src/services/mockRateLimits.ts — 809 (`setMockSubscriptionType`)L806-814 of 883

export function setMockSubscriptionType(
  subscriptionType: SubscriptionType | null,
): void {
  if (process.env.USER_TYPE !== 'ant') {
    return
  }
  mockEnabled = true
  mockSubscriptionType = subscriptionType
}