Source: https://aiprimetech.io/ja/learn/use-claude-api-with-roo-code/ [ホーム](/ja/) / [学習](/ja/learn/) / Claude APIでRoo Codeを無制限に利用 # 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: # Model: claude-sonnet-4-5 # # Profile: Unlimited-Opus # Provider: Anthropic # Base URL: https://aiprimetech.io # API Key: # Model: claude-opus-4-6 # # Mode Assignment: # Architect -> Unlimited-Opus # Code -> Unlimited-Sonnet # Debug -> Unlimited-Opus # Ask -> Unlimited-Sonnet ``` ## よくある質問 無制限プランでモードごとにモデルを割り当てる利点は何ですか？ 費用を心配せずに、Opusのような高価なモデルを推論負荷の高いモード（Architect、Debug）に割り当てつつ、使用頻度の高いモード（Code、Ask）には高速なモデルを使って応答遅延を抑えられます。トークン単位の課金ではこの戦略は高額になりますが、無制限プランなら追加費用なしで品質を最適化できます。 OrchestratorモードはAPI使用量にどう影響しますか？ Orchestratorはタスクをサブタスクに分割し、それぞれを独自のトークン予算を持つ個別の会話で実行します。複雑なタスクでは、5-10個の独立したClaudeの会話が生成されることがあります。トークン単位の課金では費用が大幅に増加しますが、無制限プランでは定額料金に含まれます。 Roo CodeはOpenAI互換エンドポイントで動作しますか？ はい。プロバイダーを「OpenAI互換」、ベースURLをhttps://unlimited.aiprimetech.io/v1,に設定したプロファイルを作成し、モデルIDを手動で入力してください。ただし、ツール呼び出しの互換性を最良に保つには、Anthropicプロバイダー経由の利用を推奨します。 .roomodesとは何ですか？使うべきですか？ プロジェクトのルートにある.roomodesファイルでは、特定のツール、プロンプト、モデルの割り当てを持つカスタムモードを定義します。無制限プランでは、充実したシステムプロンプトによる追加のトークン費用を心配せず、調査、レビュー、移行、ドキュメント作成など、さまざまなワークフロー向けの特化型エージェントを自由に作成できます。 Roo Codeでツール呼び出しエラーが発生するのはなぜですか？ Roo Codeにはネイティブ関数呼び出しが必要で、XMLへのフォールバックはありません。モデル識別子が現在のClaudeモデル（claude-sonnet-4-5以降）であることと、選択したプロバイダーの種類に合わせてベースURLが正しく設定されていることを確認してください。古いモデルバージョンでは、ツール呼び出しのサポートが弱い場合があります。 数分でClaudeの利用を開始 APIキーを取得 — Anthropicアカウントもウェイトリストへの登録も不要です。[APIキーを取得](/register) AI Prime Techは独立したAPIゲートウェイです。Anthropicとの提携関係はなく、同社の承認を受けておらず、同社の再販業者でもありません。Claudeおよび関連するモデル名は、それぞれの所有者の商標です。 ## Claude APIのその他のガイド [Claude APIキーの取得方法](/ja/learn/how-to-get-a-claude-api-key/)[Claude API の料金を解説](/ja/learn/claude-api-pricing-explained/)[Claude APIを最も安く利用する方法](/ja/learn/cheapest-way-to-use-claude-api/)[Claude APIでCursorを無制限に利用](/ja/learn/use-claude-api-with-cursor/)[Claude Codeへの無制限アクセス](/ja/learn/use-claude-api-with-claude-code/)[Claude APIゲートウェイとAnthropicへの直接接続の比較](/ja/learn/claude-api-vs-anthropic-direct/)[OpenAI互換API経由でClaudeを使う](/ja/learn/openai-compatible-claude-api/)[Claudeモデルの比較](/ja/learn/claude-api-models-compared/)[暗号資産でClaude APIの料金を支払う](/ja/learn/claude-api-with-crypto-payment/)[ウェイティングリストなしでClaude APIを利用](/ja/learn/claude-api-without-waitlist/)[Claudeのトークン使用量を削減する方法](/ja/learn/how-to-reduce-claude-token-usage/)[Claude APIでClineを無制限に利用](/ja/learn/use-claude-api-with-cline/)[JetBrains IDEでClaudeを無制限に利用](/ja/learn/use-claude-api-with-jetbrains/)[Claude APIでAiderを無制限に使う](/ja/learn/use-claude-api-with-aider/)[VS CodeでClaudeを無制限に利用](/ja/learn/use-claude-api-with-vscode/)[Claude APIでOpenCodeを無制限に使う](/ja/learn/use-claude-api-with-opencode/)[ClaudeでHermesエージェントを無制限に実行する](/ja/learn/run-hermes-agent-with-claude-api/)[ClaudeでOpenClawを無制限に実行](/ja/learn/run-openclaw-with-claude-api/)[Anthropic互換APIとは](/ja/learn/anthropic-compatible-api/)[Claude Code APIキー — 取得と設定の方法](/ja/learn/claude-code-api-key-setup/)[Claude Code APIのコスト — 料金と削減方法](/ja/learn/claude-code-api-costs/)[Claude APIのエラー — レート制限、400、500、529の対処法](/ja/learn/claude-api-errors-troubleshooting/)[Claude APIクレジットの購入方法](/ja/learn/buy-claude-api-credits/)[Claude APIの無料トライアル：実際に無料のものと、無料ではないもの](/ja/learn/claude-api-free-trial/)[Claude APIとClaude Pro/Maxサブスクリプション — どちらを選ぶべきか](/ja/learn/claude-api-vs-subscription/)[ClaudeでCodex CLIを実行する](/ja/learn/use-claude-api-with-codex/)[Claudeをn8nに接続する](/ja/learn/use-claude-api-with-n8n/)[LiteLLMからClaudeへのルーティング](/ja/learn/use-claude-api-with-litellm/)[Kilo CodeでClaudeを使う](/ja/learn/use-claude-api-with-kilo-code/)[GitHub CopilotにClaudeを導入する](/ja/learn/use-claude-api-with-github-copilot/)[ゲートウェイ経由でZedをClaudeに接続する](/ja/learn/use-claude-api-with-zed/)[Cherry StudioをClaudeに接続](/ja/learn/use-claude-api-with-cherry-studio/)[LangChainの接続先をゲートウェイ上のClaudeに設定する](/ja/learn/use-claude-api-with-langchain/)[ClaudeでFactory Droidを実行](/ja/learn/use-claude-api-with-factory-droid/)[Claude Code APIの仕組みを解説](/ja/learn/claude-code-api/)[アプリケーションへのClaude APIの統合](/ja/learn/claude-api-integration/)