Claude Code 默认使用 Anthropic 的 Claude 模型,但在国内访问可能不稳定。好消息是,Claude Code 支持配置第三方模型,包括国内大模型。
为什么配置国内模型
两个主要原因:
- 网络问题 — 国内访问 Anthropic API 需要代理
- 成本考虑 — 国内模型价格通常更低
核心方法:环境变量
Claude Code 通过环境变量支持自定义 API 端点。
关键配置项:
ANTHROPIC_BASE_URL # API 地址
ANTHROPIC_API_KEY # API 密钥
以阿里云百炼为例
阿里云百炼平台提供通义千问等模型的 API 服务。
第一步:获取 API Key
- 访问 bailian.console.aliyun.com
- 开通服务并创建 API Key
第二步:配置环境变量
export ANTHROPIC_BASE_URL="<你的 API 地址>"
export ANTHROPIC_API_KEY="<你的 API Key>"
第三步:开始使用
claude "你好,介绍一下你自己"
指定模型
不同平台有不同的模型 ID,使用时指定:
claude --model qwen-plus "解释一下 React 的 useEffect"
持久化配置
写入配置文件,不用每次设置:
# zsh
echo 'export ANTHROPIC_BASE_URL="<API 地址>"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="<API Key>"' >> ~/.zshrc
source ~/.zshrc
其他国内模型
原理相同,只需替换 BASE_URL 和 API_KEY:
- DeepSeek — platform.deepseek.com
- 智谱 GLM — open.bigmodel.cn
- 月之暗面 — platform.moonshot.cn
避坑提示
- 兼容性 — 不是所有模型都完全兼容 Claude API 格式
- 模型名称 — 每个平台的模型 ID 不同,注意查看官方文档
- API Key 安全 — 别把 Key 提交到 git 仓库