VS Code の Claude Code：接続と統合の確認

統合を構成する三つの層

「Claude Code が応答しない」場合でも、原因は次の独立した層のどれかです。

CLI。 公式拡張機能には統合ターミナル用の Claude Code CLI が含まれます。拡張機能の外で CLI を使う場合だけ、別途システムへインストールします。

VS Code 拡張機能。 Anthropic の公式拡張機能は、チャット、並列 diff、@ によるファイル参照、セッション履歴を提供します。確認時点で公式ドキュメントは VS Code 1.98.0 以降を必要としていました。

API エンドポイント。 Claude Code は既定で Anthropic API を使用します。BetterToken では ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN を設定し、拡張機能が Claude Code に渡します。Dashboard の成功記録は BetterToken の受信を示しますが、IDE 統合はファイルのコンテキストと diff でも確認します。

自分の BetterToken アカウントで API キーを作成し、Base URL はドキュメントから取得してください。

API キーの作成と Claude Code の設定: docs.bettertoken.ai/ai-tools/claude-code

API キーを作成してエンドポイントを接続する

手順 1. アカウントと API キーを作成する

bettertoken.ai で登録し、キー管理画面で新しい API キーを作成してコピーします。

手順 2. Base URL を確認する

Claude Code では、次の Anthropic 互換 Base URL を使用します。

https://www.bettertoken.ai

/v1 は追加しません。Claude Code がメソッドのパスを追加します。/v1 付きのアドレスは Codex CLI など OpenAI 互換ツール用です。

手順 3. ~/.claude/settings.json を編集する

macOS/Linux では ~/.claude/settings.json、Windows では %USERPROFILE%\.claude\settings.json を開き、env を追加します。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "your_api_key_here"
  }
}

your_api_key_here を作成したキーに置き換えます。ほかの項目がある場合は "env" だけを追加します。CLI と拡張機能は同じファイルを読みます。

手順 4. ログイン画面を無効にする

VS Code の設定（Mac は Cmd+,、Windows/Linux は Ctrl+,）で Extensions → Claude Code を開き、Disable Login Prompt を有効にします。これは外部プロバイダー用に Anthropic のログイン画面を隠すだけで、env の設定は必要です。

VS Code から Claude Code を起動する

手順 5. 拡張機能をインストールする

Mac では Cmd+Shift+X、Windows/Linux では Ctrl+Shift+X を押し、Anthropic の「Claude Code」を Install します。アイコンが出ない場合はコマンドパレットで Developer: Reload Window を実行します。Help → About で VS Code 1.98.0 以降も確認します。

手順 6. パネルを開く

ファイルを開くと Editor Toolbar に Spark アイコン（✱）が表示され、チャットを開けます。ほかに Activity Bar の Spark、Cmd+Shift+P / Ctrl+Shift+P の「Claude Code: Open in New Tab」、右下 Status Bar の ✱ Claude Code（ファイルなしでも可）があります。

手順 7. 現在のファイルのコンテキストを確認する

コードを数行選択すると、Claude Code が入力欄の下に行数を示します。Mac は Option+K、Windows/Linux は Alt+K で @file.ts#5-10 のような参照を追加できます。

コンテキスト、diff、Dashboard を確認する

手順 8. 低リスクのテストを送る

小さなスクリプトまたは設定ファイルで、取り消せる変更を依頼します。

最初の関数の前に、その役割を簡潔に説明する一行コメントを追加してください。

または:

このファイルの変数 `tmp` を `result` に名前変更してください。

手順 9. 並列 diff を確認する

拡張機能は変更前後を表示して許可を求めます。確認して Accept または Reject を選びます。有意味な diff は、モデルの応答が現在のファイルに適用されたことを示します。

手順 10. BetterToken Dashboard でリクエストを探す

bettertoken.ai の Dashboard または履歴で、テスト時刻の記録を探します。モデル、状態、入力・出力・キャッシュ Token、課金を照合します。VS Code の diff と同時刻の成功記録があれば、コンテキスト送信、BetterToken 処理、IDE への応答返却を確認できます。

検出されない場合の確認

Spark アイコンが表示されない

Editor Toolbar のアイコンには開いたファイルが必要です。VS Code 1.98.0 以降を確認し、Developer: Reload Window を実行し、Cline、Continue、GitHub Copilot を一時的に無効化します。Status Bar の ✱ Claude Code はファイルなしでも使えます。

ターミナルの環境変数を継承しない

ANTHROPIC_BASE_URL が shell にあってもログインを求める場合、Spotlight やアプリメニューから起動した VS Code は環境を継承していません。ターミナルから起動します。

code .

または Extensions → Claude Code → environmentVariables に変数を設定します。

拡張機能が再びログインを求める場合

Disable Login Prompt が有効か確認してください。この設定は Anthropic のログイン画面を無効にしますが、接続用の変数は別途設定したままにする必要があります。

変更した設定が読み込まれない場合

settings.json のパスと JSON を確認します。余分なカンマや閉じていない括弧があると env は読み込まれません。Developer: Reload Window を実行し、shell や拡張機能の設定に古い Base URL やキーが残っていないかも確認します。

401 または応答がない

https://www.bettertoken.ai に /v1 を付けていないこと、API キーに空白・改行・余分な引用符がないこと、別の ANTHROPIC_AUTH_TOKEN や ANTHROPIC_BASE_URL が上書きしていないことを確認します。Dashboard に記録がなければ送信、エンドポイント、ネットワークを確認し、401 はキーまたは形式を示します。設定の項目名は常に現在の BetterToken ドキュメントで確認してください。

BetterToken の Claude Code 完全ガイド: docs.bettertoken.ai/ai-tools/claude-code