Cursor で Claude Code のIDE統合ができない時の対処方法
2025.06.19はじめに
皆様こんにちは、あかいけです。
最近話題の Claude Code ですが、
Cursor で利用した際に IDE 統合がうまくいかない事象に遭遇したので、その解消方法を共有します。
筆者の環境
- macOS - Sequoia 15.3.1
- Cursor - 1.1.3
- Claude Code - 1.0.29
事象
npm で Claude Code をインストールしてログインなど初期設定が完了した後、
npm install -g @anthropic-ai/claude-code
IDE統合 を試してみたところ、以下のエラーが発生しました。
> /ide
Select IDE
Connect to an IDE for integrated development features.
No available IDEs detected. Make sure your IDE has the Claude Code extension or plugin installed and is running.
Claude Code のインストール自体は正常に完了しているようです。
> /doctor
✓ npm permissions: OK
Your installation is healthy and ready for auto-updates.
You can also install Claude Code locally to avoid npm permission issues using the slash command:
/migrate-installer
ただ、doctor で確認すると IDE Integration だけエラーが出ており、
IDE の再起動を促されています。
> /doctor
Claude Code Status v1.0.29
L Session ID: 9642773a-5136-4763-b593-b0f6f60e12d2
Working Directory
L /Users/user.name/github/blog-code
IDE Integration • /config
⚠ Error installing Cursor extension: 1: ENOENT
Please restart your IDE and try again.
Account • /login
L Auth Token: none
L API Key: /login managed key
L Organization: example
L Email: example@example.com
Model • /model
L Default (claude-sonnet-4-20250514)
その後 Cursor の再起動や Claude Code 自体の再インストールを試しましたが、
状態は変わりませんでした…。
解消方法
解消方法は以下の Gist の通りなのですが、一連の手順を記載します。
なお原因としては Claude Code 側が Cursor を互換性のある IDE として認識しないためのようです。
VSIX パッケージを探す
まずは Claude Code の VSIX パッケージ (拡張機能のファイル) を探します。
今回は npm でインストールしているので、以下のコマンドで Claude Code のインストール先を確認します。
% npm list -g @anthropic-ai/claude-code
/Users/user.name/.local/share/mise/installs/node/23.10.0/lib
└── @anthropic-ai/claude-code@1.0.29
対象となるファイル名は claude-code.vsix なので、これを検索結果のディレクトリ内から探します。
find /Users/user.name/.local/share/mise/installs/node/23.10.0/lib -name "claude-code.vsix" -type f
例として私の場合は以下のパスにありました。
/Users/user.name/.local/share/mise/installs/node/23.10.0/lib/node_modules/@anthropic-ai/claude-code/vendor/claude-code.vsix
インストールする
あとは見つけた VSIX をインストールするだけですが、
パスが長いのでわかりやすい場所に移動しておきます。
cp /Users/user.name/.local/share/mise/installs/node/23.10.0/lib/node_modules/@anthropic-ai/claude-code/vendor/claude-code.vsix ~/Downloads/
Cursor から CTRL + Shift + P でコマンドパレットを開いて、
拡張機能: VSIX からのインストール…を選択します。
先ほどダウンロードへ移動した claude-code.vsix を選択します。
インストールが完了したら、画面左下に以下のようなポップアップが出ます。
また拡張機能としても表示されるようになります。
この状態で /ide を実行すると、正常に Cursor と IDE 統合できるようになるはずです。
> /ide
Select IDE
Connect to an IDE for integrated development features.
❯ 1. Cursor✔
1. None
さいごに
以上、Cursor で Claude Code の IDE 統合ができない時の対処方法でした。
おそらく近いうちに Claude Code 側で修正してくれそうな気がしますが、
同じ症状でお困りの方の役に立てば嬉しいです。
