国产模型接入 Claude Code 全攻略：用 CC Switch 切换 DeepSeek、Qwen、Kimi、GLM、MiniMax

更新时间：2026-04-30

这篇教程写给已经能打开 Claude Code、但希望把日常编码模型切换到国产模型的同学。我们不手动反复改 ~/.claude/settings.json，而是用 CC Switch 管理 Provider：一次配置 DeepSeek、Qwen、Kimi、智谱 GLM、MiniMax，之后在桌面工具里一键切换。

重要提醒：国产模型接入 Claude Code 依赖各厂商提供的 Anthropic API 兼容接口、官方代理或平台侧模型映射。模型名称、计费和可用地域会变化，正式使用前请以对应厂商控制台为准。企业代码、生产密钥和客户数据不要走来源不明的免费中转。

你会搭好什么

完成后，你会得到这样一套工作流：

1. Claude Code 仍然作为终端里的编码助手使用。
2. CC Switch 负责保存多个 Provider，例如 DeepSeek、Qwen、Kimi、GLM、MiniMax。
3. 每个 Provider 里填入对应的 Base URL、API Key 和模型名。
4. 要切模型时，不再复制粘贴环境变量，直接在 CC Switch 里启用目标 Provider。
5. 进入项目目录运行 claude，用 /status 检查是否切换成功。

先理解原理

Claude Code 默认连接 Anthropic 官方服务。很多国产模型现在提供了“Anthropic API 兼容接口”，也就是说它们能接收类似 Claude Messages API 的请求格式。CC Switch 做的事情，是把这些接口配置集中管理起来，并写入 Claude Code 能读取的配置。

Claude Code
  -> CC Switch 当前启用的 Provider
  -> Anthropic 兼容 Base URL
  -> DeepSeek / Qwen / Kimi / GLM / MiniMax

这不是把 Claude Code 变成另一个软件，而是让 Claude Code 调用不同模型服务。模型能力、工具调用稳定性、上下文长度、费用和速率限制，都由实际接入的模型厂商决定。

安装 CC Switch

CC Switch 是一个桌面工具，支持 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 编程 CLI 的 Provider 管理。macOS 最省事的安装方式是 Homebrew：

brew tap farion1231/ccswitch
brew install --cask cc-switch

升级：

brew upgrade --cask cc-switch

Windows 可以去 GitHub Releases 下载 .msi 安装包或便携 ZIP；Linux 可以下载 .deb、.rpm、.AppImage，Arch 系可以使用：

paru -S cc-switch-bin

装好后第一次打开，建议让它先导入你已有的 Claude Code 配置，这样可以保留官方登录 Provider，后面随时切回官方 Claude。

接入前准备

请先确认这四件事：

1. Claude Code 已安装，并且 claude --version 能输出版本号。
2. CC Switch 已安装并能打开。
3. 至少准备一个模型厂商 API Key。
4. 先保留一个“官方 Claude / Official Login” Provider 作为回退。

建议先做一次配置备份：

cp ~/.claude/settings.json ~/.claude/settings.json.bak-$(date +%Y%m%d-%H%M%S) 2>/dev/null || true
cp ~/.claude.json ~/.claude.json.bak-$(date +%Y%m%d-%H%M%S) 2>/dev/null || true

检查 Claude Code：

claude --version

CC Switch 通用配置步骤

不同版本的 CC Switch 字段名可能略有差异，但配置逻辑是一致的：

1. 打开 CC Switch。
2. 选择 Claude Code 应用。
3. 点击 Add Provider，优先选厂商预设；没有预设就选择 Custom / Anthropic Compatible。
4. 填 Provider Name，例如 DeepSeek V4、Qwen 百炼、MiniMax M2.7。
5. 填 Base URL。
6. 填 API Key。部分厂商文档叫 ANTHROPIC_API_KEY，部分叫 ANTHROPIC_AUTH_TOKEN，在 CC Switch 里一般都填到 API Key / Auth Token 字段。
7. 填模型映射：主模型、Opus、Sonnet、Haiku、Small / Fast / Subagent。
8. 保存后点击 Enable / 启用。
9. 回到终端，在项目目录运行 claude。

进入 Claude Code 后输入：

/status

再让它做一个只读测试：

请先不要修改文件。请说明当前你能看到的工作目录、当前模型配置，以及你会如何开始阅读这个项目。

两条接入路线怎么选

路线	适合谁	优点	注意点
厂商直连	已经有对应厂商 API Key，希望减少中间层	路径清晰，排障简单，计费直接看该厂商控制台	每家都要单独申请 Key，模型名各不相同
百炼统一入口	希望用一个 DashScope Key 测多个国产模型	Qwen 官方入口；北京地域还支持 DeepSeek、Kimi、GLM、MiniMax 等第三方模型	第三方模型只适用于指定地域，模型版本可能比厂商直连慢一拍

如果你是第一次试，建议先用厂商直连跑通一个模型；如果你已经在用阿里云百炼，可以再配置一个“百炼统一入口”Provider 做对比。

DeepSeek 接入 Claude Code

DeepSeek 官方提供 Anthropic API 兼容入口，并且文档中已经给出了 Claude Code 的环境变量示例。用 CC Switch 时，不需要手动 export，只需要把这些值填到 Provider 中。

配置项	推荐填写
厂家官网	DeepSeek Platform
CC Switch Provider Name	DeepSeek V4
Base URL	https://api.deepseek.com/anthropic
API Key	DeepSeek API Key
主模型 / Opus / Sonnet	deepseek-v4-pro[1m]
Haiku / Small / Subagent	deepseek-v4-flash
备选模型	deepseek-v4-pro、deepseek-v4-flash
适合场景	长上下文代码阅读、复杂重构、中文技术解释、低成本子任务

在 CC Switch 中可以这样映射：

Claude Code 角色	DeepSeek 模型
Primary / Default	deepseek-v4-pro[1m]
Opus	deepseek-v4-pro[1m]
Sonnet	deepseek-v4-pro[1m]
Haiku	deepseek-v4-flash
Small / Fast / Subagent	deepseek-v4-flash

手动回退写法如下，方便你对照 CC Switch 字段：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your_deepseek_api_key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
claude

如果提示 model not found，先把主模型改成 deepseek-v4-pro；如果仍失败，进入 DeepSeek 控制台确认当前账号可用模型列表。

Qwen / 阿里云百炼接入 Claude Code

Qwen 最稳的接入方式是阿里云百炼的 Anthropic API 兼容接口。百炼文档给出的新版入口支持多个 Qwen 模型，并且中国站北京地域还能调用部分第三方国产模型。

配置项	推荐填写
厂家官网	阿里云百炼 Model Studio
CC Switch Provider Name	Qwen 百炼
中国站 Base URL	https://dashscope.aliyuncs.com/apps/anthropic
国际站 Base URL	https://dashscope-intl.aliyuncs.com/apps/anthropic
API Key	DashScope API Key
主模型 / Opus	qwen3.6-plus 或 qwen3.6-max-preview
Sonnet	qwen3-coder-next 或 qwen3-coder-plus
Haiku / Small / Subagent	qwen3.6-flash 或 qwen3-coder-flash
适合场景	代码生成、中文企业文档、需求拆解、低成本日常编码

建议模型映射：

Claude Code 角色	Qwen 模型
Primary / Default	qwen3.6-plus
Opus	qwen3.6-max-preview
Sonnet	qwen3-coder-next
Haiku	qwen3.6-flash
Small / Fast / Subagent	qwen3-coder-flash

手动回退写法：

export ANTHROPIC_BASE_URL=https://dashscope.aliyuncs.com/apps/anthropic
export ANTHROPIC_API_KEY=<your_dashscope_api_key>
export ANTHROPIC_MODEL=qwen3.6-plus
export ANTHROPIC_DEFAULT_OPUS_MODEL=qwen3.6-max-preview
export ANTHROPIC_DEFAULT_SONNET_MODEL=qwen3-coder-next
export ANTHROPIC_DEFAULT_HAIKU_MODEL=qwen3.6-flash
export CLAUDE_CODE_SUBAGENT_MODEL=qwen3-coder-flash
claude

百炼还有一个很实用的能力：北京地域的 Anthropic 兼容入口支持部分第三方模型。如果你想用一个 DashScope Key 统一试 DeepSeek、Kimi、GLM、MiniMax，可以额外建一个 Provider，Base URL 仍然填百炼北京地域地址，模型名按百炼控制台支持列表填写。

第三方模型	百炼文档示例模型
DeepSeek	deepseek-v4-pro、deepseek-v4-flash
Kimi	kimi-k2.5、kimi-k2-thinking
智谱 GLM	glm-5.1、glm-5、glm-4.7、glm-4.6
MiniMax	MiniMax-M2.5、MiniMax-M2.1

Kimi / Moonshot 接入 Claude Code

Kimi API 模型列表已经把 kimi-k2.6 列为最新模型，并标注上下文 256k；早期 Claude Code 接入文档仍以 kimi-k2.5 为示例。实际配置时，建议优先用 kimi-k2.6，如果当前账号、地域或接口暂未开放，再回退到 kimi-k2.5。

配置项	推荐填写
厂家官网	Kimi API Platform
CC Switch Provider Name	Kimi Moonshot
Base URL	https://api.moonshot.ai/anthropic
API Key	Moonshot API Key
主模型 / Opus / Sonnet	kimi-k2.6
Haiku / Small / Subagent	kimi-k2.6 或 kimi-k2.5
回退模型	kimi-k2.5
上下文参考	kimi-k2.6、kimi-k2.5 官方模型列表均标注 256k
适合场景	Agent 循环、长文档阅读、中文需求理解、代码解释

Kimi 的模型映射可以先保持全量一致：

Claude Code 角色	Kimi 模型
Primary / Default	kimi-k2.6
Opus	kimi-k2.6
Sonnet	kimi-k2.6
Haiku	kimi-k2.6
Small / Fast / Subagent	kimi-k2.5

手动回退写法：

export ANTHROPIC_BASE_URL=https://api.moonshot.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=<your_moonshot_api_key>
export ANTHROPIC_MODEL=kimi-k2.6
export ANTHROPIC_DEFAULT_OPUS_MODEL=kimi-k2.6
export ANTHROPIC_DEFAULT_SONNET_MODEL=kimi-k2.6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=kimi-k2.6
export CLAUDE_CODE_SUBAGENT_MODEL=kimi-k2.5
export ENABLE_TOOL_SEARCH=false
claude

如果 kimi-k2.6 报 404 或模型不存在，说明当前账号、地域或接口暂未开放该模型的 Anthropic 兼容调用，切回 kimi-k2.5：

export ANTHROPIC_BASE_URL=https://api.moonshot.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=<your_moonshot_api_key>
export ANTHROPIC_MODEL=kimi-k2.5
claude

智谱 GLM / Z.AI 接入 Claude Code

智谱现在的官方开发者文档在 Z.AI。GLM 5.1 已经有独立文档，定位为长任务和 Agentic Coding 的旗舰模型。Claude Code 接入文档中给出的 Anthropic 兼容 Base URL 是 https://api.z.ai/api/anthropic。

配置项	推荐填写
厂家官网	Z.AI 开放平台
CC Switch Provider Name	GLM 5.1
Base URL	https://api.z.ai/api/anthropic
API Key	Z.AI API Key
Opus	glm-5.1
Sonnet	glm-5-turbo
Haiku / Small / Subagent	glm-4.5-air
上下文参考	GLM-5.1 文档标注 200K 上下文、128K 最大输出
适合场景	长周期开发任务、复杂工程规划、前端原型、中文企业内容

建议模型映射：

Claude Code 角色	GLM 模型
Primary / Default	glm-5.1
Opus	glm-5.1
Sonnet	glm-5-turbo
Haiku	glm-4.5-air
Small / Fast / Subagent	glm-4.5-air

手动回退写法：

export ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic
export ANTHROPIC_AUTH_TOKEN=<your_zai_api_key>
export ANTHROPIC_MODEL=glm-5.1
export ANTHROPIC_DEFAULT_OPUS_MODEL=glm-5.1
export ANTHROPIC_DEFAULT_SONNET_MODEL=glm-5-turbo
export ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-4.5-air
export CLAUDE_CODE_SUBAGENT_MODEL=glm-4.5-air
claude

Z.AI 文档还提示：Claude Code 界面里有时仍显示 Claude 模型名，但实际服务端会映射到 GLM。最可靠的验证方式是看 API 控制台请求记录和账单消耗，同时用 /status 检查本地配置是否生效。

MiniMax 接入 Claude Code

MiniMax 国内开放平台文档明确推荐使用 cc-switch 配置 Claude Code，并给出了 MiniMax-M2.7 的 Anthropic 兼容入口。这里使用国内开放平台 platform.minimaxi.com，不是 minimax.io 的海外主页。

配置项	推荐填写
厂家官网	MiniMax 开放平台
CC Switch Provider Name	MiniMax M2.7
Base URL	https://api.minimaxi.com/anthropic
API Key	MiniMax API Key
主模型 / Opus / Sonnet	MiniMax-M2.7
Haiku / Small / Subagent	MiniMax-M2.7 或 MiniMax-M2.7-highspeed，以控制台开放情况为准
Token Plan	MiniMax 国内文档提供 Token Plan 入口，适合高频编码任务
适合场景	代码助手、Agent 工具、AI IDE、复杂办公流与工程自动化

如果 CC Switch 版本里已经有 MiniMax 预设，直接选择预设，填 API Key，再把模型名统一改成 MiniMax-M2.7。

Claude Code 角色	MiniMax 模型
Primary / Default	MiniMax-M2.7
Opus	MiniMax-M2.7
Sonnet	MiniMax-M2.7
Haiku	MiniMax-M2.7
Small / Fast / Subagent	MiniMax-M2.7

手动回退写法：

export ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your_minimax_api_key>
export ANTHROPIC_MODEL=MiniMax-M2.7
export ANTHROPIC_SMALL_FAST_MODEL=MiniMax-M2.7
export ANTHROPIC_DEFAULT_OPUS_MODEL=MiniMax-M2.7
export ANTHROPIC_DEFAULT_SONNET_MODEL=MiniMax-M2.7
export ANTHROPIC_DEFAULT_HAIKU_MODEL=MiniMax-M2.7
claude

MiniMax 文档特别提醒，配置前要清除旧的 Anthropic 环境变量，避免它们覆盖配置文件。如果你之前在 shell 里 export 过 Claude 或其他厂商的变量，先执行：

unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_API_KEY

推荐建立这 6 个 Provider

Provider 名称	Base URL	主模型	快模型
Official Claude	官方登录	官方 Claude 模型	官方 Claude 快模型
DeepSeek V4	https://api.deepseek.com/anthropic	deepseek-v4-pro[1m]	deepseek-v4-flash
Qwen 百炼	https://dashscope.aliyuncs.com/apps/anthropic	qwen3.6-plus	qwen3.6-flash
Kimi Moonshot	https://api.moonshot.ai/anthropic	kimi-k2.6	kimi-k2.5
GLM 5.1	https://api.z.ai/api/anthropic	glm-5.1	glm-4.5-air
MiniMax M2.7	https://api.minimaxi.com/anthropic	MiniMax-M2.7	MiniMax-M2.7

我的建议是：不要把所有角色都映射到最高价模型。Claude Code 会做很多读文件、列目录、生成摘要的子任务，快模型能明显降低成本。

一个更均衡的映射策略：

角色	用途	建议
Opus / 主模型	架构设计、复杂重构、疑难排错	用旗舰或长上下文模型
Sonnet	日常编码、组件实现、测试修复	用 coder 或 plus 模型
Haiku / Small / Subagent	文件阅读、摘要、简单改动	用 flash、air、highspeed、低成本模型

切换后的验证流程

每次切换 Provider 后，都按下面顺序验证：

cd /path/to/your-project
claude

在 Claude Code 里输入：

/status

再发一个安全的只读请求：

请不要修改文件。请读取当前目录结构，告诉我这个项目大概是什么技术栈，并说明你接下来会先看哪些文件。

如果它能正常读取目录、回答符合项目实际情况，并且模型控制台里出现请求记录，说明链路基本跑通。

常见问题排查

问题	常见原因	处理方式
切换后没变化	旧终端还保留环境变量，或 Claude Code 进程没重启	关闭当前 Claude Code，重新打开终端；清理旧 ANTHROPIC_* 变量
401 / unauthorized	API Key 填错、复制多了空格、Key 不属于该地域	重新复制 Key；确认中国站和国际站 Key 不混用
404 / model not found	模型名写错，或该模型未在当前地域开放	复制官方文档模型名；到控制台查看可用模型
429 / rate limit	触发限流或余额不足	降低并发、切快模型、充值或等待额度恢复
Claude Code 仍显示 Claude 模型名	部分平台采用服务端映射	看控制台请求记录和账单；确认 Base URL 和 Key 走的是目标厂商
工具调用不稳定	兼容层对 tool use 支持不完全	换更适合 Agent 的模型；复杂任务分阶段执行
长任务中断	上下文、输出长度、网关超时或 API timeout 不够	拆小任务；提高 API timeout；先让模型生成计划再逐步执行

如果你想彻底排除环境变量影响，可以新开一个干净 shell，先看当前变量：

env | grep -E 'ANTHROPIC|CLAUDE_CODE|DASHSCOPE|MOONSHOT|MINIMAX|DEEPSEEK|ZAI'

清理旧变量：

unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_API_KEY
unset ANTHROPIC_MODEL
unset ANTHROPIC_DEFAULT_OPUS_MODEL
unset ANTHROPIC_DEFAULT_SONNET_MODEL
unset ANTHROPIC_DEFAULT_HAIKU_MODEL
unset CLAUDE_CODE_SUBAGENT_MODEL

再回到 CC Switch 里重新启用 Provider。

成本和安全建议

1. 每个厂商单独建 API Key，不要多人共用一个长期密钥。
2. 给项目设置日预算、余额提醒或 Token Plan，尤其是 Claude Code 这种会自动多轮调用的工具。
3. 先在测试仓库跑通，不要一上来就接生产代码库。
4. 不要把 .env、私钥、数据库连接串、客户数据直接交给模型。
5. Provider 名称里写清楚“厂商、模型、地域”，例如 Qwen 北京 qwen3.6-plus，以后排查会轻松很多。
6. 保留官方 Claude Provider，遇到兼容问题时可以迅速切回。

一个实用的上手顺序

如果你不知道先接哪个，可以按这个顺序：

1. 先接 MiniMax M2.7，因为 MiniMax 国内文档直接推荐 cc-switch，路径最贴合本文。
2. 再接 Qwen 百炼，因为它是国内云平台统一入口，模型列表清晰。
3. 然后接 DeepSeek，适合做成本敏感的长上下文代码任务。
4. 再接 Kimi，重点测试中文需求理解和 Agent 循环。
5. 最后接 GLM 5.1，适合对比长任务和复杂工程规划。

最终你不需要只选一个模型。更好的方式是：日常开发用成本更舒服的模型，复杂任务切到旗舰模型，遇到兼容问题切回官方 Claude。

参考来源

• CC Switch 官网
• CC Switch GitHub 仓库
• Claude Code settings 官方文档
• DeepSeek Anthropic API 官方文档
• DeepSeek Integrate with AI Tools 官方文档
• 阿里云百炼 Claude Code 官方文档
• Kimi K2.5 Claude Code 官方接入文档
• Kimi API 模型列表
• Z.AI Claude Code 官方文档
• Z.AI GLM-5.1 官方文档
• MiniMax 国内开放平台：通过 AI 编程工具接入