Claude APIでRoo Codeを無制限に利用

Roo Codeは、VS Code向けの強力なエージェント型コーディング拡張機能です。役割をArchitect、Code、Debug、Askという明確な動作モードに分け、それぞれにモデル、temperature、プロバイダーの設定を個別に指定できます。Orchestrator機能はサブタスクを生成し、API使用量を大幅に増加させます。Roo Codeを定額・無制限のClaudeゲートウェイに接続すれば、ArchitectモードにOpus、CodeモードにSonnetを割り当て、オーケストレーションされたワークフローによるコストの累積を気にせず利用できます。

Roo CodeでAPI使用量が増大する仕組み

Roo Codeのアーキテクチャは、シンプルなチャット型AIエディターとは根本的に異なります。各動作モード（Architect、Code、Debug、Ask）は独自のコンテキストを保持し、異なるモデルを割り当てることができます。Orchestratorモードが有効な場合、複雑なタスクをサブタスクに分解し、それぞれを適切なモードに委任します。これにより、実質的に並行する会話が生成され、それぞれが独立してトークン予算を消費します。

「認証モジュールをリファクタリングする」といったOrchestrator主導のタスクでは、新しい構造を計画するArchitectサブタスク、異なるコンポーネントを実装する複数のCodeサブタスク、結果を検証するDebugサブタスクが生成される場合があります。各サブタスクは独自のシステムプロンプト、ツール定義、会話履歴を持ちます。各サブタスクが完全なコンテキストを注入された状態で新たに開始するため、総トークン消費量は加算的ではなく、乗算的に増加します。

Roo Codeがネイティブのツール呼び出しのみを使用することも、この増加に拍車をかけます。ネイティブ呼び出しが失敗するとXMLベースのツール呼び出しに切り替える一部のエージェントとは異なり、Roo CodeにはAPIによるネイティブの関数呼び出しサポートが必要です。各ツールの呼び出し（ファイルの読み取り、書き込み、ターミナルコマンド）は、構造化されたツール呼び出しと応答のペアとなり、すべてのやり取りにオーバーヘッドが加わります。モード別のモデル、Orchestratorのサブタスク、ネイティブのツール呼び出しが組み合わさることで、Roo CodeはVS Codeエコシステムの中でも特にAPI使用量の多いツールとなっています。

API設定プロファイルのセットアップ

Roo Codeは、プロバイダーの設定をAPI設定プロファイルにまとめて管理します。各プロファイルには、プロバイダーの種類、ベースURL、APIキー、モデル識別子、およびtemperatureや思考予算などの任意パラメーターが含まれます。VS CodeでRoo Codeの設定パネルを開き、「API設定」に移動します。「新しいプロファイルを作成」をクリックして開始してください。

Anthropicプロバイダー経由で接続する場合は、「プロバイダー」をAnthropicに設定し、「ベースURL」にhttps://unlimited.aiprimetech.ioを入力します（ルートホストを指定し、/v1は付けません。Anthropic SDKがパスを追加します）。続いて、AI Prime Tech Unlimitedのキーを貼り付けます。モデルは、バランス重視のプロファイルならclaude-sonnet-4-5、推論能力を最大限に引き出すならclaude-opus-4-6を選択します。出力の決定性と創造性のどちらを重視するかに応じて、temperatureを0から1の間に設定してください。

用途別に複数のプロファイルを作成します。簡単な質問にはHaikuを使う高速プロファイル、日常のコーディングにはSonnetを使う標準プロファイル、アーキテクチャの判断にはOpusを使う高性能プロファイルを用意します。次の手順でこれらのプロファイルを特定のモードに割り当てるため、「Unlimited-Sonnet」「Unlimited-Opus」など、わかりやすい名前を付けてください。

モード別のモデル割り当て戦略

無制限プランのユーザーにとって、Roo Codeの最大の魅力はモード別のモデル割り当てです。設定では、各モード（Architect、Code、Debug、Ask）に、使用するAPI設定プロファイルを選択するドロップダウンがあります。無制限プランでの最適な戦略は、積極的なモデル選択です。深い推論が特に重要なArchitectとDebugモードにはOpusを、速度と処理量が重視されるCodeとAskモードにはSonnetを割り当てます。

Architectモードは、実行前に複雑な変更を計画します。システム全体への影響、依存関係の連鎖、アーキテクチャパターンについて推論するOpusの優れた能力が、大きな効果を発揮します。Debugモードも同様にOpusの恩恵を受けます。バグの診断には、複数の仮説を同時に念頭に置き、実行経路をたどって推論することが必要になる場合が多いためです。

Codeモードは実際のファイル編集を担当し、最も頻繁に呼び出されます。Sonnetは、高品質なコードを生成しながら、短いフィードバックサイクルを維持できるだけの速度を備えています。Askモードは簡単な質問や説明に使われ、Sonnetはこれらを効率よく処理します。無制限プランでは、すべてのモードでOpusを使用しても追加コストは発生しませんが、対話型のワークフローではレイテンシーの違いが重要です。この使い分けにより、深い推論が必要な場面では深く考え、速度が重要な場面では素早く応答するという、両方の利点を得られます。

OrchestratorとBoomerangサブタスク

Orchestratorモード（Boomerangと呼ばれることもあります）は、Roo Codeのタスク分解エンジンです。Orchestratorモードで複雑なタスクを説明すると、作業を個別のサブタスクに分割し、それぞれを適切なモードに委任します。サブタスクの結果はOrchestratorに「ブーメラン」のように戻り、Orchestratorがそれらを統合して次の手順を決定します。

各サブタスクは、独自のトークン予算を持つ独立した会話コンテキストで実行されます。つまり、ひとつのOrchestratorタスクから複数のClaude会話が生成され、それぞれが独立して大量のトークンを消費する場合があります。トークン単位の従量課金では、中程度の複雑さの機能を開発するOrchestratorセッションでも、容易に数ドルの費用がかかります。無制限プランでは、チャットメッセージを送信する場合とまったく同じで、追加費用はかかりません。

無制限アクセスでOrchestratorを効果的に使うには、制約を設けないでください。問題の解決に必要なだけサブタスクを生成させましょう。自動モードを有効にすると、Orchestratorは各ステップで確認を求めずにタスクの分割方法を決定します。これにより、処理中に新しい情報が見つかるたびに、サブタスクの計画を見直して再実行し、自由に反復できるため、より良い結果が得られます。

.roomodesによるカスタムモード

Roo Codeは、プロジェクトのルートにある.roomodesファイルで定義する、プロジェクト単位のカスタムモードに対応しています。各カスタムモードには、名前、説明、システムプロンプトへの追加内容、使用を許可するツール、使用するAPI設定プロファイルを指定します。これにより、SQLファイルと移行ツールだけにアクセスできる「データベース移行」モードや、文章作成に最適化したプロンプトでMarkdownに集中する「ドキュメント」モードなど、プロジェクト専用の特化型エージェントを作成できます。

プロジェクトのルートに.roomodes JSONファイルを作成します。各モードのエントリには、roleDefinition（システムプロンプト）、allowedTools（そのモードで使用できるツール名の配列）、apiConfiguration（使用するプロファイル）を含めます。カスタムモードは、モード選択メニューで組み込みモードと並んで表示されます。

無制限プランでは、カスタムモードを使って独創的なワークフローを構築できます。Opusを使って不慣れなコードベースを深く分析する「調査」モードを作成しましょう。Haikuを使って簡単な単一行の変更を行う「クイック修正」モードも作成できます。コードを読み、編集せずにフィードバックを出す「レビュー」モードも作成できます。定額制なので、設定がうまくいかなかった場合の費用を心配せず、モード設定を自由に試せます。

ネイティブツール呼び出しの要件

Roo Codeはネイティブ関数呼び出しのみを使用し、一部の他のエージェントのようにXMLベースのツール呼び出しへフォールバックすることはありません。そのため、APIプロバイダーは、複数ターンにわたるtool_useおよびtool_resultブロックを含め、Messages APIのtoolsパラメーターを正しくサポートする必要があります。AI Prime Tech Unlimitedゲートウェイは、すべてのClaudeモデルでこれを完全にサポートしています。

ツール呼び出しエラーが発生する場合、ほとんどは次のいずれかが原因です。ツール呼び出しのサポートが弱い古いモデルバージョンを使用しているか、ベースURLの設定が誤っていてリクエストが別のエンドポイントに送られています。プロファイルのモデル識別子が現在のClaudeモデルと一致していることと、選択したプロバイダーの種類に対してベースURLが正しいことを確認してください。

Roo Codeで使用できるツールには、ファイル操作（読み取り、書き込み、一覧表示）、ターミナルコマンド（実行、出力の読み取り）、ブラウザー操作（有効な場合）、MCPツール（設定済みの場合）があります。ツールを呼び出すたびに、会話に構造化データが追加されます。通常、結果を含めて呼び出しごとに200-500トークンです。数十回のツール呼び出しを伴う複雑なタスクでは、この量が大きく積み重なります。

Roo Code設定のトラブルシューティング

最もよくある問題は、モードとプロファイルの不一致です。プロファイルを作成したものの、モードへの割り当てを忘れているケースです。設定で各モードのAPI設定ドロップダウンを確認してください。「デフォルト」と表示されていて、デフォルトプロファイルを設定していない場合、リクエストは失敗します。使用する予定の各モードに、プロファイルを明示的に割り当ててください。

モードを直接使用すると動作するのに、Orchestratorのサブタスクが失敗する場合、通常は、別途明示的に設定しない限りサブタスクのモードがOrchestratorのプロファイルを継承することが原因です。Orchestratorから呼び出される可能性のある各モードに、有効なプロファイルが個別に割り当てられていることを確認してください。よく使われる設定は、デフォルトプロファイルをSonnetの設定にし、ArchitectとDebugだけをOpusで上書きする方法です。

長時間のOrchestratorセッション中に接続タイムアウトエラーが発生する場合、通常は同時実行中のサブタスクが多すぎてレート制限に達しています。ゲートウェイは超過したリクエストをキューに入れ、処理可能になり次第、結果を返しますが、VS Codeがその遅延をタイムアウトと判断する場合があります。頻繁に発生する場合は、設定でOrchestratorの同時実行数を減らすか、そのまま待ってください。ゲートウェイは、公正利用の制限内で最終的にすべてのリクエストを処理します。

# Roo Code -> Settings -> API Configuration -> Create New Profile
#
# Profile: Unlimited-Sonnet
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-sonnet-4-5
#
# Profile: Unlimited-Opus
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-opus-4-6
#
# Mode Assignment:
#   Architect -> Unlimited-Opus
#   Code      -> Unlimited-Sonnet
#   Debug     -> Unlimited-Opus
#   Ask       -> Unlimited-Sonnet

よくある質問

AI Prime Techは独立したAPIゲートウェイです。Anthropicとの提携関係はなく、同社の承認を受けておらず、同社の再販業者でもありません。Claudeおよび関連するモデル名は、それぞれの所有者の商標です。