OpenCode

前置条件

需要 Node.js（安装时自带 npm）。

1. 安装

Windows、macOS 和 Linux 均可安装 OpenCode CLI：

npm install --global opencode-ai

需要独立图形客户端时，从 OpenCode 官方下载页安装 Windows、macOS 或 Linux 桌面版。CLI 也可以使用 opencode web 启动本地 Web 界面。

2. 在桌面版中配置

打开 OpenCode Desktop，依次进入设置 → 提供商 → 添加提供商 → 自定义提供商，然后填写：

提供商 ID：getrun
显示名称：GetRun
基础 URL：https://api.get-apikey.com/v1
API 密钥：填写你的实际 Key
模型：左侧填写实际模型 ID，右侧填写显示名称；两项可以相同

向下滚动并保存。需要使用多个模型时，可继续添加模型行。

Windows

macOS

3. 使用配置文件

OpenCode CLI、Desktop 和 Web 也可以共用 opencode.json：

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "getrun": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "GetRun",
      "options": {
        "baseURL": "https://api.get-apikey.com/v1",
        "apiKey": "sk-xxxxx-xxx"
      },
      "models": {
        "YOUR_MODEL": {
          "name": "YOUR_MODEL"
        }
      }
    }
  },
  "model": "getrun/YOUR_MODEL"
}

将 sk-xxxxx-xxx 和两处 YOUR_MODEL 替换为实际值。已有配置时合并 provider.getrun 和 model。

Windows

$openCodeDir = Join-Path $HOME ".config\opencode"
New-Item -ItemType Directory -Force -Path $openCodeDir | Out-Null
notepad (Join-Path $openCodeDir "opencode.json")

macOS / Linux

OPENCODE_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/opencode"
mkdir -p "$OPENCODE_DIR"
${EDITOR:-vi} "$OPENCODE_DIR/opencode.json"

4. 使用并确认回复

CLI 中运行：

opencode run --model getrun/YOUR_MODEL "只回复 OK"

需要 Web 界面时运行：

opencode web

桌面版或 Web 界面中新建会话，选择 YOUR_MODEL，发送“只回复 OK”。收到 OK 即表示配置成功。

OpenCode

本页内容