メインコンテンツへスキップ
Capriole AI の API キー 1 つで、OpenCode から GPT-6.2 Astra、Claude Fable 5.1、Opus 5.5、Gemini 4 Carbon を公式 API 価格より最大 92% 安く使えます。

OpenCode とは

OpenCode は、ターミナル インターフェイス、デスクトップ アプリ、IDE 拡張機能として使えるオープンソースの AI コーディング エージェントです。このセットアップでは、Capriole AI を 1 つのカスタム プロバイダーとして追加します。各モデルは、Capriole AI がそのモデル ファミリー向けに提供している API プロトコルを使います。

前提条件

始める前に、次を用意してください。
  • Capriole AI アカウント(こちらから登録)
  • Premium プラン(月額 USD 9、無制限のウェブチャットも含む)または Team プラン。API キーにはどちらかが必要です(購読する)
  • Capriole AI API キー(キーを取得)

インストール

OpenCode 2 と OpenCode 1 はどちらも opencode コマンドを使うため、同時にインストールできるのはどちらか 1 つです。公式のインストール スクリプトで OpenCode 2 をインストールします。
または、npm でインストールします。
OpenCode 1 から移行するには、opencode upgrade --major を実行します。https://opencode.ai/install スクリプトと opencode-ai npm パッケージは、引き続き OpenCode 1 をインストールします。 インストールを確認します。

設定

モデルの検証

OpenCode 2.2.5 は、OpenCode 2 の設定を使い、「対応モデル」のすべてのモデルで、Capriole AI 経由のファイル読み取りと最終回答の確認に合格しています。OpenCode 1.19.3 は、OpenCode 1 の設定でファイル読み取り、ファイル書き込み、最終回答の確認に合格しています。

OpenCode 2

~/.config/opencode/opencode.json を作成または更新します。
各設定の役割は次のとおりです。
  • package: "@opencode/ai/providers/openai-compatible" はプロバイダーのデフォルト パッケージです。そのため、Gemini、Grok、GLM、Kimi は Chat Completions を使います。
  • 各 GPT モデルは package を @opencode/ai/providers/openai-compatible/responses で上書きし、Responses API を使います。各 Claude モデルは @opencode/ai/providers/anthropic-compatible で上書きし、Anthropic Messages を使います。
  • env はキーを保持する環境変数を指定します。Authorization ヘッダーにより、どのパッケージでもキーが Bearer トークンとして送られます。
  • reasoningEffort は各 GPT モデルのデフォルトの推論レベルを設定します。これがないと、GPT モデルは推論せずに回答します。
  • baseURL には、どのパッケージでも /v1 を含めます。limit は各モデルのコンテキスト ウィンドウと出力上限を OpenCode に伝えます。
  • agents.title は、OpenCode がセッション タイトルに使うモデルを設定します。

OpenCode 1

OpenCode 1 は OpenCode 2 の形式を読み込みませんが、OpenCode 2 は次の形式も読み込むため、アップグレード後も OpenCode 1 の設定をそのまま使えます。~/.config/opencode/opencode.json を作成または更新します。
各設定の役割は次のとおりです。
  • npm: "@ai-sdk/openai-compatible" はプロバイダーのデフォルト パッケージです。そのため、Gemini、Grok、GLM、Kimi は Chat Completions を使います。
  • 各 GPT モデルは provider.npm を @ai-sdk/openai で上書きし、Responses API を使います。各 Claude モデルは @ai-sdk/anthropic で上書きし、Anthropic Messages を使います。
  • baseURL には、どのパッケージでも /v1 を含めます。
  • {env:CAPRIOLE_AI_API_KEY} は環境変数からキーを読み取ります。Authorization ヘッダーにより、どのパッケージでもキーが Bearer トークンとして送られます。
  • limit は各モデルのコンテキスト ウィンドウと出力上限を OpenCode に伝えます。これにより、OpenCode はコンテキストを追跡し、適切なタイミングでセッションを圧縮できます。
  • small_model は、セッション タイトルの生成などの軽いタスクに OpenCode が使うモデルです。

OpenCode を実行する

API キーを設定してから、プロジェクト ディレクトリから OpenCode を起動します。
OpenCode 2 はモデルへのリクエストをバックグラウンド サービスから送り、このサービスは起動時にキーを読み取ります。そのため、opencode service restart で設定したばかりのキーを読み込ませます。OpenCode 1 ではこの手順を省略してください。 /models でモデルを切り替えます。非対話で実行するには、opencode run を使います。

対応モデル

モデル参照は capriole-ai/<model-id> の形式です。 openai-latest、claude-latest、google-latest は、常に各ファミリーの最新の旗艦モデルを指します。現在は GPT-6.2 Astra、Claude Fable 5.1、Gemini 4 Carbon です。

トラブルシューティング

OpenCode が認証エラーを返すのはなぜですか?

OpenCode を起動する前に同じシェルで CAPRIOLE_AI_API_KEY がエクスポートされていること、および headers(OpenCode 2)または options.headers(OpenCode 1)の下に Authorization ヘッダーがあることを確認してください。OpenCode 2 が Missing Bearer token を返す場合は、バックグラウンド サービスがキーなしで起動しています。そのシェルで opencode service restart を実行してください。

Claude のリクエストが Unsupported Claude Messages model で失敗するのはなぜですか?

Anthropic パッケージを使う Claude モデルには、claude-opus-5-5 などのプレフィックスなしの Claude ID が必要です。anthropic/ プレフィックス付きの ID は Chat Completions 用です。

GPT のリクエストが失敗するのはなぜですか?

各 GPT モデルに "package": "@opencode/ai/providers/openai-compatible/responses"(OpenCode 2)または "provider": { "npm": "@ai-sdk/openai" }(OpenCode 1)があり、リクエストが Responses API を使うことを確認してください。

Capriole AI のモデルが表示されないのはなぜですか?

モデル参照が capriole-ai/moonshot/kimi-k3 のように capriole-ai/<model-id> の形式であること、および disabled_providers が capriole-ai をブロックしていないことを確認してください。OpenCode 1 は OpenCode 2 の providers 形式を無視します。

設定の変更が反映されないのはなぜですか?

プロジェクト レベルの opencode.json や OPENCODE_CONFIG による上書きがないか確認してから、OpenCode を再起動してください。

プロバイダー パッケージのエラーが出るのはなぜですか?

~/.cache/opencode をクリアして OpenCode を再起動し、プロバイダー パッケージを再インストールさせてください。

注意事項

最終更新日 2026年11月18日