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 保质量