Claude Code使用教程 第1篇:配置国内模型

8 阅读1分钟

Claude Code 默认使用 Anthropic 的 Claude 模型,但在国内访问可能不稳定。好消息是,Claude Code 支持配置第三方模型,包括国内大模型。

为什么配置国内模型

两个主要原因:

  1. 网络问题 — 国内访问 Anthropic API 需要代理
  2. 成本考虑 — 国内模型价格通常更低

核心方法:环境变量

Claude Code 通过环境变量支持自定义 API 端点。

关键配置项:

ANTHROPIC_BASE_URL      # API 地址
ANTHROPIC_API_KEY       # API 密钥

以阿里云百炼为例

阿里云百炼平台提供通义千问等模型的 API 服务。

第一步:获取 API Key

  1. 访问 bailian.console.aliyun.com
  2. 开通服务并创建 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

避坑提示

  1. 兼容性 — 不是所有模型都完全兼容 Claude API 格式
  2. 模型名称 — 每个平台的模型 ID 不同,注意查看官方文档
  3. API Key 安全 — 别把 Key 提交到 git 仓库