Pi コーディングエージェント徹底解説：その正体、仕組み、Pi 1.0 で変わったこと

Pi コーディングエージェントとは？

Pi は README で自分自身を一行でこう説明しています。"a minimal, extensible agent harness that you can make your own." ハーネスとは、言語モデルをループ、ツール、ユーザーインターフェースで包み、モデルが実際にファイルを読み、コマンドを実行し、コードを編集できるようにするプログラムです。Claude Code、OpenAI Codex、OpenCode もハーネスで、まとめて エージェント型コーディング CLI というカテゴリを成しています。Pi の違いは、最初に入っているものがとても少なく、変えられる範囲がとても広いことです。

数字を見れば、とっくにニッチなツールではなくなっていることが分かります。

ダウンロード数には注意が必要です。npm の数字には CI の実行や Pi の SDK を組み込んだアプリも含まれるため、人数ではありません。それでも週 520 万 という数字は、はるかに新しい DeepSeek Harness を含め、ほとんどのオープンソースエージェントとは別格です。

Pi は自分自身の CLI よりも大きな存在でもあります。それだけで 391,521 スターを持つパーソナルエージェント OpenClaw は、Pi のコンポーネントの上に作られています。Armin Ronacher は自身の Pi の記事ではっきり述べています。"what's under the hood of OpenClaw is a little coding agent called Pi."

Pi を作っているのは誰で、なぜ Earendil に移ったのか？

Pi は、ゲームフレームワーク libGDX で知られるオーストリアの開発者 Mario Zechner の個人プロジェクトとして始まりました。きっかけは Claude Code への不満で、彼は設計の記事で、それが "spaceship with 80% of functionality I have no use for" になり、リリースのたびにプロンプトやツールが変わると書いています。そこで、裏で何も注入されないハーネスを作り、本人の言葉で言えば "a name that's entirely un-Google-able, so there will never be any users." という名前を付けました。

この計画は OpenClaw で崩れました。Peter Steinberger のエージェントが話題になり、Pi の上で動いていることが知られると、Mario は "any VC or big corp you can think of in this space has knocked on my door." と書いています。彼はそれを軸にスタートアップを作りたくなかったので、代わりに受け皿を選びました。

Earendil は 2025 年に Armin Ronacher（Flask の作者で、Sentry に約 10 年在籍）と Colin Daymond Hanna が設立した、ウィーンの公益法人です。出資者には Accel、Balderton のほか、n8n、OpenClaw、Revolut、Sentry、Slack の創業者が名を連ねます。ライセンスの約束は Armin の RFC にあります。"Pi remains MIT licensed and that will not change." 将来の付加価値機能の一部はソース公開型で、一定期間後にオープンソース化され、エンタープライズ機能の一部は独自ライセンスになります。

この移管を誰もが歓迎したわけではありません。r/LocalLLaMA への返信の一つは "the only decent harness that isn't sketchy af." が失われることを嘆きました。半年後、コミットログがよりよい答えになっています。Mario は今もリポジトリに 3,849 コミット、Armin は 849 コミットを持ち、コアは今も MIT です。

Pi コーディングエージェントの仕組み

設計全体はナプキンに収まります。モデルと、"just loops until the agent says it's done" というループと、4 つのツールです。

コアを小さくした Mario の理由は、最先端のモデルはコーディングエージェントが何かをすでに知っているからです。"There does not appear to be a need for 10,000 tokens of system prompt," と彼は書き、"these four tools are all you need for an effective coding agent." と述べています。読み取り専用のヘルパー（grep、find、ls）はありますが、既定ではオフです。プロジェクトのルールは AGENTS.md ファイルから読み込まれ（Pi は CLAUDE.md も読みます）、Claude Code の AGENTS.md の設定とよく似ています。SYSTEM.md で既定のプロンプトを丸ごと置き換えることもできます。

このスクリーンショットは、Pi ユーザーが絶賛する習慣を示しています。Pi に自分自身へ機能を追加するよう頼むと、自分のドキュメントを読み、設定フォルダに拡張を書き、あなたは /reload を実行します。フッターには毎ターン、使用したコンテキストとドル建てのコストも表示され、小さな点ですが作業の仕方が変わります。

インストール前に知っておきたい仕組みをいくつか挙げます。

• セッションは木構造です。 すべてのメッセージが親 ID とともに JSONL ファイルに保存されるため、/tree で任意の地点に戻って分岐でき、/fork や /clone でそこから新しいセッションを始められます。/share でセッションを共有リンクにできます。
• 実行中の操縦。 Pi の作業中に Enter を押すと操縦メッセージを送れ、Alt+Enter で終了後に処理する追加指示をキューに入れられます。
• コンパクション。 コンテキストが埋まると（既定では上限まで 16,384 トークンの時点で）、Pi は古いメッセージを要約し、直近の 20,000 トークンをそのまま残します。内部の仕組みが知りたければ、Earendil がコンパクションの仕組みを書いています。
• 30 以上のプロバイダー。 Anthropic、OpenAI、Google、Bedrock、Mistral、Groq、xAI、OpenRouter、Ollama など、/model でセッション途中でも切り替えられます。Pi のモデルカタログには 41 プロバイダー、1,541 モデルが載っています。

Pi があえて入れていないもの

初めて使う人がつまずきやすい部分なので、一つの表にまとめます。どれも意図的な選択で、それぞれ文書化された代替手段があります。

これらを省く Mario の理由は、見通しの良さです。サブエージェントについて、彼の設計の記事ではこうです。"You have zero visibility into what that sub-agent does. It's a black box within a black box." プランモードについては、読んで編集してコミットできる PLAN.md ファイルのほうがよいと考えています。Claude Code のサブエージェントを使って気に入っていたなら、パッケージを入れたくなるでしょうし、それで構いません。Pi の売りは、選べることです。

コミュニティはすべてのスロットを埋めました。パッケージカタログには 5,553 件のパッケージが並び、ダウンロード数の多いものの多くは上の表にそのまま対応しています。

拡張自体は単純な TypeScript ファイルで、ツール、スラッシュコマンド、キーボードショートカット、モデルプロバイダー、ターミナル UI 全体を登録できます。Armin 自身のレビュー拡張は、その広がりをよく示す例です。

その代わり、自分の環境の保守担当になります。Hacker News の長年の Pi ユーザーは公平にこう述べました。"Pi's plugins are its strength, but also its weakness, because most feel more like personal vibe-coding projects than seriously maintained tools." ドキュメントも同じことをより冷静に言っています。パッケージはコードを実行できるので、"review third-party package source before installing it."

Pi 1.0：「MCP なし」のエージェントに MCP が入った

pi.dev には長い間、Pi は MCP、つまりエージェントを外部の MCP サーバーにつなぐプロトコルを決して対応しないと誇らしげに書かれていました。Mario の根拠はコンテキストコストです。彼は Playwright の MCP サーバーが 21 ツール・13.7k トークン、Chrome DevTools MCP が 26 ツール・18k トークンだと測定し、それを "7-9% of your context window gone before you even start working." と呼びました。

2026 年 9 月 29 日、Earendil は「You Said No MCP!」という記事でこれを撤回しました。理由はこうです。"the MCP of today is not the MCP of yesteryear," そして MCP に必要だった変更は "generally useful." でした。2 日後、Pi 1.0 が MCP を目玉機能としてリリースされました。ホームページには今、"No MCP Now with MCP+Codemode." と書かれています。

トークンの約束を守る仕掛けが Codemode です。Pi はすべての MCP ツールのスキーマをモデルに渡す代わりに、ファイルシステム、ネットワーク、タイマーを持たない QuickJS サンドボックスで短い JavaScript スクリプトを実行する 1 つのツールを渡します。

Codemode のドキュメントは簡潔にこう述べています。"Only the script's output reaches the model, so a script can run calls in parallel and filter large results before the model sees them." Pi 1.0 の変更履歴によると、Codemode のプロンプトトークンは約 40% 減り、ある GPT-5.6 のリクエストは約 5,300 から 3,300 トークンに下がりました。各 MCP サーバーには公開設定があります。

• codemode（既定）：ツールは Codemode スクリプトからのみ呼び出せます。
• deferred：tool_search で見つかった後にのみツールが宣言されます。
• direct：多くのハーネスと同じように、組み込みツールと同様に読み込まれます。
• hidden：登録はされますが到達不能で、delete_* のようなツールに便利です。

設定は ~/.pi/agent/mcp.json かプロジェクトの .pi/mcp.json にあり、Claude Desktop や Cursor と同じ mcpServers 形式なので、既存のエントリを貼り付けられます。Claude Code の MCP ツールから移る場合、最大の発想の転換は、モデルがツールを一つずつ呼ぶのではなく、コードを書いて呼び出す点です。

これはミニマリストへの裏切りだったのでしょうか。Hacker News での Mario の返信はこうです。"All of these features are still entirely optional and the only thing I could think of that could be considered "bloat" is the additional few megabytes for the QuickJS WASM blob." Armin の説明はもっと実利的でした。

"we look at what the models are doing. They are trained on their respective harnesses and we're not here to fight their behavior."

the_mitsuhiko, Hacker News

Pi 1.0 では、ツールの遅延読み込み、Anthropic モデル向けのキャッシュウォーミング、「仮想モデル」の拡張サポート（あるデモは Claude Opus で計画し、GPT で実装します）も加わり、フルスクリーンモードが既定になりました。Pi 1.0 のスレッドは Hacker News で 1,686 ポイントに達し、過去のどの Pi の議論の約 3 倍でした。

4 つの実行方法

Pi はターミナルのチャットウィンドウだけではありません。同じエージェントとセッションエンジンが 4 つのモードで動きます。

SDK は OpenClaw などの製品が Pi の上に作られている方法で、カスタムコーディングエージェント向けの Claude Code SDK と同じ発想です。Print モードは地味な主役で、Pi ユーザーがサブエージェントを疑似的に実現する方法（Pi が bash 経由で pi --print を呼ぶ）であり、Pi を Claude Code 風の自動化につなぐ方法でもあります。

10 月 1 日には、Earendil が Pi Durable も公開しました。"long-running, durable, and malleable agents that can run anywhere." のための、実験的な MIT ライセンスのライブラリです。各ステップでチェックポイントを保存するので実行がクラッシュしても継続でき、多くの人が一つの会話に参加でき、チケットや計画といったアプリの状態をトランスクリプトと並べて保存します。"does not replace the Pi coding agent" であり、ホスト型の製品でもありません。サンプルの承認フックは deploy ツールを実行する前に Slack で確認し、Earendil はこの上に作られた Slack ボットと GitHub トリアージボットが近く登場すると述べています。これは後のサポートの節で思い出してください。

Pi コーディングエージェントは安全に使えるか？

Pi 自身のセキュリティドキュメントの一文は、二度読む価値があります。Pi は "can read, change, and execute files with the permissions of the account that started it, and it does not ask for approval before every tool call."

これが有名な YOLO の既定で、見落としではなく方針です。Mario は設計の記事で他のエージェントのガードレールを "mostly security theater" と呼び、エージェントがコードを書いて実行できる以上、確認ダイアログはほとんど意味がないと主張しました。ドキュメントも同意し、"watching the transcript, using project trust, and reviewing changes do not create a security boundary." と付け加えています。推奨は、Pi をコンテナ、VM、サンドボックスの中で動かすことで、Docker、Docker Sandboxes、NVIDIA OpenShell、Gondolin マイクロ VM の手順が文書化されています。

それでも新しいユーザーは驚きます。

"I love Pi, but minimal mean minimal. I realized it when it rm -f /tmp/somefile.log without asking for permission."

u/mantafloppy, Reddit r/LocalLLaMA

そして自作の対策には穴があります。同じスレッドの別のコメントは、サンプルの権限拡張が "blocks rm -rf, but not rm -fr which does the exact same thing" と指摘しました（u/GalladeGuyGBA）。パターンマッチ型のガードレールについての正直な真実であり、だからこそ Pi のドキュメントは本物のサンドボックスを勧めています。

知っておきたい既定値がさらに 3 つあります。

1. プロジェクトの信頼。 プロジェクト単位の設定（.pi/settings.json、.pi/mcp.json、プロジェクトの拡張とスキル）は、フォルダを承認した後にのみ読み込まれます。AGENTS.md と CLAUDE.md は承認に関係なく読み込まれます。
2. テレメトリ。 匿名のインストールと更新の報告は既定でオンです（enableInstallTelemetry: true）。PI_TELEMETRY=0 でオフにできます。アナリティクスはオプトインです。--offline は自動のネットワーク呼び出しを止めます。
3. サプライチェーン。 Pi は npm でインストールされ、パッケージも同様です。ある Reddit ユーザーは、npm i -g の更新時の約 30 分の間に推移的依存が乗っ取られ、仕事用 VM が侵害されたと述べています。README は現在、すべての依存関係を固定する、固定版の pi.dev/install.sh インストーラーを推奨しています。

私の見解です。無人で動かすものは Pi をコンテナで実行し、パッケージは他の npm コードと同じ慎重さでインストールし、権限確認への期待はゼロにしておくことです。チームが既定で承認確認を必要とするなら、Claude Code の権限モデルのほうが最初から安心に感じられるでしょう。

Pi コーディングエージェントの費用は？

Pi 自体は無料です。席ごとの料金も、有料プランも、料金ページもありません。MIT ライセンスのハーネスそのものが製品のすべてだからです。支払うのはその裏のモデルで、Pi にはモデルを持ち込む方法が 3 つあります。

注意点が 2 つあります。一つ目に、Pi の変更履歴によると、Claude のサブスクリプションでログインすると、Pi は "Anthropic third-party usage draws from extra usage and is billed per token" と警告します。Claude Code と同じように Max プランが Pi もカバーするとは思わないでください。そうしたプランの計測方法は、私の Claude Code の料金ガイドで解説しています。二つ目に、Google の Gemini CLI と Antigravity のログインはバージョン 0.71.0（2026 年 4 月 30 日）で削除され、Gemini には API キーか Vertex AI が必要になりました。

Pi が真価を発揮するのはトークン効率です。システムプロンプトがとても小さいので、プロンプトキャッシュがよく効き、毎ターンの送信量が減ります。Earendil が紹介した、数百万行規模のコードベースでの Databricks のベンチマークでは、そのワークロードで "simple harnesses like Pi performed best" とされ、Pi は 1 ターンあたり約 3 分の 1 のコンテキストを送っていました。

これは提供元に近いデータの一つとして扱い、鵜呑みにしないでください。Earendil は自社製品に有利な調査を引用しています。ただし、個々のユーザーも同じ方向を報告しています。ある Hacker News のコメント投稿者はトークンテストを行い、"both pi and my own 3code used 4x fewer tokens than Claude Code, while opencode used 2x fewer tokens than Claude Code." と述べました。別の人は、プロファイリングとリファクタリングのセッション全体が "in <20k tokens." で終わると言っています。以前の Terminal-Bench 2.0 リーダーボード（2025 年 12 月）では、Claude Opus 4.5 を使った Pi が 49.8% で #7 となり、Sonnet 4.5 の Claude Code の #18、40.1% を上回りました。

開発者は Pi をどう評価しているか

称賛はプラットフォームを問わず一貫しています。小さなプロンプト、低いトークン使用量、透明性、自在に曲げられるエージェントです。最も強い個人の推薦は X からです。

"Pi is the best agent harness and more importantly framework we have right now. The stats are stunning: - highest cache hit rate - lowest latency - highest performance - smallest bundle - cleanest code - cheapest cache + tiny system prompt over months adds up. Try it"

0xSero, X

ローカルモデルのユーザーは、見過ごしやすい理由で気に入っています。巨大なシステムプロンプトはノート PC では事前処理に数分かかりますが、Pi のそれはかかりません。

"Love pi. I tried to run some local models and pi was the only one that actually worked decently because it didn't have a gargantuan system prompt that would take minutes to prefill on my scrawny ass laptop."

FacelessJim, Hacker News

ベンダーがツールを変え続ける中でも邪魔をしない点を好む人もいます。

"The result is that the tool gradually morphs into the thing I need rather than me having to adapt myself to whatever new thing Anthropic or OpenAI comes up with."

unknownfuture, Hacker News

批判も同じくらい一貫しており、もっともです。最も多い不満は、「すべてがプラグイン」だと、他のエージェントなら任せられる設定作業を自分でやることになる、という点です。

"Need to set the reasoning effort? Install pi-reasoning. Need subagents? Install pi-subagents. Need permission gating? Install one of the permission extensions (otherwise the agent can do everything)."

mixermachine, Hacker News

私が見つけた最もよい一行の要約は、Pi と OpenCode を比べたスレッドにありました。"Pi vs opencode for example is like gentoo vs macos." Reddit では、初心者へのアドバイスは初日にすべてを入れないことです。r/PiCodingAgent のあるユーザーはこう述べました。"Pi actually works pretty well out of the box." 最初からすべて揃ったものを求める人は、oh-my-pi フォークか OpenCode を勧められがちです。

Pi コーディングエージェントと Claude Code の比較

多くの人は Claude Code から Pi に来るので、日々の作業に実際に影響する点を並べて比較します。

私の見立てです。主に Claude モデルを使い、ガードレール、安定した機能セット、責任を問える単一のベンダーが欲しいなら、Claude Code のままで構いません。頻繁にモデルを切り替える、トークンを気にする、ローカルモデルを動かす、あるいはエージェントが見るすべての行を自分で握りたいなら、Pi のほうが面白いツールで、1.0 のリリースで導入ははるかに楽になりました。Cursor や GitHub Copilot まで含めた幅広い比較なら、私の AI コーディングアシスタントのまとめから始めるのがおすすめです。

Pi の上にサポートエージェントを作るべきか？

自然な発想です。Pi には SDK、RPC モード、そして Slack ボット、承認フック、トリアージボットを例に挙げる Pi Durable があります。モデルもかつてないほど安くなりました。Pi をヘルプデスクにつないで、サポートエージェントと呼べばいいのでは？

それは、ハーネスが仕事のうち小さい部分だからです。私が見る役割分担はこうです。

サポートエージェントには、ヘルプデスクとの双方向の接続（チケットを読み、タグを付け、返信し、エスカレーションする）、ヘルプセンター、マクロ、過去のチケットが変わっても同期を保つ仕組み、人間なしで何をしてよいかのルール、そして顧客に話しかける前に実際の過去のチケットでテストする方法が必要です。この最後のステップだけは、私は絶対に省きません。eesel は、自信ありげなボットが誰にも気付かれないまま何日も間違った回答を続けるのを見て、痛い思いで学びました。だから今では、eesel の導入はすべて、最初に過去のチケットでシミュレーションします。

自前で作りたくなる気持ちは、反対の側からも見ています。AR・建設テック企業や DTC の美容ブランドを含む複数の eesel の顧客が、Claude API の上に直接作るために離れていきました。そして残るチームも、同じことをよく口にします。Bitcoin ATM メーカーである GENERAL BYTES のエンジニアリングリードは、なぜ買うことを選んだかを説明しました。

"We could try to write our own LLM application but we didn't want to invest our time into that. We wanted something that we would not have to maintain."

私の答えはこうです。チームがスタック全体を持つことを楽しめて、ほぼ毎日パッチをリリースするプロジェクトに追従する時間があるなら、Pi の上に作ってください。目的が保守するフレームワークではなく回答済みのチケットなら、チームメイトを採用し、Pi には得意なこと、つまりコードを書くことを任せましょう。

eesel を試す

Pi はハーネスで、eesel は従業員です。eesel は、特定の仕事にすぐ取りかかれる AI チームメイトを採用できるプラットフォームです。サポート向けが AI ヘルプデスクチームメイトで、数分で Zendesk、Freshdesk、Gorgias、Slack に接続し、過去のチケットとヘルプセンターから学びます。顧客に一件も返信する前に、自社のチケット履歴でシミュレーションできます。必要なのがチケットではなくコンテンツなら、同じプラットフォームに AI ブログライターチームメイトもあります。

Pi ユーザーに嬉しい点があります。ターミナルを離れる必要がありません。eesel CLI は、ダッシュボードと同じチームメイトとワークスペースを操作します。"another way in, not a separate copy." npx @eesel/cli init はアカウント不要でエージェントを設定し、eesel integrations connect zendesk でヘルプデスクに接続し（Zendesk 内で担当者が承認します）、eesel instructions でエージェントの常設ルールをプレーンテキストで編集し、eesel approvals list で人間の確認待ちのアクションを表示し、eesel activity ですべての実行を読めます。すべてのコマンドが JSON を出力して --dry-run に対応し、エラーは hint フィールド付きで返るので、まさにコーディングエージェントがツールを自力で操作するのに必要なものです。

eesel のドキュメントは Claude Code、Cursor、Codex を挙げていますが、Pi が同じ役割を果たせない理由はありません。bash ツールで CLI を実行することも、Pi 1.0 が MCP を話せるようになったので、すべての eesel ワークスペースが公開する MCP サーバーに接続することもできます（eesel mcp token が URL と 30 日有効のトークンを出力します）。ヘッドレス構成では EESEL_API_URL、EESEL_API_TOKEN、EESEL_AGENT_ID を使います。AI エージェント CLI とカスタマーサポート向け CLI についての私のガイドで、さらに詳しく扱っています。

100 クレジット付きでカード不要の無料プランから始められます。チームメイトの有料プランは月 $299 から 500 クレジットで、チケットまたはチャット 1 件が、どれだけ長くかかっても 1 クレジットです。CLI のセットアップと確認のコマンドは無料で、課金されるのはチャットだけです。解決済みのチケットが欲しいなら、これが近道で、入力作業は引き続き Pi に任せられます。