OpenCode

OpenCode に custom provider を追加し、認証情報とモデルを設定します。

導入と準備

1. Node.js と npm を用意し、下の公式 npm パッケージで OpenCode を導入して opencode --version を実行します。
2. API Keysで routerra.ai キーを作成し、モデルから利用可能な ID をコピーします。この例は Chat Completions を使います。コーディングにはツール呼び出し対応が必要です。

npm install -g opencode-ai
opencode --version

routerra を登録して接続

3. プロジェクトルートの opencode.json に下の設定を作成またはマージします。全プロジェクト共通なら ~/.config/opencode/opencode.json を使います。すべての YOUR_MODEL_ID を同じ値に置き換えます。routerra/ は OpenCode の provider 接頭辞で、上流モデル ID の一部ではありません。
4. opencode を起動し、/connect → Other で provider ID routerra とキーを入力します。ID は JSON のキーと完全一致させます。認証情報は ~/.local/share/opencode/auth.json に別保存されます。/models でモデルを選び、設定ファイル変更後は再起動します。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "routerra/YOUR_MODEL_ID",
  "provider": {
    "routerra": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "routerra.ai",
      "options": { "baseURL": "https://routerra.ai/v1" },
      "models": { "YOUR_MODEL_ID": { "name": "YOUR_MODEL_ID" } }
    }
  }
}

接続を確認

provider が見つからなければ、読み込まれたプロジェクト／グローバル設定と provider.routerra.models を確認します。異なる /connect ID に保存したキーは使えません。/responses 専用モデルは npm を @ai-sdk/openai に変更します。例の @ai-sdk/openai-compatible は /chat/completions を呼びます。短い返答と読み取り専用のファイル照会を試し、routerra.ai の使用量でモデルを確認します。