配置 Claude Code 使用国内大模型

2025-08-14

📋 概述

Claude Code 是一款强大的 AI 辅助编程工具,默认使用 Anthropic 的模型。但在国内环境下,我们可以将其配置为使用国内领先的大模型,如智谱 AI月之暗面的 Kimi,这两家官方适配了claude code。本文将指导你完成这一配置过程。

🚀 配置智谱 AI 模型

步骤 1: 获取智谱 AI API 密钥

  1. 访问智谱 AI 开放平台并注册账号
  2. 在控制台中创建 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 密钥

  1. 访问月之暗面开发者平台并注册账号
  2. 在控制台中创建 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 ~/.zshrcsource ~/.bashrc 使配置生效。

🔍 故障排除

常见问题

  1. API 连接失败
    • 检查网络连接
    • 确认 API Key 是否正确
    • 验证 API URL 是否正确

🌟 更多模型选择

如果你想使用更多模型或自定义本地模型,可以考虑使用 Claude Code Proxy。这是一个专为 Mac 用户设计的工具,允许你:

  • ✨ 使用 Claude Code 搭配任意 AI 模型
  • 🛡️ 通过本地部署保障数据隐私
  • 💰 通过选择自己的模型提供商控制成本

详细信息请参考我们的文章:Claude Code Proxy 使用指南

✅ 结语

通过以上配置,你可以在 Claude Code 中使用国内领先的大模型,享受本地化的 AI 辅助编程体验。无论是智谱 AI 的 GLM 系列还是月之暗面的 Kimi 系列,都能为你的开发工作提供强大支持。

祝你编码愉快!🚀