ドキュメント
Roo Code
Roo CodeのOpenAI Compatibleプロバイダーは、3つのフィールドとモデル機能の設定ブロックで構成されます。この機能設定ブロックは任意の装飾ではありません。Roo Codeがコンテキストをどのように割り当てるかを決める設定です。
OpenAI Compatibleプロバイダーを選び、ベースURLとキーを貼り付け、モデルのコンテキストウィンドウと最大出力を設定すると、Roo Code自身の予算計算が正しくなります。
API Provider OpenAI Compatible
Base URL https://api.kunavo.com/v1
API Key sk-kn-...
Model claude-sonnet-5
Model Configuration
Context Window 200000
Max Output Tokens 64000
Image Support onsk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Roo Code設定が表示されます。手順
/app/keysでキーを作成してコピーします。キーは一度だけ表示されます。- Roo Codeの設定パネルを開き、API Providerを
OpenAI Compatibleに設定します。 - Base URLに
https://api.kunavo.com/v1、キーにご利用のキーを入力します。/v1のサフィックスはベースURLに含めてください。Roo Codeが追加するのはルートだけです。 - モデルidを選択または入力し、Model Configurationを開いて、コンテキストウィンドウ、最大出力トークン数、画像対応、以下の表に記載された入力・出力料金を設定します。
- Codeモードでメッセージを送信します。ここで入力した料金は、Roo Code独自のタスクごとのコスト表示に使われるため、正確な値を設定してください。
Roo CodeのOpenAI Compatibleプロバイダーのページで2026年9月6日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。
クライアントをデバッグする前に確認すること
1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーがRoo Codeで機能します。
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."フィールドに入力するモデルID
すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。
| モデル ID | Kunavo 入力 / 出力 | Roo Codeでの位置付け |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | Codeモード — デフォルトのモードで、コスト表示の基準にもなっています |
claude-opus-5 | $3.50 / $17.50 | Architectモード。誤った計画はトークン消費以上の損失につながります |
claude-haiku-4-5 | $0.70 / $3.50 | Askモードとファイルの繰り返し読み取り |
gpt-5-6-terra | $0.70 / $4.20 | 大規模リポジトリを長いコンテキストで解析 |
よくある質問
Roo CodeをカスタムのOpenAI互換エンドポイントに接続するにはどうすればよいですか?
Roo Codeの設定パネルで、API Providerを"OpenAI Compatible"に設定します。次に、そのエンドポイントのBase URLとAPI Keyを入力し、モデルを選択します。Roo Codeが付加するのはルートだけなので、ベースURLにはサービスの/v1ルートを指定します。Roo Codeの公式ドキュメントでは、リクエストの送信先を決めるフィールドであるBase URLを重要な設定項目としています。
カスタムエンドポイント経由でRoo Codeに対応するモデルはどれですか?
エンドポイントが提供し、OpenAI互換のネイティブなツール呼び出しに対応するモデルなら使用できます。Roo Codeはネイティブのツール呼び出しのみを使い、フォールバックモードはありません。そのため、ツールに対応していないモデルは接続後、エージェントがファイルの読み取りや書き込みを試みた時点で失敗します。ClaudeとGPTのテキストモデルはすべて該当しますが、画像、動画、音声モデルは該当しません。
Roo CodeのContext WindowとMax Output Tokensには何を設定すればよいですか?
デフォルト値ではなく、選択したモデルの実際の上限値を設定してください。Roo Codeはこの2つの数値に基づいて会話をいつ要約するか判断します。そのため、モデルの実際のコンテキスト上限より低い値を設定すると、履歴が不必要に破棄され、上限より高い値を設定すると、適切に要約されず上流から400エラーが返されます。モデルごとの数値は、エンドポイントのモデルカタログで確認できます。
Roo Codeがタスクのコストを誤って表示するのはなぜですか?
Model ConfigurationのInput PriceとOutput Priceは手動入力で、デフォルト値は0または別のプロバイダーの料金です。Roo Codeのタスクごとのコスト表示はこの2つのフィールドだけを使って計算されます。エンドポイントから料金を取得することはないため、表示額の正確さは入力値次第です。プロバイダーの公式カタログに掲載されている料金を転記してください。