OpenCode 配置教程

第 1 步：记录正在运行的版本

command -v opencode
opencode --version

本机有两个安装：Homebrew 路径为 1.2.15，用户目录另有 1.3.13。下面只绑定 /opt/homebrew/bin/opencode 1.2.15；不能把公开包最新版当成实测版。

第 2 步：创建令牌并选择 Responses 提供商

进入 apizt 控制台 → API 令牌 → 新建，选择支持目标模型及协议的分组，设置额度后复制令牌。已有令牌可继续使用；模型目录和权限不是同一回事。查看创建分组令牌的图文步骤。

v1 合并到 ~/.config/opencode/opencode.json 或测试项目 opencode.json。本次用 @ai-sdk/openai 走 Responses，避免把 Chat 与 Responses 返回格式混用。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "apizt/gpt-6-sol",
  "provider": {
    "apizt": {
      "npm": "@ai-sdk/openai",
      "name": "apizt",
      "options": {
        "baseURL": "https://api.apizt.com/v1",
        "apiKey": "{env:tokenba_API_KEY}"
      },
      "models": {
        "gpt-6-sol": {
          "name": "gpt-6-sol"
        }
      }
    }
  }
}

第 3 步：设置环境变量并核对模型

export tokenba_API_KEY="YOUR_tokenba_API_KEY"
/opt/homebrew/bin/opencode models apizt
/opt/homebrew/bin/opencode run --model apizt/gpt-6-sol "Reply exactly tokenba_OK. Do not use tools."

提供商 ID、models 内部 ID 与 apizt/gpt-6-sol 三处对应。只列出模型不能证明调用成功；用户配置、项目配置和 OPENCODE_CONFIG_CONTENT 会合并，检查覆盖来源。

第 4 步：按协议选择包与鉴权

切换包时同步更换支持该协议的模型。v2 使用 providers/package/settings，必须按独立 v2 官方文档；不要把这些字段混进本机 v1 配置。

真实调用记录与验证范围

测试日期：2026-09-28（Asia/Shanghai）；macOS 26.3。查看脱敏记录、软件版本和真实生成图片。一次文本成功仅证明本次请求，不代表其他模型、工具执行、多轮上下文或桌面版均已通过。

OpenCode 1.2.15
provider: apizt
npm: @ai-sdk/openai
model: gpt-6-sol
{"type":"text","part":{"text":"tokenba_OK"}}
{"type":"step_finish","part":{"reason":"stop"}}

本次真实运行使用测试目录，关闭工具权限；验证了文本生成与客户端响应解析。代码读写、MCP、长会话未验证。能列出模型但调用失败时的检查步骤。

接下来：核对模型 ID 与支持协议 · 计算费用 · 创建令牌。

历史界面参考