ドキュメント

ドキュメント

Roo Code

Roo CodeのOpenAI Compatibleプロバイダーは、3つのフィールドとモデル機能の設定ブロックで構成されます。この機能設定ブロックは任意の装飾ではありません。Roo Codeがコンテキストをどのように割り当てるかを決める設定です。

OpenAI Compatibleプロバイダーを選び、ベースURLとキーを貼り付け、モデルのコンテキストウィンドウと最大出力を設定すると、Roo Code自身の予算計算が正しくなります。

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      on
Roo Codeはフォールバックなしでネイティブのツール呼び出しを使うため、選択するモデルはOpenAI互換のツール呼び出しに必ず対応している必要があります。以下の表に記載されたidはすべて対応しています。ここでテキスト専用モデルやメディアモデルを設定すると、設定時ではなく、エージェントが最初にツールを使おうとした時点で失敗します。
デフォルトのままにせず、Context WindowとMax Output Tokensを入力してください。Roo Codeはこの数値に基づいて会話をいつ要約するか判断するため、コンテキストウィンドウを低く設定しすぎると不要な履歴の切り捨てが発生し、高く設定しすぎると適切に要約されず、上流から400エラーが返されます。
まだキーをお持ちですか?Kunavoアカウントを作成し、キーを作成します(sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Roo Code設定が表示されます。

手順

  1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
  2. Roo Codeの設定パネルを開き、API ProviderをOpenAI Compatibleに設定します。
  3. Base URLにhttps://api.kunavo.com/v1、キーにご利用のキーを入力します。/v1のサフィックスはベースURLに含めてください。Roo Codeが追加するのはルートだけです。
  4. モデルidを選択または入力し、Model Configurationを開いて、コンテキストウィンドウ、最大出力トークン数、画像対応、以下の表に記載された入力・出力料金を設定します。
  5. Codeモードでメッセージを送信します。ここで入力した料金は、Roo Code独自のタスクごとのコスト表示に使われるため、正確な値を設定してください。

Roo CodeのOpenAI Compatibleプロバイダーのページで2026年9月6日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

これが短い概要です。完全な手順 — モデルの選択、実際のセッション費用、失敗するケース — はRoo Code + Claudeの手順にあります。

クライアントをデバッグする前に確認すること

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で、入力 / 出力の順です。

モデル IDKunavo 入力 / 出力Roo Codeでの位置付け
claude-sonnet-5$1.40 / $7.00Codeモード — デフォルトのモードで、コスト表示の基準にもなっています
claude-opus-5$3.50 / $17.50Architectモード。誤った計画はトークン消費以上の損失につながります
claude-haiku-4-5$0.70 / $3.50Askモードとファイルの繰り返し読み取り
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つのフィールドだけを使って計算されます。エンドポイントから料金を取得することはないため、表示額の正確さは入力値次第です。プロバイダーの公式カタログに掲載されている料金を転記してください。