配置 Claude Code 使用国内大模型
2025-08-14
📋 概述
Claude Code 是一款强大的 AI 辅助编程工具,默认使用 Anthropic 的模型。但在国内环境下,我们可以将其配置为使用国内领先的大模型,如智谱 AI 和月之暗面的 Kimi,这两家官方适配了claude code。本文将指导你完成这一配置过程。
🚀 配置智谱 AI 模型
步骤 1: 获取智谱 AI API 密钥
- 访问智谱 AI 开放平台并注册账号
- 在控制台中创建 API Key
# API Key 格式示例
4dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
步骤 2: 配置 Claude Code 环境变量
打开终端,设置以下环境变量:
# 设置 API 基础 URL
export ANTHROPIC_API_URL=https://open.bigmodel.cn/api/anthropic
# 设置 API Key
export ANTHROPIC_API_KEY=4dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
步骤 3: 启动 Claude Code
设置完环境变量后,直接启动 Claude Code:
claude
🌙 配置月之暗面 Kimi 模型
步骤 1: 获取月之暗面 API 密钥
- 访问月之暗面开发者平台并注册账号
- 在控制台中创建 API Key
# API Key 格式示例
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
步骤 2: 配置 Claude Code 环境变量
打开终端,设置以下环境变量:
# 设置 API 基础 URL
export ANTHROPIC_API_URL=https://api.moonshot.cn/anthropic
# 设置 API Key
export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# 设置模型名称
export ANTHROPIC_MODEL=kimi-k2-turbo-preview
export ANTHROPIC_SMALL_FAST_MODEL=kimi-k2-turbo-preview
步骤 3: 启动 Claude Code
设置完环境变量后,直接启动 Claude Code:
claude
🔄 永久配置(可选)
如果你希望永久设置这些配置,可以将环境变量添加到你的 shell 配置文件中:
Mac/Linux 用户
编辑 ~/.zshrc
或 ~/.bashrc
文件:
# 智谱 AI 配置
# export ANTHROPIC_API_URL=https://open.bigmodel.cn/api/anthropic
# export ANTHROPIC_API_KEY=4dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# 月之暗面配置
# export ANTHROPIC_API_URL=https://api.moonshot.cn/anthropic
# export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# export ANTHROPIC_MODEL=kimi-k2-turbo-preview
取消注释你想要使用的配置,然后执行 source ~/.zshrc
或 source ~/.bashrc
使配置生效。
🔍 故障排除
常见问题
- API 连接失败
- 检查网络连接
- 确认 API Key 是否正确
- 验证 API URL 是否正确
🌟 更多模型选择
如果你想使用更多模型或自定义本地模型,可以考虑使用 Claude Code Proxy。这是一个专为 Mac 用户设计的工具,允许你:
- ✨ 使用 Claude Code 搭配任意 AI 模型
- 🛡️ 通过本地部署保障数据隐私
- 💰 通过选择自己的模型提供商控制成本
详细信息请参考我们的文章:Claude Code Proxy 使用指南
✅ 结语
通过以上配置,你可以在 Claude Code 中使用国内领先的大模型,享受本地化的 AI 辅助编程体验。无论是智谱 AI 的 GLM 系列还是月之暗面的 Kimi 系列,都能为你的开发工作提供强大支持。
祝你编码愉快!🚀