Roo Code

Roo Code は TokenHub の OpenAI compatible インターフェイス経由でモデルを呼び出せます。公式のインストール手順はそのまま使い、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 settings

TokenHub API key を作成し、TokenHub のモデル一覧からこのツールに適したモデルを選びます。

export TOKENHUB_API_KEY="sk-..."

キーはローカル shell、IDE のシークレット保存領域、またはツールの安全な API key 欄に保存します。リポジトリにはコミットしないでください。

Models、Providers、API Keys、OpenAI Compatible などの設定画面で次の値を入力します。

項目	値
プロバイダー	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 モデルを使います。動作確認後にコスト、レイテンシ、推論力で分けます。

一時変数は 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 など全てのモデル欄を再確認します。