Claude Code VS Code 拡張の API キーとカスタムゲートウェイ設定
2026-10-07 時点で、Claude Code 公式ドキュメントが示す VS Code 拡張のカスタムゲートウェイ接続の確実な方法は、VS Code のユーザー設定の claudeCode.environmentVariables に ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN を書くことです。拡張は起動前にこの設定の認証情報を確認するためです。同じ 2 項目を ~/.claude/settings.json の env ブロックにも書けば、ターミナルの CLI と共有できます。QCode の場合は https://api.qcode.cc/api と cr_ で始まるキーを入れます。本ページでは手順、CLI との関係、キーが見つからない・ログインを求められる・モデル選択という 3 つのよくある問題をまとめます。
更新日 2026-10-08
最初に押さえる 4 点
QCode で必要な変数
ANTHROPIC_BASE_URL に https://api.qcode.cc/api（/api まで、末尾のスラッシュなし）、ANTHROPIC_AUTH_TOKEN にコンソールで作成した cr_ キーを設定します。
ゲートウェイの認証情報を置く確実な場所
公式ドキュメントによると、拡張は起動前に claudeCode.environmentVariables の認証情報を確認します。~/.claude/settings.json の値は起動されたプロセスには届きますが、拡張自身のログイン確認には届きません。
ターミナル CLI と共有する設定
~/.claude/settings.json は拡張と CLI で共有されます。env ブロックに同じ 2 項目を書けば、ターミナルの claude も同じゲートウェイに接続します。コミットされるプロジェクトの .claude/settings.json には書かないでください。
カスタム base URL 時のコンテキスト
2.1.285 以降、カスタム ANTHROPIC_BASE_URL を設定したセッションでは Opus 4.7 以降、Sonnet 5 以降、Fable がそのまま 1M で動作します。ゲートウェイが 200K までなら、公式の変更履歴は /autocompact 200k の実行を案内しています。
VS Code 拡張が設定を読む仕組み
2026-10-07 時点の答えは、拡張には 2 種類の設定があるということです。公式ドキュメントによると、VS Code の拡張設定は拡張自体の動作を制御し、~/.claude/settings.json は拡張と CLI で共有され、環境変数、許可するコマンド、hooks、MCP サーバーを書く場所です。カスタムゲートウェイでは、公式のゲートウェイ文書が認証情報を VS Code ユーザー設定の claudeCode.environmentVariables に置くよう案内しています。拡張が起動前にそこの認証情報を確認するためです。拡張はチャットパネル用に CLI のコピーを同梱していますが、claude を PATH には追加しません。統合ターミナルで claude を使うには CLI を別途インストールします。VS Code 1.94.0 以降が必要です。Claude の有料サブスクリプションや Console アカウントでサインインする場合 API キーは不要で、ゲートウェイでは認証情報の変数が claude.ai ログインの代わりになります。
最近の VS Code 関連の変更（2026-10-07 時点）
2026-10-07 時点で、GitHub Releases の最新版は 2.1.292（2026-10-06 公開、UTC）です。ゲートウェイ関連では、2.1.285 からカスタム ANTHROPIC_BASE_URL の背後のセッションが、1M ウィンドウを持つモデル（Opus 4.7 以降、Sonnet 5 以降、Fable）で 1M を使うようになり、公式の変更履歴はゲートウェイが 200K までなら /autocompact 200k を実行するよう書いています。2.1.280 では VS Code に Status ダイアログが追加され、/status と入力するとセッションのバージョン、アカウント、モデル、サーバー情報を確認できます。2.1.277 からは、プランの利用上限が適用されないサインイン（変更履歴では Vertex、Bedrock、Foundry、API key を列挙）で、Account & usage ダイアログにセッションの費用と token 使用量が表示されます。2.1.290 では、Claude Code が自身のプログラムを見つけられない、または起動できないときに、サインインや新規セッションが理由を示さない問題が修正されました。
リリースの時系列
2.1.261 リリース（UTC）：Disable Login Prompt を有効にしていても、Claude Code が未ログインと報告したときやログインがないためリクエストが失敗したときに、VS Code でサインイン画面が出る問題を修正。
2.1.280 リリース（UTC）：VS Code に Status ダイアログを追加。パネルで /status と入力するとセッションのバージョン、アカウント、モデル、サーバー情報を確認でき、設定が反映されたかを確かめやすくなりました。
2.1.285 リリース（UTC）：カスタム ANTHROPIC_BASE_URL を設定したセッションで、1M ウィンドウを持つモデル（Opus 4.7 以降、Sonnet 5 以降、Fable）がそのまま 1M で動作するように変更。
確認済み vs ドキュメントにないこと
確認済み（ドキュメントで逐語確認可能）
以下は Claude Code 公式ドキュメント、変更履歴、QCode ドキュメントで逐語的に確認できます：VS Code 1.94.0 以降、拡張は CLI を同梱するが PATH には追加しない、~/.claude/settings.json は拡張と CLI で共有、ゲートウェイの変数は claudeCode.environmentVariables に書き拡張は起動前にその認証情報を確認する、Disable Login Prompt は認証プロンプトを省略する、ANTHROPIC_AUTH_TOKEN は Authorization: Bearer、ANTHROPIC_API_KEY は x-api-key ヘッダーで送られる、認証情報の変数は保存済みの claude.ai ログインより優先される、ANTHROPIC_BASE_URL だけで認証情報がなければサブスクリプションのログインは置き換わらない、拡張と CLI は会話履歴を共有する、2.1.285 での 1M 既定ウィンドウへの変更、QCode の値 https://api.qcode.cc/api と cr_ キー。
ドキュメントにない・未確認のこと
次の 3 点は結論を出しません。① 2026-10-07 時点の公式の拡張設定表には、API キーや base URL 専用の設定項目は記載されていません。本ページは公式ドキュメントに載っている設定場所だけを扱い、その他の設定ファイルによる方法は対象外です。② ゲートウェイ側が設けたコンテキスト上限は Claude Code から検出できないと公式に書かれています。お使いのゲートウェイが 1M を通すかは、そのドキュメントか実測で確かめてください。③ 拡張の設定名やボタンはバージョンにより変わります。本ページは 2026-10-07 に取得した公式ドキュメントに基づき、各バージョンでの実機確認はしていないため、お手元のバージョンを優先してください。
どこに置くか、CLI との関係
environmentVariables と settings.json
両方に書くのが簡単です。claudeCode.environmentVariables は VS Code のユーザー設定で、Claude プロセスの環境変数を設定します。拡張は起動前にここの認証情報を確認するため、公式のゲートウェイ文書は認証情報をここに置いています。~/.claude/settings.json の env ブロックは拡張とターミナルの CLI で共有され、公式の VS Code ドキュメントは共有する設定をこちらに書くよう勧めています。後者だけだと値はプロセスに届いても拡張自身のログイン確認には届かず、前者だけだとターミナルの CLI とは共有されません。
VS Code 拡張とターミナル CLI
両者は同じ設定ファイルを読み、会話履歴も共有します。ターミナルで claude --resume を実行すれば拡張の会話を続けられます。違いは機能面で、公式の比較表では CLI がすべてのコマンドと skills を持ち、拡張はその一部（/ を入力して確認）です。! Bash ショートカットと Tab 補完は CLI のみです。拡張は claude を PATH に追加しないため、CLI は別途インストールが必要です。拡張で原因が分からないときは、ターミナルで claude を実行して詳しいエラーを見るよう公式は勧めています。
カスタムゲートウェイにつなぐ 5 ステップ
① 拡張をインストール：拡張機能ビュー（Cmd+Shift+X / Ctrl+Shift+X）で Claude Code を検索してインストールするか、ターミナルで code --install-extension anthropic.claude-code を実行します。VS Code 1.94.0 以降が必要です。② コマンドパレットで Preferences: Open User Settings (JSON) を実行し、claudeCode.environmentVariables に 2 項目を追加します。name が ANTHROPIC_BASE_URL で value が https://api.qcode.cc/api、name が ANTHROPIC_AUTH_TOKEN で value が cr_ キーです。③ それでもログイン画面が出る場合は、設定で Claude Code login を検索し Disable Login Prompt にチェックを入れます（公式はサードパーティ構成で認証プロンプトを省略する設定と説明しています）。④ ターミナルの CLI と共有するなら、~/.claude/settings.json（Windows は %USERPROFILE%\.claude\settings.json）の env ブロックに同じ 2 項目を書きます。プロジェクトの .claude/settings.json には書かないでください。⑤ Developer: Reload Window を実行し、パネルで /status と入力してバージョン、アカウント、モデル、サーバー情報を確認してから、テストメッセージを送ります。
QCode では
QCode では、2 つの値を QCode ドキュメントどおりに設定します：ANTHROPIC_BASE_URL=https://api.qcode.cc/api（/api まで、末尾のスラッシュなし）、ANTHROPIC_AUTH_TOKEN は cr_ で始まるキー（コンソールで作成）で、Claude Code はこれを Bearer トークンとして送ります。Claude モデルは Anthropic プロトコルのエンドポイントでのみ使え、VS Code 拡張が使うのもこのプロトコルです。QCode で呼び出せる Claude モデルには claude-sonnet-5-5、claude-opus-5-5、claude-sonnet-5 などがあり、料金は token 単位の従量制で各モデルの単価は /models に掲載、Claude 系列には長短の料金区分がありません。北米と欧州では us.qcode.cc（ロサンゼルス）が使え、中国本土のネットワークではドキュメントが asia.qcode.cc を勧めています。パスは同じで、キーも共通です。各リクエストは probe.qcode.cc でキーを入力すると確認できます。
よくある質問
VS Code の Claude Code で API キーとカスタム base URL はどこに入力しますか？
VS Code ユーザー設定の claudeCode.environmentVariables に入力します。コマンドパレットで Preferences: Open User Settings (JSON) を実行し、ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN の 2 項目を追加します。QCode なら https://api.qcode.cc/api と cr_ キーです。2026-10-07 時点の公式の拡張設定表には、API キーや base URL 専用の設定項目は記載されていません。公式のゲートウェイ文書は、拡張が起動前にこの設定の認証情報を確認するため、ここがゲートウェイの認証情報を置く確実な場所だとしています。
ターミナルで export したのに、拡張がキーを見つけられないのはなぜですか？
多くの場合、変数が VS Code に届いていません。公式ドキュメントによると、shell の export はそのターミナルセッションと、そこから起動したプログラムにしか効かず、Dock やスタートメニューから起動したエディタには見えません。~/.claude/settings.json の env ブロックに書くだけでも不十分で、その値は起動されたプロセスには届きますが、拡張自身のログイン確認には届きません。2 項目を claudeCode.environmentVariables に書き、Developer: Reload Window を実行し、パネルで /status と入力して確かめてください。
設定したのに、まだログインを求められるのはなぜですか？
たいていは、拡張のログイン確認が認証情報を見つけられていません。まず認証情報が claudeCode.environmentVariables にあり、ANTHROPIC_BASE_URL だけを設定した状態でないかを確かめてください。公式ドキュメントによると、base URL だけで認証情報の変数がなければサブスクリプションは置き換わらず、保存済みの claude.ai ログインが有効な認証情報のままです。それでもログイン画面が出るなら、設定で Claude Code login を検索して Disable Login Prompt にチェックを入れます。2.1.261 でこの設定を有効にしてもサインイン画面が出る問題が修正されたので、古いバージョンは先に更新してください。起動時に 2 つの認証情報の出どころを挙げ auth may not work as expected で終わる警告が出たら、公式の対処は /logout を実行してゲートウェイの認証情報だけを残すことです。
VS Code 拡張とターミナル CLI で設定を共有できますか？
できます。~/.claude/settings.json を共有します。公式ドキュメントによると、ターミナル、VS Code と JetBrains の拡張、デスクトップアプリは同じ設定ファイルを読みます。env ブロックに ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN を書けば、ターミナルの claude も同じゲートウェイに接続します。shell の export と設定ファイルの env ブロックで同じ変数を設定した場合は、設定ファイルの値が使われます。会話履歴も共有されるので、ターミナルで claude --resume を実行すれば拡張の会話を続けられます。なお拡張は claude を PATH に追加しないため、CLI は別途インストールが必要です。
モデルはどう選びますか？ 使いたいモデルが選択肢にない場合は？
入力欄の下のモデル表示をクリックするか、/model と入力して選びます。環境変数 ANTHROPIC_MODEL や設定ファイルの model フィールドでも指定できます。公式ドキュメントによると、/model は選択をユーザー設定の model フィールドに書き込み新しいセッションの既定にするため、拡張と CLI は同じ既定値を読みます。ゲートウェイのモデル名が Claude Code の内蔵リストにない場合、公式の対処は CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 を設定して、ゲートウェイのモデル一覧を選択肢に読み込むことです。QCode では claude-sonnet-5-5、claude-opus-5-5、claude-sonnet-5 を指定でき、現在の一覧は /models で確認できます。
ANTHROPIC_AUTH_TOKEN と ANTHROPIC_API_KEY のどちらを使いますか？
QCode では ANTHROPIC_AUTH_TOKEN を使います。公式ドキュメントによると、これは Authorization: Bearer ヘッダーで送られ、ANTHROPIC_API_KEY は x-api-key ヘッダーで送られます。認証情報を違う変数に入れると、ゲートウェイが読まないヘッダーで届いて 401 で失敗するので、もう一方の変数に替えて試してください。QCode ドキュメントはキーを ANTHROPIC_AUTH_TOKEN に置く決まりにしており、ANTHROPIC_API_KEY しか読まないツールでも同じ cr_ キーで使えます。もう一つの違いとして、ANTHROPIC_API_KEY は対話モードで最初に一度承認が必要ですが、ANTHROPIC_AUTH_TOKEN は保存済みのログインより直ちに優先されます。
情報源
設定場所と拡張の動作：Claude Code 公式ドキュメントの VS Code ページ（code.claude.com。前提条件、拡張設定表、サードパーティ構成の手順、CLI との比較、よくある問題）と、LLM ゲートウェイへの接続、LLM ゲートウェイ概要、認証、設定、環境変数、モデル設定の各ページ。いずれも 2026-10-07 に取得。バージョンの変化：anthropics/claude-code リポジトリの CHANGELOG と GitHub Releases の公開日時（UTC）、同日取得。QCode 側の値：QCode ドキュメントの環境変数設定ページ（2026-09-25 更新）、エンドポイントと API 形式のページ、VS Code 連携ページ（2026-09-18 更新）、/models ページ、同日取得。
関連記事
ANTHROPIC_BASE_URL と AUTH_TOKEN の設定ガイド
Claude Code を独自エンドポイントに向ける 2 つの環境変数と settings.json の書き方。
Claude Code 使い方ガイド
インストールから日常の使い方までの完全チュートリアル。
Claude Code 中国利用完全ガイド
中国本土の開発者向けに、Claude Code と Codex API の接続方法と Alipay での支払いをまとめています。
本ページの手順と引用は 2026-10-07 に Claude Code 公式ドキュメント、変更履歴、QCode ドキュメントで確認したものです。上流の変更は予告なく行われることがあります。拡張の画面や設定名はバージョンにより変わるため、お手元のバージョンを優先してください。モデルの提供状況は /models をご確認ください。