配置服务器管理的设置

​

要求

• Claude for Teams 或 Claude for Enterprise 计划
• 您的 Claude 组织中的所有者或主要所有者角色，以查看和编辑配置
• Claude for Teams 的 Claude Code 版本 2.1.38 或更高版本，或 Claude for Enterprise 的版本 2.1.30 或更高版本
• 对 api.anthropic.com 的网络访问

​

在服务器管理和端点管理的设置之间选择

​

配置服务器管理的设置

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

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "/usr/local/bin/audit-edit.sh" }
        ]
      }
    ]
  }
}

{
  "autoMode": {
    "environment": [
      "Source control: github.example.com/acme-corp and all repos under it",
      "Trusted cloud buckets: s3://acme-build-artifacts, gs://acme-ml-datasets",
      "Trusted internal domains: *.corp.example.com"
    ]
  }
}

​

验证设置传递

​

访问控制

• 主要所有者
• 所有者

​

仅限托管的设置

​

当前限制

• 设置统一应用于组织中的所有用户。尚不支持按组配置。
• managed-mcp.json 文件无法通过服务器管理的设置分发。改为在那里传递 allowedMcpServers 和 deniedMcpServers 策略键。
• 限制于操作系统级别策略源的设置，如 policyHelper 和 wslInheritsWindowsSettings，不被遵守。改为通过 MDM 或系统 managed-settings.json 文件部署它们。

​

设置传递

​

设置优先级

​

获取和缓存行为

• Claude Code 异步获取设置
• 如果获取失败，Claude Code 继续运行而不使用托管设置
• 在设置加载之前有一个简短的窗口，其中限制尚未被强制执行

• 缓存的设置在启动时立即应用
• Claude Code 在后台获取新鲜设置
• 缓存的设置通过网络故障持久化

​

已传递设置中的无效条目

• 位于 ~/.claude/remote-settings.json 的缓存存储已删除无效条目的已保存有效负载。原始无效有效负载永远不会被持久化。
• 当有效负载中没有字段可以被保存时，Claude Code 保留最后接受的缓存设置并记录致命错误。
• 安全批准对话框评估已保存的有效负载，因此被删除的无效条目永远不会被呈现以供批准，也永远不会执行。

​

强制执行故障关闭启动

{
  "forceRemoteSettingsRefresh": true
}

​

安全批准对话框

• Shell 命令设置：执行 shell 命令的设置
• 自定义环境变量：不在已知安全允许列表中的变量
• Hook 配置：任何 hook 定义
• 托管 CLAUDE.md 内容：通过托管设置传递的 claudeMd 值

​

平台可用性

• Amazon Bedrock
• Google Vertex AI
• Microsoft Foundry
• Claude Platform on AWS
• 通过 ANTHROPIC_BASE_URL 或第三方 LLM gateways 的自定义 API 端点

​

审计日志

​

安全考虑

​

另请参阅

• Settings：完整的配置参考，包括所有可用的设置
• Endpoint-managed settings：由 IT 部门部署到设备的托管设置
• Authentication：设置用户对 Claude Code 的访问
• Security：安全保障和最佳实践