JetBrains IDE

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

JetBrains IDE 連携¶

Claude Code は公式の JetBrains プラグインを提供しており、IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm、RubyMine、CLion、Rider、DataGrip、Android Studio など、IntelliJ プラットフォームベースのすべての IDE に対応しています。本記事では、プラグインをインストールし、QCode ゲートウェイに向ける方法を説明します。これにより、Claude Opus 4.8 や Sonnet 4.6 などのフラッグシップモデルをより低コストで利用できます。

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

前提条件¶

1. Claude Code CLI がインストール済みで正常に動作すること（現在のバージョン 2.1.187）

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

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

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

5. JetBrains IDE 2024.1 以降のバージョン（プラグインは比較的新しい IntelliJ プラットフォーム API に依存します）

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

インストール手順¶

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

1. JetBrains IDE を開く

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

3. 「Claude Code」（発行者: Anthropic）を検索

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 4.8 / Sonnet 4.6 および GPT-5.x シリーズ）は、入力として画像を読み取ることができます：

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

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

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

モデル選択¶

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

QCode は GPT-5.x や Gemini（従量課金 ×2）などのモデルにも対応していますが、JetBrains 向けの Claude Code プラグインは主に Anthropic プロトコルを対象としています。GPT/Gemini はそれぞれ対応するツール（Codex / Antigravity など）で使うのが適しています。詳しい料金は下記の CTA リンクを参照してください。

高度な使い方¶

• ダイナミックワークフロー（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 を参照してください。

よくある質問¶

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

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

2. Claude Code CLI がグローバルにインストールされていることを確認：ターミナルで claude --version を実行し、2.1.187 以上が表示されること

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

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

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

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 を選んでください。