Claude Code 如何切换第三方模型？四种方式完整配置指南

发布日期：2026-06-16 | 话题：Claude Code 配置 | 适用人群：开发者、AI 工程师
Claude Code 默认调用 Anthropic 官方 API，但通过修改 settings.json 中的 ANTHROPIC_BASE_URL 和 ANTHROPIC_MODEL 字段，可以切换到 Amazon Bedrock、Google Vertex AI、兼容 API 的第三方推理服务，或通过 Router 方案按任务类型动态路由到不同模型。切换后 Claude Code 的对话、代码生成、文件操作、工具调用等核心功能保持不变，仅底层调用路径发生改变。本文系统整理官方文档中四种切换方式的完整配置步骤、关键环境变量和常见报错处理，包括国内开发者最关心的兼容 API 接入方案。

为什么要切换第三方模型？

Claude Code 切换第三方模型的主要场景：

● 成本控制：部分云平台提供企业协议价，或配合预付资源包使用

● 合规要求：企业数据不出特定云环境（AWS/GCP 内部流转）

● 访问稳定性：国内开发者通过兼容 API 服务获得更低延迟

● 模型替换：将 Claude 模型替换为 DeepSeek、Kimi 等其他模型，复用 Claude Code 的工具链

● 多模型路由：主力任务用高性能模型，背景任务用低成本模型

方式一：兼容 API 服务（最简单，5 分钟完成）

适合国内开发者和希望快速接入的场景。只需两个字段：ANTHROPIC_BASE_URL（指向兼容服务的端点）和 ANTHROPIC_AUTH_TOKEN（API Key）。

配置 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "ANTHROPIC_BASE_URL": "https://你的兼容服务端点",
    "ANTHROPIC_MODEL": "目标模型 ID"
  }
}

以七牛云 API Key 为例，将 ANTHROPIC_AUTH_TOKEN 替换为七牛云控制台生成的 Key，ANTHROPIC_BASE_URL 填入 https://api.qnaigc.com，即可在国内直接接入多款主流大模型，无需额外网络配置。七牛云提供标准化 API 接入，兼容主流 SDK，激活后可调用平台内全部模型。

切换到非 Claude 模型（如 DeepSeek、Kimi）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "ANTHROPIC_BASE_URL": "https://你的兼容服务端点",
    "ANTHROPIC_MODEL": "deepseek/deepseek-v4-pro",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek/deepseek-v4-flash"
  }
}

ANTHROPIC_SMALL_FAST_MODEL 控制 WebFetch、会话标题生成等后台轻量任务使用的模型，建议设为成本更低的 Flash 级模型。

验证配置： 启动 Claude Code 后执行 /status，确认 Base URL 和模型名称正确显示。

方式二：Amazon Bedrock

Claude Code 内置 Bedrock 支持，通过登录向导或手动环境变量配置均可。

向导方式（推荐新手）

claude  # 启动后在登录界面选择 "3rd-party platform" → "Amazon Bedrock"

向导自动检测 AWS 凭证、验证模型可用性并写入 settings.json。配置完成后可随时用 /setup-bedrock 重新打开向导。

手动配置

{
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "AWS_REGION": "us-east-1",
    "AWS_ACCESS_KEY_ID": "你的 Access Key",
    "AWS_SECRET_ACCESS_KEY": "你的 Secret Key"
  }
}

固定模型版本（多人团队必须设置）：

{
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "AWS_REGION": "us-east-1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "us.anthropic.claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "us.anthropic.claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "us.anthropic.claude-haiku-4-5-20251001-v1:0"
  }
}

不固定版本时，模型别名（sonnet、opus）解析为 Claude Code 内置默认值，可能落后于最新版本。

注意事项：

● Bedrock 上 WebSearch 工具不可用

● /logout 命令不可用（认证由 AWS 凭证管理）

● 使用跨区域推理配置文件 ID 时需加 us. 前缀

方式三：Google Vertex AI

与 Bedrock 类似，内置登录向导支持。

向导方式

claude  # 登录界面选择 "3rd-party platform" → "Google Vertex AI"

配置完成后可用 /setup-vertex 重新打开。

手动配置

# 先设置 GCP 凭证
gcloud auth application-default login

{
  "env": {
    "CLAUDE_CODE_USE_VERTEX": "1",
    "CLOUD_ML_REGION": "global",
    "ANTHROPIC_VERTEX_PROJECT_ID": "你的 GCP Project ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5@20251001"
  }
}

区域说明： CLOUD_ML_REGION 支持 global（推荐，可用性最广）、多区域（us、eu）或具体区域（us-east5）。部分模型不支持 global 端点，可用 VERTEX_REGION_CLAUDE_* 单独指定。

方式四：Router 多模型路由（按任务类型动态切换）

Router 方案允许为不同任务类型指定不同模型，例如主力编程任务用高性能模型，背景摘要任务用轻量模型，兼顾性能和成本。

核心配置字段：

字段	说明
model	主力模型，处理主要对话和编程任务
ANTHROPIC_SMALL_FAST_MODEL	轻量后台任务（标题生成、WebFetch 等）
advisorModel	顾问工具使用的模型（v2.1.98+）
fallbackModel	主模型不可用时的备用链（最多 3 个）

示例：高性能主模型 + 低成本后台模型组合：

{
  "model": "claude-opus-4-8",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "ANTHROPIC_BASE_URL": "https://你的服务端点",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001"
  },
  "fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5-20251001"]
}

完整可配置字段速查：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "主力模型 ID",
  "advisorModel": "顾问模型 ID",
  "availableModels": ["sonnet", "opus"],
  "fallbackModel": ["备用模型1", "备用模型2"],
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "API Key",
    "ANTHROPIC_BASE_URL": "端点 URL",
    "ANTHROPIC_MODEL": "覆盖当前会话模型（优先级高于 model 字段）",
    "ANTHROPIC_SMALL_FAST_MODEL": "后台轻量任务模型",
    "MAX_THINKING_TOKENS": "0",
    "DISABLE_AUTO_COMPACT": "1"
  }
}

配置文件优先级与作用域

Claude Code 支持多级配置文件，高优先级覆盖低优先级：

优先级	文件位置	作用域
最高	/Library/Application Support/ClaudeCode/managed-settings.json（macOS）	企业托管策略
2	命令行参数 --model	当次启动
3	.claude/settings.local.json	项目本地（不提交 git）
4	.claude/settings.json	项目共享（提交 git）
最低	~/.claude/settings.json	用户全局

实用场景：

● 个人全局偏好 → 写入 ~/.claude/settings.json

● 项目统一配置（团队共享）→ 写入 .claude/settings.json

● 本地临时测试（不影响他人）→ 写入 .claude/settings.local.json

常见问题 FAQ

Q1：切换模型后 Claude Code 功能会受损吗？

对话、代码生成、文件读写、工具调用等核心功能保持可用。部分功能依赖特定模型能力：WebSearch 工具在 Bedrock 上不可用；思维链（thinking）功能需要支持 extended thinking 的模型。切换到非 Claude 模型时，兼容性取决于目标模型对 Anthropic API 格式的支持程度。Q2：ANTHROPIC_MODEL 和 model 字段有什么区别？

model 字段写在 settings.json 顶层，是持久化配置；ANTHROPIC_MODEL 写在 env 块或通过命令行 --model 传入，优先级更高，覆盖 model 字段，但只影响当前会话。日常使用推荐用 model 字段，临时切换用 ANTHROPIC_MODEL。

Q3：/model 命令和 settings.json 有什么关系？

/model 是会话内切换命令，效果等同于 ANTHROPIC_MODEL，仅影响当前会话，重启后恢复 settings.json 中的配置。availableModels 字段可以限制 /model 命令能选择的模型范围。

Q4：多人团队怎么统一模型版本？

将配置写入项目根目录的 .claude/settings.json 并提交 git，团队所有成员拉取后自动使用相同配置。Bedrock/Vertex 场景下务必用 ANTHROPIC_DEFAULT_*_MODEL 固定具体版本号，避免因别名解析不同导致结果不一致。

Q5：如何验证当前实际使用了哪个模型？

在 Claude Code 中执行 /status，会显示当前 Base URL、API Key 状态、已解析的模型名称和提供商信息。Bedrock 会显示 Amazon Bedrock，Vertex 显示 Google Vertex AI，自定义端点显示端点 URL。

小结

Claude Code 切换第三方模型的核心是两个配置项：ANTHROPIC_BASE_URL（指向目标服务）和 ANTHROPIC_MODEL（指定模型 ID），写入 ~/.claude/settings.json 的 env 块即生效。Bedrock 和 Vertex AI 有内置向导，配置更简单但有额外的云账号前置要求。多模型 Router 方案通过 model、ANTHROPIC_SMALL_FAST_MODEL、fallbackModel 三个字段组合，可以在性能和成本之间灵活取舍。本文配置示例基于 Claude Code 官方文档（code.claude.com/docs，2026-06），具体字段以官方文档为准。

参考来源：

● Claude Code 官方文档：Settings 配置项说明（code.claude.com/docs/en/settings）

● Claude Code 官方文档：Amazon Bedrock 接入指南（code.claude.com/docs/en/amazon-bedrock）

● Claude Code 官方文档：Google Vertex AI 接入指南（code.claude.com/docs/en/google-vertex-ai）

● 七牛云：通过 Router 配置 Claude Code 完整教程

● 七牛云：API Key 申请与管理

● 多模型统一接入与配置参考：七牛云 AI 大模型广场

● AI 编程套餐：Fenno Coding Plan