JetBrains 系 IDE で Claude Code を使う

JetBrains 系 IDE で Claude Code を、AI in IDE の API キー 1 本で動かします。対象は IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm、Android Studio です。

この統合は VS Code / Cursor とは別物です。JetBrains にはチャット機能を内蔵した拡張機能がありません。プラグインが IDE の統合ターミナルで claude コマンドを起動し、ローカルのソケットで接続します。したがって CLI を入れ、プラグインを入れ、CLI の環境を設定する、という 3 段階になります。ここに「ワンクリックで完了」は存在せず、そう書いてある手順は誤りです。

JetBrains 統合が他と違う点

ネットワークと話すのは CLI なので、AI in IDE の設定は CLI に属し、プラグインの GUI にはありません。これはむしろ好都合で、~/.claude/settings.json 1 つで CLI、プラグイン、ターミナルセッションがすべて設定されます。

バージョンと前提条件

プラグインは Claude Code [Beta] として公開されています。機能や設定メニューはリリースごとに動くため、入れたビルドのプラグインページを確認し、オプションの存在を決めつけないでください。

インストール

1. CLI

Copy
1
npm install -g @anthropic-ai/claude-code
2
claude --version

通常のターミナルで claude が解決できることを確認します。できない場合、プラグインは起動できず Cannot launch Claude Code と表示します。原因はたいてい Node のバージョン管理ツール（nvm、fnm、asdf）です。claude はシェルの初期化スクリプト経由で PATH に入るため、IDE はそのスクリプトを実行しません。システム側の Node で入れるか、次の手順で絶対パスを指定してください。

2. プラグイン

Settings → Plugins → Marketplace を開き Claude Code を検索してインストールし、IDE を完全に再起動します（プロジェクトの開き直しでは不十分）。Remote Development では Settings → Plugin (Host) からホスト側に入れてください。ローカルクライアントに入れてもリモートプロジェクトには接続しません。

3. プラグインに CLI を教える

Settings → Tools → Claude Code [Beta] → Claude command はパスだけでなくコマンド文字列を受け取ります。

• claude（PATH 上にある場合）
• /usr/local/bin/claude などの絶対パス
• npx @anthropic-ai/claude-code（常に最新の公開版を実行）
• WSL を使う Windows では wsl -d Ubuntu -- bash -lic "claude"（Ubuntu は自分のディストリビューション名に置換）

command not found の通知が出たときの確実な対処はこの設定です。

API キーを作成してコピーする

1. 料金ページでプランを選びます。1 つのアカウントで Claude・GPT・Gemini 用のキーを個別に作成でき、各キーは選択したチャンネルのモデルに使用します。
2. API Keys を開いてキーを作成します。
3. AWSQ か CCMAX を選びます。Claude Code 用のチャンネルはこれだけで、Codex や Gemini のキーは別エンドポイントのためここでは失敗します。
4. あとから API Keys の一覧でキー全体を表示したり、コピーしたりできます。

設定

CLI は ~/.claude/settings.json（macOS/Linux）または C:/Users/<UserName>/.claude/settings.json（Windows）を読みます。次の内容で作成します。

Copy
1
{
2
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
3
  "env": {
4
    "ANTHROPIC_BASE_URL": "https://api.aiinide.com",
5
    "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY",
6
    "API_TIMEOUT_MS": "600000",
7
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
8
  }
9
}

ANTHROPIC_BASE_URL はホスト名までにします。CLI が /v1/messages を付けるため、/v1 を含めると /v1/v1/messages になって 404 が返ります。権限ルールやフックを含む settings.json が既にある場合は、ファイル全体を置き換えず env オブジェクトを追加してください。

なぜシェルの export ではなくファイルなのか。Dock やスタートメニューから起動した JetBrains IDE はシェルのプロファイルを実行せず、プラグインは IDE の環境を引き継ぐからです。ファイルは CLI 自身が読むので、ターミナルの起動方法に左右されません。環境変数を使いたい場合は、シェルのプロファイルに書いたうえで IDE をシェルから起動するか、プラグインのコマンド行に含めてください。

CLI の初回ログイン画面も不要です。ANTHROPIC_AUTH_TOKEN があり claude.ai のセッションがなければ、Claude Code はそのトークンを使います。

動作確認

最初にモデル一覧を取得し、キーと Claude チャンネルを確認します。このリクエストではクォータを消費しません。

Copy
1
curl --globoff -i 'https://api.aiinide.com/v1/models' \
2
  -H "x-api-key: YOUR_DASHBOARD_API_KEY" \
3
  -H "anthropic-version: 2023-06-01"

HTTP 200 ならモデル一覧が返ります。401 はキーの未指定、無効、または期限切れ、400 はチャンネルの不一致を示します。以下の Messages の例では一覧のモデル ID を指定してください。

1. まずターミナル。 プロジェクトルートで IDE の統合ターミナルを開き claude を実行します。ログイン画面なしでプロンプトが出るはずです。ここで失敗するならプラグインも動きません。プラグインに触る前に CLI と環境を直してください。
2. IDE から接続。 プロジェクトを開いた状態で IDE のターミナルから claude を実行するか、Cmd+Esc / Ctrl+Esc を押します。プラグインが CLI を起動して接続します。
3. 接続の確認。 /status を実行するとバージョン、モデル、アカウント状態が出ます。接続済みのセッションではファイル編集がターミナルではなく IDE の差分ビューアーに表示されます。
4. 外部ターミナルから接続。 IDE の外で claude を起動した場合、Claude Code 内で /ide と入力します。成功すると Connected to IntelliJ IDEA.（IDE 名は環境に応じて変化）と表示されます。CLI はプロジェクトルートと同じディレクトリから起動してください。違うとファイル集合が一致しません。
5. 確認済みのキーでモデルを直接呼び出します。

Copy
1
curl --globoff 'https://api.aiinide.com/v1/messages' \
2
  -H "x-api-key: YOUR_DASHBOARD_API_KEY" \
3
  -H "anthropic-version: 2023-06-01" \
4
  -H "Content-Type: application/json" \
5
  -d '{"model":"MODEL_ID_FROM_LIST","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'

1. 使用量。 最初のプロンプトが成功すると、使用量ページにそのキーのトークン消費が表示されます。

トラブルシューティング

GET /v1/models が返す正確な ID を指定してください。claude-* の名前を誤入力すると、設定済みの既定の Claude モデルに切り替わり、そのモデルの料金が発生する場合があります。

API Error: 404

ANTHROPIC_BASE_URL は https://api.aiinide.com に設定します。/v1 を追加するとリクエスト先が /v1/v1/messages になり、404 が返ります。

API Error: 400

• チャンネルの誤り。 Codex や Gemini のキーは /responses や /v1beta/models/... で認証するため、このエンドポイントでは 400 になります。AWSQ か CCMAX のキーを作成してください。
• settings.json の破損。 JSON が解析できないと CLI は黙って既定値に戻り、リクエストはプロキシ用トークンを付けたまま本物の Anthropic エンドポイントへ飛んで失敗します。ファイルを検証してください。$schema の行があれば IDE がその場でエラーを示します。

API キーの確認

キーの確認には GET /v1/models のステータスを使います。ネイティブの POST /v1/messages はキーが未指定または無効でも HTTP 200 を返し、content に認証エラーが入る場合があります。

• 設定の置き場所が違う。 Remote Development やコンテナでは、~/.claude/settings.json は CLI を実行するホストまたはコンテナ側に必要です。手元のノート PC ではありません。
• 古い ANTHROPIC_API_KEY が残っている。 環境に Anthropic のキーもあると、ANTHROPIC_AUTH_TOKEN より優先されることがあります。unset して IDE を再起動してください。
• キーの期限切れ。 ダッシュボードで有効期限を確認し、延長ではなくローテーションします。

JetBrains 固有の統合エラー

タイムアウトとプロキシ

API_TIMEOUT_MS は長いエージェントのターンに効きます。社内プロキシはリクエストごとに遅延を足します。一定間隔で失敗するならタイムアウト値が読まれていません。settings.json の env 内にあることを確認して IDE を再起動してください。TLS を検査するプロキシの背後では、同じ env に NODE_EXTRA_CA_CERTS を追加し、プロキシのルート CA を指定します。

権限モードについての注意

JetBrains では、プラグインが IDE の設定ファイルを変更でき、IDE がそれを実行する可能性があります。信頼できないリポジトリでは Manual モードのまま acceptEdits を切っておき、書き込み可能なセッションで開くプロジェクトディレクトリを意識的に選んでください。

モデルと料金

Opus 5.5 の基本料金は 100 万トークンあたり入力 $4、キャッシュ読み取り $0.20、出力 $20。クォータ消費は AWSQ が 0.8 倍、CCMAX が 2 倍です。上流が Fast モードで処理した場合は基本料金とキャッシュ料金が 2 倍になります。

• プラン：料金
• キーとクォータ：API Keys
• プロトコルの詳細：設定
• 公式プラグインページ：JetBrains Marketplace
• 公式統合ガイド：code.claude.com JetBrains

よくある質問

なぜワンクリックのセットアップがないのですか。 プラグインは意図的に CLI を同梱せず、インストール済みの claude を起動します。ターミナルと IDE が 1 つの設定を共有するためで、その結果 CLI を入れてからプラグインを入れる順序が必要になります。

VS Code の拡張機能を流用できますか。 できません。VS Code / Cursor の拡張機能は別製品で、ここでのインターフェースは IDE ターミナルの CLI です。流用できるのは ~/.claude/settings.json で、どちらもこれを読みます。

プラグインに Anthropic のログインは必要ですか。 不要です。ANTHROPIC_AUTH_TOKEN と ANTHROPIC_BASE_URL を設定すれば、CLI はログイン画面を飛ばして AI in IDE にリクエストを送ります。

対応 IDE はどれですか。 文書化されているのは IntelliJ IDEA、PyCharm、WebStorm、PhpStorm、GoLand、Android Studio です。同じプラットフォームの他の IDE も多くの場合動きますが、プラグインはベータなので、依存する前に差分表示と /ide を確認してください。