AI编程工具篇
如何使用Claude Code对接国产大模型
用Claude Code的体验,跑国产模型的能力
Claude Code 默认使用 Anthropic 的 Claude 模型,但通过简单配置,你可以让它对接国产大模型——如 MiniMax、智谱GLM、Kimi(月之暗面)等。这样既能享受 Claude Code 强大的工程能力,又能使用国产模型。
💡 类比:Claude Code 是一台"万能遥控器",默认控制的是 Claude 这台"电视"。通过修改设置,你可以让它控制其他"电视"(国产大模型),操作方式完全一样。
加载图表中...
为什么要对接国产大模型?
| 原因 | 说明 |
|---|---|
| 降低成本 | 国产模型 API 价格通常更低 |
| 网络稳定 | 国内访问更快、更稳定 |
| 中文优化 | 部分国产模型对中文理解更好 |
| 合规需求 | 某些项目需要使用国内服务 |
原理:OpenAI 兼容接口
大多数国产大模型都提供与 OpenAI 兼容的 API 接口。Claude Code 支持通过环境变量配置自定义的 API 端点,这就是对接的基础。
加载图表中...
配置方法
核心配置
Claude Code 通过环境变量来配置 API 连接:
# 设置 API 端点地址
export ANTHROPIC_BASE_URL="https://国产模型的API地址"
# 设置 API Key
export ANTHROPIC_API_KEY="你的API Key"
对接 MiniMax
MiniMax 提供兼容 OpenAI 格式的 API:
# 配置 MiniMax
export ANTHROPIC_BASE_URL="https://api.minimax.chat/v1"
export ANTHROPIC_API_KEY="你的MiniMax API Key"
# 启动 Claude Code
claude
对接智谱 GLM
智谱 AI 的 GLM 系列模型同样支持 OpenAI 兼容接口:
# 配置智谱 GLM
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/paas/v4"
export ANTHROPIC_API_KEY="你的智谱API Key"
# 启动 Claude Code
claude
对接 Kimi(月之暗面)
# 配置 Kimi
export ANTHROPIC_BASE_URL="https://api.moonshot.cn/v1"
export ANTHROPIC_API_KEY="你的Kimi API Key"
# 启动 Claude Code
claude
使用第三方聚合平台
如果你使用 PoloAI、UniAPI 等第三方聚合平台,配置更加灵活——一个 Key 可以访问多种模型:
# 使用第三方聚合平台
export ANTHROPIC_BASE_URL="https://api.poloai.top/v1"
export ANTHROPIC_API_KEY="你的第三方API Key"
# 启动时可以选择不同模型
claude
加载图表中...
永久配置(推荐)
每次输入环境变量很麻烦,可以写入 Shell 配置文件实现永久生效:
macOS / Linux
# 编辑 ~/.zshrc 或 ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.poloai.top/v1"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="你的API Key"' >> ~/.zshrc
# 使配置生效
source ~/.zshrc
项目级配置
也可以在项目根目录创建 .env 文件,只对当前项目生效:
# 项目根目录下的 .env 文件
ANTHROPIC_BASE_URL=https://api.poloai.top/v1
ANTHROPIC_API_KEY=你的API Key
⚠️ 记得把
.env加入.gitignore,不要把 API Key 提交到 Git!
国产模型能力对比
| 模型 | 编码能力 | 中文理解 | 上下文长度 | 价格 |
|---|---|---|---|---|
| MiniMax | 较强 | 优秀 | 较长 | 较低 |
| 智谱GLM-4 | 强 | 优秀 | 128K | 中等 |
| Kimi | 较强 | 优秀 | 超长(200K) | 较低 |
| DeepSeek | 很强 | 优秀 | 64K | 很低 |
注意事项
| 事项 | 说明 |
|---|---|
| 模型差异 | 国产模型和 Claude 的编码能力可能有差距,复杂任务建议用原版 Claude |
| 接口兼容性 | 并非所有功能都完全兼容,部分高级特性可能不支持 |
| 响应格式 | 少数情况下返回格式可能略有差异 |
| 及时切换 | 简单任务用国产模型省钱,复杂任务切回 Claude 保质量 |
加载图表中...
🎯 AI编程小贴士:对接国产大模型最大的好处是降低成本和提升网络稳定性。建议你准备两套配置——日常开发用国产模型(省钱),遇到复杂问题时切换回原版 Claude(保质量)。通过 Shell 别名可以快速切换。
小结
- Claude Code 可以通过环境变量对接国产大模型
- 支持 MiniMax、智谱GLM、Kimi 等主流国产模型
- 也可以通过第三方聚合平台(PoloAI、UniAPI)统一接入
- 建议写入 Shell 配置文件实现永久生效
- 简单任务用国产模型省钱,复杂任务用原版 Claude 保质量