OpenCode のカスタムモデルと API 設定

OpenCode は @ai-sdk/openai-compatible を使って BetterToken に接続します。OpenCode のプロバイダー名は BetterToken または OpenAI Compatible にします。一般的な API Key、Base URL、opencode.json の設定にはこのページを使用してください。特定モデルの選択と確認には、GLM ガイドまたは Kimi K3 ガイドを参照してください。 モデル広場から正確な Model ID をコピーしてください。

主な設定

項目	値
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
モデル	YOUR_MODEL_ID

前提条件

• 以下のコマンドで OpenCode 1 をインストールします
• BetterToken API Key を作成する
• model plaza またはキーの Setup ダイアログから Model ID をコピーする

登録して BetterToken API Key を取得→

アカウントをお持ちの方は、ログインして残高をチャージし、コンソールでキーを作成してください。

インストール

これらのコマンドは OpenCode 1 をインストールします。OpenCode 2 についてはインストールガイドを参照してください。OpenCode 2 は同じ場所から既存の設定を読み込み、対応する V1 プロバイダー設定を変換します。設定の構文を変更する前に移行ガイドを確認してください。

curl

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

npm

npm install -g opencode-ai

コマンドラインで設定する

BetterToken の自動設定スクリプトが、OpenCode の BetterToken プロバイダーを作成または更新します。このスクリプトには Node.js が必要です。API Key または Model ID を引数で指定しなかった場合は、実行時に入力を求められます。

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-opencode-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-opencode-provider.ps1" -OutFile "$env:TEMP\install-opencode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-opencode-provider.ps1"

スクリプトの完了後に bettertoken/YOUR_MODEL_ID を選択します。OpenCode がすでに起動している場合は、テストする前に再起動してください。

手動で設定する

方法 1：/connect で認証情報を保存する

OpenCode を起動し、次のコマンドを実行します。

/connect

Other を選択し、プロバイダー ID に bettertoken、続いて YOUR_API_KEY を入力します。OpenCode は認証情報をローカルに保存します。

方法 2：JSON を設定する

グローバル設定ファイルは ~/.config/opencode/opencode.json です。プロジェクトではルートディレクトリの opencode.json を使用できます。

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

/connect を使わない場合は、"apiKey": "YOUR_API_KEY" を options の下に追加します。実際のキーを含む設定をコミットしないでください。

この例では Chat Completions に @ai-sdk/openai-compatible を使います。SDK パッケージはエンドポイントのプロトコルと一致させます。別のプロトコルを使う前に、公式のプロバイダーガイドを確認してください。GPT モデルを使った macOS のテストでは、OpenCode 1.19.4 と 2.1.4 の両方で、各 SDK によるファイル読み取りのツール呼び出しが完了しました。@ai-sdk/openai-compatible は /v1/chat/completions、@ai-sdk/openai は /v1/responses を使いました。read を許可し、edit と bash を拒否した 4 件すべてでファイル読み取りに成功しました。

接続を確認する

プロジェクトで opencode を実行し、bettertoken/YOUR_MODEL_ID を選択して短いメッセージを送信します。通常の応答が返れば設定は完了です。JSON を変更した後は OpenCode を再起動してください。

OpenCode 1 で非対話型のテキスト確認を行うには、次を実行します。

opencode run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

OpenCode 2 で非対話型の実行を行うには --standalone が必要です。

opencode run --standalone --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

モデルを切り替える

新しい YOUR_MODEL_ID を provider.bettertoken.models に追加し、最上位の model を更新します。保存して OpenCode を再起動してください。

よくあるエラー

エラー	対処方法
401	/connect をもう一度実行するか、apiKey を確認します。
404	https://bettertoken.ai/v1 だけを baseURL に使い、/chat/completions を追加しないでください。
モデルが見つからない	最上位の model を models 内の ID と完全に一致させます。
設定が反映されない	プロジェクトの opencode.json がグローバル設定を上書きしていないか確認し、OpenCode を再起動します。

詳細設定

関連するよくある質問

• [OpenAI 互換 API と Anthropic 互換 API の違い- OpenCode で Kimi K3 を接続する方法

• OpenCode で GLM を接続する方法 ](/ja/faq/concepts/openai-compatible-vs-anthropic-compatible)

• MCP と API Key・Base URL の違い

• model_provider、base_url、wire_api とは？

• Cline で OpenAI 互換 API を設定する方法

• 対応ツールを比較する

• API エラー、ステータスコード、レート制限

任意：CC Switch でプロバイダーを管理する

複数の外部ツールのプロバイダーをまとめて管理する場合は、CC Switch での OpenCode 設定を参照してください。

技術的な詳細

プロバイダーとモデルプロバイダー

OpenCode のプロバイダーは bettertoken で、@ai-sdk/openai-compatible と Chat Completions を使います。選択した完全な Model ID を models に追加してください。 モデル広場から正確な Model ID をコピーしてください。