企业控制面与受管配置

企业部署 Claude Code 时,真正要落地的是一套控制面:谁能用、走哪个 Provider、能访问哪些 MCP、Auto mode 信任哪些基础设施、如何看用量、哪些合规边界不能被本地用户覆盖。

如果你只需要代理、CA、mTLS 和网络 allowlist,先看 企业网络与集中管控。本页聚焦组织级策略和 rollout 后的治理。

#控制面地图

#Server-managed 与 endpoint-managed

受管 settings 处于 settings 优先级最高层。server-managed 与 endpoint-managed 不会做深度 merge:通常是谁先提供非空配置,谁就成为本次 managed 来源。调试时用 /status 看当前 managed source。

#Server-managed settings 运维点

官方 server-managed settings 从 claude.ai 管理后台配置,客户端启动时拉取,会话中定期轮询。

强制要求刷新成功后才能进入会话:

{
  "forceRemoteSettingsRefresh": true
}

这个开关适合强管控环境,但要先验证所有客户端都能访问官方 settings 服务。否则用户会直接卡在启动阶段。

#安全 settings 模板

禁止绕过权限,只允许托管规则生效:

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(curl * | sh)",
      "Bash(curl * | bash)"
    ],
    "disableBypassPermissionsMode": "disable"
  },
  "allowManagedPermissionRulesOnly": true
}

给 Auto mode 提供组织边界:

{
  "autoMode": {
    "environment": [
      "$defaults",
      "Organization: acme-corp. Primary use: software development and internal automation",
      "Source control: github.example.com/acme-corp and all repos under it",
      "Trusted internal domains: *.corp.example.com, api.internal.example.com",
      "Trusted cloud buckets: s3://acme-build-artifacts, gs://acme-ml-datasets",
      "Sensitive remote targets: prod Kubernetes namespaces and production databases"
    ]
  }
}

"$defaults" 很关键。省略它会替换官方默认规则,可能把 force push、curl | bash、生产部署等默认保护拿掉。

#Auto mode 策略

完整配置参考和 denial 复盘流程见 Auto mode 策略参考。本节只放企业控制面中最关键的边界。

Auto mode 不是简单的 allowlist。它会在权限系统之后再通过 classifier 判断操作是否可自动执行。

如果某个动作必须永远禁止,用 permissions.deny。不要只依赖 Auto mode classifier。

#Managed MCP

默认用户可以自行添加 MCP server。企业环境至少要明确 MCP 策略。

managed-mcp.json 不能通过 server-managed settings 下发。常见路径:

最小禁用 MCP:

{
  "mcpServers": {}
}

固定部署示例:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "company-internal": {
      "type": "stdio",
      "command": "/usr/local/bin/company-mcp-server",
      "args": ["--config", "/etc/company/mcp-config.json"]
    }
  }
}

不要在系统级 managed-mcp.json 里写明文 API Key。优先使用 OAuth、per-user headers、${VAR} 展开或 headersHelper。

#插件和市场的组织约束

插件可以带 Skills、agents、hooks、MCP、LSP 和可执行文件。企业里要同时管安装来源和插件内容。

插件分发细节见 插件市场与分发。

#Analytics 与 OTel

官方 analytics 可以用来衡量团队 adoption、贡献和使用趋势。Passion8 接入时,还需要从网关侧补齐请求、模型、成本和缓存字段。

建议至少保留这些维度:用户、团队、项目、Provider、模型、请求状态、cache_creation_input_tokens、cache_read_input_tokens、总成本、trace id。

#GitHub Enterprise Server

自托管 GitHub Enterprise Server 场景要额外确认:

如果 GHES 位于内网,通常要结合 Claude apps gateway、VPN、私有网络出口或只使用本地 CLI/IDE。

#合规边界

#上线验收

#官方参考

• Server-managed settings
• Managed MCP
• Auto mode configuration
• Analytics
• Legal and compliance
• GitHub Enterprise Server