# JetBrains IDE 連携

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

## 概要

| 項目 | 内容 |
|---|---|
| 利用できるモデル | Claude ✅（Claude Code プラグイン、CLI 設定を共有）· GPT / 中国系 ⚠️ JetBrains AI Assistant のカスタムモデル欄参照 · Gemini ❌ |
| プロトコルと Base URL | Anthropic：`https://api.qcode.cc/api`（`claude` CLI の環境変数／settings.json に設定） |
| 設定場所 | IDE の Settings → Tools → Claude Code [Beta]。基盤は `~/.claude/` を共有 |
| 公式ドキュメント | [code.claude.com/docs/en/jetbrains](https://code.claude.com/docs/en/jetbrains) |

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` で確認。このページの古い数字と突き合わせない）
   - [インストールガイド](/docs/getting-started/installation) を参考にインストール
   - [環境変数の設定](/docs/getting-started/environment) を参考に QCode API を設定
   - ターミナルで `claude --version` を実行して動作を確認

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

3. **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 つの環境変数です：

```bash
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` が返れば、パスは正しく認証が欠けているだけで、想定どおりです）：

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

## 使い方

### ショートカットキー

| ショートカットキー | 機能 |
|--------|------|
| `Cmd+Esc` / `Ctrl+Esc` | Claude Code パネルの開閉 |
| `Cmd+Option+K` / `Ctrl+Alt+K` | プロンプトに現在のファイル参照（@file）を挿入 |
| `Esc` | 現在の生成を中断 |

> 実際のショートカットはプラグインのバージョンとキーマップによって異なります。**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 画像生成](/docs/usage/image-2) を参照してください。

### モデル選択

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

| モデル | コンテキスト | 適した用途 |
|------|--------|----------|
| `claude-opus-5` | 1M | フラッグシップ、複雑なリファクタリングとアーキテクチャ推論 |
| `claude-opus-4-7` | 1M | フラッグシップの代替 |
| `claude-sonnet-5` | 1M | 日常のコーディング、バランスの取れたコストパフォーマンス |
| `claude-haiku-4-5` | 200K | 軽量タスク、素早い Q&A |

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

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

### 高度な使い方

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

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

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

公式記載の設定ページは **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 種別は鍵の欄しかありません。

| 経路 | プロトコル | アドレス指定 | QCode 経由で呼べるもの |
|---|---|---|---|
| Claude Code プラグイン（本ページ） | Anthropic Messages | 可。`ANTHROPIC_BASE_URL` = `https://api.qcode.cc/api` | Claude 系列と中国系（Anthropic 経路） |
| AI Assistant → OpenAI-compatible | OpenAI Chat Completions | 可。URL 欄あり | GPT 系列と中国系（`https://api.qcode.cc/openai/v1`） |
| AI Assistant → Anthropic / Gemini | ネイティブ | **公式文書にアドレス欄なし**、鍵のみ | QCode には向けられない |

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](https://github.com/anthropics/claude-code/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 フォーマット](/docs/getting-started/endpoints-and-api-paths) で 4 つのドメインと各プロトコルの base URL を確認

- [VS Code 連携](/docs/ide/vscode) で VS Code 拡張機能を確認

- [Cline 連携](/docs/ide/cline) でもう一つの VS Code AI 拡張機能を確認

- [CLI のヒント](/docs/usage/cli-tips) でターミナルの使い方のコツを確認

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