Rooコードとは何ですか?
Roo Code は、OpenAI 互換プロバイダーを使用し、ファイルを編集し、承認されたツールを実行できるオープンソースの VS Code コーディング エージェントです。
この Roo コード ガイドでは、OpenAI 互換プロバイダー設定を通じて TokenHub を追加します。最初に読み取り専用タスクをテストし、次にネイティブ ツール呼び出しを検証してから、ファイル編集またはターミナル コマンドを有効にします。 Roo Code は、VS Code からファイルを読み取り、編集を提案し、ターミナル ツールを実行できるため、プロバイダーの接続とエージェントの機能を個別にテストする必要があります。最初の実行では自動承認をオフのままにし、使い捨てリポジトリを使用し、選択したモデルがネイティブ ツール呼び出しで信頼できることが証明されるまで、要求されたアクションをそれぞれ確認します。
Roo Code は TokenHub の OpenAI compatible 互換 API ゲートウェイ経由でモデルリクエストを送信できます。公式のインストール手順はそのまま使い、API key、Base URL、モデル ID だけを置き換えます。
このガイドで使う TokenHub endpoint は https://us-api.tokenhub.com/v1/chat/completions です。
使う場面
小さなリポジトリや検証用プロジェクトから始めます。まずは読み取り、コード説明、計画作成を試し、その後で編集や自動化タスクを有効にします。
インストールまたは起動
まず Roo Code 公式ドキュメント に従ってインストールまたは起動します。画面名が違う場合は現在の公式ドキュメントを優先してください。
CLI ツールの場合、TokenHub 認証情報を追加する前に実行ファイルが使えることを確認します：
# open the tool, then open its model or provider settingsTokenHub 認証情報を準備
TokenHub API key を作成し、TokenHub のモデル一覧からこのツールに適したモデルを選びます。
export TOKENHUB_API_KEY="sk-..."キーはローカル shell、IDE のシークレット保存領域、またはツールの安全な API key 欄に保存します。リポジトリにはコミットしないでください。
TokenHub プロバイダーを設定
Models、Providers、API Keys、OpenAI Compatible などの設定画面で次の値を入力します。
Provider の値
| 項目 | 値 |
|---|---|
| プロバイダー | OpenAI Compatible または Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | TOKENHUB_API_KEY の値 |
| モデル | gpt-4.1 または別の TokenHub model ID |
設定ファイルの場所
| 項目 | 値 |
|---|---|
| Provider settings | Roo Code provider settings or configuration profile |
| Provider mode | OpenAI Compatible |
| Required fields | Base URL, API Key, Model ID |
拡張機能が独自 schema を持つ場合は、まず設定 UI を使ってください。UI は同じ値をユーザー設定に保存し、バージョンで変わる内部キーを推測せずに済みます。
Use a model that supports OpenAI tool calling for Code mode tasks.
ツールが chat、edit、apply、fast model を分けている場合、最初のテストでは同じ TokenHub モデルを使います。動作確認後にコスト、レイテンシ、推論力で分けます。
一時環境変数はデバッグ用
拡張機能が独自 schema を持つ場合は、まず設定 UI を使ってください。UI は同じ値をユーザー設定に保存し、バージョンで変わる内部キーを推測せずに済みます。
一時変数は key、ネットワーク、モデル名の確認にだけ使います。確認後は同じ値を上の永続設定に移してください。
接続を確認
まず読み取り専用のプロンプトで、モデルが文脈を読めること、ファイルを変更しないことを確認します。その後、編集や Agent タスクを試します。
このプロジェクトの README を読み、3 文で要約してください。ファイルは変更しないでください。プロンプトが成功したら、TokenHub のリクエストログでモデル名、endpoint、token 使用量、課金グループを確認します。
トラブルシューティング
| 症状 | 対処 |
|---|---|
| 401 または認証失敗 | TOKENHUB_API_KEY が有効で、同じ terminal、IDE、クライアントプロファイルに保存されているか確認します。 |
| 404 またはモデルが見つからない | TokenHub ワークスペースに存在し、選択したプロトコルに対応するモデル ID を使います。 |
| endpoint が違う | 上記の Base URL と完全に一致させます。OpenAI 互換ツールは通常 /v1 が必要で、Claude 互換ツールは通常不要です。 |
| リクエストがタイムアウトする | https://us-api.tokenhub.com へのネットワーク、プロキシ設定、ワークスペースの allowlist を確認します。 |
| 別のモデルが使われる | chat、edit、apply、fast、autocomplete など全てのモデル欄を再確認します。 |
モデルの選び方
Roo コード API プロバイダーに関するよくある質問
Roo コードではどの API プロバイダーを選択すればよいですか?
[OpenAI 互換] を選択し、TokenHub ベース URL、API キー、および正確なモデル ID を入力します。
チャットは機能するが、ツールの呼び出しが失敗した場合はどうすればよいでしょうか?
まず、ネイティブ ツール呼び出しを明示的にサポートするコーディング モデルまたはエージェント モデルに切り替えてから、Roo コードの権限と承認モードを確認します。
最初の Roo Code テスト中のリスクを軽減するにはどうすればよいですか?
テスト リポジトリを使用し、読み取り専用の説明から始めて自動承認をオフにして、徐々に編集とターミナル コマンドを検証します。
Roo コード 401 のトラブルシューティングを行うにはどうすればよいですか?
API キーに欠落している文字やスペースがないか確認し、それがアクティブなプロファイルに保存されていることを確認します。短いリクエストを再試行し、TokenHub ログを検査します。
Roo Code 404 のトラブルシューティングを行うにはどうすればよいですか?
/v1 で終わる TokenHub API ルートを使用し、/chat/completions パスの重複を避け、モデル ID が存在することを確認します。
参考資料
この設定は TokenHub と公式ドキュメントに基づいており、最終確認日は 2026-09-04。
