配置 Claude Code 使用国内大模型 0822更新
2025-08-22
📋 概述
Claude Code 是一款强大的 AI 辅助编程工具,默认使用 Anthropic 的模型。但在国内环境下,我们可以将其配置为使用国内领先的大模型,如DeepSeek、智谱 AI 和月之暗面的 Kimi,目前有三家国内模型供应商原生支持使用 Claude Code。本文将指导你完成这一配置过程。
🔑 第一步:获取 API 密钥
DeepSeek
- 访问 DeepSeek 开放平台
- 注册账号并在控制台创建 API Key
- 格式:
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
智谱 AI
- 访问 智谱 AI 开放平台
- 注册账号并在控制台创建 API Key
- 格式:
4dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
月之暗面 Kimi
- 访问 月之暗面开发者平台
- 注册账号并在控制台创建 API Key
- 格式:
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚙️ 第二步:配置环境变量
根据你选择的模型供应商,在终端中设置相应的环境变量:
🧠 DeepSeek 配置
export ANTHROPIC_API_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export ANTHROPIC_MODEL=deepseek-chat
export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
🚀 智谱 AI 配置
export ANTHROPIC_API_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_API_KEY=4dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
🌙 月之暗面 Kimi 配置
export ANTHROPIC_API_URL=https://api.moonshot.cn/anthropic
export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export ANTHROPIC_MODEL=kimi-k2-turbo-preview
export ANTHROPIC_SMALL_FAST_MODEL=kimi-k2-turbo-preview
🚀 第三步:启动 Claude Code
设置完环境变量后,直接启动 Claude Code:
claude
🔄 永久配置(推荐)
为了避免每次都要重新设置环境变量,建议将配置添加到 shell 配置文件中。
编辑 ~/.zshrc 或 ~/.bashrc 文件,添加以下内容(取消注释你想使用的配置):
# DeepSeek 配置
# export ANTHROPIC_API_URL=https://api.deepseek.com/anthropic
# export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# export ANTHROPIC_MODEL=deepseek-chat
# export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
# 智谱 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
# export ANTHROPIC_SMALL_FAST_MODEL=kimi-k2-turbo-preview
保存后执行 source ~/.zshrc 或 source ~/.bashrc 使配置生效。
🔍 故障排除
常见问题
- API 连接失败:检查网络连接、API Key 正确性和 API URL 格式
- 模型不可用:确认所选模型在对应平台可用
- 环境变量未生效:重新加载 shell 配置文件或重启终端
🌟 更多模型选择
如果你想使用更多模型或自定义本地模型,可以考虑使用 CC Terminal Proxy(原名为 Claude Code Proxy)。这是一个专为 Mac 用户设计的工具,允许你:
- ✨ 使用 Claude Code 搭配任意 AI 模型
- 🛡️ 通过本地部署保障数据隐私
- 💰 通过选择自己的模型提供商控制成本
详细信息请参考我们的文章:Claude Code Proxy 使用指南
✅ 结语
通过以上配置,你可以在 Claude Code 中使用国内领先的大模型,享受本地化的 AI 辅助编程体验。无论是 DeepSeek 的深度推理模型、智谱 AI 的 GLM 系列还是月之暗面的 Kimi 系列,都能为你的开发工作提供强大支持。
祝你编码愉快!🚀