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 をインストールします。
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 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 を再起動し、プロバイダー パッケージを再インストールさせてください。
注意事項
- キーは環境変数に保持してください。
opencode.jsonに貼り付けないでください。 - Capriole AI の別のモデルを追加するには、同じファミリーのモデルのエントリーをコピーして ID を変更します。
GET https://api.caprioletech.com/v1/modelsですべてのモデル ID を一覧できます。 - Gemini 4 Carbon は Gemini 4 Argon より長く思考するため、各ターンに時間がかかり、使うトークンも多くなることがあります。速さを重視する場合は
google/gemini-4-argonを使ってください。 - 同じキーを他のコーディング エージェントでも使うには、1 つの API キーでコーディング エージェントを使うを参照してください。
- OpenCode 2 のリファレンス:インストール、OpenCode 1 からの移行、プロバイダー、モデル、バックグラウンド サービス、リリース。
- OpenCode 1 のリファレンス:インストール、設定、プロバイダー、モデル、トラブルシューティング。

