​
集成指南总览

集成指南面向已有客户端、CLI、Agent 应用或工作流平台的使用者，说明如何填写 AIMax 的 API 地址、密钥、协议和模型名称。 API 路径、参数和响应字段请以 API 手册 为准；本页不重复维护接口字段表。

​
使用前准备

  1. 从平台获取 API Key，并避免将其写入公开仓库、截图或共享配置。
  2. 确认目标软件支持自定义 Base URL 和对应协议。
  3. 在目标软件中选择当前 API Key 可见的模型；可先调用 GET /v1/models 检查可用模型。
  4. 完成目标软件自己的最小任务后，再用于实际业务。

​
支持状态

​
已验证集成

当前已完成以下真实最小任务验证：
  1. Claude Code 已通过 Anthropic Messages 协议完成只读最小文本验证。
  2. Codex CLI 已通过 OpenAI Responses 协议完成只读最小文本验证。
  3. Gemini CLI 已通过 Gemini 原生格式完成只读最小文本验证。

​
可配置，待验证

​
聊天与知识库

​
开发工具与编码 Agent

​
Agent 应用与工作流平台

​
协议选择

​
开发工具多模型接入

开发工具通常把“协议 Provider”和“模型 ID”分开配置：
  1. 先调用 GET /v1/models，选择当前 API Key 可见的模型；
  2. OpenAI Chat/Responses 客户端使用 https://your-domain/v1；
  3. Anthropic Messages 客户端使用 https://your-domain，由客户端请求 /v1/messages；
  4. Gemini 原生客户端使用 https://your-domain，由客户端请求 /v1beta/models/...；
  5. Claude Code 和 OpenCode 可以更换模型 ID，但目标模型必须在所选协议入口上实际可用；
  6. 纯文本成功后，再单独验证工具调用、MCP、联网、文件操作和多回合 Agent 能力。

​
发布规则

  1. 不因第三方页面、截图或“理论兼容”将产品标为已支持。
  2. 编码 Agent 和 Agent 应用必须额外完成工具调用或其所需最小 Agent 回合验证，纯文本回复成功不足以代表完整支持。
  3. 每篇独立教程必须写明当前状态、所用协议、已验证边界和未验证边界，不把某个版本写成唯一支持范围。
  4. 文档不展示渠道、供应商、价格、成本、内部模型映射或测试环境信息。