VSCode で Claude が使えない時の対処｜起動しない・IDE 未検出

まず確認:診断コマンド /doctor と前提条件 {#first-check}

個別の対処に入る前に、原因を機械的に切り分けます。Claude Code が起動するなら、プロンプトボックスで /doctor を実行してください。インストール状態・設定の有効性・MCP サーバー設定・コンテキスト使用量を一度に自動チェックしてくれます。そもそも claude がまったく起動しない場合は、シェル(ターミナル)から claude doctor を実行すると同等の診断が走ります。

あわせて前提条件を確認します。公式が求める条件は次の 2 つです。

1. VS Code 1.98.0 以上(Help → About で確認)
2. Anthropic アカウント(拡張を初めて開いたときにサインイン)

ここで見落としやすいのが料金プランです。無料の Claude.ai プランには Claude Code が含まれず、拡張をインストールしても起動しません。最低でも Pro 以上の購読、または Console アカウント(API)が必要です。料金体系の整理は別記事「Claude を VSCode で使う料金」も参照してください。

出典:トラブルシューティング — Claude Code Docs / VS Code で Claude Code を使用する — Claude Code Docs

拡張機能がインストールできない・表示されない {#install-fail}

「Marketplace からインストールしようとすると失敗する」「インストールしたのに拡張一覧に出てこない」場合は、次の順で対処します。

1. VS Code のバージョンを確認 — 1.98.0 以上が必須です。古いと拡張が互換性エラーで入りません
2. インストール権限を確認 — VS Code に拡張をインストールする権限があるか確認します(企業端末では制限されていることがあります)
3. Marketplace から直接インストール — 拡張ビューの検索で入らない場合は、VS Code Marketplace のページから直接インストールを試します
4. インストール後に表示されない — VS Code を再起動するか、コマンドパレット(Cmd+Shift+P / Ctrl+Shift+P)で 「Developer: Reload Window」 を実行します

Cursor・Windsurf・Kiro などの VSCode フォークでも同じ拡張が動きます。どうしても拡張が入らないエディタでは、統合ターミナルで claude を実行すれば CLI としてそのまま利用できます。

出典:VS Code で Claude Code を使用する — Claude Code Docs

Spark アイコンが出ない・パネルが開かない {#no-spark-icon}

拡張は入っているのに、起動の入口である Spark(✱)アイコンが見当たらない——これは「使えない」相談で最も多いパターンです。Spark アイコンは ファイルを開いているとき にエディタ右上のツールバーに表示されます。出ないときは次を順に試します。

1. ファイルを開く — フォルダを開いただけでは表示されません。何らかのファイルをエディタで開きます
2. VS Code バージョンを確認 — 1.98.0 以上(Help → About)
3. ウィンドウをリロード — コマンドパレットで「Developer: Reload Window」を実行します
4. 競合する AI 拡張を無効化 — Cline・Continue など他の AI 拡張を一時的に無効にします
5. ワークスペース信頼を確認 — 制限モード(Restricted Mode)では拡張が機能しません。信頼済みワークスペースとして開き直します

それでも見つからないときの代替起動口として、ウィンドウ右下の ステータスバーの「✱ Claude Code」 をクリックする方法があります。こちらはファイルを開いていなくても機能します。コマンドパレットで「Claude Code」と入力して起動コマンドを選ぶ手もあります。

出典:VS Code で Claude Code を使用する — Claude Code Docs

サインインできない・「Please run /login」が消えない {#signin-loop}

パネルは開くのにサインインが完了せず、「Not logged in · Please run /login」 が出続ける場合の対処です。

1. 自動再表示を待つ — このメッセージが出ると、拡張はサインイン画面を自動的に再度開きます
2. ウィンドウをリロード — 再表示されないときはコマンドパレットで「Developer: Reload Window」を実行します
3. 環境変数を継承させる — ANTHROPIC_API_KEY をシェルに設定しているのにサインインを求められる場合、VS Code がシェル環境を継承していない可能性があります。ターミナルから code . で VS Code を起動して環境変数を引き継がせるか、Claude アカウントでサインインします

なお前述のとおり、無料の Claude.ai プランでは認証を通しても Claude Code は起動しません。「サインインはできたのに動かない」場合は、プランが Pro 以上(または Console アカウント)かどうかを確認してください。

出典:VS Code で Claude Code を使用する — Claude Code Docs

v2.1.51 で Windows 全体が起動不能になったバグと回避 {#v2151-bug}

「昨日まで使えていたのに、更新したら急に動かなくなった」場合は、拡張機能側の既知バグを疑います。2026 年にリリースされた Claude Code for VS Code v2.1.51 には、Linux 向けビルドのパスが Windows ビルドに誤って混入し、ファイル読み込みに失敗してアクティベーション(拡張の有効化)ができなくなる不具合がありました。

これは環境や操作の問題ではなく構造的なバグで、Windows ユーザー全体が同じエラーに遭遇 しました。やっかいなのは、再インストールや再起動では直らない点です(最新版が再度インストールされ、同じバグが入り直すため)。回避策は安定版へのダウングレードです。

1. 拡張機能パネルで Claude Code を右クリックします
2. 「別のバージョンをインストール」 を選びます
3. 確認済みの安定版である v2.1.49 をインストールします
4. VS Code を再起動します

再発を防ぐため、続けて拡張を右クリックして 「自動更新を無効にする」 を選んでおきます(他の拡張の自動更新には影響しません)。ユーザーデータや会話履歴はダウングレードしても保持されます。修正版の v2.1.52 が既にリリースされているため、現在は最新版へ更新すれば解決します。Windows のエラーログは %APPDATA%\Code\logs で確認できます。

出典:Claude Code VS コード拡張機能が起動しない不具合を解決する方法 — AIHackDeck

Claude が応答しない・フリーズする {#no-response}

サインインも済み、画面も開いているのにプロンプトを送っても反応しない場合は、次の順で切り分けます。

1. インターネット接続を確認 — 安定した接続があるか確認します
2. 新しい会話を開始 — 別の会話を立ち上げて、問題が続くか確認します
3. CLI で詳細エラーを見る — 統合ターミナルで claude を実行すると、より詳しいエラーメッセージが表示される場合があります

操作中にコマンドがハング(フリーズ)したときは、まず Ctrl+C で現在の操作をキャンセルします。それでも反応しなければターミナルを閉じて再起動します。会話は失われないので、同じディレクトリで claude --resume を実行すればセッションを再開できます。

大規模なコードベースで CPU やメモリ使用量が高く重い場合は、/compact でコンテキストを定期的に圧縮し、タスクの区切りで Claude Code を閉じて再起動し、巨大なビルドディレクトリを .gitignore に加えると安定します。

出典:トラブルシューティング — Claude Code Docs / VS Code で Claude Code を使用する — Claude Code Docs

ターミナルで「IDE が検出されない」・WSL で不安定なとき {#ide-not-detected}

CLI から使おうとして IDE 連携が効かない、WSL で挙動が不安定、というケースです。まず連携の基本動作を押さえます。

1. 統合ターミナルで起動する — VS Code の統合ターミナル(Ctrl+\`` / Cmd+``)で claude を実行すると、自動的に IDE と統合され、差分表示や診断共有が使えます
2. 外部ターミナルなら /ide — VS Code の外のターミナルで起動した場合は、Claude Code 内で /ide を実行して VS Code に接続します
3. code . で起動する — VS Code が code コマンドとして PATH に通っていないと連携できません。ターミナルから code . で開き直すと環境を引き継げます

WSL 特有の問題として、検索結果が想定より少なくなる 現象があります。Windows と Linux のファイルシステムをまたぐ読み取りペナルティが原因で、検索自体は動くものの一部のマッチが返りません(この場合 /doctor は Search を OK と表示します)。対処は次のとおりです。

1. 検索を具体的にする — ディレクトリやファイルタイプを絞って検索対象を減らします
2. プロジェクトを Linux 側へ置く — /mnt/c/ ではなく /home/ 配下に置くとパフォーマンスが改善します
3. ネイティブ Windows を検討 — WSL ではなく Windows でネイティブに動かす選択肢もあります

また @file メンションやカスタムスキルがファイルを見つけられないときは、同梱の ripgrep が動いていない可能性があります。OS の ripgrep(例:Ubuntu なら sudo apt install ripgrep、Windows なら winget install BurntSushi.ripgrep.MSVC)を入れ、環境変数 USE_BUILTIN_RIPGREP=0 を設定すると解決します。

出典:トラブルシューティング — Claude Code Docs / VS Code で Claude Code を使用する — Claude Code Docs

それでも直らないときの初期化とログ確認 {#reset-and-logs}

ここまでで解決しない場合は、設定の初期化とログ確認に進みます。

1. 拡張データを削除してリセット — すべての設定をリセットするには、rm -rf ~/.vscode/globalStorage/anthropic.claude-code を実行してから VS Code を開き直します
2. 拡張ログを確認 — コマンドパレットで「Claude Code: Show Logs」を実行すると、認証エラーやポート競合などのデバッグログが見られます(Windows のシステムログは %APPDATA%\Code\logs)
3. 問題を報告 — Claude Code 内の /feedback コマンド、または GitHub の Issues で既知の問題を確認・報告します

切り分けの最短ルートは、まず /doctor(起動しなければ claude doctor)で全体診断 → 症状に応じて本記事の該当セクションへ という流れです。多くの「使えない」は、対応バージョン・サインイン・既知バグ・IDE 連携のいずれかに帰着するため、上から順に当たれば大半は復旧できます。

出典:VS Code で Claude Code を使用する — Claude Code Docs / トラブルシューティング — Claude Code Docs

出典

• VS Code で Claude Code を使用する — Claude Code Docs(前提条件・サインイン・一般的な問題の修正)
• トラブルシューティング — Claude Code Docs(/doctor 診断・WSL 検索・ripgrep)
• Claude Code VS コード拡張機能が起動しない不具合を解決する方法 — AIHackDeck(v2.1.51 バグとダウングレード手順)