支持状态:AIMax Anthropic Messages 已完成最小文本与工具调用验证,Claude 系模型与国产模型均可通过
ANTHROPIC_MODEL 直接指定。具体模型的文件、Shell、MCP、联网和多回合 Agent 能力需要分别验证。准备工作
- 在 AIMax 平台 创建文本 API Key。
- 从该 Key 当前可见模型中选择模型;本文使用
claude-sonnet-4-6作为示例,国产模型(如deepseek-v4-pro)同样可以直接使用。 - 确认已安装 Node.js 18+(官方安装脚本与 npm 安装方式都需要)。
- 如果 Claude Code 已登录 Claude 账号,建议先执行
/logout,避免账号 Token 与 API Key 冲突。
安装 Claude Code
使用官方安装脚本:写入配置
Claude Code 读取配置有两个位置:配置文件(推荐,长期生效)和终端环境变量(临时,仅当前终端有效)。二选一即可,同时配置时以环境变量为准。方式一:写入配置文件(推荐)
编辑(不存在则创建)~/.claude/settings.json:
macOS / Linux 可直接执行:
env 中填入 Base URL、API Key 与模型:
ANTHROPIC_BASE_URL填站点根地址,结尾不要加/v1。Claude Code 会自行请求/v1/messages。ANTHROPIC_AUTH_TOKEN与ANTHROPIC_API_KEY二选一即可,都填 API Key 原文(含sk-前缀)。若 Claude Code 已登录 Claude 账号,建议先执行/logout;使用ANTHROPIC_AUTH_TOKEN时会覆盖账号登录态,不会再退回账号认证。ANTHROPIC_MODEL决定主对话模型,可先省略,让 Claude Code 使用默认档位。
方式二:终端环境变量
只在当前终端会话生效,适合临时切换:~/.zshrc 或 ~/.bashrc,然后重新打开终端。修改配置文件或环境变量后,都要新开终端才会被 Claude Code 读取。
如何选择其他模型
ANTHROPIC_MODEL 填平台该 Key 当前可见的模型名称即可。平台会把 Claude Messages 请求转译到对应模型,因此除了 Claude 系模型,也可以直接填国产模型(DeepSeek、GLM、Kimi、Qwen 等)。
在 ~/.claude/settings.json 的 env 中修改这一项:
固定各档位模型
Claude Code 用模型别名(opus / sonnet / haiku)和 Default 选项切换档位。不配置时,这些别名会解析到 Claude Code 内置的默认模型;要让它们指向 AIMax 上的模型,在env 中显式指定:
ANTHROPIC_SMALL_FAST_MODEL 已被 Claude Code 废弃,请不要再使用,Haiku 档位改用 ANTHROPIC_DEFAULT_HAIKU_MODEL。ANTHROPIC_MODEL 即可:
非 Claude 模型经平台协议转译后可以使用 Claude Messages 与工具调用,但不同模型对文件读写、Shell、MCP 和多回合 Agent 的支持程度并不一致。建议先用下文只读验证命令跑通,再逐项验证工具能力;不要因为某个模型能完成普通文本响应,就默认它也完整支持 Claude Code 的全部工具能力。
启动使用
新开一个终端(让配置文件或环境变量生效),进入任意项目目录运行:/status,确认 Anthropic base URL 与认证变量已被当前会话读取;再输入一句话(例如「用一句话介绍你自己」),能收到回复即接入成功,平台的使用日志中也会出现这次调用。
执行一次只读验证:
排错
- 启动后仍要求登录:在 Claude Code 中执行
/logout,并确认~/.claude/settings.json已保存、或环境变量在同一终端中生效。 Connection error/fetch failed:确认ANTHROPIC_BASE_URL是https://api.aimaxa.cn且结尾没有/v1;在 Claude Code 中运行/status确认当前会话实际读取到了该地址。401/403:检查ANTHROPIC_AUTH_TOKEN(或ANTHROPIC_API_KEY)是否完整复制、包含sk-前缀,且令牌未被删除。- 模型不存在:回到平台确认该 Key 当前可见模型,并原样填写完整模型名称;也需确认该 Key 所属分组包含该模型。
- 改完配置不生效:
settings.json与环境变量都需要新开终端才会被读取。 - 文本成功但工具失败:分别验证目标模型的 Messages 和工具调用能力。
- 安装或配置异常:运行
claude doctor。