OpenCode 配置使用教程

安装

OpenCode 按照官方文档安装即可，官网有比较详细的安装教程。

如果已经安装过 OpenCode，可以直接跳到“配置模型”部分。

配置模型

安装完成后，编辑 OpenCode 配置文件：

text

~/.config/opencode/opencode.json

在配置文件中添加模型提供商。

下面是推荐配置模板，请把 你的 API Key 替换成你在后台创建的 API 密钥：

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "Rsta": {
      "npm": "@ai-sdk/openai",
      "name": "Rsta",
      "options": {
        "baseURL": "https://rsta.uk"
      },
      "models": {
        "gpt-5.5": {
          "name": "GPT-5.5",
          "thinking": true,
          "modalities": {
            "input": [
              "text",
              "image",
              "pdf"
            ],
            "output": [
              "text"
            ]
          },
          "limit": {
            "context": 1000000,
            "output": 128000
          },
          "options": {
            "store": false,
            "reasoningEffort": "xhigh",
            "textVerbosity": "high",
            "reasoningSummary": "auto",
            "include": [
              "reasoning.encrypted_content"
            ]
          }
        },
        "gpt-5.4": {
          "name": "GPT-5.4",
          "thinking": true,
          "options": {
            "store": false,
            "reasoningEffort": "xhigh"
          }
        },
        "gpt-5.4-mini": {
          "name": "GPT-5.4 Mini",
          "options": {
            "store": false
          }
        }
      }
    }
  }
}

如果 OpenCode 需要单独填写 API Key，请填写你在后台 API Keys 页面创建的 sk- 开头密钥。

API Key 配置方式

不同版本 OpenCode 的 API Key 配置方式可能不同，一般有两种：

方式一：界面中填写

如果 OpenCode 设置页面支持填写 API Key，直接填写：

text

API Key: 你的 sk- 开头密钥
Base URL: https://rsta.uk
Model: gpt-5.5

方式二：环境变量

如果 OpenCode 读取环境变量，可以设置：

Windows PowerShell：

powershell

$env:OPENAI_API_KEY="你的 sk- 开头密钥"

Mac / Linux：

bash

export OPENAI_API_KEY="你的 sk- 开头密钥"

方式三：手动编辑 auth.json

如果 OpenCode 使用 auth.json 管理供应商密钥，可以编辑：

text

~/.local/share/opencode/auth.json

注意：auth.json 里的供应商名称必须和 opencode.json 里的供应商名称完全一致。本教程统一使用：

text

Rsta

示例：

json

{
  "Rsta": {
    "type": "api",
    "key": "你的 sk- 开头 API 密钥"
  }
}

如果要退出这个供应商的登录状态，也要使用同一个名字：

bash

opencode auth logout Rsta

使用模型

配置完成后，重启 OpenCode。

推荐优先选择：

text

Rsta/gpt-5.5

如果 gpt-5.5 不可用，可以换成后台支持的其他模型，例如：

text

gpt-5.4
gpt-5.4-mini
gpt-5.3-codex
gpt-5.2

常见报错

401 Unauthorized

通常是 API Key 错误、没有填写 API Key、Key 复制不完整或账号余额不足。

处理方式：

重新复制后台 API Key。
检查 API Key 前后是否有空格。
检查后台余额。
重启 OpenCode。

model not found

说明模型名写错，或者当前账号分组不支持该模型。

处理方式：

到后台查看可用模型。
完整复制模型名称。
换成可用模型，例如 gpt-5.5。

baseURL 配置错误

请确认配置里填写的是：

json

"baseURL": "https://rsta.uk"

不要填写别人的中转站地址。

最后检查

发布或使用前，请确认：

baseURL 是 https://rsta.uk
API Key 已正确填写
模型名是后台支持的模型
修改配置后已经重启 OpenCode