Claude Code 通过 Anthropic Messages 协议连接 AIMax,适合在终端中进行代码阅读、修改和任务执行。
支持状态:AIMax Anthropic Messages 已完成最小文本与工具调用验证,Claude 系模型与国产模型均可通过 ANTHROPIC_MODEL 直接指定。具体模型的文件、Shell、MCP、联网和多回合 Agent 能力需要分别验证。

准备工作

  1. 在 AIMax 平台 创建文本 API Key。
  2. 从该 Key 当前可见模型中选择模型;本文使用 claude-sonnet-4-6 作为示例,国产模型(如 deepseek-v4-pro)同样可以直接使用。
  3. 确认已安装 Node.js 18+(官方安装脚本与 npm 安装方式都需要)。
  4. 如果 Claude Code 已登录 Claude 账号,建议先执行 /logout,避免账号 Token 与 API Key 冲突。
协议字段见 Claude Messages。本页只说明 Claude Code 产品配置。

安装 Claude Code

使用官方安装脚本:
也可以通过 Homebrew 或 npm 安装:

写入配置

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 使用默认档位。

方式二:终端环境变量

只在当前终端会话生效,适合临时切换:
Windows PowerShell:
需要长期生效时,把这几行写入 ~/.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 的全部工具能力。

启动使用

新开一个终端(让配置文件或环境变量生效),进入任意项目目录运行:
先在 Claude Code 中运行 /status,确认 Anthropic base URL 与认证变量已被当前会话读取;再输入一句话(例如「用一句话介绍你自己」),能收到回复即接入成功,平台的使用日志中也会出现这次调用。 执行一次只读验证:
收到回复后,再逐项验证文件读取、文件修改、Shell、MCP 和联网能力。

排错

  • 启动后仍要求登录:在 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。
参考:Claude Code 安装、Claude Messages。