ロシアの GitHub Copilot：アカウント、プラン、Custom Endpoint

BetterToken Custom Endpoint を通じて外部モデルを Copilot Chat に接続できます。 GitHub アカウント、Copilot プラン、API アクセスは異なる機能を制御します。現在の VS Code はキーをローカルの Secret Storage に保存します。その後、Chat と Dashboard でリクエストを確認できます。この設定は inline completion も GitHub サービスへのアクセスも変更しません。

Endpoint を設定する前に、自分の API Key が必要です。 BetterToken アカウントを作成

設定するもの

Copilot には独立した複数の層があります。設定前にこれらを分けると、Chat は応答するのにエディターの候補が変わらない理由を理解しやすくなります。

層	制御するもの	Custom Endpoint が置き換えるか
GitHub アカウント	サインイン、ライセンス、GitHub 機能	いいえ
Copilot プラン	組み込みモデルと completions を含む Copilot サービスのクォータと機能	いいえ
ローカル BYOK / Custom Endpoint	対応クライアントと Chat 画面で外部モデルを選択すること	クライアントが選択モデルへ送るリクエストだけ
Inline completions	エディターでコードを直接補完すること	いいえ。GitHub Copilot の機能のまま

GitHub はローカル BYOK を説明しています。キーはデバイスに保存され、対応状況はクライアントごとに違います。Business または Enterprise 組織では、管理者がこの機能を無効にできます。Enterprise BYOK は別のサーバー側シナリオで、要件も別です。

BetterToken Custom Endpoint の設定は最新の手順と照合してください。BetterToken は OpenAI-compatible API アクセスと Dashboard の利用履歴を提供しますが、GitHub アカウントの発行、Copilot プランの有効化、GitHub の地域ルール変更は行いません。

ロシアで GitHub Copilot を設定する前の確認事項

1. VS Code の最新安定版をインストールします。
2. Chat: Manage Language Models を実行するか、Chat の画面で Manage Language Models を選びます。
3. Add Models → Custom Endpoint が使えることを確認します。
4. 自分の BetterToken API Key を作り、モデルディレクトリで正確な Model ID を選びます。

BYOK の対応はすべてのクライアントで同時に変わりません。VS Code に Custom Endpoint があるからといって、同じ設定が JetBrains、Xcode、GitHub.com、その他の画面で動くとは限りません。対応クライアントと制限の最新一覧は GitHub が公開しています。

公式 Copilot にはもう一つ制限があります。GitHub Trade Restrictions Policyでは、適切な許可なしに Copilot をロシアへ販売または輸出できないとされています。Custom Endpoint はこのポリシーを上書きしません。地域変更、第三者決済、アカウント確認回避の手順はありません。

VS Code に BetterToken Custom Endpoint を追加する方法

1. モデル管理を開く

Copilot Chat の入力欄で Manage Language Models を選ぶか、Command Palette から Chat: Manage Language Models を実行します。次に Add Models → Custom Endpoint をクリックします。

この選択肢がなければ、まず VS Code を更新してください。古い任意の手順から設定を移さないでください。コマンド名やファイル構成は変わっていることがあります。

2. グループを作成してキーを保存する

Group Name に BetterToken と入力します。VS Code が API Key を求めたら、ポップアップにキーを貼り付けて Enter を押します。

VS Code はシークレットをローカルに保存し、設定には次のような参照を書きます。

"apiKey": "${input:betterTokenApiKey}"

この参照を実際のキーに置き換えないでください。キーを settings.json、公開リポジトリの .env に書いたり、commit したりしてはいけません。

3. Chat Completions プロトコルを選ぶ

検証済みの BetterToken 設定では Chat Completions を選びます。VS Code が chatLanguageModels.json を開きます。

最小構成は次のとおりです。

[
  {
    "name": "BetterToken",
    "vendor": "customendpoint",
    "apiKey": "${input:betterTokenApiKey}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "YOUR_MODEL_ID",
        "name": "YOUR_MODEL_ID",
        "url": "https://www.bettertoken.ai/v1/chat/completions"
      }
    ]
  }
]

YOUR_MODEL_ID はプレースホルダーです。利用可能なモデルの正確な ID に置き換えます。ここで url は完全な Chat Completions endpoint です。Base URL https://www.bettertoken.ai/v1 だけではこのフィールドに十分ではありません。toolCalling、vision、Token コンテキスト制限は、選択したモデルの能力と現在の BetterToken ドキュメントに従う場合だけ追加してください。

4. VS Code ウィンドウを再読み込みする

ファイルを保存し、Command Palette で次を実行します。

Developer: Reload Window

再起動後に Copilot Chat の選択をもう一度開き、BetterToken グループのモデルを選びます。

5. 短いテストを行う

検証しやすい結果のリクエストを送ります。例：

次の二つのフィールドだけを含む JSON を返してください: language="ja" と sum=2+2。

接続が確認できるのは、次の三条件を同時に満たすときだけです。

• Copilot Chat が認証または Model ID エラーなしに有効な JSON を返す。
• リクエストが BetterToken Dashboard の利用履歴に現れる。
• inline completion は別に確認し、Custom Endpoint の結果として扱わない。

Chat は動くのに inline completion が変わらない理由

Custom Endpoint はモデルを Chat に接続します。Agent Host セッションで BYOK モデルを使うには、現在の実験的設定 chat.agentHost.byokModels.enabled が必要です。通常の Chat でリクエストが成功しても、Agent workflow の確認にはなりません。エディターに直接出る自動補完は GitHub Copilot の機能のままです。BetterToken リクエストが成功しても、公式 completions が確認されたことにはならず、同じ方法で消費されるわけでもありません。

VS Code の一部機能も GitHub サービスに依存します。セマンティック検索、inline suggestions、embeddings には GitHub アカウントとインターネット接続が必要で、プラン要件は機能ごとに異なります。モデルとの会話だけが必要なら、ローカル BYOK で足りる場合があります。Agent Host、completions、その他の統合 Copilot 機能では、現在の設定、プラン、組織ポリシーを別に確認してください。

よくある Custom Endpoint エラー

モデルが選択肢に現れない

VS Code が最新であること、chatLanguageModels.json にエントリーがあること、Model ID が完全一致していることを確認します。その後 Developer: Reload Window を実行します。管理対象デバイスでは、Business または Enterprise ポリシーがローカル BYOK を禁止していないか確認してください。

Error 401 または Invalid token

Add Models からモデルを再追加し、VS Code がキーを要求して Secret Storage に保存するようにします。JSON には実値でなく ${input:...} 参照が必要です。キーが自分の BetterToken アカウントのもので有効かも確認してください。

404 または model not found

apiType: "chat-completions" では完全な URL https://www.bettertoken.ai/v1/chat/completions を確認します。次に id を BetterToken ディレクトリの現在の Model ID と比較します。Base URL、完全な endpoint、Model ID は三つの別々の検証項目です。

Chat は応答するが completions は変わらない

これは期待される機能境界です。Custom Endpoint は inline completions を置き換えません。これらには対応する GitHub Copilot 機能への別のアクセスが必要です。

最終的に GitHub と BetterToken のどちらに依存するか

GitHub はアカウント、Copilot プラン、地域・組織上の制限、inline completions のような組み込み機能を制御します。このシナリオで BetterToken が担うのは、外部 OpenAI-compatible リクエスト、API Key、利用可能な Model ID、Dashboard の利用記録です。

設定前に、クライアントで現在の BYOK 対応を確認してください。その後 現在の BetterToken 手順を開き、VS Code の画面から Custom Endpoint を追加し、短いクエリと Dashboard エントリーで検証を完了します。

FAQ

有料 Copilot プランなしで Custom Endpoint を使えますか？

現在の VS Code では、BYOK Chat に有料 Copilot プランも GitHub サインインも必要ありません。セマンティック検索、inline suggestions、embeddings には GitHub アカウントとインターネット接続が必要で、プランと組織ポリシーは機能ごとに確認します。

BetterToken は GitHub Copilot サブスクリプションを置き換えますか？

いいえ。BetterToken は、クライアントが Custom Endpoint または BYOK をサポートする場所で外部モデルを接続します。GitHub アカウント、プラン、completions、その他の Copilot 機能は別です。

API Key を chatLanguageModels.json に保存できますか？

実際のキー値をこのファイルに書いてはいけません。VS Code ポップアップでキーを入力し、アプリが作成したシークレット参照を残してください。

この方式に VPN は必要ですか？

ロシアから BetterToken API Endpoint へ接続するために VPN は不要です。この説明は BetterToken endpoint にだけ当てはまります。GitHub サイト、サインイン、クライアントのダウンロード、更新、Copilot 機能は GitHub の条件とネットワークに従います。