OpenCode ​

说明

订阅套餐（Token Plan / Coding Plan）专属 API Key 仅限在 AI 编程工具中使用，不可用于 API 调试、工作流平台等非交互式场景。Key 与 Base URL 请参见 快速开始 → 接入方式一览。

订阅套餐 ​

OpenCode 通过自定义 provider（@ai-sdk/openai-compatible）接入兼容 OpenAI chat/completions 协议的服务。下方示例以 Token Plan 专属 Key（sk-tp- 开头）为例，Coding Plan 专属 Key（sk-sp- 开头）配置方式相同。

方式一：直接编辑配置文件（推荐） ​

OpenCode 全局配置文件通常位于：

text
~/.config/opencode/opencode.json

也可以在项目根目录中创建 opencode.json 作为项目级配置。

参考配置如下：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "scnet": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "SCNet",
      "options": {
        "baseURL": "https://api.scnet.cn/api/llm/v1",
        "apiKey": "sk-tp-你的专属Key"
      },
      "models": {
        "MiniMax-M2.5": {
          "name": "MiniMax-M2.5"
        }
      }
    }
  },
  "model": "scnet/MiniMax-M2.5"
}
  • model 必须使用 provider_id/model_id 格式，此处 provider_id 即配置中的 scnet。
  • 平台模型需在 models 字段中显式声明后才可选用。

方式二：配置 provider 后通过 /connect 录入密钥 ​

若不希望将 Key 明文写入配置文件，可先在配置文件中定义 provider，再在 OpenCode 中录入凭据：

  1. 按方式一创建配置文件，但省略 options 中的 apiKey 字段。
  2. 安装 OpenCode 后，在终端进入项目目录，执行：
bash
opencode
  1. 在 OpenCode 中输入：
text
/connect
  1. 选择 Other Custom provider，输入 provider ID（须与配置文件中的 scnet 保持一致），并粘贴专属 Key。

桌面端说明

/connect 为终端 TUI 命令，OpenCode 桌面端不提供该命令。桌面端请在图形界面的添加 provider（Custom provider）表单中填写 provider ID、Base URL 与专属 Key；也可在终端执行 /connect 或 opencode auth login 完成录入。凭据统一存储于 ~/.local/share/opencode/auth.json，配置文件亦为两端共享，任一端配置后另一端同样生效。

环境变量方式 ​

也可先通过环境变量注入密钥，并在配置文件中以 {env:...} 引用（自定义 provider 不会自动读取 OPENAI_API_KEY）：

json
"options": {
  "baseURL": "https://api.scnet.cn/api/llm/v1",
  "apiKey": "{env:SCNET_API_KEY}"
}

Linux/macOS

bash
export SCNET_API_KEY="sk-tp-你的专属Key"
opencode

Windows

powershell
setx SCNET_API_KEY "sk-tp-你的专属Key"

设置后需重新打开终端窗口生效。

使用建议 ​

  • 建议优先使用全局配置，便于多个项目复用。
  • 若团队内多个项目需使用不同模型，可在项目级配置中覆盖 model。