🙄

Claude CodeがVSCoed(Cursor, Windsurf)にインストールできない時の対処法

に公開
VS Code
Cursor
Claude
Claude Code
Vibe Coding
tech

2025年5月23日に嬉しいニュースが飛び込んできましたね！
Claude CodeがついにVSCodeやJetBrains IDEs上で利用できるようになりました🎉

これまでコマンドラインでのみ利用できていたClaude Codeが、コマンド一発で拡張機能としてインストールできるように。
現在はストアでの公開はまだですが、Cline系と同様の体験を得られてvibe codingが捗りそうです。

ところが早速インストールしようとしたところ、なぜかインストールできず。。。
色々と試行錯誤した結果、無事インストールに成功したので、対処法について記載します。

🚀 まずは正規のインストール方法

通常のインストールはとてもシンプル。てかこれ地味にいい体験ですよね。
VSCode（またはCursor、Windsurf）内のターミナルで claude コマンドを実行するだけで、IDEを自動検知してインストールを実行してくれます。

# Claude Codeをまだインストールしていない場合
npm install -g @anthropic-ai/claude-code

# VSCodeを起動して、VSCode内のターミナルでコマンド実行
claude

🔧 インストールできない場合の対処法

なぜか上記の方法で、どうやってもうまくいかなかったのですが、、、
結論は、Claude Codeパッケージに含まれているVS Code拡張機能ファイル（claude-code.vsix）を見つけて、直接インストールすればOKでした。

事前準備

まず、code コマンドが使えることを確認しましょう。これがないと手動インストールができません。

手順

方針としては、以下のコマンドでインストールしたパッケージに含まれる claude-code.vsix を見つけて、それを使って直接インストールを行います。

npm install -g @anthropic-ai/claude-code

以下の手順がおすすめです。

# 1. claude コマンドのインストール場所を確認
$ which claude
~/.nodebrew/current/bin/claude

# ⚠️ 注意：nodeマネージャー（nodebrew、nvm、n など）によってパスは変わります

# 2. シンボリックリンクの実体を確認
ls -l ~/.nodebrew/current/bin/claude
lrwxr-xr-x - user 27 5  11:58 ~/.nodebrew/current/bin/claude -> ../lib/node_modules/@anthropic-ai/claude-code/cli.js

# 3. 拡張機能ファイルの存在確認（念のため）
ls -l ~/.nodebrew/current/lib/node_modules/@anthropic-ai/claude-code/vendor/claude-code.vsix

# 4. 手動インストール実行
code --install-extension ~/.nodebrew/current/lib/node_modules/@anthropic-ai/claude-code/vendor/claude-code.vsix

パスは環境に応じて適宜読み替えてください。重要なのは @anthropic-ai/claude-code/vendor/claude-code.vsix の部分です。

2の部分で、 ../lib/node_modules/@anthropic-ai/claude-code/cli.js となっていることから、インストールしているパッケージ（@anthropic-ai/claude-code）は ~/.nodebrew/current/lib/node_modules/@anthropic-ai/claude-code にあるとわかります。
そして拡張機能のファイル claude-code.vsix は @anthropic-ai/claude-code/vendor/claude-code.vsix にあるので使ってインストールする形です。

😵 私が遭遇した問題と症状

インストール後、VSCodeでClaude Codeを確認してみると...なぜかIDEが検出されない状況に。

/ide コマンドで確認すると、こんな表示が：

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.

日本語で言うと「利用可能なIDEが検出されません。IDEにClaude Codeの拡張機能がインストールされ、実行されていることを確認してください」という状況。

普段 tmux + fish を使っているので、bash への切り替え、Claude Code の再インストールなど色々試しましたが、なかなか解決せず...

/status コマンドでも状況を確認してみました：

 Claude Code Status v1.0.3
 Working Directory 
  L ************/path/to/project
 IDE Integration • /config
 ⚠  Error installing VS Code extension: 1: ENOENT
    Please restart your IDE and try again.
 Account • /login
  L Login Method: API Key (/login managed key)
  L Organization: *********
  L Email: *******
 Memory • /memory
  L project: CLAUDE.md
 Model • /model
  L Default (claude-sonnet-4-20250514)

リスタートしろと言われていますが、行っても改善は見られません、、、
Cursorなどは Error installing Cursor extension: 1: ENOENT と表示されるみたいです。

解決のきっかけ

同様の問題は Claude Code の GitHub Issues でも報告されていました：

色々な対処法が検討されていましたが、結局 code コマンドでの直接インストールが一番確実で早かったです。

上記の手動インストール手順を実行したところ、無事に成功！🎉

インストール成功の画像

ついにVSCode内でClaude Codeが動作するようになりました。
Happy coding with Claude! 🚀

Discussion