ドキュメント · ガイド

JetBrains Air を任意のモデルで

JetBrains Air は設定でサインインしたアカウントで自身のエージェント（Claude Agent、Codex、Gemini CLI、Junie）を動かし、向け先を変えるベース URL はありません。一方で Agent Client Protocol を話すエージェントなら何でも受け付けます。magpie は Magpie という名前のエージェントを追加するので、Air は magpie にある任意のモデルで動きます：DeepSeek、GLM、Qwen、OpenAI や Anthropic のキー、ChatGPT や Copilot のサブスクリプション。

Air はカスタム ACP エージェントを設定フォルダの acp.json から読みます：macOS は ~/Library/Application Support/JetBrains/Air、Linux は $XDG_CONFIG_HOME/JetBrains/Air、Windows は %APPDATA%\JetBrains\Air。magpie はそこに Magpie というエントリを追加し、OpenCode の ACP サーバー opencode acp を、acp.json の横に置く magpie-opencode.json を OPENCODE_CONFIG にして起動させます。このファイルには magpie のプロバイダ、そのモデル、タスク開始時のモデル、magpie だけに絞った enabled_providers が入ります。OpenCode はこれを自分の設定に重ね、プラグイン、エージェント、MCP サーバーはそのまま残します。Air 自身のエージェントとそのアカウントには触れません。

Air をつなぐ

  1. magpie にプロバイダを追加プロバイダ タブで API キーを追加するか、サブスクリプションにサインインします。
  2. JetBrains Air の行でモデルを選ぶエージェント タブで magpie の下のモデルを選びます。
  3. Air で新しいタスクを始めるエージェントメニューで Magpie を選ぶと、magpie のモデルとルーティンググループがモデルメニューに並びます。
ターミナル
magpie air deepseek/deepseek-v4-pro        # Air アプリ
magpie air-ide deepseek/deepseek-v4-pro    # JetBrains IDE の Air

OpenCode

Magpie エージェントの中身は OpenCode なので、OpenCode のインストールが必要です。アプリはシェルの PATH を持たないことがあるため、magpie はフルパスを渡します：PATH 上のもの、なければ ~/.opencode/bin、なければ JetBrains IDE や Zed が ACP レジストリから入れたもの。見つからないときは行にインストールの案内が出ます：

ターミナル
npm i -g --allow-scripts=@opencode/cli @opencode/cli

モデルメニュー

Magpie エージェントの Air のモデルメニューは OpenCode が報告する一覧で、magpie のモデルとルーティンググループだけが並び、OpenCode 自身のものはありません。行で選んだモデルは新しいタスクの開始時のモデルで、OpenCode がタイトルや要約に使う小さなモデルでもあります。タスクごとに Air のメニューで別のモデルを選べます。

JetBrains IDE の Air

Air は JetBrains IDE のプラグインでもあります：2026.3 には同梱、2026.2 では JetBrains Marketplace から入れます。プラグインはどのシステムでも ~/.jetbrains/acp.json からカスタムエージェントを読むので、専用の行 Air (JetBrains IDEs) があり、そこに同じ Magpie エージェントを追加します。Magpie がまだ出ないときは IDE を再起動してください。IDE では、Air 自身の Codex と Claude Agent は自分のログインのとき、このコンピュータの codex と claude を動かすので、Codex と Claude Code を magpie につないでいればそれらも magpie を通ります。Air の行のモデルは Magpie エージェントだけのものです。

WSL プロジェクト

Windows の IDE は WSL ディストリビューションにあるプロジェクトのエージェントをそのディストリビューションの中で起動し、Windows のコマンドを拒否します。そこで OpenCode があり動いている各ディストリビューションに、Magpie (WSL Ubuntu) のような専用のエントリができ、ディストリビューション内の OpenCode のパスと、ディストリビューションから届くゲートウェイを書いた設定を使います。

環境変数のプロバイダキー

OpenCode 側の制限が一つあります：Air が起動するときの環境にプロバイダのキー（OPENAI_API_KEY、DEEPSEEK_API_KEY など、空でないもの）があると、ACP サーバーはそのプロバイダだけを並べ、設定のものは一つも並べないので、magpie のモデルが出ません。その変数を外すか、キーを OpenCode の auth.json に置いてください。

元に戻す

行を magpie から外します。magpie は acp.json から Magpie エントリを消し、magpie-opencode.json を削除します。Air 自身のエージェントは最初から変わっていません。Magpie エントリを手で消すと、Air が magpie に届かなくなったと行に表示されます。

よくある質問

JetBrains Air で DeepSeek、GLM、Qwen は使えますか？

使えます。Air の新しいタスクで Magpie エージェントを選ぶと、magpie にあるすべてのモデルがモデルメニューに並びます：DeepSeek、GLM、Qwen、GPT、Claude など。

magpie は Air 自身のエージェントやアカウントを変えますか？

変えません。acp.json に ACP エージェント Magpie を一つ追加するだけです。Claude Agent、Codex、Gemini CLI、Junie は自分のアカウントのままです。

Magpie エージェントに magpie のモデルが出ないのはなぜ？

たいてい Air の起動環境に OPENAI_API_KEY などのプロバイダキーがあります。OpenCode はそのプロバイダだけを並べます。外すか、キーを OpenCode の auth.json に置いてください。

IntelliJ IDEA や PyCharm など JetBrains IDE でも使えますか？

使えます。Air プラグイン（2026.3 に同梱、2026.2 は Marketplace から）を通します。Air (JetBrains IDEs) の行をつなぎ、IDE を再起動してください。

同じモデルで使えるほかのエージェント：OpenCode で他のモデル、Antigravity を任意のモデルで、Snow CLI を任意のモデルで。うまくいかないときは よくあるエラーの対処 を見るか、Discord で質問してください。