Guide

国产模型接入总览

保留 Claude Code 的终端体验与工具能力，把「大脑」换成国内平台的模型。你仍用 claude 命令，请求会发到配置的 API 地址。

原理一句话

Claude Code 读取 ANTHROPIC_BASE_URL 和鉴权变量，把请求发到兼容 Anthropic 的接口。界面、斜杠命令、文件工具不变，变的是后端模型与账单归属。

三种常见付费方式

Claude 官方订阅（Pro / Team）

在终端运行 claude 后按提示浏览器登录。体验最接近官方，但需要可用的 Anthropic 账号与网络环境。

适合：已有官方账号、希望完整能力的用户

Anthropic API（按量计费）

在 Console 创建 API Key，写入环境变量或 settings.json。适合自动化与精确控费。

适合：开发者、CI、需要 API 集成的场景

国产模型 API + 兼容接口

通过 ANTHROPIC_BASE_URL 把请求转到 DeepSeek、GLM 等。保留 Claude Code 界面与工具，按国内平台计费。

适合：国内用户、想先低成本练手的初学者

国内初学者多数选第三种。不想手改环境变量？可看 CC Switch 图形化配置。

通用配置步骤

在对应平台注册并创建 API Key（相当于密码，勿泄露）。
查清该平台文档里的 Anthropic 兼容 Base URL 和模型名称。
在启动 claude 之前设置环境变量，或写入 ~/.claude/settings.json。
运行 claude，用 /status 或简单对话验证是否走通。
到平台控制台查看调用记录，确认费用从正确账户扣除。

~/.claude/settings.json 示例（全局）

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<你的 API Key，不要提交到 Git>",
    "ANTHROPIC_MODEL": "deepseek-chat"
  }
}

项目级可写 .claude/settings.local.json（加入 .gitignore）。详见官方 Settings 文档。

主流国产平台速览

下表为入门参考。Base URL 与模型名可能更新，配置前务必打开对应平台最新文档核对。

DeepSeek

完整教程 →Claude Code 配置文档去注册

性价比高，适合日常改代码；本站有模型映射与排错教程。

兼容地址: https://api.deepseek.com/anthropic
常用模型: deepseek-chat / deepseek-reasoner 等（以平台文档为准）

环境变量示例

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 API Key>
export ANTHROPIC_MODEL=deepseek-chat

智谱 GLM

Claude Code 配置文档去注册

国内访问稳定，支持 GLM Coding Plan；官方文档含环境变量、settings.json 与模型映射说明。

兼容地址: https://open.bigmodel.cn/api/anthropic
常用模型: glm-4-plus 等（以智谱开放平台为准）

环境变量示例

export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 API Key>
export ANTHROPIC_MODEL=glm-4-plus

Kimi（月之暗面）

去注册

长文本场景表现好，配置前请核对官方最新的 Anthropic 兼容地址。

兼容地址: https://api.moonshot.cn/anthropic（示例，请以官方文档为准）
常用模型: 以 Moonshot / Kimi 开放平台当前列表为准

环境变量示例

export ANTHROPIC_BASE_URL=<官方文档中的 Anthropic 兼容地址>
export ANTHROPIC_AUTH_TOKEN=<你的 API Key>
export ANTHROPIC_MODEL=<平台提供的模型名>

通义千问（阿里云）

去注册

企业用户多，注意区分通用 API 与 Anthropic 兼容端点。

兼容地址: 以阿里云「Claude Code 接入」文档为准
常用模型: qwen-max 等（以百炼 / DashScope 文档为准）

环境变量示例

# 请打开阿里云最新「Claude Code」集成文档复制 Base URL 与模型名

MiniMax

去注册

适合作为备选线路，上线前用简单对话验证连通性。

兼容地址: 以官方 Anthropic 兼容文档为准
常用模型: 以 MiniMax 开放平台文档为准

环境变量示例

export ANTHROPIC_BASE_URL=<官方兼容地址>
export ANTHROPIC_AUTH_TOKEN=<你的 API Key>
export ANTHROPIC_MODEL=<模型名>

Windows 用户注意

先安装 Git for Windows，否则 claude 在很多项目里无法正常使用 git 相关能力。
PowerShell 临时变量：$env:ANTHROPIC_BASE_URL="..."，仅当前窗口有效。
长期生效：用 setx 写入用户环境变量，或写入 settings.json；改完后关闭并重新打开终端。

使用注意

第三方模型可能不支持 Claude 的 extended thinking、部分缓存特性，表现会与官方有差异。
复杂架构设计仍建议用 Claude 官方模型；国产 API 更适合日常改 bug、写脚本、练手。
学习阶段不必过度省 Token，先把闭环跑通；熟悉后再按任务选模型控成本。

下一步

核对日期：2026-05-20