使用 AIMax 配置 Claude Code

Claude Code 通过 Anthropic Messages 协议调用模型。AIMax 为该协议提供统一入口，因此 Claude Code 的 Base URL、认证方式和模型选择可以独立配置。

本文不把某个 Claude Code 版本或某个模型版本作为唯一支持范围。Claude Code 的文件修改、MCP、联网搜索、插件和复杂 Agent 回合仍需按目标模型分别验证。

准备工作

按 Claude Code 官方文档安装 claude 命令。
获取 AIMax API Key。
先调用 /v1/models，选择当前 Key 可见的模型。

export AIMAX_API_KEY="YOUR_API_KEY"
export AIMAX_BASE_URL="https://your-domain"

curl --request GET \
  --url "$AIMAX_BASE_URL/v1/models" \
  --header "Authorization: Bearer $AIMAX_API_KEY"

保存一个模型 ID：

export AIMAX_MODEL="MODEL_FROM_MODELS"

环境变量

export ANTHROPIC_API_KEY="$AIMAX_API_KEY"
export ANTHROPIC_BASE_URL="$AIMAX_BASE_URL"

ANTHROPIC_BASE_URL 填服务根地址，例如 https://your-domain。Claude Code 会自行请求：

POST /v1/messages

不要把 /v1/messages 直接写进 Base URL。

最小验证

先用计划权限和单轮纯文本任务验证：

claude \
  --print \
  --output-format json \
  --permission-mode plan \
  --bare \
  --model "$AIMAX_MODEL" \
  "只回复 OK，不要调用任何工具。"

成功时应返回单轮文本结果。确认基础协议正常后，再打开文件读写、Shell、MCP 或联网能力。

使用不同模型族

Claude Code 的请求协议仍然是 Anthropic Messages；切换模型只改变 --model 的模型 ID：

# Claude 模型
claude --model "CLAUDE_MODEL_FROM_MODELS" --print "只回复 OK"

# GPT 模型
claude --model "GPT_MODEL_FROM_MODELS" --print "只回复 OK"

# Gemini、Kimi、Grok 或其他当前可见模型
claude --model "MODEL_FROM_MODELS" --print "只回复 OK"

这要求目标模型在 AIMax 的 Anthropic Messages 入口上可用。模型能够通过 OpenAI Chat/Responses 调用，不代表 Claude Code 入口一定可用；如果出现协议或参数错误，应回到 /v1/messages 的实际错误进行确认。

常见问题

返回 401 或 403

使用 ANTHROPIC_API_KEY，不要只设置 OPENAI_API_KEY。
确认 ANTHROPIC_BASE_URL 没有重复追加 /v1 或 /v1/messages。
确认 Key 没有前后空格或换行。

返回模型不可用

重新查询 /v1/models，使用当前 Key 返回的完整模型 ID。不同分组或授权范围可能看到不同模型集合。

纯文本成功，工具调用失败

工具调用需要模型、协议转换和目标工具共同支持。先确认最小文本任务，再单独验证具体工具和权限，不要把单轮 OK 结果当成完整 Agent 能力验收。

集成总览

聊天应用

开发工具

Agent 应用

应用平台

Claude Code

使用 AIMax 配置 Claude Code

准备工作

环境变量

最小验证

使用不同模型族

常见问题

返回 401 或 403

返回模型不可用

纯文本成功，工具调用失败

协议参考

​使用 AIMax 配置 Claude Code

​准备工作

​环境变量

​最小验证

​使用不同模型族

​常见问题

​返回 401 或 403

​返回模型不可用

​纯文本成功，工具调用失败

​协议参考

使用 AIMax 配置 Claude Code

准备工作

环境变量

最小验证

使用不同模型族

常见问题

返回 401 或 403

返回模型不可用

纯文本成功，工具调用失败

协议参考