JetBrains IDE 連携

IntelliJ IDEA、WebStorm、PyCharm、GoLand などの JetBrains IDE で QCode 経由で Claude Code を使用する

最終確認：2026-09-18 · 📄 公式ドキュメント準拠（Claude Code JetBrains プラグイン 0.1.14-beta（Marketplace、IDE 2024.2 以上必須））

概要¶

Claude Code は公式の JetBrains プラグインを提供しています。公式文書が名指ししているのは 6 つ（Android Studio を含む。ただし Android Studio 側は Ladybug 2024.2.1 以上が必要で、JetBrains MPS は別途 2024.3 以上）。Marketplace の互換一覧には RubyMine、CLion、Rider、DataGrip など他の IntelliJ 系 IDE も並んでいますが、「IntelliJ ベースなら何でも動く」とは断定しません。導入前にご自身の IDE の Marketplace ページで確認してください。本記事では、プラグインをインストールし、QCode ゲートウェイに向ける方法を説明します。これにより、Claude Opus 5 や Sonnet 5 などのフラッグシップモデルをより低コストで利用できます。

プラグインはコマンドライン版と同じ設定を共有します。claude CLI が QCode に接続できれば、IDE プラグインもそのまま利用できます。

前提条件¶

1. Claude Code CLI がインストール済みで正常に動作すること（claude --version で確認。このページの古い数字と突き合わせない）

2. インストールガイド を参考にインストール

3. 環境変数の設定 を参考に QCode API を設定

4. ターミナルで claude --version を実行して動作を確認

5. JetBrains IDE 2024.2 以降のバージョン（Marketplace 上の該当プラグインの下限は build 242.0、つまり 2024.2 です。2024.1 では非互換と表示されます）

6. QCode API Key（cr_ で始まる）。同じ Key がすべての接続先で利用できます

インストール手順¶

ステップ 1：Claude Code プラグインのインストール¶

1. JetBrains IDE を開く

2. Settings / Preferences → Plugins → Marketplace に移動

3. Claude Code [Beta] を検索してください —— これが Marketplace 上の正式名称です（発行者 Anthropic PBC、xmlId com.anthropic.code.plugin）。⚠️ "Claude Code" だけで検索すると無関係な第三者の同名プラグインが先に出ます。発行者を確認してから導入してください

4. Install をクリック

5. IDE を再起動

ヒント：ネットワークから JetBrains Marketplace に直接アクセスできない場合は、プラグインのホームページから .zip パッケージをダウンロードし、Plugins → 歯車アイコン → Install Plugin from Disk... からオフラインでインストールできます。詳細は JetBrains 公式ドキュメントを参照してください。

ステップ 2：QCode への接続設定¶

プラグインは Claude Code CLI の設定を再利用します。核となるのは 2 つの環境変数です：

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_api_key"

中国本土のユーザー：api.qcode.cc を asia.qcode.cc に置き換えると、通常はより高速で安定します：

bash export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"

4 つのドメイン api / asia / us / eu は同じ API Key を共有するため、地域に応じて最適なものを選べます。BASE_URL の末尾にスラッシュを付けないでください。

ヒント：JetBrains IDE はシステムの環境変数を継承します。すでに ~/.zshrc や ~/.bashrc で設定済みであれば、IDE 起動時に自動的に読み込まれます——ただし、その設定が読み込まれた環境から IDE を起動した場合に限ります（下記のよくある質問を参照）。

グローバルな環境変数に依存したくない場合は、プロジェクトごとに設定することもできます（よくある質問を参照）。

ステップ 3：動作確認¶

1. IDE で Cmd+Esc（macOS）または Ctrl+Esc（Windows/Linux）を押して Claude Code パネルを開く

2. 簡単なメッセージ（例：「こんにちは」）を入力して接続をテスト

3. 正常な応答が返れば、プラグインは QCode 経由で正常に接続されています

curl でゲートウェイ自体が到達可能かを確認することもできます（401 が返れば、パスは正しく認証が欠けているだけで、想定どおりです）：

curl -i https://api.qcode.cc/api/v1/messages
# HTTP/2 401  ← パスは正しい、想定どおり

使い方¶

ショートカットキー¶

実際のショートカットはプラグインのバージョンとキーマップによって異なります。Settings → Keymap で「Claude」を検索してカスタマイズできます。

主な機能¶

1. コードの説明：コードを選択 → 右クリック → Ask Claude で、そのロジックを説明させる

2. コード生成：Claude パネルで自然言語で要件を記述し、コードを生成または変更させる

3. エラー修正：スタックトレースやエラーメッセージを Claude に送信して分析と修正を依頼

4. コードリファクタリング：対象コードを選択し、構造の改善、関数の抽出、テストの追加を Claude に依頼

ネイティブの Diff ビュー¶

プラグインは JetBrains と深く統合されています。Claude がファイルの変更を提案すると、IDE のネイティブな並列 Diff ビューで表示されるため、変更を 1 つずつ確認し、承認または却下してからディスクに書き込めます。これは単なるターミナルの diff より直感的で安全です。

内蔵ターミナルとの併用¶

JetBrains IDE 内蔵のターミナルで直接 claude コマンドを実行でき、CLI と同じ機能が利用できます。プラグインは IDE で現在開いているファイルや選択範囲を自動的にコンテキストとして CLI に渡すため、両者を併用すると最も快適に使えます。

画像入力（ビジョン機能）¶

ビジョン対応モデル（Claude Opus 5 / Sonnet 5 および GPT-5.x シリーズ）は、入力として画像を読み取ることができます：

• スクリーンショットを Claude パネルに直接貼り付け（Ctrl+V）
• 画像ファイルをチャットボックスにドラッグ＆ドロップ
• プロンプトで画像ファイルのパスを参照

代表的な用途：デザイン稿/スクリーンショットから UI を再現、エラースクリーンショットからのデバッグ、アーキテクチャ図やチャートの読解。

これは画像入力であり、画像生成ではありません。モデルに画像を生成させたい場合は gpt-image-2 モデルを使用してください。詳細は gpt-image-2 画像生成 を参照してください。

モデル選択¶

Claude パネルでは /model コマンドでモデルを切り替えられます。すべてのモデルは同じ QCode Key 経由で呼び出されます。よく使う選択肢：

単価は本ページに転記しません —— qcode.cc/models のリアルタイム表示を正としてください（管理による料率変更があります）。

QCode は GPT-5.x や Gemini などのモデルにも対応していますが、JetBrains 向けの Claude Code プラグインは主に Anthropic プロトコルを対象としています。GPT/Gemini はそれぞれ対応するツール（Codex / Antigravity など）で使うのが適しています。単価は qcode.cc/models に従ってください。claude-sonnet-4-6 や claude-opus-4-8 などの 4.x は引き続き販売中です。

高度な使い方¶

• ダイナミックワークフロー（Dynamic Workflows）：プロンプトにキーワード ultracode を含める（または「ワークフローを実行して」と依頼する）と、数十〜数百のバックグラウンドサブエージェントを並列で編成し、大規模なタスク（リポジトリ全体のコードレビュー、一括移行、複数ファイルにまたがる調査など）を処理できます。サブエージェントはバックグラウンドで実行され、その間も作業を続けられます。進捗は /workflows コマンドで確認できます。Claude Code に設定されているモデル上で動作するため、QCode に向けた状態でも利用できます。サブエージェント を参照してください。

• ヘッドレス / 自動化：IDE のターミナルでも claude -p "<プロンプト>" を --output-format json|text|stream-json と組み合わせてスクリプト化した呼び出しができます。json は result、total_cost_usd、usage、session_id を含む構造化オブジェクトを返すため、jq で簡単に解析できます。自動化と CI/CD を参照してください。

プラグイン自身の設定ページ¶

公式記載の設定ページは Settings → Tools → Claude Code [Beta] です。列挙されている項目は：

• Claude command：プラグインが Claude Code を起動ときに使うコマンド。例 claude、/usr/local/bin/claude、npx @anthropic-ai/claude-code。IDE が claude を見つけられない場合、公式の正規の対処はここに絶対パスを書くことで、shell の起動方法を作り直す必要はありません
• Suppress notification for when Claude Command is not found：「claude コマンドが見つからない」通知を黙らす
• Enable using Option+Enter for multi-line prompts：macOS のみ、複数行入力での改行
• Enable automatic updates：プラグイン更新の自動確認と適用（再起動時）

外部ターミナルから IDE に接続する /ide¶

公式文書どおり、外部ターミナルで動いている Claude Code 内で /ide を実行すると、起動中の JetBrains IDE に接続され全機能が有効になります。成功時は Connected to IntelliJ IDEA. のような応答が返ります。プラグイン未導入の IDE が検出された場合、/ide が代わりにプラグインを導入し、再起動を促します。QCode 経由でも同じです——外部ターミナルの claude は設定済みの ANTHROPIC_BASE_URL を使います。

JetBrains リモート開発：プラグインは遠端 Host 側に入れる¶

公式の明記では、JetBrains Remote Development を使う場合はプラグインを遠端ホスト側に入れなければなりません。経路は Settings → Plugins → Plugin (Host) です。手元のクライアント側に入れても効きません。

AI Assistant は別物です¶

本ページが対象にしているのは Claude Code プラグインで、自分の claude CLI を Anthropic プロトコル経由で動かし、base URL は環境変数で決まります。JetBrains の AI Assistant も第三者モデルを付けられますが入口が別です：設定は Settings | Tools | AI Assistant | Providers & API keys、そして公式文書上 URL を入力できるのは "OpenAI-compatible" の種別だけで、Anthropic と Gemini の API key 種別は鍵の欄しかありません。

AI Assistant の AI completion（行内補完 / next edit）も "OpenAI Compatible" エンドポイントのみ対応で、公式は行内補完に Fill-in-the-Middle 対応を要求しているため汎用の対話モデルは適さないと注意喚起しています。

よくある質問¶

プラグインに Claude Code パネルが表示されない場合¶

1. プラグインがインストールされ、有効になっていることを確認（Settings → Plugins → Installed）

2. Claude Code CLI がグローバルにインストールされていることを確認：ターミナルで claude --version を実行し、バージョン番号が出ること（正本は 公式 Releases）

3. IDE のバージョンが 2024.2 以上であることを確認

4. IDE を再起動。必要に応じて File → Invalidate Caches / Restart を実行

Esc で生成を中断できない場合¶

公式のトラブル項目どおり、JetBrains のターミナルでは Esc が「フォーカスをエディタへ移す」方に取られています。対処は Settings → Tools → Terminal で、次のいずれか："Move focus to the editor with Escape" のチェックを外す、または "Configure terminal keybindings" で "Switch focus to Editor" ショートカットを削除する。

環境変数が反映されない場合¶

JetBrains IDE がシェル設定ファイルの環境変数を読み込めていない可能性があります（GUI で起動したプロセスは ~/.zshrc を読み込まないことが多い）。対処法：

• macOS：Dock からではなく、ターミナルから IDE を起動（例：open -a "IntelliJ IDEA"）。または Tools → Create Command-line Launcher を使ってターミナルから起動

• すべてのプラットフォーム：IDE の Run/Debug Configurations → Environment variables で ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN を手動で追加

• 永続化：JetBrains Toolbox、*.vmoptions、またはシステムレベルの環境変数で設定し、起動のたびに読み込まれるようにする

認証失敗 / 401 / 403 の場合¶

1. ANTHROPIC_AUTH_TOKEN が cr_ で始まる有効な QCode Key で、余分なスペースや引用符が含まれていないか確認

2. ANTHROPIC_BASE_URL の末尾にスラッシュがなく、パスが /api（Anthropic プロトコル）であることを確認

3. curl -i https://api.qcode.cc/api/v1/messages を実行：401 が返ればゲートウェイは到達可能（認証が欠けているだけ）、接続エラーならネットワーク/プロキシの問題

接続タイムアウト / 社内プロキシ越しにアクセスできない場合¶

• 中国本土のユーザーはまず asia.qcode.cc に切り替える

• 社内プロキシの背後にいる場合、IDE の Settings → Appearance & Behavior → System Settings → HTTP Proxy が正しく設定されているか確認するか、ターミナルに HTTPS_PROXY 環境変数を設定

• ファイアウォールが IDE プロセスから *.qcode.cc:443 への外向きアクセスを許可していることを確認

環境変数を変更したのに IDE が認識しない場合¶

環境変数はプロセス起動時に一度だけ読み込まれます。~/.zshrc やシステム変数を編集した後は、変更を反映させるために IDE を完全に終了して再起動する必要があります（ウィンドウを開き直すだけでは不十分です）。

次のステップ¶

• 接続先と API フォーマット で 4 つのドメインと各プロトコルの base URL を確認

• VS Code 連携 で VS Code 拡張機能を確認

• Cline 連携 でもう一つの VS Code AI 拡張機能を確認

• CLI のヒント でターミナルの使い方のコツを確認

JetBrains でどのモデルを動かすのが最もコスト効率が良いか気になりますか？QCode 料金ページ で予算に合わせて Opus / Sonnet / Haiku を選んでください。