OpenCode 可以在 opencode.json 中登记自定义 Provider 和模型。本页分别给出 Chat Completions 与 Responses 配置，二者不能混用适配器。
支持状态：基础配置可用。具体模型、流式响应和工具调用仍需分别验证。

​
准备工作

  1. 在 AIMax 平台 创建文本 API Key。
  2. 在平台确认该 Key 当前可见的完整模型名称。
  3. 根据目标模型和 OpenCode 使用方式选择 Chat Completions 或 Responses。

​
安装 OpenCode

macOS、Linux 或 WSL：
也可以通过 npm 安装：

​
配置 Chat Completions

在项目目录创建 opencode.json：

​
配置 Responses

目标模型支持 Responses 时使用：

​
选择模型

把示例中的 gpt-5.4 替换为平台当前对该 Key 展示、且适合所选协议的完整模型名称。需要登记多个模型时，在 models 中继续增加条目。

​
启动使用

进入会话后使用 /models 选择已经登记的模型。也可以在启动时指定：
先发送 只回复 OK，不要调用任何工具。。收到回复后，再验证文件、Shell、MCP 和其他 Agent 能力。

​
排错

  • Provider 不显示：检查 opencode.json 位置、JSON 语法和 models 登记。
  • API Key 未读取：确认同一终端已导出 AIMAX_API_KEY。
  • 请求路径错误：确认 baseURL 是 https://api.aimaxa.cn/v1，并匹配所选适配器。
  • 模型不存在：回到平台确认该 Key 当前可见模型，并同步修改默认模型和 models 条目。
  • 文本成功但工具失败：分别验证目标模型协议和工具调用能力。
参考：OpenCode Providers、文本模型总入口。