JetBrainsのClaude AgentとClaude Codeプラグインの違い

JetBrains AI AssistantのClaude AgentはClaude Codeプラグインとは別物

JetBrains製IDEでClaudeを使う入口は2つあります。ひとつはAI Assistantに組み込まれた「Claude Agent」、もうひとつはJetBrains Marketplaceで配布されている「Claude Code [Beta]」プラグインです。名前が似ていますが、JetBrainsの公式ヘルプはClaude AgentがClaude Codeプラグインとは無関係で、別のサードパーティプラグインであり、スコープも機能も異なると明記しています。

違いは名前だけではありません。認証の入口、ファイルを守る仕組み、IDEから渡る文脈の範囲が、それぞれ別の設計になっています。とくに.aiignoreは、Claude Agentには効きません。

プラグインの導入手順はClaude Code JetBrainsプラグインの導入と設定にあります。ここでは、両者を取り違えたときに何が起きるかを軸に見ていきます。

認証は3経路 — 選んだ経路が課金とAI Assistant機能の範囲を決める

Claude Agentの有効化は、AI Chatで「Claude Agent」を選び、メッセージを送って起動する流れです。「Install and Continue」で利用条件に同意してエージェントをインストールすると、認証方法を選ぶ画面が出ます。

選べる経路は次の3つです。

選んだ認証方法はリクエスト処理と課金の両方に使われます。「どこに請求が飛ぶか」は、この選択でほぼ決まります。

JetBrains AI subscriptionまたはAPIキーで有効化すると、AI Assistantの他の機能も使えるようになります。プロバイダーアカウントのOAuthによる認証は、AI Chatでエージェントが使えるだけです。ただしOAuthの対象として表に載っているのはCodexとGitHub Copilotで、Claude Agentの行は「JetBrains AI」「APIキー」「Anthropic Console」の3つになっています。

いま有効な経路は、Settings | Tools | AI Assistant | Providers & API keysのAgent Authorizationで確認できます。経路を変えたいときは、同じ画面でRevokeを押して認可を取り消し、新しいチャットを作ります。既存のチャットは以前の認証方法を保持し続けます。

Claude Codeプラグイン側の認証と混ぜない

Claude Codeプラグインが実行するのはIDEの統合ターミナル上のclaudeコマンドです。ログインはCLI側で済ませます。ClaudeサブスクリプションやConsoleアカウントの扱いはClaude CodeでAPIキーなしにログインする方法で整理しています。

つまり、JetBrainsアカウントのサブスクリプションでClaude Agentを動かしていても、その認証がClaude Codeプラグインに引き継がれることはありません。プラグインにはCLIのログインが別途必要です。両方を併用すると、請求元がJetBrainsとAnthropicの2か所に分かれます。

.aiignoreはClaude Agentに効かない

これがもっとも取り違えやすい点です。

AI Assistantには、特定のファイルやフォルダーをAIの処理から外す.aiignoreがあります。書式は.gitignoreと同じで、Settings | Tools | AI Assistant | Project Settingsで「Enable .aiignore」にチェックを入れて作成します。.cursorignore、.codeiumignore、.aiexcludeがプロジェクトルートにあれば、それらも同じ役割で読まれます。

ところがClaude Agentのヘルプページには、次の1文があります。

Claude Agent does not work with AI Assistant's .aiignore functionality, which means that files listed in .aiignore can be processed by Claude Agent.

.aiignoreに書いた.envやsecrets/も、Claude Agentは処理できてしまいます。AI Assistant本体の機能を.aiignoreで止めたつもりで、Claude Agentを有効にしていると、除外は働きません。

一方、.aiignoreのヘルプには、このファイルはJetBrains AI Assistantプラグインにだけ作用し、JetBrains IDE用のサードパーティ製AI連携プラグインには作用しないという注記があります。Claude Codeプラグインもこの注記の対象なので、.aiignoreで守れるのはAI Assistant自身の機能だけです。

では何で除外するのか

Claude Agent側の除外手段は、確認したヘルプには載っていません。載っていない以上、「.aiignoreの代わりにこの設定が効く」と書くことはできません。

Claude Codeプラグインには、文書化された手段があります。Claude Codeのドキュメントによれば、IDEで選択中のテキストや開いているファイルは自動でClaude Codeに共有され、Readの拒否ルールに一致するファイルはこの共有から外れます。.envのような機密ファイルは、プロジェクトの.claude/settings.jsonで次のように指定します。

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)"
    ]
  }
}

拒否ルールの書き方はClaude Codeの拒否ルールをeval等ですり抜けられる問題と対策や、/permissionsコマンドの解説が詳しく扱っています。この拒否ルールはClaude Codeの機能です。Claude Agentに同じ設定が効くかどうかは、JetBrainsの公式ヘルプに記載がありません。機密ファイルを含むリポジトリでClaude Agentを使うなら、効くと決めつけずに、リポジトリ側で機密ファイルを置かない構成にするのが手堅い選択肢です。

IDEコンテキスト — 自動で付くのは開いているファイルと選択範囲だけ

Claude Agentは、編集中のセッションの情報を自動で受け取れます。自動コンテキストを有効にすると、各リクエストに次の2つが付きます。

• エディターで開いているファイル
• そのファイル内で選択しているテキスト(あれば)

チャット入力欄のインジケーターをクリックすると、有効と無効を切り替えられます。無効にすれば、エディターの文脈は自動では添付されません。

他に開いているファイル、最近編集したファイル、プロジェクト全体の文脈は、自動では加わりません。必要なファイルは入力欄で@を使って添付します。

Claude Codeプラグインでも、選択範囲や開いているタブが共有される点は似ています。ただし共有の抑止に使うのは、先ほどのRead拒否ルールです。同じ「自動添付」でも、絞る手段が別物です。

コンテキスト使用量の表示

Claude Agentには、コンテキストウィンドウの使用率とトークン数を示すインジケーターがあります。最初の応答のあとに表示され、セッションを開き直しても最後の値が残ります。モデルを切り替えると、コンテキストウィンドウの大きさが違うため値が変わることがあります。

動作モードとロールバック — Claude Agent側で選べるもの

Claude Agentは6つの動作モードを持ちます。

既定では、bashコマンドの実行、変更の導入、ファイル操作、外部ツールの利用の前に許可を求められます。応答は「Allow once」「Always allow」「Deny」から選びます。変更が気に入らなければ、変更ファイルの一覧から個別に、または「Rollback」で全ファイルを戻せます。

Bypass Permissionsを選ぶと、権限チェックが丸ごと外れます。.aiignoreが効かない点と重なるので、機密ファイルのあるリポジトリではこのモードを避けるという判断材料になります。

Fast modeも切り替えられます。同じモデルのまま出力を速くする機能ですが、1応答あたりのコストは上がり、すべてのモデルが対応するわけではありません。

MCPサーバーと指示ファイルの渡し方

Claude Agentから外部ツールを使うには、2段の設定が要ります。まずSettings | Tools | AI Assistant | Model Context Protocol (MCP)でMCPサーバーを登録し、次にTools | AI Assistant | Agentsの「Pass custom MCP servers」を有効にします。DataGripなどデータベース系のIDEでデータベース固有のツールを使うときは、「Pass IntelliJ MCP server」をOnにします。

設定した外部ツールは、/メニューには出ません。エージェントが必要に応じて自動で呼ぶか、プロンプト内で直接指名して使います。

指示ファイルはプロジェクトルートのCLAUDE.mdから読まれます。バージョン管理に載せてプロジェクト間で使い回せます。AI Assistantには「Project rules」という似た機能もありますが、こちらはIDE内で設定してAI Assistantのチャットモードにだけ効きます。エージェントの指示はCLAUDE.mdやAGENTS.mdに書く、という住み分けです。

Claude Codeプラグインの側も、CLIが読むCLAUDE.mdを共有できます。同じCLAUDE.mdを両方で使い回せる構成なので、指示の内容を二重管理せずに済みます。CLAUDE.mdの規約の書き方はClaude CodeにpytestのCLAUDE.md規約を教えるが具体例になります。

どちらを使うか — 使い分けの早見表

Claude Codeプラグインを選ぶときの注意点は、CLI本体を別にインストールする必要がある点です。プラグイン自体はCLIを同梱しません。Claude Codeインストール完全ガイドを先に済ませておくと、つまずきません。

よくある質問

Claude AgentとClaude Codeプラグインを同時に入れても問題ありませんか

ヘルプに併用を禁じる記載はありません。ただし認証も課金も別々で、.aiignoreの効き方も違います。どちらでどのファイルが処理されるかを把握したうえで使うことになります。

JetBrains AI subscriptionがなくてもClaude Agentは使えますか

APIキーまたはAnthropic Consoleの経路があります。JetBrains AIまたはAPIキーで有効化した場合は他のAI Assistant機能も有効になります。

.aiignoreを書いたのにClaude Agentがファイルを読みます。バグですか

仕様です。ヘルプが、Claude Agentは.aiignoreに対応せず、記載ファイルも処理され得ると明記しています。除外を効かせたい機密ファイルは、そもそもリポジトリに置かない構成にするか、Claude Code側の拒否ルールで守る範囲を分けて考えます。