OpenCode 接入

开源终端 Agent，支持多模型切换，OpenAI 兼容协议接入 ByteSeek。

下载安装

安装脚本

npm

Homebrew

macOS / Linux

curl -fsSL https://opencode.ai/install | bash

官网见 opencode.ai。

前置条件

已安装 OpenCode（opencode --version 可输出版本）
已在API 密钥页面创建 OpenAI 格式分组的 Key

配置（控制台一键获取）

不用手写配置——控制台会按你的密钥生成一份带完整模型清单的 opencode.json：

打开API 密钥页面，在密钥行的操作列点「更多」→「使用密钥」；
弹窗切到 OpenCode 标签，复制生成的 opencode.json 全文；
写入 ~/.config/opencode/opencode.json（也可用 opencode.jsonc），文件不存在先手动创建。

使用密钥弹窗 OpenCode 标签 — 「使用密钥」弹窗的 OpenCode 标签：一份带完整模型清单与推理强度档位的 opencode.json，整段复制即可（密钥已脱敏）

生成的配置走默认 openai provider 指向 ByteSeek，每个模型都带好上下文上限与推理强度档位，结构节选如下（完整内容以弹窗为准，直接整段复制）：

{
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://tokens.byteseek.ai/v1",
        "apiKey": "sk-你的密钥"
      },
      "npm": "@ai-sdk/openai",
      "models": {
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol",
          "limit": { "context": 1050000, "output": 128000 },
          "options": { "store": false },
          "variants": { "low": {}, "medium": {}, "high": {}, "xhigh": {}, "max": {} },
          "tool_call": true
        }
      }
    }
  },
  "agent": {
    "build": { "options": { "store": false } },
    "plan": { "options": { "store": false } }
  },
  "$schema": "https://opencode.ai/config.json"
}

补充说明（弹窗内同样标注）：

API Key 可以不写进文件，改用客户端的 /connect 命令配置；
也可以不用默认 openai provider，自定义 provider_id（如 byteseek），模型与选项按需增删；
模型 ID 以模型广场为准；用复合 Key时写带前缀的 ID。

验证时你应看到

启动 opencode 后按 Ctrl+X 换模型，列表中出现配置里的 provider（默认 openai，或你自定义的 ID）及模型清单；
界面右下角显示当前模型名称；
发送一句话能正常收到回复，无认证报错。

验证

启动 OpenCode，用模型选择器切到 ByteSeek 下的模型，发送一条消息确认回复正常。扣费明细在使用记录页面可查。

常见问题

症状	处理
401	检查 `apiKey` 字段是否完整
模型不在列表	`models` 里没登记，或模型不属于 Key 的分组
403	分组与模型/格式不匹配，见错误码清单

#OpenCode 接入

#下载安装

#前置条件

#配置（控制台一键获取）

#验证

#常见问题

OpenCode 接入

下载安装

前置条件

配置（控制台一键获取）

验证

常见问题