Claude Media
Claude Code JetBrainsプラグインの導入と設定

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. 1

    CLIを入れて claude --version で確認する

    PATHが通っていないとプラグインからも起動できません。claude --version が通るかを先に見ます。

  2. 2

    Marketplaceで「Claude Code [Beta]」を入れる

    インストール後にIDEを再起動します。

  3. 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の再起動が要ります。

Windows 11 22H2以降

ミラーリングに切り替え

.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=mirrored

IDE内蔵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とプラグイン間の挙動を揃えやすくなります。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/ja/jetbrains
  2. code.claude.com/docs/ja/setup
  3. code.claude.com/docs/ja/troubleshoot-install
  4. code.claude.com/docs/en/jetbrains
  5. code.claude.com/docs/en/vs-code
この記事を共有:XはてブLinkedIn