OpenCode 接入

OpenCode 可以通过自定义 provider 连接吉格api。本页使用 OpenAI Compatible provider，对应 Chat Completions 兼容接口。

配置

1. 安装

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

也可以通过 npm 安装：

npm install -g opencode-ai
opencode --version

Windows 可通过 npm 安装，或按 OpenCode 官方建议在 WSL 中使用。

2. 设置密钥

macOS / Linux：

export JIGE_API_KEY="YOUR_API_KEY"

Windows PowerShell：

$env:JIGE_API_KEY = "YOUR_API_KEY"

3. 编辑配置文件

全局配置通常位于 ~/.config/opencode/opencode.json，项目根目录也可以使用 opencode.json。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "jigeapi/YOUR_MODEL_ID",
  "provider": {
    "jigeapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "吉格api",
      "options": {
        "baseURL": "https://chickener.cc.cd/v1",
        "apiKey": "{env:JIGE_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}

检查配置并发起验证：

opencode debug config
opencode models jigeapi
opencode run -m jigeapi/YOUR_MODEL_ID "Reply with exactly: OK"

要点

• 字段名区分大小写：baseURL 和 apiKey 不能改成其他写法。
• 默认模型使用 provider/model 格式，例如 jigeapi/YOUR_MODEL_ID。
• @ai-sdk/openai-compatible 使用 Chat Completions 兼容接口。
• 只有确认 Responses API 的完整工具调用兼容性后，才考虑改用 @ai-sdk/openai。
• API Key 通过 {env:JIGE_API_KEY} 引用环境变量，不要把真实密钥提交进配置文件。
• OpenCode 的登录命令名称可能随版本变化；TUI 中的 /connect 通常是较稳定的入口。

常见问题

提示 provider 或模型不存在

确认顶层 model 使用 jigeapi/YOUR_MODEL_ID，且 provider 中存在同名 jigeapi 配置。模型 ID 必须与模型广场完全一致。

配置解析失败

运行 opencode debug config 查看合并后的配置。重点检查 JSON 语法、provider 是否为单数，以及 baseURL、apiKey 的大小写。

返回 404

baseURL 应为 https://chickener.cc.cd/v1。不要追加 /chat/completions，SDK 会自动拼接端点。

文本请求正常，但工具调用失败

这通常表示所选模型或接口的工具调用能力没有完整匹配。先确认模型支持对应功能，再保留错误和 request id 排查。