本页面提供了可用部署选项的概述,并帮助您为组织选择合适的配置。

提供商比较

功能AnthropicAmazon BedrockGoogle Vertex AI
区域支持的国家多个AWS区域多个GCP区域
提示缓存默认启用默认启用默认启用
身份验证API密钥AWS凭证(IAM)GCP凭证(OAuth/服务账户)
成本跟踪仪表板AWS Cost ExplorerGCP计费
企业功能团队,使用监控IAM策略,CloudTrailIAM角色,Cloud Audit Logs

云提供商

企业基础设施

配置概述

Claude Code支持灵活的配置选项,允许您组合不同的提供商和基础设施:

了解以下区别:

  • 企业代理:用于路由流量的HTTP/HTTPS代理(通过HTTPS_PROXYHTTP_PROXY设置)
  • LLM网关:处理身份验证并提供与提供商兼容的端点的服务(通过ANTHROPIC_BASE_URLANTHROPIC_BEDROCK_BASE_URLANTHROPIC_VERTEX_BASE_URL设置)

这两种配置可以同时使用。

使用Bedrock与企业代理

通过企业HTTP/HTTPS代理路由Bedrock流量:

# 启用Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

# 配置企业代理
export HTTPS_PROXY='https://proxy.example.com:8080'

使用Bedrock与LLM网关

使用提供Bedrock兼容端点的网关服务:

# 启用Bedrock
export CLAUDE_CODE_USE_BEDROCK=1

# 配置LLM网关
export ANTHROPIC_BEDROCK_BASE_URL='https://your-llm-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1  # 如果网关处理AWS身份验证

使用Vertex AI与企业代理

通过企业HTTP/HTTPS代理路由Vertex AI流量:

# 启用Vertex
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

# 配置企业代理
export HTTPS_PROXY='https://proxy.example.com:8080'

使用Vertex AI与LLM网关

将Google Vertex AI模型与LLM网关结合使用以进行集中管理:

# 启用Vertex
export CLAUDE_CODE_USE_VERTEX=1

# 配置LLM网关
export ANTHROPIC_VERTEX_BASE_URL='https://your-llm-gateway.com/vertex'
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1  # 如果网关处理GCP身份验证

身份验证配置

Claude Code在需要时使用ANTHROPIC_AUTH_TOKEN作为Authorization标头。SKIP_AUTH标志(CLAUDE_CODE_SKIP_BEDROCK_AUTHCLAUDE_CODE_SKIP_VERTEX_AUTH)用于LLM网关场景,其中网关处理提供商身份验证。

选择正确的部署配置

在选择部署方法时考虑这些因素:

直接提供商访问

最适合以下组织:

  • 希望最简单的设置
  • 拥有现有的AWS或GCP基础设施
  • 需要提供商原生监控和合规性

企业代理

最适合以下组织:

  • 有现有的企业代理要求
  • 需要流量监控和合规性
  • 必须通过特定网络路径路由所有流量

LLM网关

最适合以下组织:

  • 需要跨团队的使用跟踪
  • 希望在模型之间动态切换
  • 需要自定义速率限制或预算
  • 需要集中式身份验证管理

调试

调试部署时:

  • 使用claude /status斜杠命令。此命令提供对任何应用的身份验证、代理和URL设置的可观察性。
  • 设置环境变量export ANTHROPIC_LOG=debug来记录请求。

组织最佳实践

1. 投资于文档和记忆

我们强烈建议投资于文档,以便Claude Code理解您的代码库。组织可以在多个级别部署CLAUDE.md文件:

  • 组织范围:部署到系统目录,如/Library/Application Support/ClaudeCode/CLAUDE.md(macOS)以实现公司范围的标准

  • 存储库级别:在存储库根目录中创建包含项目架构、构建命令和贡献指南的CLAUDE.md文件。将这些检入源代码控制,以便所有用户受益

    了解更多

2. 简化部署

如果您有自定义开发环境,我们发现创建”一键”安装Claude Code的方式是在组织中推广采用的关键。

3. 从引导使用开始

鼓励新用户尝试使用Claude Code进行代码库问答,或处理较小的错误修复或功能请求。要求Claude Code制定计划。检查Claude的建议,如果偏离轨道则给出反馈。随着时间的推移,当用户更好地理解这种新范式时,他们将更有效地让Claude Code更自主地运行。

4. 配置安全策略

安全团队可以配置Claude Code允许和不允许执行的托管权限,这些权限不能被本地配置覆盖。了解更多

5. 利用MCP进行集成

MCP是为Claude Code提供更多信息的好方法,例如连接到票务管理系统或错误日志。我们建议一个中央团队配置MCP服务器并将.mcp.json配置检入代码库,以便所有用户受益。了解更多

在Anthropic,我们信任Claude Code为每个Anthropic代码库的开发提供动力。我们希望您像我们一样享受使用Claude Code!

下一步