Cursor で Claude Code 使えない原因と対処法｜接続エラー解決

目次

• Cursor で Claude が使えないときに最初に確認する 3 項目
• IDE is not connected エラーの解決手順
• Spark アイコン・拡張機能が表示されないときの対処
• ログイン・認証エラーで Claude Code が動かない場合
• Cursor が重い・固まる・クラッシュするときの対策
• /migrate-installer 後に PATH が壊れた場合の修復
• どうしても使えないときの最終手段
• まとめ

Cursor で Claude が使えないときに最初に確認する 3 項目

「Cursor で Claude Code が使えない」と感じたとき、再インストールに走る前に確認すべき項目は次の 3 つです。原因の 8 割はこの初動チェックで切り分けられます。

1. Cursor のバージョンが Claude Code 拡張に対応しているか。Cursor は更新頻度が高く、拡張機能側が追随していない期間が稀に発生します。Help > About で確認し、Cursor 公式の Changelog で Claude Code 連携の対応バージョンを照合してください。
2. Claude Code 拡張機能のステータス。Cmd+Shift+X で拡張機能パネルを開き、Anthropic 公式の Claude Code が Enabled 表示になっているかを確認します。Disabled や Reload Required の場合は有効化と再読み込みで復旧します。
3. エディタにファイルを開いているか。Cursor は「ファイルを開いていない状態では Spark アイコンを描画しない」仕様のため、ようこそ画面のままだとどれだけ操作しても起動しません。任意の .txt や README を開いてから右上を確認してください。

この 3 項目で症状が消えるなら以降の章は不要です。残るときは症状別の章へ進みます。

IDE is not connected エラーの解決手順

cursor + claude code: IDE is not connected というエラーは、Claude Code CLI と Cursor の双方向接続が確立されていないときに表示されます。Cursor を再起動する前に、まず CLI 側からの接続再確立を試すと数秒で解決します。

手順 1: Claude Code CLI で /ide コマンドを実行

ターミナルで claude を起動し、起動後の入力欄で /ide を入力します。Cursor が起動中であれば自動検出され、Connected to Cursor というメッセージが表示されます。これだけで接続が復旧することが多く、再インストールは不要です。

手順 2: ターミナルから cursor . で起動し直す

GUI からの起動だと環境変数や PATH が引き継がれず、CLI と Cursor が別の Claude Code バイナリを参照していることがあります。ターミナルで cursor . を実行すると、シェル環境変数を引き継いだ Cursor が立ち上がり、claude コマンドとの接続経路が一致します。

手順 3: claude-code.vsix を手動インストール

それでも繋がらない場合、拡張機能の実体が壊れている可能性があります。~/.claude/ 配下の claude-code.vsix を探し、Cursor のコマンドパレット(Cmd+Shift+P)で Extensions: Install from VSIX... を選んで読み込ませます。クラスメソッドの DevelopersIO 記事でも同じ手順が IDE 統合の確定解として紹介されています(DevelopersIO)。

Spark アイコン・拡張機能が表示されないときの対処

右上に出るはずの Spark アイコン(Claude のロゴ)が表示されないとき、現場で頻発する原因は次の順に多いです。

原因 A: ファイルを開いていない

Cursor は「アクティブなエディタタブがある状態」でのみ Spark アイコンを表示します。ようこそ画面・空のワークスペース・サイドバー全閉じ状態では非表示が正常な挙動です(Carpe Diem)。任意のファイルを開いてください。

原因 B: 拡張機能が無効化されている

Cursor のバージョン更新時に Claude Code 拡張が自動で Disabled になるケースがあります。拡張機能パネルから Enable を押し、Reload で再読み込みします。

原因 C: 拡張機能パネルから検出できない

Cursor の拡張機能検索で Claude Code が出てこない場合、Cursor のマーケットプレイスではなく VS Code Marketplace 経由で配信されているバージョンを直接取得する必要があります。Anthropic 公式リンクから .vsix をダウンロードして手動インストールするのが確実です。

原因 D: WSL や Remote SSH 環境

Remote 環境では拡張機能を「ホスト側」と「リモート側」のどちらに入れるかで挙動が変わります。Claude Code は リモート側にインストール する必要があり、ホスト側だけだと Spark アイコンが描画されません。

ログイン・認証エラーで Claude Code が動かない場合

「Sign in」が出続ける、ANTHROPIC_API_KEY is not set で止まる、ブラウザ認証が完了しないといった認証系トラブルは、原因が 3 つに集約されます。

原因 1: 環境変数が引き継がれていない

シェルで ANTHROPIC_API_KEY をエクスポートしているのに Cursor が認識しない場合、GUI 起動だと .zshrc や .bashrc が読み込まれていません。ターミナルから cursor . で起動し直すか、macOS なら launchctl setenv で GUI セッションにも値を渡します。

原因 2: OAuth 認証のリダイレクトが失敗

ブラウザで Anthropic アカウントの認証画面が表示されない、または認証後に「コールバックを待っています」のまま固まる場合、ブラウザのポップアップブロッカーや拡張機能(uBlock Origin 等)が干渉している可能性があります。プライベートウィンドウで再試行するのが最短です。

原因 3: Claude Max プランの未契約・サブスク切れ

Claude Code は Claude Max プラン(月額契約)が前提で、API キー単独運用ではモデル選択に制限がかかります。claude 起動時に「subscription required」が出る場合は Anthropic コンソールで契約状態を確認してください。

Cursor が重い・固まる・クラッシュするときの対策

長時間使うと Cursor が重くなる、エディタが応答しなくなる、突然落ちる——この症状はメモリリークが主因です。

対策 1: ターミナル履歴を定期クリア

Claude Code は内部でターミナル履歴をコンテキストに保持し続けるため、長セッションで GB 級のメモリを消費します。Cmd+K でターミナルをクリアするか、claude を /clear で履歴リセットすると改善します。

対策 2: タブを 10 個以下に保つ

Cursor は開いているタブの内容を AI コンテキストに含めるため、大量のタブを開くと推論コストとメモリ使用量が同時に増えます。aitools-zukan の検証記事でも、タブ数削減と長時間セッションの分割がクラッシュ抑制に効くと報告されています(aitools-zukan)。

対策 3: 拡張機能を最小構成にする

Cursor 標準の Composer や Tab 補完と Claude Code 拡張が同時稼働すると、メモリ競合でクラッシュしやすくなります。Claude Code を主に使う場合、Cursor の Tab 補完を一時的に無効化することで安定します(note.com)。

/migrate-installer 後に PATH が壊れた場合の修復

Claude Code CLI の /migrate-installer を実行した直後に IDE 連携が動かなくなる事象が報告されています。これは migration 後にバイナリ配置先が変わり、Cursor が古いパスを参照し続けるためです。

修復手順は以下のとおりです。

1. ターミナルで which claude を実行し、現在の参照先を確認
2. ~/.claude/local/claude など migration 後の新しいパスがあれば、echo 'export PATH="$HOME/.claude/local:$PATH"' >> ~/.zshrc で先頭に追加
3. Cursor を完全終了(Cmd+Q)し、ターミナルから cursor . で再起動
4. Claude Code 拡張の設定で claude.executablePath を新パスに上書き

これで CLI と Cursor が同じバイナリを指すようになり、IDE 統合が再び動きます。

どうしても使えないときの最終手段

ここまでの手順で復旧しない場合、選択肢は次の 3 つです。

1. VS Code 版 Claude Code への乗り換え

Cursor と VS Code は拡張機能 API が共通しているため、設定ファイルを引き継いだまま VS Code 側で Claude Code を動かせます。Zenn の検証記事では VS Code 版のほうがメモリ安定性が高く、長時間セッションでクラッシュしにくいと報告されています(Zenn)。

2. Cursor と Claude Code の完全アンインストール → 再導入

~/.cursor と ~/.claude を退避してから両方をアンインストールし、Cursor → Claude Code 拡張の順で入れ直します。設定が壊れているケースの最終解です。

3. Claude Code 単独の CLI 運用に切り替え

IDE 統合に固執せず、ターミナルだけで claude を起動して使うのも選択肢です。Cursor は別途エディタとしてだけ使い、AI 連携は CLI と切り離す運用は破綻が少なく、サブスク切れ判定や障害対応も簡単になります(株式会社 Uravation)。

まとめ

Cursor で Claude Code が使えない症状は「接続・表示・認証・クラッシュ・PATH」の 5 系統に必ず分類できます。再インストールに走る前に、/ide コマンド・cursor . 起動・VSIX 手動インストール・タブ削減・PATH 修復の 5 手順を順に試せば、現場で発生する 9 割の症状が復旧します。それでも止まるなら VS Code 版や CLI 単独運用への切り替えが正解で、Cursor に固執しないほうが結果的に開発速度を落としません。

出典

• Cursor で Claude Code の IDE 統合ができない時の対処方法｜DevelopersIO
• Claude Code が重いときの対処法(Cursor 対応)｜aitools-zukan
• Cursor で Claude Code がクラッシュする問題対策｜note papapenpal
• Cursor から乗り換えた人向け、VSCode 版 Claude Code を使いやすくする 6 つの設定｜Zenn
• Cursor 上で Claude Code のアイコンが出ない｜Carpe Diem
• Claude が使えない・繋がらない時は？障害確認 3 ステップ｜株式会社 Uravation