Claude Code 国内模型接入：三种方案的配置与对比
一、背景：为什么需要国内模型接入
Claude Code 是 Anthropic 推出的 AI 编程助手 CLI 工具，默认使用 Claude 系列模型（Opus/Sonnet/Haiku）。但在国内网络环境下，开发者通常面临两个问题：
- 网络限制：部分用户无法直接访问 Anthropic API 端点（
https://api.anthropic.com） - 成本高昂：Claude API 按 token 计费，高强度开发场景下单月费用可达数百美元
解决方案：将国内大模型（DeepSeek、智谱 GLM、硅基流动等）通过 API 协议兼容转接方式接入 Claude Code，作为 Claude 的推理替代引擎。这种方式不依赖 Anthropic 官方 MCP 协议，而是通过修改 Claude Code 的 API 请求目标来实现接口替换。
本文将覆盖三种主流方案，从图形化工具到手动配置，每种方案都包含完整步骤、配置说明和故障排查。
二、三种方案概览
| 方案 | 工具 | 适用人群 | 难度 | 核心原理 |
|---|---|---|---|---|
| A. CC Switch 图形化 | CC Switch | 新手 / 不想动配置文件 | ⭐ | GUI 拦截 Claude Code 发往 api.anthropic.com 的请求，路由到第三方 API 供应商 |
| B. 手动配置 settings.json | 无额外工具 | 熟悉命令行 / 追求极致可控 | ⭐⭐ | 直接修改配置文件中的 API 端点和密钥 |
| C. 国内 Agent 代装 | WorkBuddy 等 | 无需命令行经验 | ⭐ | 用 AI Agent 自动安装 Claude Code + 配置 |
三、方案 A：CC Switch 图形化接入（适合不熟悉命令行的用户）
原理
CC Switch 是一个跨平台桌面应用，通过本地代理技术拦截 Claude Code 发往 api.anthropic.com 域名的 API 请求，将其路由到你指定的第三方 API 供应商（DeepSeek、智谱、Kimi、硅基流动等）。整个过程不需要手动编辑任何 JSON 配置文件。
api.anthropic.com 这一个域名的请求，不会劫持整机网络流量或影响其他应用程序的网络连接。安装与配置
第一步：下载 CC Switch
- GitHub 官方仓库下载（版本 ≥ 3.15.0）
- Windows 使用
.zip（解压即用）或.msi（安装版） - macOS 使用
.dmg - 如无法访问 GitHub，可到 B站或其他网络平台搜索 "CC Switch"，通常能找到热心用户分享的下载资源
第二步：获取 API Key
选择以下任一供应商注册并获取密钥：
- DeepSeek（推荐）：访问 platform.deepseek.com，注册 → 充值 → 创建 API Key
- 硅基流动（零成本体验）：访问 siliconflow.cn，注册 → 实名认证 → 获取 API 密钥。新用户赠送 ¥16 体验金
- 智谱 AI：访问 open.bigmodel.cn，注册后获取 API Key
- MiniMax、Kimi、百川 等流程类似
第三步：配置 CC Switch
- 打开 CC Switch → 点击右上角 “+” 号
- 选择供应商（如 DeepSeek），填入 API Key
- 根据供应商设置推荐模型名称：
| 供应商 | 推荐模型（旗舰） | 推荐模型（轻量） | 上下文长度 |
|---|---|---|---|
| DeepSeek | deepseek-v4-pro[1m] | deepseek-v4-flash[1m] | 100 万 token |
| 硅基流动 | Pro/MiniMaxAI/MiniMax-M2.5 | Pro/Qwen/Qwen3-Coder-480B | 视模型而定 |
| 智谱 | GLM-5.1 | GLM-5.1-Flash | 128K token |
[1m] 后缀：DeepSeek 的 V4 系列模型支持 100 万 token 上下文，[1m] 表示启用完整上下文。如不需要长上下文，可以省略以降低延迟。第四步：开启路由
- CC Switch 主界面 → 选择 Claude Code → 打开左上角开关（变绿即为启用）
- 如果报“切换路由状态失败”，参考下方故障排查
第五步（推荐）：跳过权限确认
在 CC Switch 中点击“编辑通用配置”，写入：
{ "permissions": { "defaultMode": "bypassPermissions" }}此配置跳过 Claude Code 每次操作前的权限询问，大幅提升使用流畅度。如果你希望保留安全确认，可跳过此步。
故障排查
问题：切换路由状态失败（报 {detail}）
这是 CC Switch 最常见的问题，根源是 Claude Code 的 settings.json 中缺少必要的认证标记。
解决方法：
- 检查
C:\Users\<用户名>\.claude\settings.json（macOS/Linux 为~/.claude/settings.json）是否存在 - 如果不存在，手动创建该文件，填入：
{ "env": { "ANTHROPIC_AUTH_TOKEN": "PROXY_MANAGED" }}- 退出 CC Switch（包括右下角系统托盘中的图标）
- 重新打开 CC Switch → 开启路由
问题：路由开启后依然失败
除上述 settings.json 缺失外，还需排查以下因素：
- 部分防火墙或杀毒软件（如 Windows Defender 防火墙、360 安全卫士、火绒等）可能拦截 CC Switch 的本地代理端口，导致路由无法生效。遇到此情况，请在防火墙或杀毒软件中将 CC Switch 添加为信任程序
- 确认 CC Switch 版本 ≥ 3.15.0
- 确认供应商的 API Key 有效且余额充足
- 确认已选择正确的模型名称
- 重启 Claude Code（CLI 端用
exit退出后重新打开，桌面端退出后重新启动）
四、方案 B：手动配置 settings.json（追求极致可控）
原理
Claude Code 在启动时会读取用户目录下的 settings.json 配置文件。通过修改该文件中的环境变量，可以直接指定 API 端点和模型，从而实现 API 协议兼容转接——接入任意兼容 Anthropic API 格式的第三方模型。
配置文件位置
| 操作系统 | 路径 |
|---|---|
| Windows | C:\Users\<用户名>\.claude\settings.json |
| macOS | ~/.claude/settings.json |
| Linux | ~/.claude/settings.json |
.claude是隐藏文件夹。如果在资源管理器中看不到，需要开启“显示隐藏的项目”：文件资源管理器 → 查看 → 勾选“隐藏的项目”。如果文件不存在，手动创建即可。Claude Code 的 CLI 端和 VS Code 插件端共用同一份配置。
DeepSeek 接入配置（完整版）
{ "env": { "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "你的 DeepSeek API Key", "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash[1m]", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" }}CLAUDE_CODE_EFFORT_LEVEL：此参数在新版 Claude Code 中已逐步废弃，非必要无需配置。如需调整推理强度，建议通过模型选择本身来控制。各配置项详解
| 配置项 | 必填 | 说明 |
|---|---|---|
ANTHROPIC_BASE_URL | ✅ | API 端点地址。各家模型提供兼容 Anthropic 格式的接口 |
ANTHROPIC_AUTH_TOKEN | ✅ | 你的 API Key。各家供应商的密钥格式不同，从供应商后台获取 |
ANTHROPIC_MODEL | ✅ | 默认使用的模型名称。这是最主要的配置项 |
ANTHROPIC_DEFAULT_OPUS_MODEL | 推荐 | 当 Claude Code 尝试调用 Opus 级别的能力时使用的模型。建议映射到你高性能的模型 |
ANTHROPIC_DEFAULT_SONNET_MODEL | 推荐 | 主力工作模型 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | 推荐 | 轻量快速任务模型 |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 建议 | 设为 “1” 可禁用非必要的网络请求（如遥测、更新检查） |
其他供应商的配置
硅基流动（SiliconFlow）
{ "env": { "ANTHROPIC_BASE_URL": "https://api.siliconflow.cn/anthropic", "ANTHROPIC_AUTH_TOKEN": "你的硅基流动 API Key", "ANTHROPIC_MODEL": "Pro/MiniMaxAI/MiniMax-M2.5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "Pro/MiniMaxAI/MiniMax-M2.5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "Pro/Qwen/Qwen3-Coder-480B", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "Pro/Qwen/Qwen3-Coder-480B" }}智谱 AI（GLM）
{ "env": { "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/paas/v4/anthropic", "ANTHROPIC_AUTH_TOKEN": "你的智谱 API Key", "ANTHROPIC_MODEL": "GLM-5.1", "ANTHROPIC_DEFAULT_OPUS_MODEL": "GLM-5.1", "ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-5.1", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "GLM-5.1-Flash" }}重要提醒
- CC Switch 会覆盖 settings.json：如果 CC Switch 的路由开关处于开启状态，它会覆盖你手动写入的 settings.json 配置。两者同时使用时以 CC Switch 为准
- API Key 是敏感信息：不要将包含 API Key 的 settings.json 提交到 Git 仓库。建议将 API Key 存储在环境变量中
- CLI 端和 VS Code 插件共用配置：在 settings.json 中修改后，两个端都会生效，无需重复配置
五、方案 C：国内 Agent 代装（无需命令行经验）
原理
使用国内的 AI Agent 产品（如 WorkBuddy）来全自动完成 Claude Code 的安装和基础配置。整个过程不需要手动操作命令行，适合无需命令行经验的开发者。
操作步骤
- 安装 Agent 工具：访问 workbuddy.cn（或其他国内 Agent 产品），下载安装
- 登录并切换模式：登录后切换到“代码开发”模式
- 发送安装指令：
帮我安装 Claude Code。如果是 macOS 用 Homebrew 安装。如果是 Windows 用 winget 安装：winget install Anthropic.ClaudeCode遇到问题自行安装依赖或解决。- 授权执行：当 Agent 遇到权限申请时，点击“同意运行”
- 等待完成：通常 5–10 分钟，安装过程全自动
- 配置模型：安装完成后，再按照方案 A 或方案 B 配置要使用的模型
局限性
- Agent 代装只解决安装问题，后续的模型配置仍需手动完成
- Agent 工具本身可能有使用门槛（注册、配置等）
- 不是所有 Agent 产品都支持此类操作，需要选择支持“代码开发”模式的产品
- 老旧 Windows 系统兼容性：部分老旧版本 Windows（如 Windows 10 早期版本、LTSC 版）大概率缺失
winget包管理器。Agent 通过winget安装时会失败，需先手动安装winget（从 Microsoft Store 安装“应用安装程序”）或改用 npm 方式安装 Claude Code。此外，部分系统可能缺少 VC++ 运行库、.NET Framework 等基础依赖，同样需手动预装
六、国内模型与价格速查
| 供应商 | 推荐模型 | 输入价格 | 输出价格 | 特色 |
|---|---|---|---|---|
| DeepSeek | v4-pro[1m] | ¥2/百万 token | ¥8/百万 token | 性价比之王，1M 上下文 |
| DeepSeek | v4-flash[1m] | ¥1/百万 token | ¥4/百万 token | 轻量低价，日常够用 |
| 硅基流动 | MiniMax-M2.5 | 免费额度（新用户送 ¥16） | 零成本体验 | |
| 智谱 | GLM-5.1 | ¥5/百万 token | ¥20/百万 token | 综合能力强 |
| MiniMax | MiniMax-M2.5 | ¥4/百万 token | ¥16/百万 token | 长文本处理优秀 |
| Kimi | Moonshot-v1-128k | ¥8/百万 token | ¥16/百万 token | 超长上下文 |
| 百川 | Baichuan4 | ¥10/百万 token | ¥20/百万 token | 中文理解力强 |
七、方案选择决策
┌─ 你能正常访问 Anthropic API 吗？│├─ 能 ──→ 优先考虑 MCP 挂载方案（能力无损，降本 70%）│ 本文的 API 替换方案会导致核心推理能力降级│ 且 MCP 全部失效│└─ 不能 ──→ 你需要 API 替换方案（本文） │ ├─ 不熟悉命令行，不想碰命令行？ │ └─→ 方案 C（Agent 代装）→ 方案 A（CC Switch） │ 注意：老旧 Windows 可能需手动安装系统依赖 │ ├─ 愿意用图形界面配置？ │ └─→ 方案 A（CC Switch）⭐ 推荐 │ └─ 追求极致可控，不介意编辑 JSON？ └─→ 方案 B（手动配置 settings.json） Windows 下记得开启"显示隐藏的项目"简洁版建议
| 你的情况 | 推荐方案 |
|---|---|
| 新手 / 不想折腾 | 方案 A（CC Switch）+ DeepSeek |
| 零成本体验 | 方案 A（CC Switch）+ 硅基流动（新用户 ¥16） |
| 熟练开发者 | 方案 B（手动配置） |
| 无需命令行经验 | 方案 C（Agent 代装）→ 方案 A |
| 追求高性能效果 | 方案 B + DeepSeek v4-pro[1m] |
八、常见问题
Q: CC Switch 和 settings.json 可以同时使用吗？
A: 可以，但 CC Switch 的路由开启后会覆盖 settings.json 的配置，以 CC Switch 为准。不建议同时使用两者，容易造成混淆。
Q: 切换模型后 Claude Code 的能力会下降多少？
A: 取决于你接入的模型。DeepSeek v4-pro 在代码生成任务上接近 Claude Sonnet 水平，但在架构设计、复杂推理方面仍有差距。硅基流动上的一些开源模型差距更大。这是接口替换方案的根本局限——你失去了 Claude 的核心推理能力，同时 MCP、Hook 等依赖 Claude 推理引擎的高级功能也将失效。
Q: settings.json 修改后不生效怎么办？
A: 检查以下几点：
- 文件路径是否正确（Windows 下
.claude是隐藏文件夹——需在资源管理器中开启“显示隐藏的项目”） - JSON 格式是否合法（可以用在线 JSON 校验工具检查）
- 是否退出了 Claude Code 后重新打开（CLI 端执行
exit，桌面端检查任务管理器是否有残留进程）
Q: CC Switch 会影响其他使用 Anthropic API 的工具吗？
A: CC Switch 只拦截 api.anthropic.com 域名的请求，默认只影响 Claude Code。不会劫持整机网络流量或影响其他应用程序。
Q: DeepSeek 的 [1m] 后缀是什么？必须加吗？
A: [1m] 表示启用 100 万 token 上下文窗口。加上的好处是支持超长对话和超大代码库分析，缺点是首 token 延迟略高。日常开发可以不使用 [1m]，需要处理长上下文时再加上。
Q: 使用接口替换后 MCP 还能用吗？
A: 不能。 MCP 生效的前提是 Claude 能够正常连接 Anthropic 官方 API 并完成推理。使用本文介绍的接口替换方案后，Claude 的核心推理引擎被第三方模型替代，所有基于 Claude 推理的 MCP 工具调用机制将一并失效。
九、安全与运维提醒
- API Key 管理：永远不要将 API Key 硬编码在项目代码或提交到 Git 仓库中。优先使用环境变量。
- 预算控制：在各供应商平台设置每日调用预算上限，异常超限自动停止，避免意外账单。
- 模型切换验证：切换模型后，用一个简单的代码生成任务验证配置是否正确，再进行高强度使用。
- 定期检查：各供应商的 API 端点和模型名称可能随版本更新而变化，定期检查官方文档更新。
- 备份配置：在修改 settings.json 前建议备份原文件，方便回滚。
十、总结
三种方案各有适用场景：
- CC Switch 是最省心的选择，图形化操作，内置了多家供应商的配置模板
- 手动配置 提供最大灵活性，适合需要精细控制模型选择和参数的开发者
- Agent 代装 帮助不熟悉命令行用户跨越安装门槛
但需要始终牢记：本文介绍的 API 协议兼容转接方案本质上是放弃了 Claude 的核心推理能力，用国内模型的推理替换了 Claude 的推理。如果你能正常访问 Anthropic API，建议优先考虑 MCP 挂载方案（详见《Claude Code MCP 挂载 DeepSeek —— 双模型协同降本 70% 方案说明》），它能让你在保留 Claude 全部能力的同时大幅降低成本。
备注 1：本文基于 2026 年 6 月 Claude Code 0.9.x 版本与各厂商公开接口信息编写。各厂商的定价、API 接口规范、模型名称以及 Claude Code 软件功能均可能随版本迭代发生变更，实际操作请以各平台官方最新文档为准。
备注 2：文中所涉方案仅限个人学习研究用途。如需商用，请遵守中华人民共和国相关法律法规以及各平台 API 服务协议中的商用条款。