メインコンテンツへスキップ
Roo Codeは設定パネルで構成するプロバイダープロファイルを通じてモデルと通信します。 OpenAI Compatible プロバイダーを追加し、 Base URL を https://api.tokios.com/v1 に、 API Key を sk-tok-… キーに、 Model ID をTokiosコンソールで登録したデプロイ名に設定します。するとRoo Codeは、マシンがどこにあっても、コネクター経由でローカルモデルにリクエストを送信します。

前提条件

  • ローカルモデルとペアリング済みのTokiosコネクターが動作していること — Connector install
  • 登録済みのモデルデプロイ名 — Register a model
  • Tokios APIキー( sk-tok-… ) — API Keys
  • VS CodeにRoo Code拡張機能がインストール済みであること

OpenAI Compatibleプロバイダーの設定

1

Roo Codeのプロバイダー設定を開く

VS CodeでRoo Codeパネルを開き、設定に移動します。APIプロバイダーとして OpenAI Compatible を選択します。
2

ベースURLを設定する

次の値に設定します Base URL :
3

APIキーを追加する

貼り付けます sk-tok-… キーを API Key フィールドに。Roo CodeはすべてのリクエストでこれをBearerトークンとして送信します。
4

モデルIDを設定する

設定します Model ID を 公開デプロイ名 に。登録は Models タブで行います。例えば gemma-tunnel です。これはバックエンド(Ollama、llama.cpp、vLLM、LM Studio)が使用するローカルモデルIDではありません。
置き換えてください: gemma-tunnel →ご自身のデプロイ名、 sk-tok-YOUR_KEY →ご自身のキー。どちらも共有の設定ファイルにコミットしないでください。

ツール呼び出しをサポートするモデルを選ぶ

Roo Codeはネイティブのツール呼び出しに依存して、プロジェクト内のファイル読み取り、コマンド実行、編集の適用を行います。基礎となるモデルがネイティブツール呼び出しをサポートしていない場合、Roo Codeはレスポンスをツールアクションに解析できず、前進する代わりにリトライとループを繰り返します。 Tokiosはリクエストのツール呼び出し構造をそのままバックエンドに通過させます。ツール呼び出しが実際に動作するかどうかは、実行しているモデルに完全に依存し、Tokiosやコネクターには依存しません。Roo Codeを実際の作業に使用する前に、デプロイの背後にあるモデルがネイティブツール呼び出しサポートを持っているかを確認してください。エージェントワークロード向けのモデル比較についてはChoose a local modelを参照してください。
ネイティブツール呼び出しを持たないモデルは、同じデプロイを通じてプレーンチャットでは正常に動作する場合でも、Roo Codeでは機能しません。Roo Codeが同じステップを繰り返しリトライしているように見える場合は、まずこれをチェックしてください。

トラブルシューティング

Roo Codeが送信したAPIキーが欠落、不正な形式、または無効化されています。余分な空白を含まずに完全な sk-tok-… キーを貼り付けたかを確認し、Keysタブでステータスを確認してください。
キーは有効ですが、 Model ID のデプロイにスコープされていないか、アカウントが停止されています。Keysタブでキーの許可モデルパターンを確認してください。
確認してください Model ID の値が登録済みのデプロイと一致しているかを。Modelsタブの公開名と完全に一致している必要があります。Ollama/llama.cpp/vLLM/LM StudioのローカルモデルIDではありません。
そのデプロイのコネクターがオフラインか、同時実行数の上限に達しています。Connectorsタブを確認してください。コネクターが Online を示している必要があります。
これは通常Tokiosのエラーではなく、デプロイの背後にあるモデルがネイティブツール呼び出しをサポートしていない兆候です。上記のツール呼び出しをサポートするモデルを選ぶを参照してください。

次のステップ

ローカルモデルを選ぶ

Roo Codeのようなコーディングエージェントワークロード向けのモデルとバックエンドを比較します。

互換クライアント

その他のOpenAIおよびAnthropic互換クライアントのベースURLとキー設定を参照してください。