Claude APIを使ったRoo Code — プロバイダー設定とモードごとのモデル

Roo CodeはVS Code向けのオープンソース自律型コーディングエージェントです。Clineファミリーのフォークであり、モードシステムとモードごとのモデルルーティングを特徴としています。独自のモデルは搭載していないため、APIキーが必要です。このガイドでは、1つのsk-kn-キーでRoo Code上のClaudeを、主要モデルでAnthropicの定価より約30%低い価格で実行するための正確な設定方法、構成プロファイルを使って高性能モデルの費用を必要な箇所だけに使う方法、セッションの費用、Anthropicを直接呼び出す場合とのトレードオフを率直に説明します。

Roo Code に API キーが必要な理由

Roo Code が行うすべてのステップ — ファイルの読み取り、差分の書き込み、コマンドの実行、結果の読み取り — は、トークン単位で課金されるモデル呼び出しです。claude.ai の Pro または Max サブスクリプションではカバーされません。チャットプランと API アクセスは別の製品であり、Roo Code は API と通信します。エージェントループでは、増え続けるタスクコンテキストが各ステップで再送されるため、トークン単価がセッションコストを左右する最大の要因です。これがゲートウェイを利用する理由です。$10 のチャージから従量課金で始められ、1つのキーで GPT にもアクセスでき、残高は失効しません。

セットアップ — 3つのフィールド

Settings → Providers を開き、API プロバイダーを OpenAI Compatible に設定します。値は3つです。

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...              # create at kunavo.com/app/keys
Model ID       claude-sonnet-5        # or claude-opus-5 / claude-haiku-4-5

ダッシュボードでサインアップしてチャージした後にキーを作成します — キーは一度しか表示されないため、すぐに保存してください。Claude API キーのドキュメントでは、ローテーションと支出上限を説明しています。Roo Code がコンテキストウィンドウや出力上限などのモデルメタデータを求める場合は、モデルページの値を使用してください — コンテキストウィンドウを控えめに設定すると、必要以上に早く切り捨てられます。

コードを編集させる前に、小さな内容でテストしてください。ここでの 401 はほぼ常にキーが原因で、404 はほぼ常にベース URL または存在しないモデルスラッグが原因です — Kunavo はスラッグを完全一致させ、日付サフィックス付きの名前を別名として扱わないため、claude-sonnet-4-5-20250929 は 404 を返し、claude-sonnet-4-6 は解決されます。

モードと構成プロファイル — コストを左右する要因

Roo Code には、Code、Architect、Ask、Debug などの組み込みモードに加え、自分で定義できるカスタムモードがあります。コストに関して重要なのは、Roo Code が名前付き API 構成プロファイルを保存し、各モードで最後に使用したプロファイルを記憶することです。つまり、モデルは変更を覚えておく対象ではなく、モードのプロパティになります。

# One API configuration profile per job, all on the same sk-kn- key.
# Roo Code remembers the profile you last used in each mode.

Profile "strong"         model claude-opus-5        -> bind to Architect and Debug
Profile "code-default"   model claude-sonnet-5      -> bind to Code mode
Profile "ask-cheap"      model claude-haiku-4-5     -> bind to Ask mode

これが機能する理由は、モードごとにトークンの使い方が大きく異なるためです。Architect は、次の20ステップが有意義になるかどうかをモデル品質が左右する、推論負荷の高い少数のターンです — 総トークンの割合は小さいため、高性能モデルでも絶対額では安く済みます。Code は機械的なステップが多く、各ステップでコンテキストが再送されるため、トークン単価が積み重なります。Ask は通常1回限りで、最先端モデルを必要としません。

計算例は以下のとおりです。Opus 5 で Architect を3ステップ、Sonnet 5 で Code を17ステップ実行すると約 $1.06 で、すべて Sonnet で実行した場合の $0.87 に対して、計画品質が大幅に向上する一方、追加コストはおよそ 23% です。すべてを Opus で実行するよりはるかに安価です。

ネイティブ Anthropic ルート（および利用する理由）

Roo Code には、カスタムベース URL フィールドを備えたネイティブ Anthropic プロバイダーもあります。https://api.kunavo.com を指定すると — オリジンのみを指定し、/v1 は付けません。クライアント自身が /v1/messages を追加するためです — ネイティブ Messages API 経由でルーティングされます。ここに /v1 形式を貼り付けると、存在しないモデルのように見える 404 が発生します。

このルートの利点はプロンプトキャッシュです。cache_control は変換されずに通過し、キャッシュされた入力は入力単価の10%で課金されます（仕組み）。各ステップで安定したプレフィックスを再送するループでは、これが利用可能な単一の最大節約です — モデルを変更するより大きな効果があります。どちらのルートも機能します。開始時は OpenAI Compatible のほうが簡単で、切り替えも設定変更だけです。

ただし、プロンプトキャッシュ自体にネイティブのルートは必要ありません。長いプロンプトでは、Kunavo が OpenAI Compatible のルート上でキャッシュのブレークポイントを自ら設定します。設定先は、システムプロンプト、ツール定義、そして会話にアシスタントのターンが含まれていれば最後のメッセージで、エージェントのループでは最初のステップより後のすべてのステップがこれに当たります。Roo Code がそのルートで設定した cache_control は保持されます。ネイティブのルートでは、リクエストは Roo Code が送ったとおりに渡され、ブレークポイントは追加されないため、何がキャッシュされるかは Roo Code が設定するブレークポイント次第です。

各モードに割り当てる Claude モデル

これらはすべて同じキーと同じエンドポイントを使用し、異なるのはモデルスラッグだけです。したがって、プロファイルでは1語を変更するだけです。Anthropic の公式料金との比較を含むモデル別の詳細な料金はAnthropic Claude API 料金表に、最新のカタログは料金ページにあります。

Kunavo 上の Roo Code と Anthropic への直接呼び出しの比較

直接利用のほうが適している場合も含めた、率直な比較です。

この容量の行が、実際のトレードオフを率直に示しています。保証クォータ、契約上の SLA、またはモデルベンダーとの調達関係が必要なら、直接利用してください — 価格差が購入するものはそれです。個人開発者や Roo Code を使う小規模チームでは、通常は逆の選択になります。

Roo Code のセッションに実際にかかるコスト

エージェント型ツールは、各ステップでシステムプロンプト、タスク履歴、新しいファイルコンテキストを再送するよう設計されているため、トークンを大量に消費します。Kunavo料金での現実的な数字は次のとおりです。

実行可能な計算式：

# Kunavo Claude rates (USD per 1M tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
    "claude-opus-5":     (3.50, 17.50),
}

def step_cost(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# One Code-mode step: Roo resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task on the Code-mode default:
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# Architect mode on Opus 5 for 3 steps, Code mode on Sonnet 5 for 17:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

請求額を抑える

1. 1つのタスクを永遠に延長せず、新しいタスクを開始してください。 Roo Code は各ステップで会話全体を再送するため、長時間続く1つのタスクはコストが二次関数的に増加します。新しいタスクは小さく新鮮なコンテキストになるため、ここで最も効果の大きい習慣です。
2. モードごとにプロファイルを割り当ててください。 前述のとおり、モデルルーティングを、タスク途中で覚えておく必要のあるものではなく、構成に変えられます。
3. キャッシュにはネイティブ Anthropic ルートを使用してください。 入力単価の10%でのキャッシュ入力は、安定したプレフィックスを再送するループにおける最大の構造的節約です。
4. エディター専用の支出制限付きキーを用意してください。 ダッシュボードで別のキーを作成し、実際に1週間使った後に使用量を確認してください。これが、自分にかかるコストを正直に見積もる唯一の方法です。

よくある質問