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

七牛云行业应用

592人浏览 · 2026-04-08 11:27:17

七牛云行业应用 · 2026-04-08 11:27:17 发布

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 Bedrock	AWS 用户/企业	按调用计费	AWS 中国区可用
Google Vertex AI	GCP 用户/企业	按调用计费	需代理
Microsoft Foundry	Azure 用户/企业	按调用计费	Azure 中国区可用
LLM Gateway（LiteLLM 等）	团队统一管理	取决于后端	取决于配置
第三方兼容 API	国内用户/成本敏感	取决于提供商	✓

数据来源：Claude Code 官方认证文档、模型配置文档（code.claude.com/docs），2026 年 4 月。

在这里插入图片描述

方案一：Claude.ai 订阅直连（最简单）

适合个人开发者，使用 Claude Pro（$20/月）或 Max（$100/$200/月）订阅，无需管理 API Key。

配置步骤：

# 1. 安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash

# 2. 启动后自动打开浏览器登录
claude

# 3. 用 Claude.ai 账号登录即可

无需任何环境变量配置，订阅用量由 Anthropic 直接管理。

局限： 国内访问需代理；重度使用可能触及用量上限。

方案二：Claude Console API Key（开发者首选）

适合需要精确控制用量和费用的个人或小团队，按 Token 计费，灵活性最高。

配置步骤：

方式 A：环境变量（临时或开发环境）

export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxx
claude

方式 B：写入全局配置文件（永久生效）

编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxxxxxxxxxxx"
  }
}

方式 C：配置第三方兼容 API（国内推荐）

Claude Code 支持通过 ANTHROPIC_BASE_URL 将请求转发到任何兼容 Anthropic Messages 格式的推理服务：

export ANTHROPIC_API_KEY=your-provider-key
export ANTHROPIC_BASE_URL=https://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 Bedrock（AWS 用户）

适合已在 AWS 生态内的团队，支持 IAM 权限管理和企业级审计。

快速配置：

# 方式 A：AWS CLI（最常用）
aws configure
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_PROFILE=your-profile

# 方式 B：环境变量（Access Key）
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_ACCESS_KEY_ID=your-key
export AWS_SECRET_ACCESS_KEY=your-secret
export AWS_SESSION_TOKEN=your-token   # 临时凭证时需要

# 方式 C：Bedrock API Key（最简单，无需完整 AWS 凭证）
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_BEARER_TOKEN_BEDROCK=your-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 AI（GCP 用户）

适合 GCP 生态的团队，支持 global 和 regional 端点。

# 认证
gcloud auth application-default login

# 配置环境变量
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id

固定区域（部分模型不支持 global 端点）：

export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1
export VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5

注意： Vertex AI 的 /login 和 /logout 命令被禁用，认证完全由 Google Cloud 凭证管理。

方案五：Microsoft Foundry（Azure 用户）

适合 Azure 生态的团队，支持 API Key 和 Microsoft Entra ID 两种认证。

# 方式 A：API Key
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

# 方式 B：Entra ID（不设置 API Key 时自动使用）
az login
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name

方案六：LLM Gateway（团队统一管理）

LLM Gateway 在 Claude Code 和模型提供商之间增加代理层，提供统一鉴权、用量追踪、成本控制和审计日志。官方支持 LiteLLM Proxy。

⚠️ 安全警告： LiteLLM PyPI 版本 1.82.7 和 1.82.8 被恶意软件污染，可窃取凭证。如已安装，立即移除并轮换所有相关 Key。

基础配置（推荐统一端点）：

# 统一端点（推荐）：支持负载均衡、Fallback、成本追踪
export ANTHROPIC_BASE_URL=https://your-litellm-server:4000
export ANTHROPIC_AUTH_TOKEN=sk-litellm-your-static-key

动态 Key 轮换（进阶）：

{
  "apiKeyHelper": "~/bin/get-litellm-key.sh"
}

配合 CLAUDE_CODE_API_KEY_HELPER_TTL_MS=3600000 设置 Key 刷新间隔（毫秒）。

Gateway 必须支持以下 API 格式之一，并正确转发所有请求头：

Anthropic Messages：/v1/messages，需转发 anthropic-beta、anthropic-version 头
Bedrock InvokeModel：/invoke，需保留请求体中的 anthropic_beta、anthropic_version
Vertex rawPredict：:rawPredict，需转发 anthropic-beta、anthropic-version 头

在这里插入图片描述

模型配置：别名与版本固定

配置好 API 接入后，可以单独设置使用哪个模型。

模型别名（自动跟随最新版）

别名	当前对应模型	适用场景
`sonnet`	Claude Sonnet 4.6	日常编程任务
`opus` / `best`	Claude Opus 4.6	复杂推理任务
`haiku`	Claude Haiku 4.5	快速简单任务
`sonnet[1m]`	Sonnet 4.6（1M context）	超大代码库分析
`opus[1m]`	Opus 4.6（1M context）	长会话复杂推理
`opusplan`	Plan 阶段用 opus，执行阶段用 sonnet	兼顾质量与速度

设置模型（优先级从高到低）

# 1. 会话中切换（最高优先级，仅当前 session）
/model opus

# 2. 启动时指定
claude --model sonnet

# 3. 环境变量
export ANTHROPIC_MODEL=opus

# 4. 配置文件（永久）

{
  "model": "opus"
}

固定具体版本（团队部署必做）

使用别名会在 Anthropic 发布新版时自动切换，可能导致团队成员使用不同版本。生产环境建议固定：

export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-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 Gateway（LiteLLM）

在这里插入图片描述

常见问题

Q：ANTHROPIC_BASE_URL 设置了但不生效，是什么原因？
优先排查两点：① 确认提供商支持 /v1/messages 端点并正确转发 anthropic-beta 和 anthropic-version 请求头；② 如果使用 Bedrock/Vertex 格式接入 Gateway，需额外设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 避免功能特性不兼容。

Q：如何判断当前 Claude Code 使用的是哪个 API 和模型？
在 Claude Code 会话中运行 /cost，2.1.92 版本起会显示每个模型的用量明细和缓存命中情况。也可运行 /config 查看当前生效的模型设置。

Q：企业如何限制用户只能用指定模型？
在 managed 或 policy 级别的 settings.json 中设置 availableModels 字段。设置后，用户无法通过 /model、--model 参数或 ANTHROPIC_MODEL 环境变量切换到列表外的模型：

{
  "availableModels": ["claude-sonnet-4-6", "haiku"]
}

Q：Console 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/docs，2026 年 4 月 7 日），Claude Code 当前版本 2.1.92。

延伸资源

AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

AI标书底层技术全解析：NLP+大模型落地，喜鹊标书AI如何重构投标效率

AtomGit开源社区

GMS / HMS 是整个生态的 “命根子”，谁开源谁就放弃控制权

OpenHarmony开源生态的战略价值与落地挑战核心摘要：技术构成：OpenHarmony基于80%Linux等开源技术+20%自研创新（分布式总线/KAL/HDF框架），采用合理的技术集成策略而非抄袭。战略本质：通过完全自主的架构设计+开源Linux底座，实现系统主导权掌控，建立不受制于人的数字安全基座，其战略安全性＞短期功能性。生态现状：开源部分仅含操作系统骨架（Apache 2.0