OpenCode 配置

OpenCode 适合偏好终端交互、希望使用开源编程 Agent 的用户。这里使用 OpenAI Responses 接口，配置保存在项目的 opencode.json 中。

接入协议OpenAI Responses

配置步骤

1
复制下方配置，在你的项目文件夹中创建或更新 opencode.json。
2
启动 OpenCode，在命令框运行 /connect 连接 custom。
3
在provider搜索框中输入 custom，回车后粘贴 API Key。
4
测试配置

复制配置

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "custom/gpt-5.6-sol",
  "provider": {
    "custom": {
      "npm": "@ai-sdk/openai",
      "name": "custom",
      "options": {
        "baseURL": ""
      },
      "models": {
        "gpt-5.6-sol": {
          "name": "gpt-5.6-sol"
        }
      }
    }
  }
}

看图操作

OpenCode 配置流程图

OpenCode 的密钥通过 /connect 保存，地址和模型写入 opencode.json；配置完成后从底部状态栏确认模型。

截图中的供应商名称是示例，仅用于定位操作入口。实际供应商名称或 ID 统一填写 custom；地址、密钥和模型请使用本页复制区的值。

界面可能随版本变化

第 1 步
创建或更新 opencode.json
在项目文件夹中创建或更新 opencode.json，复制上方配置并保存。
自行采集OpenCode 当前稳定版配置核验于 2026-08-27
2
第 2 步
启动 OpenCode 并运行 /connect
1. 1
  在底部输入区键入 /connect，然后按回车。
在终端中切换目录到项目文件夹，输入opencode启动，然后在底部输入区键入 /connect 并回车。
自行采集OpenCode 当前稳定版核验于 2026-08-27
3
第 3 步
搜索并选择 Provider
1. 1
  在搜索组合框中输入 custom。
2. 2
  在搜索结果中选择 custom，然后按回车。
在上方的搜索组合框中输入 custom；搜索结果出现后，选择 custom 并按回车。
自行采集OpenCode 当前稳定版核验于 2026-08-27
4
第 4 步
设置 API Key
1. 1
  在 API key 输入框粘贴自己的完整密钥，然后按回车保存。
在提示中粘贴从 custom 后台获取的完整 API Key 并按回车。
自行采集OpenCode 当前稳定版核验于 2026-08-27
5
第 5 步
配置完成
1. 1
  模型返回正常回复，表示 API 地址和密钥均可用。
2. 2
  底部状态栏显示页面复制区对应的模型名称。
配置完成后，跟模型打个招呼吧，有类似回应表示配置成功。只需要一次配置，后续在同一项目中启动 OpenCode 就会自动使用 custom。
自行采集OpenCode 当前稳定版核验于 2026-08-27