Claude Code

Claude Code 通过 Anthropic Messages 协议连接 AIMax，适合在终端中进行代码阅读、修改和任务执行。

支持状态：AIMax Anthropic Messages 已完成最小文本与工具调用验证，Claude 系模型与国产模型均可通过 ANTHROPIC_MODEL 直接指定。具体模型的文件、Shell、MCP、联网和多回合 Agent 能力需要分别验证。

准备工作

在 AIMax 平台创建文本 API Key。
从该 Key 当前可见模型中选择模型；本文使用 claude-sonnet-4-6 作为示例，国产模型（如 deepseek-v4-pro）同样可以直接使用。
如果 Claude Code 已登录 Claude 账号，建议先执行 /logout，避免账号 Token 与 API Key 冲突。

协议字段见 Claude Messages。本页只说明 Claude Code 产品配置。

安装 Claude Code

使用官方安装脚本：

curl -fsSL https://claude.ai/install.sh | bash
claude --version

也可以通过 Homebrew 或 npm 安装：

brew install --cask claude-code

npm install -g @anthropic-ai/claude-code
claude --version

写入配置

macOS / Linux

在当前终端设置：

export ANTHROPIC_API_KEY="YOUR_API_KEY"
export ANTHROPIC_BASE_URL="https://api.aimaxa.cn"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

需要长期生效时，把配置写入 ~/.zshrc 或 ~/.bashrc，然后重新打开终端。

Windows PowerShell

$env:ANTHROPIC_API_KEY="YOUR_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.aimaxa.cn"
$env:ANTHROPIC_MODEL="claude-sonnet-4-6"

ANTHROPIC_BASE_URL 使用服务根地址，不要追加 /v1 或 /v1/messages。Claude Code 会自行请求 /v1/messages。

如何选择其他模型

ANTHROPIC_MODEL 填平台该 Key 当前可见的模型名称即可。平台会把 Claude Messages 请求转译到对应模型，因此除了 Claude 系模型，也可以直接填国产模型（DeepSeek、GLM、Kimi、Qwen 等）。 Claude 系模型示例：

export ANTHROPIC_MODEL="claude-sonnet-4-6"

国产模型示例（任选其一，直接写平台模型名）：

export ANTHROPIC_MODEL="deepseek-v4-pro"

export ANTHROPIC_MODEL="deepseek-v4-flash"

export ANTHROPIC_MODEL="glm-5.3"

export ANTHROPIC_MODEL="kimi-k3"

export ANTHROPIC_MODEL="qwen3.8-flash"

常用的可选模型（以平台当前可见为准）：

模型	`ANTHROPIC_MODEL`	说明
Claude Sonnet 4.6	`claude-sonnet-4-6`	通用编码与 Agent 任务
Claude Haiku 4.5	`claude-haiku-4-5-20251001`	轻量高频场景
DeepSeek V4 Pro	`deepseek-v4-pro`	高能力文本与代码
DeepSeek V4 Flash	`deepseek-v4-flash`	低延迟高吞吐
GLM 5.3	`glm-5.3`	通用文本与代码
Kimi K3	`kimi-k3`	长上下文与代码
Qwen 3.8 Flash	`qwen3.8-flash`	轻量通用

如需固定子 Agent 或默认角色模型，可以复用同一模型：

export CLAUDE_CODE_SUBAGENT_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"

非 Claude 模型经平台协议转译后可以使用 Claude Messages 与工具调用，但不同模型对文件读写、Shell、MCP 和多回合 Agent 的支持程度并不一致。建议先用下文只读验证命令跑通，再逐项验证工具能力；不要因为某个模型能完成普通文本响应，就默认它也完整支持 Claude Code 的全部工具能力。

启动使用

进入持续交互模式：

claude

执行一次只读验证：

claude --print \
  --permission-mode plan \
  --model "claude-sonnet-4-6" \
  "只回复 OK，不要调用任何工具。"

收到回复后，再逐项验证文件读取、文件修改、Shell、MCP 和联网能力。

排错

启动后仍要求登录：在 Claude Code 中执行 /logout，并确认环境变量在同一终端中生效。
401/403：检查 ANTHROPIC_API_KEY，不要只设置 OPENAI_API_KEY。
请求路径异常：确认 ANTHROPIC_BASE_URL 是 https://api.aimaxa.cn。
模型不存在：回到平台确认该 Key 当前可见模型，并原样填写完整模型名称。
文本成功但工具失败：分别验证目标模型的 Messages 和工具调用能力。
安装或配置异常：运行 claude doctor。

参考：Claude Code 安装、Claude Messages。

集成总览

聊天应用

开发工具

Agent 应用

应用平台

准备工作

安装 Claude Code

写入配置

macOS / Linux

Windows PowerShell

如何选择其他模型

启动使用

排错

​准备工作

​安装 Claude Code

​写入配置

​macOS / Linux

​Windows PowerShell

​如何选择其他模型

​启动使用

​排错

准备工作

安装 Claude Code

写入配置

macOS / Linux

Windows PowerShell

如何选择其他模型

启动使用

排错