メインコンテンツへスキップ
VS CodeのGitHub CopilotのBring Your Own Key(BYOK)設定は「OpenAI Chat Completions APIと互換性のある任意のエンドポイント」を受け入れます。Tokiosはそのようなエンドポイントの一つです。Copilotをhttps://api.tokios.com/v1に向け、sk-tok-…キーを使用すれば、Copilot Chatとエージェントモードはトンネルなしでローカルモデルを呼び出せます。 BYOKはVS Codeで2026年にGAとなりました。Copilotの設定UIはリリースごとに変更されるため、インストール済みバージョンの正確なメニューパスとフィールドラベルを確認してください。

前提条件

  • ローカルモデルとペアリング済みのTokiosコネクターが動作していること — Connector install
  • 登録済みのモデルデプロイ名 — Register a model
  • Tokios APIキー(sk-tok-…) — API Keys
  • GitHub CopilotおよびCopilot Chat拡張機能がインストールされ、サインイン済みのVS Code
BYOKはCopilot BusinessおよびEnterpriseプランで利用可能です。GitHubのCopilot plans and featuresページにどのティアにBYOKが含まれるかが一覧表示されています。トラブルシューティングの前にアカウントを確認してください。
BYOKはCopilotのChatおよびエージェントモードにのみ適用されます。インラインコード補完は変更されません。これらはBYOKモデルを追加しても常にGitHub独自の補完モデルを使用し続けます。

CopilotをTokiosに向ける

1

Open the model picker

コマンドパレットからChat: Manage Language Modelsを実行します。またはCopilot Chatを開き、チャット入力の上のモデルピッカーをクリックして、 Manage Models… を選択します。正確な文言はCopilot Chatのバージョンによって異なるため、お手元のバージョンを確認してください。
2

Choose the OpenAI-compatible provider

カスタムOpenAI互換エンドポイント(BYOK)を追加するオプションを選択します。GitHubのドキュメントでは、これは「OpenAI Chat Completions APIと互換性のある他の任意のエンドポイント」を追加するものとして一般的に説明されており、Ollama、vLLM、Foundry Localなどの名前付きプロバイダーと並んで表示されます。お使いのバージョンの正確なラベルは異なる場合があります。
3

Enter the base URL

エンドポイントURLを以下に設定します。
4

Add your deployment as the model

次の公開デプロイ名を Models タブで登録したものを入力します。例:gemma-tunnel。これはCopilotがmodelフィールドで送信する値であり、Ollama、llama.cpp、vLLM、LM StudioのローカルモデルIDではありません。
5

Paste your Tokios API key

次のsk-tok-…キーをカスタムモデル用のAPIキーフィールドに貼り付けます。CopilotはすべてのリクエストでこれをBearerトークンとして送信します。
例:gemma-tunnelを登録したデプロイ名に、sk-tok-YOUR_KEYをご自身のキーに置き換えてください。どちらも共有の設定ファイルにコミットしないでください。

公開HTTPSエンドポイントが必要な理由

CopilotのBYOKリクエストはVS Codeから設定したエンドポイントに対して送信されますが、そのエンドポイントはCopilotのクライアントサイド拡張機能が実行されている場所から到達可能である必要があります。単なるhttp://localhost:11434はVS Codeとモデルが完全に同じマシン上にある場合にのみ機能します。別のラップトップ、devcontainer、またはリモートワークスペースを使用すると、localhostはもうモデルを指しません。 Tokiosのコネクターは送信のみなので、モデルはインバウンドポートを決して開かず、すべてのリクエストには何もない代わりにスコープ付きのsk-tok-…キーが付与されます。
  • 認証なしの公開がない — コネクターはTokiosにダイヤルアウトし、ポートで待ち受けません。リクエストには有効なキーが必要です。
  • 安定したURL — https://api.tokios.com/v1は再起動間で変化しないため、Copilotで一度設定するだけで、どのマシンからでも動作し続けます。
  • スコープ付きキー — キーは特定のデプロイに限定でき、漏洩した場合はローカルモデルやコネクターに触れることなく即座に取り消せます。

トラブルシューティング

お使いのCopilotプランにBYOKが含まれていない場合があります。アカウントがBYOKをサポートするティアにあるかを確認してください(上記の前提条件のノートを参照)。
Copilotが送信したAPIキーが欠落、不正な形式、または無効化されています。余分な空白を含まずにsk-tok-…キーの全体を貼り付けたかを確認し、Keysタブでステータスを確認してください。
Copilotが送信したmodel値が登録済みのデプロイと一致しません。Modelsタブの公開名と完全に一致しているかを確認してください — Ollama/llama.cpp/vLLM/LM StudioのローカルモデルIDではありません。
コネクターがオフラインか、同時実行数の上限に達しています。ConnectorsタブでコネクターがOnlineを示しており、実行マシンが稼働中であることを確認してください。
これは想定通りの動作です。BYOKはCopilot Chatとエージェントモードにのみ影響します。インライン補完はBYOK経由では設定できません。

次のステップ

Quickstart

コネクターのペアリング、モデルの登録、APIキーの作成を最初から行います。

Compatible clients

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