まだRoo Codeのインストールを維持している場合、Roo Code OpenAI互換APIルートは、主にプロバイダータイプ、ベースURL、APIキー、モデルIDといった設定面です。見落としやすいのが本番環境でのリスクです。Roo Codeのプロバイダーのドキュメントでは、このパスにはネイティブなOpenAIスタイルのツール呼び出しが必要とされているため、プレーンなチャット応答だけではコーディングエージェントのワークフローの証明には不十分です。
このガイドでは、開発者、AI製品チーム、自動化ビルダー、プラットフォームエンジニア、財務担当者、調達レビュー担当者向けに、既存のRoo Code設定をFlatkey経由でルーティングする方法を説明します。現在のRoo Codeの注意点、FlatkeyのベースURLの検証、正確なモデルエイリアス、ネイティブなツール呼び出しのプリフライト、Roo Codeの設定、使用状況のレビュー、ロールバックについて説明します。
出典注記: これは2026年6月29日に、公式のRoo Codeドキュメンテーションホーム、公式のRoo Code OpenAI互換プロバイダードキュメンテーション、公開されているFlatkeyのページ、および認証済みFlatkeyゲートウェイのスモークテスト1件に対して確認されました。Roo Codeのドキュメンテーションホームには、Roo Code拡張機能が2026年5月15日にシャットダウンされたと記載されているため、これを拡張機能の利用可能性を確認せずに新しい展開を標準化するための推奨事項としてではなく、既存のインストール、アーカイブされた設定、または移行レビューのためのセットアップガイドとして扱ってください。
クイックアンサー：Roo Code OpenAI互換APIのセットアップ
Flatkeyを使用したRoo Code OpenAI互換APIのセットアップでは、APIプロバイダーとしてOpenAI Compatibleを選択し、現在のFlatkeyベースURLを貼り付け、Flatkey APIキーを使用し、OpenAI互換のチャットとネイティブなツール呼び出しをサポートする正確なFlatkeyモデルエイリアスを入力します。その後、コードワークスペース内で信頼する前に、小さなcurlリクエストでルートを証明します。
| Roo Codeのフィールド | Flatkeyの値 | レビューチェック |
|---|---|---|
| APIプロバイダー | OpenAI Compatible | Flatkeyにはこのプロバイダーを使用し、公式のOpenAIプロバイダーは使用しないでください。 |
| ベースURL | アカウントの現在のFlatkeyプロバイダーベースURL。例えば、検証済みの値が https://router.flatkey.ai/v1 の場合など |
ベースURLのみを貼り付けてください。Roo Codeに完全な /chat/completions エンドポイントを貼り付けないでください。 |
| APIキー | 適切なユーザー、チーム、または環境が所有するFlatkeyキー | アップストリームプロバイダーのキーをFlatkeyのベースURLと混在させないでください。 |
| モデルID | そのキーで有効になっている正確なFlatkeyモデルエイリアス | コーディングタスクに使用する前に、エイリアスがOpenAIチャットエンドポイントとネイティブなツール呼び出しをサポートしていることを確認してください。 |
| 検証 | 小さなチャットとツール呼び出しのスモークテスト、その後、安全なRoo Codeプロンプトを1つ実行 | テスト後にFlatkeyの使用状況を確認し、財務およびプラットフォームの所有者がルートを照合できるようにします。 |
最も安全で短い手順は、Flatkeyのトランスポートを証明し、モデルエイリアスを証明し、ネイティブなツール呼び出しを証明してから、Roo Codeの設定を保存することです。このRoo Code OpenAI互換APIガイドの残りの部分では、これを再現可能なチェックリストにまとめています。
現在のRoo Codeドキュメントで確認できること
Roo Codeのドキュメンテーションホームには現在、拡張機能のシャットダウンに関する警告が掲載されています。これは計画を立てる上で重要です。チームが既存のRoo Codeインストールを使用している場合、以下の設定詳細はメンテナンスや移行レビューに引き続き役立ちます。チームが新しい標準のコーディングアシスタントを選択している場合は、Roo Codeをより広いグループに割り当てる前に、まず拡張機能、マーケットプレイス、フォークのステータスを確認してください。
Roo Code OpenAI互換プロバイダーのページには、このプロバイダークラスの3つの主要な値、ベースURL、APIキー、モデルIDが記載されています。また、APIプロバイダーとしてOpenAI Compatibleを選択するように指示されています。ベースURLはプロバイダーのエンドポイントであり、OpenAI互換でないプロバイダーを使用している場合は、公式のOpenAI API URLでは明示的にありません。
Roo Code固有の重要な制約は、ツール呼び出しです。同じプロバイダーページには、Roo Codeはネイティブなツール呼び出しのみを使用し、XMLベースのフォールバックはないと記載されています。また、選択されたモデルはOpenAI互換のツール呼び出しをサポートする必要があるとも述べられています。Flatkeyを介したRoo Code OpenAI互換APIルートの場合、これはモデルエイリアスがプレーンテキスト生成だけでは検証できないことを意味します。
Roo Codeを開く前に確認すべきFlatkeyの値
1. アカウントのベースURLを確認する
2026年6月29日に確認されたFlatkeyのホームページには、One API gateway for production AI teamsというタイトルと、Flatkeyがモデルアクセス、ルーティング、請求、使用状況分析、運用管理を統合するというメタディスクリプションがあります。公開されているホームページの例には、OpenAIスタイルのチャット補完が含まれています。この記事のための認証済みランタイムチェックでは、https://router.flatkey.ai/v1が使用され、有効なモデルリストが返されました。
公開されている例とアカウント固有のルートは時間とともに異なる可能性があるため、本番環境で使用する前に、コンソール、ドキュメント、または作業環境から現在のFlatkeyベースURLをコピーしてください。Roo Codeでは、ベースURLはプロバイダーのベースであるべきで、/v1/chat/completionsではありません。
2. モデルエイリアスとツールサポートを確認する
2026年6月29日に確認したFlatkeyの料金ページによると、23のプロバイダーにわたる635のAIモデルのサーバーレンダリング価格を公開していると記載されています。そのエンドポイントマップには、/v1/chat/completions、/v1/responses、/v1/messages、/v1/images/generations、/v1/video/generationsが含まれています。これはカタログとエンドポイントの証拠であり、すべてのFlatkeyキーがすべてのモデルを呼び出せるという保証ではありません。
Roo Code OpenAI互換APIのセットアップでは、OpenAI互換のチャットとツール呼び出しをサポートする、アカウントで表示可能なモデルエイリアスを1つ選択します。この記事のために認証済みチェックを行ったところ、56のアカウントで表示可能なモデルが返され、gpt-5.4-miniを使用した小さなツール呼び出しリクエストは、finish_reason: tool_callsと使用状況メタデータとともにHTTP 200を返しました。これはテストされたアカウントの日付付きのルート証明として扱い、すべてのFlatkeyワークスペースに対する恒久的な推奨事項として扱わないでください。
3. キーの所有権と使用状況の確認
Roo Codeはコードワークスペース上で動作するため、キーの所有権は重要です。リスクを所有する開発者、チーム、または環境にスコープされたFlatkeyキーを使用してください。誰がキーをローテーションできるか、どのモデルエイリアスが許可されているか、どのエンドポイントファミリーが期待されるか、そして最初のプロンプトの後に使用状況ログがどこでレビューされるかを記録してください。
ステップバイステップ：FlatkeyでRoo Codeを設定する
- これが既存のRoo Codeのインストールであるかどうかを確認します。 公式ドキュメントでは現在、拡張機能のシャットダウンについて言及されているため、新しいマーケットプレイスのインストールが利用可能であると仮定して開始しないでください。
- Roo Codeのプロバイダー設定を開きます。 既存の拡張機能の設定で、モデルプロバイダーまたはAPI設定エリアに移動します。
- OpenAI Compatibleを選択します。 OpenAI互換でないエンドポイントについては、Roo Codeによって文書化されているプロバイダータイプを使用します。
- ベースURLを設定します。 確認済みのFlatkeyベースURLを入力します。例えば、アカウントの現在の有効な値が
https://router.flatkey.ai/v1である場合、それを入力します。 - Flatkey APIキーを貼り付けます。 リポジトリファイル、issueのコメント、スクリーンショット、プロンプトには含めないでください。
- モデルIDを設定します。 正確なFlatkeyモデルエイリアスを入力します。Flatkeyがその正確なエイリアスをキーに公開していない限り、一般的なベンダーファミリー名を使用しないでください。
- 以下のcurlプレフライトを実行します。 通常のチャットも便利ですが、Roo Codeはネイティブのツール呼び出しを必要とするため、テストにツールスキーマを含めてください。
- 安全なRoo Codeプロンプトを1つ実行します。 Roo Codeを本番リポジトリに向ける前に、使い捨てのワークスペースまたは非破壊的なタスクを使用してください。
- Flatkeyの使用状況を確認します。 タイムスタンプ、キーの所有者、モデルエイリアス、トークン使用量、ステータス、コストの可視性を確認します。
- ロールバックを文書化します。 他の開発者に切り替えを依頼する前に、以前のプロバイダー設定、モデルエイリアス、所有者を保存します。
ネイティブツール呼び出しのプレフライトテンプレート
Roo Code OpenAI互換APIのセットアップをデバッグする最も安全な方法は、まずRoo Codeの外部でFlatkeyルートをテストすることです。このテンプレートはチャットエンドポイントを検証し、モデルにOpenAIスタイルのツール呼び出しを返すよう要求します。
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://router.flatkey.ai/v1"
export FLATKEY_ROO_MODEL="replace-with-tool-capable-flatkey-model"
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_ROO_MODEL"'",
"messages": [
{
"role": "user",
"content": "route_checkをステータスokで呼び出し、散文は含めないでください。"
}
],
"tools": [
{
"type": "function",
"function": {
"name": "route_check",
"description": "ルーティングのスモークテストステータスを返します。",
"parameters": {
"type": "object",
"properties": {
"status": { "type": "string" }
},
"required": ["status"]
}
}
}
],
"tool_choice": {
"type": "function",
"function": { "name": "route_check" }
},
"max_tokens": 64
}'正常な応答には、tool_callsを含むアシスタントメッセージが含まれるはずです。このリクエストが失敗した場合は、Roo Codeの設定を変更する前に、Flatkeyキー、ベースURL、モデルエイリアス、またはモデルの機能を修正してください。リクエストは成功するがRoo Codeが失敗する場合は、保存されたRoo Codeのフィールド、ローカルネットワークアクセス、拡張機能の状態、またはプロバイダー設定で入力された正確なモデルIDに焦点を当ててください。
最初にデバッグすべき失敗モード
| 症状 | 考えられる原因 | 修正 |
|---|---|---|
| 無効なAPIキー | キーが正しくコピーされていない、ローテーションされている、別の環境にスコープされている、またはFlatkeyではなくアップストリームプロバイダーに属している。 | 新しいFlatkeyキーを使用し、curlでテストしてから、同じキーをRoo Codeに貼り付けます。 |
| 接続エラー | ベースURLが間違っている、ベースURLフィールドに完全なエンドポイントパスが貼り付けられている、ネットワークパスがブロックされている、またはローカルプロキシの問題。 | 同じマシンからプロバイダーのベースURLを確認し、/chat/completionsを再テストします。 |
| モデルが見つかりません | Roo CodeのモデルIDが、キーに対して有効になっているFlatkeyエイリアスと一致しません。 | Flatkeyの価格設定、カタログ、またはアカウントに表示されるモデルリストから正確なエイリアスをコピーします。 |
| ツール呼び出しエラー | 選択されたモデルはチャットに応答できますが、OpenAI互換のネイティブツール呼び出しをサポートしていません。 | ツール対応のモデルエイリアスに切り替え、Roo Codeを使用する前にプレフライトを再実行します。 |
| 拡張機能が利用不可 | 現在のRoo Codeの配布状態では、計画されているインストールまたは更新パスがサポートされていません。 | セットアップをレガシーメンテナンスとして扱い、新しい展開にはアクティブなコーディングエージェントワークフローを選択します。 |
| 使用状況を調整できません | チームがキーの所有者、モデルエイリアス、Roo Codeユーザー、環境、またはタイムスタンプを記録していませんでした。 | より多くの開発者にルートを拡大する前に、ランブックに行を追加します。 |
既存のインストールか、新しい標準か？
Roo Code OpenAI互換APIルートは便利ですが、拡張機能のシャットダウン通知によって決定が変わります。チームに依存を依頼する前に、この表を使用してください。
| 状況 | 推奨されるアクション | 重要な理由 |
|---|---|---|
| 開発者がまだ使用している既存のRoo Codeインストール | Flatkeyルートを文書化し、ツール呼び出しをテストし、ロールバックを維持します。 | チームが移行または置換を計画している間、メンテナンスを継続できます。 |
| チーム全体の新しいコーディングエージェントの展開 | まず現在の拡張機能の可用性を確認し、次にアクティブな代替案を比較します。 | シャットダウンされた拡張機能は、サポート、セキュリティ、およびオンボーディングのリスクを生み出す可能性があります。 |
| ツール統合クラスターの標準化 | ツール間で同じFlatkeyキー、ベースURL、モデルエイリアス、および使用状況ログパターンを使用します。 | 一貫性により、請求、デバッグ、および調達レビューが容易になります。 |
Roo CodeとFlatkeyの本番環境ランブック
より多くの開発者がRoo Code OpenAI互換APIルートを使用する前に、サポートとコストレビューを可能にする運用上の事実を書き留めてください。
| ランブックのフィールド | 記録する内容 |
|---|---|
| Roo Codeのスコープ | 既存のローカルインストール、チームイメージ、アーカイブされたプロファイル、または移行のみのテスト。 |
| Flatkeyキー | 所有者、環境、ローテーション日、および失効所有者。 |
| ベースURL | Roo Codeに保存されている正確なプロバイダーのベースURLと、それが検証された日付。 |
| モデルエイリアス | Roo CodeモデルID、Flatkeyモデルエイリアス、エンドポイントファミリー、およびネイティブツール呼び出しの結果。 |
| スモークテスト | HTTPステータス、終了理由、使用量合計、およびtool_callsが表示されたかどうか。 |
| 使用状況レビュー | プラットフォームと財務の所有者がリクエスト量、コスト、予期しないモデルの変更を確認する場所。 |
| ロールバック | 以前のプロバイダー設定、以前のモデルエイリアス、およびそれを復元できる人。 |
内部移行パス
チームがFlatkeyでOpenAI互換のツール構成を標準化している場合は、このセットアップを統合クラスターの他の部分と整合させてください。ベースURLおよびロールバックハブとしてOpenAI互換API移行ガイドを使用してください。別のデスクトップクライアントパターンについては、Cherry Studio APIセットアップガイドを比較してください。開発者マシンでのコーディングエージェントのルーティングについては、cc-switch Claude Codeガイドを確認してください。
最初の安全なRoo Codeプロンプトが機能した後、現在のFlatkeyモデル価格ページを確認し、次に個別のユーザー、チーム、または環境の境界ごとにキーを取得してください。
よくある質問
Roo CodeはまだOpenAI互換プロバイダーをサポートしていますか？
Roo Code OpenAI互換プロバイダーのドキュメントには、APIプロバイダー、ベースURL、APIキー、モデルIDのプロバイダーフィールドが引き続き記載されています。ドキュメントのホームには、Roo Code拡張機能が2026年5月15日にシャットダウンされたとも記載されているため、新しい展開の前にインストールパスを確認してください。
Roo Code OpenAI互換APIプロバイダーにはどのベースURLを使用すればよいですか？
アカウントの現在のFlatkeyプロバイダーベースURLを使用してください。この記事の認証済みFlatkeyチェックではhttps://router.flatkey.ai/v1が使用されましたが、公開されている例は変更される可能性があります。Roo Codeには、完全なチャット補完エンドポイントではなく、ベースURLのみを貼り付けてください。
なぜネイティブツール呼び出しが必要なのですか？
Roo Codeのプロバイダードキュメントによると、ネイティブツール呼び出しが、OpenAI互換プロバイダーでサポートされている唯一のツールプロトコルです。プレーンなチャットには応答できても、OpenAIスタイルのツール呼び出しを生成できないモデルでは、信頼性の高いRoo Codeのセットアップには不十分です。
モデルIDはFlatkeyのモデルエイリアスと完全に一致させる必要がありますか？
はい。キーで呼び出せる正確なFlatkeyエイリアスを使用し、ツール呼び出しのスモークテストで検証してください。モデルファミリー名、プロバイダーのマーケティング名、ゲートウェイのエイリアスは異なる場合があります。
このガイドを新しいRoo Codeのデプロイメントに使用できますか？
現在のRoo Codeの利用可能性を確認した後にのみ使用してください。Flatkeyのルーティングチェックは依然として有用ですが、Roo Codeのシャットダウン通知は、新しいチーム全体のデプロイメントには明確な製品サポートの決定が必要であることを意味します。
結論
Flatkeyを介した安全なRoo Code OpenAI互換APIのセットアップは、単なるチャット応答の成功以上のものを証明するはずです。Roo Codeに実際のコード作業へのアクセスを許可する前に、現在のベースURLを確認し、Flatkey所有のキーを使用し、正確なモデルエイリアスを選択し、ネイティブツール呼び出しをテストし、使用状況の可視性を確認してください。ルートが別のユーザーや環境で使用できるようになったら、キーを取得し、セットアップ手順の隣にロールバック用の行を保持しておいてください。
