Claude Code JetBrainsプラグインの導入と設定
IntelliJ IDEA・PyCharm・WebStorm向けClaude Code JetBrainsプラグインの導入手順、リモート開発の注意点、WSL2接続トラブルの直し方をまとめます。
Claude Code JetBrainsプラグインとは
Claude Code JetBrainsプラグインは、IntelliJ IDEA・PyCharm・WebStorm等のJetBrains製IDEにClaude Codeをつなぐ公式プラグインです。VS Code拡張機能がGUIのチャットパネルを主役にするのに対し、JetBrains版はIDEの統合ターミナルでCLIを動かし、そこにdiff表示や選択範囲の共有を重ねる構成です。VS Codeとの違いはVS Code拡張機能の使い方にありますが、この記事はJetBrains側の導入・設定・つまずきだけを扱います。
公式は、IntelliJ IDEA・PyCharm・Android Studio・WebStorm・PhpStorm・GoLandを含む大半のJetBrains IDEに対応するとしています。
入れるものは2つ: CLI本体とプラグイン
JetBrainsプラグインはCLIを同梱していません。プラグインが実行するのは統合ターミナル上の claude コマンドそのものなので、CLIが無いと「Cannot launch Claude Code」という通知が出ます。CLIの入れ方はClaude Codeインストール完全ガイドに詳しくありますが、要点は次の1行です。
curl -fsSL https://claude.ai/install.sh | bash導入の流れ
- 1
CLIを入れて claude --version で確認する
PATHが通っていないとプラグインからも起動できません。
claude --versionが通るかを先に見ます。 - 2
Marketplaceで「Claude Code [Beta]」を入れる
インストール後にIDEを再起動します。
- 3
必要なら「Claude command」にフルパスを指定する
CLIをIDEが見つけられない場合は、プラグイン設定でこの欄に指定します。
/usr/local/bin/claudeやnpx @anthropic-ai/claude-codeの形式が使えます。
認証はPro・Max・Team・EnterpriseのいずれかのClaudeサブスクリプション、またはClaude Consoleアカウントで、APIキーは要りません。初回の claude 実行時にログインを求められます。JetBrains AI Assistant内のClaude Agentは別物です(違いの解説)。ZedでClaudeを使う場合の認証と課金はZedでClaude Agentを使う手順にあります。
起動のしかたで何が変わるか
統合機能は、IDEの統合ターミナルで claude を起動すれば自動で有効になります。外部ターミナルで動かしているClaude Codeから接続したいときは、/ide を実行します。
/ide接続に成功すると Connected to IntelliJ IDEA. のようなメッセージが出ます。IDEは動いているのにプラグインが入っていない場合、/ide がプラグインを入れて、IDEの再起動を求めます。Claudeに見せたいファイルをIDEと揃えるには、IDEのプロジェクトルートと同じディレクトリでClaude Codeを起動します。IDEで複数のプロジェクトを開いてメモリが膨らむ場合は、IntelliJの複数プロジェクトとメモリの件も確認してください。
起動時に自動接続させるフラグもあります。v2.1.285の claude --help には次の1項目が出ました(IDEとの接続は試していません)。
--ide Automatically connect to IDE on startup
if exactly one valid IDE is available--ideが自動接続するのは、有効なIDEがちょうど1つのときだけです。複数のIDEを開いていて接続先が決まらないときは、/ideで選びます。
IDEとつながると使える機能
統合機能の一覧
クイック起動
Cmd+Esc(Mac)/Ctrl+Esc(Windows/Linux)でエディタから開けます。UIのClaude Codeボタンからも開けます。diff表示
変更をIDEのdiffビューアーで開きます。
/configの「Diff tool」でauto(IDE)とterminalを切り替えます。選択範囲の共有
IDEで選択中のテキストとアクティブなファイルのパスが、プロンプトを送るたびに渡されます。
ファイル参照の挿入
Cmd+Option+K(Mac)/Alt+Ctrl+K(Windows/Linux)で@src/auth.ts#L1-99の形式の参照を入れます。
診断結果(lintや構文エラー)の共有は、上の4つとは動き方が違います。Claudeが getDiagnostics ツールを呼んだときにIDEのinspection結果を読む仕組みで、Claude Code側が編集のたびにプラグインへ診断を要求することはありません。「編集すると自動でエラーが会話に入る」と期待すると、実際の動きとずれます。
選択範囲が共有されると、会話に ⧉ Selected N lines from <file> の行が出ます。メッセージをキューに入れた場合、選択は Enter を押した時点のものが使われ、その後に選択を変えても影響しません。.env のように渡したくないファイルは、Read の拒否ルールにそのパスを追加すると、選択テキストと「開いているファイル」の通知の両方が止まります。
「Diff tool」は、IDEに接続しているときだけ /config に表示されます。出ない場合はJetBrainsのターミナルから claude を起動するか、外部ターミナルで先に /ide を実行します。統合ターミナルの描画が崩れるときはClaude CodeがPyCharmで表示崩れする症状と回避策を見てください。
プラグイン設定と、ESCキーが効かないとき
設定はSettings → Tools → Claude Code [Beta]にあります。
- Claude command: 起動コマンド。WSLなら
wsl -d Ubuntu -- bash -lic "claude"の形式にします(Ubuntuは自分のディストリビューション名) - Suppress notification for when Claude Command is not found: コマンド未検出の通知を止める
- Enable using Option+Enter for multi-line prompts: macOSのみ。Option+Enterで改行できる。Optionキーが意図せず奪われるときはオフにし、ターミナルの再起動が要る
- Enable automatic updates: プラグインの更新確認とインストールを自動化し、再起動時に適用する
ESCキーでClaude Codeの実行を止められないときは、Settings → Tools → Terminalで「Move focus to the editor with Escape」のチェックを外すか、「Configure terminal keybindings」から「Switch focus to Editor」のショートカットを削除します。
リモート開発ではプラグインの入れ先が違う
「No available IDEs detected」が出る: WSL2の直し方
WSL2上のClaude CodeからWindows側のIDEに接続できないとき、原因の多くはWSL2のNATネットワーキングか、Windowsファイアウォールが通信を遮っていることです。WSL1はホストのネットワークを直接使うので影響を受けません。devcontainer内で同じメッセージが出る場合は、原因が別の報告があります(Claude Codeのdevcontainerでの連携不具合)。
直し方は2通りで、公式が勧めるのは既存のネットワーキングモードを変えずに済むファイアウォールルールの追加です。
WSL2の接続を直す2つの方法
ファイアウォールルールを追加
Windows 10でも使えます。WSL2のサブネットに向けた受信許可を1本足すだけで、ネットワーキングモードはそのままです。IDEとClaude Codeの再起動が要ります。
ミラーリングに切り替え
.wslconfig に設定を書き、wsl --shutdown で再起動します。WindowsのループバックがLinux側と共有されるので、IDEのMCPサーバーをループバックのままにできます。
ファイアウォール側は、まずWSLシェルでIPを確認します。
hostname -I先頭2オクテットに .0.0/16 を付けたものがサブネットです(例: 172.21.123.45 なら 172.21.0.0/16)。PowerShellを管理者権限で開き、そのサブネットでルールを追加します。
New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16ミラーリングにする場合は、Windowsのユーザーディレクトリの .wslconfig に次を書きます。
[wsl2]
networkingMode=mirroredIDE内蔵MCPサーバーの正体
プラグインが有効な間、ide という名前のローカルMCPサーバーが動いています。CLIがIDEのネイティブdiffを開くのも、@メンションのために選択範囲を読むのも、Claudeがinspectionの診断を読むのも、このサーバー経由です。設定するものが無いので /mcp の一覧には出ません。PreToolUse フックでMCPツールを許可リスト化している組織は、この非表示サーバーの存在を知っておく必要があります。
モデルから見えるツールは mcp__ide__getDiagnostics(読み取り専用)の1つだけです。1回の呼び出しで見られるのは1ファイルで、Claudeが指定したファイル、指定がなければIDEで開いているファイルです。UI操作用の内部RPCはモデルに渡す前に除外され、JetBrainsプラグインはコード実行ツールをモデルに公開しません。
通信は、OSが割り当てるエフェメラルポート上の暗号化されていない ws:// です。ポートは固定できません。IDE起動のたびに生成されるトークンを ~/.claude/ide/<port>.lock に書き、CLIがそれを X-Claude-Code-Ide-Authorization ヘッダーで示して接続します。CLAUDE_CONFIG_DIR を設定している場合、ロックファイルの場所は $CLAUDE_CONFIG_DIR/ide/ です。
既定ではループバック(127.0.0.1)にしかlistenしません。Settings → Tools → Claude Code [Beta] → Networking (Advanced)の「Accept connections from all network interfaces」を有効にすると、ローカルネットワークからも届くようになり、通信もトークンも平文でネットワークを流れます。WSL2のNAT環境やリモートIDEなどループバックが使えないときの設定なので、WSL2ならミラーリングを先に検討してください。
セキュリティ上の注意
JetBrains IDE内で acceptEdits 権限モードを使うと、Claude CodeはIDEの設定ファイルまで変更できてしまいます。IDEがその設定ファイルを自動実行する仕組みを持つ場合、通常のBash実行の許可プロンプトを迂回する経路になり得ます。公式は、編集をManualモードで確認しながら進めること、信頼できるプロンプトだけを与えること、Claudeが触れるファイルの範囲を把握しておくことを挙げています。acceptEdits に加えてautoモードも、作業ディレクトリ内の編集を確認なしで承認します(保護対象のパスは除く)。権限モデル全体はClaude Codeセキュリティ・権限ガイドにあります。
症状から見るべき節を探す
公式のTroubleshootingは3症状に絞られていて、どれも前の節で扱った内容の裏返しです。症状ごとに戻る先を示します。
| 症状 | 最初に確認すること | 戻る節 |
|---|---|---|
| プラグインを入れたのに機能が出ない | 最初に確認することプロジェクトのルートから起動しているか。IDEを完全に再起動する(複数回必要なこともあります)。Remote Developmentならリモートホスト側に入っているか | 戻る節起動のしかた / リモート開発 |
/ide で「No available IDEs detected」 | 最初に確認することプラグインが有効か。自動接続を期待したなら統合ターミナルから起動したか。WSLはファイアウォールかミラーリング | 戻る節起動のしかた / WSL2 |
| Claudeアイコンで「command not found」 | 最初に確認することターミナルで claude --version が通るか。通るなら「Claude command」にフルパスを指定。WSLは専用のコマンド形式 | 戻る節導入の流れ / プラグイン設定 |
認証エラーやMCP関連のエラーなどCLI本体側の問題は、Claude Codeでよくあるエラーの対処ガイドを見てください。WSLを使っていないWindowsで「No available IDEs detected」が出る場合は、RiderでWSL形式のパスが返る症状も確かめられます。
よくある質問
VS Code拡張機能とどちらを選びますか
普段使うIDEで決めるのが基本です。VS Code拡張機能ではプランがMarkdown文書として開き、実行前にインラインコメントで指示を返せます。会話をタブで並行させることもできます。こうしたGUI前提の体験が要るならVS Code、IDEを変えずにClaude Codeを呼びたいならJetBrainsプラグインです。
MCPサーバーを追加するには
JetBrains IDEのターミナルで claude mcp add を使います。claude mcp --help にはHTTPサーバーの追加例として claude mcp add --transport http sentry https://mcp.sentry.dev/mcp が載っています(v2.1.285)。詳しい設定例はMCPとは — Claudeでの使い方にあります。
まとめ
症状が出たら、CLI単体で動くか、統合ターミナルからの起動か /ide での接続か、WSL2やRemote Developmentか、の順に切り分けると原因に近づきやすくなります。導入後はClaude Code設定ガイドでsettings.jsonの共有設定も確認しておくと、CLIとプラグイン間の挙動を揃えやすくなります。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。