Claude Code 配置自定义模型指南

本文记录在 Linux 服务器上配置 Claude Code 使用第三方模型（如 MiniMax）的完整过程。

问题背景

MiniMax 官方文档建议通过 ~/.claude/settings.json 配置环境变量来使用 Claude Code：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "MINIMAX_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.minimax.chat/v1"
  }
}

实测结果：在 Linux 服务器上，此配置方式无效，环境变量不会生效。

解决方案：必须通过 Linux 环境变量配置才能正常使用。

解决方案

临时配置（仅当前终端有效）

export ANTHROPIC_AUTH_TOKEN="your_minimax_api_key"
export ANTHROPIC_BASE_URL="https://api.minimaxi.com/anthropic"

永久配置（推荐）

编辑用户配置文件：

nano ~/.bashrc

在文件末尾添加以下内容：

# MiniMax API 配置
export ANTHROPIC_AUTH_TOKEN="your_minimax_api_key"
export ANTHROPIC_BASE_URL="https://api.minimaxi.com/anthropic"

保存文件后，执行以下命令使配置生效：

source ~/.bashrc

系统级配置（可选）

如果需要所有用户都能使用，可以创建系统级配置：

sudo nano /etc/profile.d/claude.sh

添加内容：

export ANTHROPIC_AUTH_TOKEN="your_minimax_api_key"
export ANTHROPIC_BASE_URL="https://api.minimaxi.com/anthropic"

设置权限：

sudo chmod +x /etc/profile.d/claude.sh

验证配置

执行以下命令确认环境变量已正确设置：

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

输出显示对应的值即表示配置成功。

注意事项

1. 环境变量优先级：在 Linux 环境下，ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 环境变量的优先级高于 settings.json 配置文件。

2. API 端点：MiniMax 的实际 API 端点可能因服务类型不同而有所差异，常用端点包括：

   • 通用接口：https://api.minimax.chat/v1
   • 文本生成：https://api.minimax.chat/v1/text/chatcompletion_v2
   • 代码plannning: https://api.minimaxi.com/anthropic

3. 生效范围：修改 ~/.bashrc 后，需要执行 source ~/.bashrc 或重新登录才能生效。

4. 安全性：建议在生产环境中使用更安全的密钥管理方式，避免明文保存 API Key。

常见问题

Q: 配置后 Claude Code 仍然无法连接？

A: 检查以下事项：

• API Key 是否正确
• API 端点是否可访问（检查网络/防火墙）
• 环境变量是否已正确加载（使用 env | grep ANTHROPIC 查看）

Q: Windows 和 Linux 配置方式有何不同？

A: Windows 可使用 setx 命令或系统设置界面配置环境变量，也可以通过 settings.json 配置。Linux 环境下建议直接使用 ~/.bashrc 或 /etc/profile.d/ 目录配置。