opencode 配置第三方 API：opencode.jsonc 与 /connect 完整教程

准备：一把 OpenAI 分组的 Key 和装好的 opencode

开始前准备两样东西：一把 GPT.COM.SE「OpenAI」分组的 API Key，以及装好的 opencode。API Key 是一串以 sk- 开头的密钥，相当于账号的调用密码；分组决定这把 Key 能调哪类模型。

1. 打开 注册页，用邮箱注册，收验证码完成登录。用纯数字 QQ 邮箱（如 123456789@qq.com）注册的新用户送 5 美元体验额度，英文别名的 QQ 邮箱不送，活动仅限中国用户。
2. 体验额度用完后到「充值」页面充值，支持微信、支付宝。按量计费，用多少扣多少。
3. 进「API 密钥」页面点新建，分组选「OpenAI」。复制出来的 sk-xxxxxxxx 就是你的 Key。

安装 opencode

opencode 是命令行工具，依赖 Node.js，建议先装 Node.js 22 及以上版本。macOS、Linux、WSL2 用下面的命令安装；Windows 去 Node.js 下载页下 LTS 22.x 一路下一步，装完开 PowerShell 输 node -v 验证。

curl -fsSL https://fnm.vercel.app/install | bash
fnm install 22
fnm use 22
node -v   # 看到 v22.x.x 就对了

Node.js 装好后，用 npm 安装 opencode。npm 是 Node.js 自带的安装工具。

npm i -g opencode-ai
opencode --version   # 能打印出版本号就装好了

opencode 配置文件在哪

全局配置文件在 ~/.config/opencode/opencode.jsonc，没有这个文件就自己新建。~ 代表你的用户主目录；jsonc 是允许写注释的 JSON 格式，opencode 能直接读。

目录不存在时，先用下面的命令建好目录和空文件，再用任意编辑器打开。

mkdir -p ~/.config/opencode
touch ~/.config/opencode/opencode.jsonc

第一步：设置 Key 并写入 provider 配置

先在终端设置 Key，再把下面这段配置写进 ~/.config/opencode/opencode.jsonc，配置和本站使用教程一致。provider 指模型服务商，opencode 靠它区分不同的接口地址和 Key；本教程把 GPT.COM.SE 这个 provider 命名为 gptse。

1. 在终端设置 Key

export GPTSE_API_KEY="sk-你的Key"

环境变量是系统里的一个命名值，程序运行时可以读取。上面这行只对当前终端窗口有效，想每次打开终端都自动生效，就把这一行加到 ~/.zshrc（macOS 默认）或 ~/.bashrc（多数 Linux）末尾，然后重开终端。

2. 写入 opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "gptse": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "GPT.COM.SE",
      "options": {
        "baseURL": "https://gpt.com.se/v1",
        "apiKey": "{env:GPTSE_API_KEY}"
      },
      "models": {
        "gpt-6-astra": { "name": "GPT-6 Astra" },
        "gpt-5.6-sol": { "name": "GPT-5.6 Sol" },
        "gpt-5.5": { "name": "GPT-5.5" },
        "gpt-6-sol": { "name": "GPT-6 Sol" }
      }
    }
  }
}

Base URL 就是接口地址，opencode 把请求发到这里。opencode、Cursor、Cherry Studio 和 OpenAI SDK 都填带 /v1 的 https://gpt.com.se/v1；Codex 和 WorkBuddy 才填不带 /v1 的根地址。推荐按上面填 /v1；如果工具自动去掉了 /v1，本站也已兼容。

第二步：在 opencode 里用 /connect 连接

进入 opencode 后输入 /connect，选择 Other，provider id 填 gptse，就完成了连接。/connect 是 opencode 里添加服务商的命令，Other 表示自定义服务商。

1. 打开一个设置好 GPTSE_API_KEY 的终端，进入你的项目目录，运行 opencode。
2. 在输入框里输入 /connect 回车。
3. 在服务商列表里选 Other。
4. provider id 填 gptse，和配置文件里 provider 下面的名字一致。
5. 如果接着提示输入 API Key，粘贴同一把「OpenAI」分组的 Key。
6. 输入 /models，在 GPT.COM.SE 下面选一个模型，例如 GPT-5.6 Sol。
7. 发一句「你好」，能收到回复就接好了。

想确认环境变量有没有生效，在同一个终端里运行 echo $GPTSE_API_KEY，能看到 sk- 开头的 Key 就说明设置成功。

opencode 配置模型：可填的模型名与价格

opencode 里能选哪些模型，取决于配置里 models 写了哪些模型名，本站在售的对话模型有下表 7 个。模型名要原样填写，大小写和点号都不能错。

token 是模型处理文字的计费单位，输入和输出都按 token 数计费。上下文指模型一次能读进去的内容总量。缓存读指和之前请求重复的那部分输入命中了缓存，按更低的单价计费。

把 models 换成全部在售模型

把配置里的 models 这一段换成下面这样，opencode 的 /models 列表里就能选到本站全部在售对话模型。想少放几个，删掉对应的行即可，最后一行末尾不要留逗号。

"models": {
  "gpt-6-astra": { "name": "GPT-6 Astra" },
  "gpt-6-sol": { "name": "GPT-6 Sol" },
  "gpt-5.6-sol": { "name": "GPT-5.6 Sol" },
  "gpt-5.6-terra": { "name": "GPT-5.6 Terra" },
  "gpt-5.6-luna": { "name": "GPT-5.6 Luna" },
  "gpt-5.5": { "name": "GPT-5.5" }
}

本站暂未提供 gpt-6-luna 和 gpt-6.1-sol，写进 models 也调不通。生图模型要用「GPT 生图」分组的 Key，用法见 GPT 生图 API。

算一笔账：一次 opencode 改代码会话花多少钱

opencode 每一轮对话都会把前面的上下文一起发给模型，所以输入 token 往往远多于输出，缓存读的单价对总花费影响很大。下面按一次会话累计「未缓存输入 20 万 token、缓存读 80 万 token、输出 4 万 token」计算，实际命中多少缓存以控制台明细为准。

同样的用量，如果 100 万 token 输入全部没命中缓存，gpt-5.6-sol 这一次要 ¥4.8，是上表的 2.5 倍。选型上，写代码、跑 Agent 优先 gpt-6-astra；想用 GPT-5.6 旗舰档就选 gpt-5.6-sol；跑量大又简单的活用 gpt-5.6-luna 更省。各型号的详细对比见 GPT-5.6 Sol、Terra、Luna 和 全部 GPT 模型与选型。

opencode 接入第三方 API 常见报错排查表

报错先看状态码：401 查 Key，403 查余额，404 查地址，模型不存在查模型名。

怎么确认 opencode 调用的就是你选的模型

看控制台的用量明细：每次调用都记录模型名、token 数和费用，和你在 /models 里选的模型对一下就清楚。

本站不做模型替换，用户请求哪个模型就调用哪个模型，缺货时直接报错，不会偷偷换成别的模型。扣费按 OpenAI 官方美元标价，明细里的费用可以用上面的价格表自己核算。更多自检方法见 不替换模型与自检方法。