Claude APIでRoo Codeを無制限に使う

Roo Codeは、VS Code上で動く強力なagentic coding extensionです。Architect、Code、Debug、Askといった役割ごとのoperational modeに責務を分け、それぞれに別のmodel、temperature、provider設定を割り当てられます。さらにOrchestrator機能はsubtaskを生成するため、API消費量が一気に増えます。Roo Codeを定額の無制限Claude gatewayに接続すれば、Architect modeにはOpus、Code modeにはSonnetを割り当て、orchestrated workflowでコストが複利的に膨らむ心配をせずに使えます。

Roo CodeがAPI消費を大きく増やす仕組み

Roo Codeのアーキテクチャは、単純なチャット型AI editorとはかなり違います。Architect、Code、Debug、Askといった各operational modeがそれぞれ独立したcontextを持ち、必要に応じて別々のmodelを割り当てられます。Orchestrator modeを有効にすると、複雑なタスクを複数のsubtaskに分解し、内容に応じて適切なmodeへ委任します。つまり、見た目には1つの依頼でも、内部では複数の会話が並行して立ち上がり、それぞれが独自のtoken budgetを消費します。Roo Codeで本格的に開発を回すとclaude api 料金が読みにくくなるのは、この構造が大きな理由です。

たとえば「authentication moduleをリファクタリングして」という1つのOrchestrator-driven taskでも、Architect subtaskが新しい構成を設計し、3つのCode subtaskが別々のcomponentを実装し、Debug subtaskが結果を検証する、といった流れになり得ます。それぞれのsubtaskにはsystem prompt、tool definition、conversation historyが付きます。合計token消費は単なる足し算ではありません。各subtaskが新しい会話として始まり、十分なcontext injectionを受けるため、実質的には掛け算のように増えていきます。claude api 購入を検討するとき、Roo Codeのようなagentic toolでは、通常のチャット利用よりも消費が大きい前提で見積もる必要があります。

さらにRoo Codeはnative tool callingを前提にしています。一部のagentはnative callが失敗したときにXMLベースのtool invocationへfallbackしますが、Roo CodeはAPI側にnative function calling supportを求めます。file read、write、terminal commandなどの各tool invocationは、structured tool callとresponseのペアとして扱われ、やり取りのたびに追加のoverheadが発生します。modeごとのmodel、Orchestrator subtask、native tool callが組み合わさることで、Roo CodeはVS Code ecosystemの中でも特にAPI消費が重い部類に入ります。だからこそ、claude 無制限の定額gatewayと相性が良く、コストを気にして小さく使うよりも、開発効率を優先した使い方がしやすくなります。

API Configuration Profileの設定

Roo Codeでは、provider設定をAPI Configuration Profileとして管理します。各profileにはprovider type、base URL、API key、model identifier、必要に応じてtemperatureやthinking budgetなどのparameterをまとめて保存できます。VS CodeでRoo Codeのsettings panelを開き、API Configurationへ移動します。そこでCreate New Profileをクリックすれば、新しいprofileを作成できます。claude api キーを複数の用途で使い分ける場合も、profile名を明確にしておくと後から迷いにくくなります。

Anthropic provider pathを使う場合は、ProviderをAnthropicに設定し、Base URLにはhttps://claudeapikey.devを入力します。root hostのみを指定し、/v1は付けません。Anthropic SDK側がpathを追加するためです。そのうえでAI Prime Tech UnlimitedのAPI keyを貼り付けます。modelは、バランス重視ならclaude-sonnet-4-5、最大限のreasoning powerを使いたいならclaude-opus-4-6を選びます。temperatureは、安定した出力を重視するなら低め、発想の幅やcreativeな提案を重視するなら高めにし、0から1の範囲で調整します。claude code api キー設定に慣れている開発者であれば、考え方は近く、Roo Code側のprofileにgatewayのURLとkeyを入れるだけです。

用途別に複数のprofileを作るのがおすすめです。たとえば、短い質問用にHaikuを使うfast profile、日常的なcoding用にSonnetを使うstandard profile、設計判断や難しいdebug用にOpusを使うpower profileを用意します。profile名は「Unlimited-Sonnet」「Unlimited-Opus」のように、後から見ても用途が分かる名前にしてください。次のstepで、これらのprofileを特定のmodeに割り当てます。AI Prime Tech Unlimitedのような定額gatewayを使う場合、コスト最適化のためだけでなく、latency、品質、workflow上の役割に応じてprofileを分ける発想が重要になります。

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

無制限ユーザーにとって、Roo Code最大の強みはper-mode model assignmentです。settingsでは、Architect、Code、Debug、Askの各modeごとに、利用するAPI Configuration Profileをdropdownで選べます。unlimited環境での最適戦略はかなり攻めた設定です。深いreasoningが重要なArchitectとDebugにはOpusを割り当て、速度と実行回数が重要なCodeとAskにはSonnetを割り当てます。通常の従量課金ではclaude api 料金が気になってOpusを使う場面を絞りがちですが、定額なら品質を優先した設計ができます。

Architect modeは、実行前に複雑な変更の計画を立てます。system-wideな影響、dependency chain、architectural patternを考える必要があるため、Opusのreasoning能力が大きく効きます。大規模なリファクタリング、module境界の見直し、既存仕様との整合性確認などでは、最初の設計品質がその後の実装品質を左右します。Debug modeも同様にOpusとの相性が良いです。bugの診断では複数の仮説を同時に保持し、実行pathやstateの変化を追いながら原因を絞り込む必要があります。短い回答よりも、粘り強い推論が価値を持つ場面です。

Code modeは実際のfile editを担当し、最も頻繁に呼び出されます。Sonnetはfeedback loopを短く保てるだけの速度がありながら、高品質なcodeも生成できます。Ask modeは短い質問や説明に使うことが多く、Sonnetで十分効率的に処理できます。無制限環境では、すべてのmodeにOpusを割り当てても追加コストは発生しません。ただし、interactive workflowではlatencyの差が体感に影響します。そのため、重要な判断にはOpus、手数の多い実装や質問にはSonnetという分担が、品質と速度の両方を取りやすい現実的な構成です。

OrchestratorとBoomerang Subtask

Orchestrator modeは、Roo Codeのtask decomposition engineです。Boomerangと呼ばれることもあります。複雑なtaskをOrchestrator modeで説明すると、作業を個別のsubtaskに分解し、それぞれを適切なmodeへ委任します。subtaskの結果はOrchestratorへboomerangのように戻り、Orchestratorがそれらを統合して次のstepを判断します。この流れにより、人間が細かく指示しなくても、設計、実装、検証、再計画をagent側で進めやすくなります。

各subtaskは独自のconversation contextとtoken budgetを持って実行されます。つまり、1つのOrchestrator taskが5つの別々のClaude conversationを生成し、それぞれが数万tokenを個別に消費することもあります。従量課金では、中程度のcomplexityを持つfeatureのOrchestrator sessionだけで数ドルかかる可能性があります。AI Prime Tech Unlimitedのようなclaude 無制限の定額環境では、これは単一のchat messageと同じく追加費用を気にせず扱えます。Roo Codeを日常的に使うなら、claude api 購入時には単純な1 request単価だけでなく、Orchestratorによるmultiplicationも考慮するべきです。

無制限アクセスでOrchestratorを効果的に使うなら、必要以上に制限しないことが大切です。問題が必要とするだけsubtaskを生成させ、各stepで確認を求めるのではなく、Orchestratorが分解を自律的に決められるautomatic modeを有効にします。このほうが、Orchestratorは途中で得た新しい情報に基づいて自由にre-planし、subtaskを再実行できます。結果として、最初の指示だけでは見えていなかった依存関係やedge caseにも対応しやすくなります。従量課金では試行錯誤を抑えがちですが、定額ならagentic workflow本来の強みを引き出しやすくなります。

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

Roo Codeは、project rootに置いた.roomodes fileでproject-level custom modesを定義できます。各custom modeにはname、description、system prompt additions、allowed tools、利用するAPI Configuration Profileを指定できます。これにより、自分のprojectに特化したagentを作れます。たとえば、SQL fileとmigration toolだけにアクセスできる「Database Migration」modeや、Markdownに集中しwriting向けpromptを持つ「Documentation」modeを用意できます。チームの開発ルールやrepository構成に合わせてmodeを切り分けると、Roo Codeの出力が安定しやすくなります。

project rootに.roomodesというJSON fileを作成します。各mode entryにはroleDefinition、allowedTools、apiConfigurationを含めます。roleDefinitionはsystem promptに相当し、そのmodeの振る舞いや責務を定義します。allowedToolsは、そのmodeが使えるtool名のarrayです。apiConfigurationには、どのprofileを使うかを指定します。custom modeはbuilt-in modeと並んでmode selectorに表示されるため、ArchitectやCodeと同じ感覚で切り替えられます。profileとmodeを合わせて設計しておくと、たとえばreview専用modeには編集toolを許可しない、といった安全な運用もできます。

無制限環境では、custom modeによってかなり創造的なworkflowを作れます。未知のcodebaseを深く読むための「Research」modeにはOpusを使い、trivialな1行修正のための「Quick Fix」modeにはHaikuを使う、といった使い分けができます。codeを読み、変更はせずにfeedbackだけを出す「Review」modeを作るのも便利です。richなsystem promptはtoken消費を増やしますが、定額モデルならそのコストを気にしすぎる必要がありません。失敗した設定を試しても追加料金に直結しにくいため、projectごとに最適なmode構成を実験しやすくなります。

Native Tool Callingの要件

Roo Codeはnative function callingを専用で使います。一部のagentのようにXMLベースのtool invocationへfallbackする仕組みはありません。そのため、API providerはMessages APIのtools parameterを正しくサポートしている必要があります。multi-turnのtool_useとtool_result blockも含めて対応していることが重要です。AI Prime Tech Unlimited gatewayは、すべてのClaude modelでこの要件を満たすように設計されています。Roo Codeのようなtool-heavyなclientでは、単にchat completionが返るだけでは不十分で、tool callingの互換性が実運用の安定性を左右します。

tool-calling errorが出る場合、原因はほとんどの場合2つです。1つは、tool-calling supportが弱い古いmodel versionを使っていること。もう1つは、base URLの設定ミスによりrequestが誤ったendpointへ送られていることです。profileのmodel identifierが現在のClaude modelと一致しているか、選択したprovider typeに対してbase URLが正しいかを確認してください。Anthropic provider pathではhttps://claudeapikey.devを使い、OpenAI-compatible endpointを使う場合は/v1付きのURLを使う、という違いも混同しやすいポイントです。

Roo Codeのtool repertoireには、file operation（read、write、list）、terminal command（execute、read output）、browser action（有効化した場合）、MCP tool（設定済みの場合）などが含まれます。各tool callはconversationにstructured dataを追加します。結果を含めると、tool invocationごとに通常200〜500 token程度が増えることがあります。数十回のtool callを含むcomplex taskでは、このoverheadがかなり大きく積み上がります。だからこそ、claude api 料金を毎回意識せずにtool-richなagent workflowを使える定額gatewayは、Roo Codeの実用性を高めます。

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

最もよくある問題は、modeとprofileの不一致です。profileは作成したものの、各modeへ割り当てるのを忘れているケースです。settingsで各modeのAPI Configuration dropdownを確認してください。もし「Default」と表示されていて、default profileを設定していない場合、requestは失敗します。利用予定の各modeに対して、明示的にprofileを割り当てましょう。claude api キー自体が正しくても、Roo Code側のmode assignmentが未設定だと動作しません。

direct modeでは動くのにOrchestrator subtaskだけ失敗する場合、subtask modeが明示的に設定されていないため、Orchestratorのprofileを継承していることが原因になりがちです。Orchestratorから呼び出される可能性がある各modeに、有効なprofile assignmentがあるか確認してください。よくある構成は、default profileをSonnet設定にしておき、ArchitectとDebugだけOpusでoverrideするパターンです。これにより、subtaskがどのmodeに振り分けられても、少なくとも動作するprofileを持つ状態になります。

長いOrchestrator session中にconnection timeout errorが出る場合、多くのsubtaskが同時に走りすぎてrate limitに当たっている可能性があります。gatewayは余分なrequestをqueueに入れ、利用可能になり次第返しますが、VS Code側がその遅延をtimeoutとして扱うことがあります。これが継続的に起きる場合は、settingsでOrchestrator concurrencyを下げてください。もしくは、少し待てばgateway側で最終的にrequestは処理されます。fair-use limitの範囲内で、重いworkflowを安定させるには、concurrencyとlatencyのバランスを調整するのが現実的です。

# Roo Code -> Settings -> API Configuration -> Create New Profile
#
# Profile: Unlimited-Sonnet
#   Provider:  Anthropic
#   Base URL:  https://claudeapikey.dev
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-sonnet-4-5
#
# Profile: Unlimited-Opus
#   Provider:  Anthropic
#   Base URL:  https://claudeapikey.dev
#   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

FAQ

無制限環境でモード別モデル割り当てを使うメリットは何ですか？
ArchitectやDebugのようなreasoning-heavyなmodeにはOpusのような高性能modelを割り当て、CodeやAskのような高頻度modeには低latencyなmodelを使えます。従量課金では高くつく構成ですが、無制限なら品質優先で最適化しやすくなります。

Orchestrator modeはAPI使用量にどう影響しますか？
Orchestratorはtaskをsubtaskに分解し、それぞれが独自のconversationとtoken budgetで実行されます。1つのcomplex taskが5〜10個のClaude conversationを生成することもあります。従量課金ではコストが大きく増えますが、無制限では定額内でカバーされます。

Roo CodeはOpenAI-compatible endpointでも動きますか？
はい。ProviderをOpenAI Compatible、Base URLをhttps://claudeapikey.dev/v1に設定し、model IDを手入力すればprofileを作成できます。ただし、tool-calling互換性を最優先するならAnthropic provider pathを推奨します。

.roomodesとは何ですか？使うべきですか？
project rootの.roomodes fileで、特定のtool、prompt、model assignmentを持つcustom modeを定義できます。無制限環境では、research、review、migration、documentationなどworkflow別のspecialized agentを、richなsystem promptのtoken costを気にせず作れます。

Roo Codeでtool-calling errorが出るのはなぜですか？
Roo CodeはXML fallbackなしのnative function callingを必要とします。model identifierが現在のClaude model（claude-sonnet-4-5以降など）であること、選択したprovider typeに対してbase URLが正しく設定されていることを確認してください。古いmodel versionではtool-calling supportが弱い場合があります。