OpenCode 接入

OpenCode 支持自定义 OpenAI Compatible Provider。建议从环境变量读取 Key，配置文件只保存 Provider、Base URL 和模型 ID。

1. 安装

Windows 可使用：

powershell

npm install -g opencode-ai
opencode --version

macOS / Linux：

bash

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

其他安装方式见 OpenCode 官方文档。

2. 设置密钥

Windows PowerShell：

powershell

$env:FREEDOMZ_API_KEY = "YOUR_API_KEY"

macOS / Linux：

bash

export FREEDOMZ_API_KEY="YOUR_API_KEY"

3. 配置 `opencode.json`

将 MODEL_ID_FROM_V1_MODELS 替换为当前 Key 的真实模型 ID：

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "freedomz": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "FreedomZ AI",
      "options": {
        "baseURL": "https://freedomz.cn/v1",
        "apiKey": "{env:FREEDOMZ_API_KEY}"
      },
      "models": {
        "MODEL_ID_FROM_V1_MODELS": {
          "name": "FreedomZ AI Model"
        }
      }
    }
  },
  "model": "freedomz/MODEL_ID_FROM_V1_MODELS"
}

项目级配置可放在项目根目录；全局使用时按 OpenCode 当前版本的全局配置目录保存。不要把包含真实 Key 的配置提交到公开仓库。

4. 验证

在同一终端启动 opencode。
确认当前模型显示为 freedomz/...。
发起一次最小文本请求。
到使用记录核对。

常见错误

现象	处理
Environment variable not found	在启动 OpenCode 的同一进程环境设置 Key
Provider 加载失败	检查 `npm` 是否为 `@ai-sdk/openai-compatible`
401	检查 Key，停止连续重试
model not found	同步修改 `models` 键和顶层 `model`
客户端成功但站内无记录	检查当前 Provider 是否为 `freedomz`

OpenCode 接入 ​

1. 安装 ​

2. 设置密钥 ​

3. 配置 opencode.json ​