Claude Code API配置实战：国内可用方案与模型选型指南

Claude Code 支持多种 API 接入方式从个人订阅直连、API Key 调用到企业级 Amazon Bedrock、Google Vertex AI、Microsoft Foundry以及通过 LiteLLM 等 LLM Gateway 接入任意兼容提供商。本文梳理各方案的配置步骤、适用场景和选型建议覆盖从个人开发者到企业团队的全部需求。五种接入方式一览方案适合人群付费方式国内可用Claude.ai 订阅Pro/Max个人开发者月费包含用量需代理Claude Console API Key个人/小团队按 Token 计费需代理Amazon BedrockAWS 用户/企业按调用计费AWS 中国区可用Google Vertex AIGCP 用户/企业按调用计费需代理Microsoft FoundryAzure 用户/企业按调用计费Azure 中国区可用LLM GatewayLiteLLM 等团队统一管理取决于后端取决于配置第三方兼容 API国内用户/成本敏感取决于提供商✓数据来源Claude Code 官方认证文档、模型配置文档code.claude.com/docs2026 年 4 月。方案一Claude.ai 订阅直连最简单适合个人开发者使用 Claude Pro$20/月或 Max$100/$200/月订阅无需管理 API Key。配置步骤# 1. 安装 Claude Codecurl-fsSLhttps://claude.ai/install.sh|bash# 2. 启动后自动打开浏览器登录claude# 3. 用 Claude.ai 账号登录即可无需任何环境变量配置订阅用量由 Anthropic 直接管理。局限国内访问需代理重度使用可能触及用量上限。方案二Claude Console API Key开发者首选适合需要精确控制用量和费用的个人或小团队按 Token 计费灵活性最高。配置步骤方式 A环境变量临时或开发环境exportANTHROPIC_API_KEYsk-ant-xxxxxxxxxxxx claude方式 B写入全局配置文件永久生效编辑~/.claude/settings.json{env:{ANTHROPIC_API_KEY:sk-ant-xxxxxxxxxxxx}}方式 C配置第三方兼容 API国内推荐Claude Code 支持通过ANTHROPIC_BASE_URL将请求转发到任何兼容 Anthropic Messages 格式的推理服务exportANTHROPIC_API_KEYyour-provider-keyexportANTHROPIC_BASE_URLhttps://your-provider.com/v1 claude或写入配置文件{env:{ANTHROPIC_API_KEY:your-provider-key,ANTHROPIC_BASE_URL:https://your-provider.com/v1}}第三方提供商需支持/v1/messages和/v1/messages/count_tokens端点并正确转发anthropic-beta和anthropic-version请求头。方案三Amazon BedrockAWS 用户适合已在AWS 生态内的团队支持 IAM 权限管理和企业级审计。快速配置# 方式 AAWS CLI最常用aws configureexportCLAUDE_CODE_USE_BEDROCK1exportAWS_PROFILEyour-profile# 方式 B环境变量Access KeyexportCLAUDE_CODE_USE_BEDROCK1exportAWS_ACCESS_KEY_IDyour-keyexportAWS_SECRET_ACCESS_KEYyour-secretexportAWS_SESSION_TOKENyour-token# 临时凭证时需要# 方式 CBedrock API Key最简单无需完整 AWS 凭证exportCLAUDE_CODE_USE_BEDROCK1exportAWS_BEARER_TOKEN_BEDROCKyour-bedrock-api-key写入 settings.json推荐团队部署{env:{CLAUDE_CODE_USE_BEDROCK:1,AWS_PROFILE:your-profile},awsAuthRefresh:aws sso login --profile your-profile}awsAuthRefresh字段支持 AWS SSO 凭证过期时自动刷新无需手动重新登录。注意首次使用需在 Amazon Bedrock 控制台申请 Claude 模型访问权限一次性操作并在多用户部署时固定模型版本以防 Anthropic 更新模型后中断。方案四Google Vertex AIGCP 用户适合GCP 生态的团队支持 global 和 regional 端点。# 认证gcloud auth application-default login# 配置环境变量exportCLAUDE_CODE_USE_VERTEX1exportCLOUD_ML_REGIONglobalexportANTHROPIC_VERTEX_PROJECT_IDyour-gcp-project-id固定区域部分模型不支持 global 端点exportVERTEX_REGION_CLAUDE_4_6_SONNETeurope-west1exportVERTEX_REGION_CLAUDE_HAIKU_4_5us-east5注意Vertex AI 的/login和/logout命令被禁用认证完全由 Google Cloud 凭证管理。方案五Microsoft FoundryAzure 用户适合Azure 生态的团队支持 API Key 和 Microsoft Entra ID 两种认证。# 方式 AAPI KeyexportCLAUDE_CODE_USE_FOUNDRY1exportANTHROPIC_FOUNDRY_RESOURCEyour-resource-nameexportANTHROPIC_FOUNDRY_API_KEYyour-azure-api-key# 方式 BEntra ID不设置 API Key 时自动使用az loginexportCLAUDE_CODE_USE_FOUNDRY1exportANTHROPIC_FOUNDRY_RESOURCEyour-resource-name方案六LLM Gateway团队统一管理LLM Gateway 在 Claude Code 和模型提供商之间增加代理层提供统一鉴权、用量追踪、成本控制和审计日志。官方支持 LiteLLM Proxy。⚠️ 安全警告LiteLLM PyPI 版本1.82.7 和 1.82.8被恶意软件污染可窃取凭证。如已安装立即移除并轮换所有相关 Key。基础配置推荐统一端点# 统一端点推荐支持负载均衡、Fallback、成本追踪exportANTHROPIC_BASE_URLhttps://your-litellm-server:4000exportANTHROPIC_AUTH_TOKENsk-litellm-your-static-key动态 Key 轮换进阶{apiKeyHelper:~/bin/get-litellm-key.sh}配合CLAUDE_CODE_API_KEY_HELPER_TTL_MS3600000设置 Key 刷新间隔毫秒。Gateway 必须支持以下 API 格式之一并正确转发所有请求头Anthropic Messages/v1/messages需转发anthropic-beta、anthropic-version头Bedrock InvokeModel/invoke需保留请求体中的anthropic_beta、anthropic_versionVertex rawPredict:rawPredict需转发anthropic-beta、anthropic-version头模型配置别名与版本固定配置好 API 接入后可以单独设置使用哪个模型。模型别名自动跟随最新版别名当前对应模型适用场景sonnetClaude Sonnet 4.6日常编程任务opus/bestClaude Opus 4.6复杂推理任务haikuClaude Haiku 4.5快速简单任务sonnet[1m]Sonnet 4.61M context超大代码库分析opus[1m]Opus 4.61M context长会话复杂推理opusplanPlan 阶段用 opus执行阶段用 sonnet兼顾质量与速度设置模型优先级从高到低# 1. 会话中切换最高优先级仅当前 session/model opus# 2. 启动时指定claude--modelsonnet# 3. 环境变量exportANTHROPIC_MODELopus# 4. 配置文件永久{model:opus}固定具体版本团队部署必做使用别名会在 Anthropic 发布新版时自动切换可能导致团队成员使用不同版本。生产环境建议固定exportANTHROPIC_DEFAULT_SONNET_MODELclaude-sonnet-4-6exportANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-4-6exportANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5或在 settings.json 中{model:claude-sonnet-4-6,env:{ANTHROPIC_DEFAULT_SONNET_MODEL:claude-sonnet-4-6}}API 选型决策树我的使用场景是 │ ├─ 个人开发不想管理 Key │ └─ → Claude.ai 订阅Pro/Max │ ├─ 个人开发按用量付费 / 国内网络 │ └─ → Console API Key 第三方兼容 API │ ├─ 团队 / 企业已在 AWS │ └─ → Amazon Bedrock │ ├─ 团队 / 企业已在 GCP │ └─ → Google Vertex AI │ ├─ 团队 / 企业已在 Azure │ └─ → Microsoft Foundry │ └─ 团队需要统一管理多个提供商 └─ → LLM GatewayLiteLLM常见问题QANTHROPIC_BASE_URL 设置了但不生效是什么原因优先排查两点① 确认提供商支持/v1/messages端点并正确转发anthropic-beta和anthropic-version请求头② 如果使用 Bedrock/Vertex 格式接入 Gateway需额外设置CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS1避免功能特性不兼容。Q如何判断当前 Claude Code 使用的是哪个 API 和模型在 Claude Code 会话中运行/cost2.1.92 版本起会显示每个模型的用量明细和缓存命中情况。也可运行/config查看当前生效的模型设置。Q企业如何限制用户只能用指定模型在 managed 或 policy 级别的settings.json中设置availableModels字段。设置后用户无法通过/model、--model参数或ANTHROPIC_MODEL环境变量切换到列表外的模型{availableModels:[claude-sonnet-4-6,haiku]}QConsole API Key 和订阅方式哪个更便宜取决于使用量。订阅方式Claude Max $100/月包含大额用量适合重度用户Console 按 Token 计费轻度使用更划算。[数据待核实建议参考 anthropic.com/pricing 最新 Token 单价对比]Q国内网络如何使用 Claude Code通过ANTHROPIC_BASE_URL指向兼容 Anthropic API 格式的国内第三方推理服务即可无需修改其他配置。例如七牛云 AI 推理服务兼容该接口标准可通过API Key直接接入开发者在不修改代码的情况下切换底层模型。总结Claude Code API 配置的核心只有两个变量ANTHROPIC_API_KEY鉴权和ANTHROPIC_BASE_URL端点。云平台方案Bedrock/Vertex/Foundry通过各自的平台变量替代 API Key适合已有云服务合同的企业。个人用户最简路径是订阅直连国内用户通过ANTHROPIC_BASE_URL接入第三方兼容服务即可无缝使用。本文配置信息来自 Claude Code 官方认证文档、模型配置文档及 LLM Gateway 文档code.claude.com/docs2026 年 4 月 7 日Claude Code 当前版本 2.1.92。延伸资源Claude Code 认证配置官方文档Claude Code LLM Gateway 配置主流 AI 编程工具配置大全