Pi Coding Agent レビュー：ミニマルでハック可能なAIコーディングCLI

Pi Coding Agentは、4つのデフォルトツールを搭載し、ほとんどの動作を拡張機能、スキル、およびユーザー自身のワークフローに委ねる、最小限かつオープンソースのターミナルコーディングハーネスです。

多くのAIコーディングエージェントは、より大きなプロダクトへと進化しています。プランニングモード、サブエージェント、権限レイヤー、IDE連携、バックグラウンドワーカー、そしてモデルを取り巻くますます複雑なオーケストレーションが追加されています。Piはほぼ逆のアプローチを採用しています。デフォルトのエージェントは、read、write、edit、bashという4つの基本ツールから始まり、興味深い動作の大部分は、意図的に拡張機能、スキル、パッケージ、およびユーザー自身のワークフローに委ねられています。

本レビューは、2026年8月14日にリリースされたPi v0.84.2に基づいています。Mario Zechner氏がプロジェクトを立ち上げ、2026年5月にEarendil Worksへ移管したため、現在のパッケージは旧来の@mariozechnerではなく@earendil-worksスコープを使用しています。Piは急速に変化しているため、チーム全体で標準化させる前に、設定や拡張機能APIのバージョン確認をお勧めします。

ただし、同様に重要な点があります。Piは多くのコーディングエージェントよりもはるかに多くの制御を提供しますが、それに応じてより大きな責任も伴います。Claude Codeや類似ツールを使用した後に開発者が期待するであろう、組み込みのセキュリティサンドボックスや権限システムは提供されていません。以下では、クイックスタート、アーキテクチャ、モデルサポート、拡張機能、セッションモデル、セキュリティへの影響、そして現代のAIコーディングツールの中でPiがどの位置にあり我认为いるかを解説します。

Pi Coding Agentとは何か？

Piは、完成した主観的なコーディング環境ではなく、エージェントハーネスとして理解するのが最も適切です。この区別は重要です。コーディングモデルはプロンプトに回答しますが、エージェントハーネスは、そのモデルがどのようなコンテキストを見るか、どのツールを呼び出せるか、ツールの結果がどのように返されるか、セッションがどのように永続化されるか、ターン間で何が起きるかを決定します。Piはこれらのレイヤーのほとんどをアクセス可能にしているため、AI開発者ツール分野において、オールインワン型のコーディングプロダクトではなく、キット構築エンドに位置しています。

Piを使用する最も強力な理由は、競合するコーディングエージェントよりも多くの機能を持っていることではありません（実際そうではありません）。理由は、Piがエージェント自体のより多くの部分を公開していることです。これは、シニア開発者、プラットフォームエンジニア、AIツールチーム、そしてコーディングエージェントの制限が根本的なモデルではなくハーネスによって引き起こされていると認識したすべての人にとって、特に魅力的です。エージェントをインストールし、いくつかの安全なデフォルトを承認し、そのアーキテクチャについて二度と考えたくないという人にとって、Piは説得力に欠けます。そのミニマリズムは、そのミニマリズムが生み出す制御を重視する場合にのみ生産的です。

Piが実際に提供するもの

デフォルトのモデル向けツールセットは意図的に小さくなっています：

read
write
edit
bash

grep、find、lsを含む追加の読み取り専用ツールが利用可能であり、最近のPiリリースでは、初期の組み込みツール選択を設定できます。

デフォルトは疎らに見えますが、それがポイントです。追加のツールはすべて、モデルが下さなければならない決定の数が増え、システムプロンプトが拡大し、デバッグが必要な別の行動表面を作成します。Piは代わりに、能力のある基本的なセットから始まり、ワークフローが実際にそれらを必要とするときに、専門的なツールを追加できるようにします。

この哲学はツール以上に広がっています。Piは、組み込みのサブエージェントや必須のプランモードをプロダクトの中心にすることを意図的にしていません。これらの動作は、代わりに拡張機能またはインストールされたパッケージを通じて実装できます。これにより、Piは箱出しでは便利さが落ちますが、開発者はこれらのメカニズムがどのように実装されるかをより多く制御できます。Claude Codeの組み込みサブエージェントに慣れている場合、再実装することになるものを理解するための便利な参考資料として、Claude Codeサブエージェントガイドがあります。私はこのアプローチを少し爽快だと感じます。Piは、AIコーディングエージェントを操作する正しい方法が一つだけであると装いません。

Pi Coding Agentのインストールとセッションの開始

現在のパッケージを@earendil-worksスコープからインストールします。古いチュートリアルでは、2026年5月の移管以前の@mariozechnerパッケージが表示されることがありますが、新しいインストールに対してはそれらの名前は古いです。

また、この名前は、Oh My Opencodeハーネスのコミュニティフォークであるoh-my-piと重複しています。そのプロジェクトはこのコーディングエージェントとは無関係であり、Oh My Opencodeレビューは、間違ったPiにたどり着いた場合のフォークを説明しています。

インストールと認証

1. npmでPiをグローバルにインストールします：

   npm install -g --ignore-scripts @earendil-works/pi-coding-agent
   

   --ignore-scriptsは、インストール中の依存関係のライフサイクルスクリプトを無効にします。Piは通常のnpmインストールにこれらのスクリプトを必要としないため、スキップすることで一般的なサプライチェーンリスクを軽減できます。

2. インストールを確認します：

   pi --version
   

3. プロジェクトに入り、開始します：

   cd /path/to/project
   pi
   

Piはbash対応の環境を前提としています。Windowsでは、cmd.exeではなくWSLまたはGit Bashを使用してください。

Piはインタラクティブなサブスクリプション認証およびAPIキーベースのプロバイダをサポートしています。Pi内部では、最も簡単な方法は次のとおりです：

/login

認証後、モデルを選択します：

/model

環境変数を通じてプロバイダの認証情報を提供することもできます。例えば：

export ANTHROPIC_API_KEY="your-api-key"
pi

Piは現在、OpenAI、Anthropic、Google、Azure OpenAI、Amazon Bedrock、NVIDIA NIM、DeepSeek、Mistral、Groq、Cerebras、Cloudflare、xAI、OpenRouterなど、広範なモデルプロバイダをサポートしています。ローカルで提供されるモデル用にllama.cppルータもサポートされています：llama.cppクイックスタートはOpenAI互換APIでのGGUFモデルの提供をカバーし、LLMホスティングガイドは、Ollama、vLLM、またはホスティングプロバイダと比較したい場合の、周辺のローカル、セルフホスト、クラウドランタイムをマッピングします。サポートされているAPIを話すカスタムプロバイダは~/.pi/agent/models.jsonを通じて追加でき、カスタムAPIやOAuthフローは拡張機能で配線できます。

このマルチプロバイダ設計は、Piの実用的な利点の一つです。モデルとコーディングハーネスは別々の変数です：Piでは、ツールとセッション環境を基本的に同じままにしてモデルを変更できるため、完全に異なるコーディングプロダクトを比較するよりも、モデルの比較がはるかに有意義になります。

制御された最初のセッションで始める

最初のPiプロンプトを「私のアプリケーションをリファクタリングしてください」にすべきではありません。変更するのではなく、検査するよう尋ねることから始めてください：

pi --tools read,grep,find,ls -p "Inspect this repository. Explain its architecture, identify the main entry points, and list the commands you would run before making a change. Do not modify files."

既存のリポジトリでその読み取り専用プロンプトを実行したとき、有用な結果は賢いアーキテクチャのエッセイではありませんでした。それは、モデルが実際のエントリポイントと、書き込みアクセスを要求する前に実際に実行するコマンドを特定したかどうかでした。これにより、通常のツールセットを通じて書き込みパスを即座に許可せずに、選択したモデルがあなたのツリーをどのようにナビゲートするかを確認できます。

インタラクティブな作業では、最初に使い捨てのGitブランチを作成することをお勧めします：

git switch -c ai/pi-evaluation
pi

Piは作業ディレクトリ内のファイルを修正し、bashを通じてシェルコマンドを実行できるため、評価時にGitは最も単純で実用的なロールバックレイヤーの一つです。永続化されないテストセッションが欲しい場合、pi --no-sessionはエフェメラルモードで実行します。

プロジェクト指示はAGENTS.mdに属します。有用な開始ファイルは次のようになるかもしれません：

# Project Instructions

- Read the existing implementation before modifying files.
- Keep changes narrowly scoped to the requested task.
- Run `npm test` after code changes.
- Run `npm run lint` before declaring the task complete.
- Do not modify database migrations unless explicitly requested.
- Do not access production infrastructure.
- Explain any destructive command before running it.

Piはプロジェクトディレクトリを巡回する際にCLAUDE.mdも理解し、AGENTS.override.mdはディレクトリ用の通常のプロジェクト指示を上書きできます。

それから具体的なタスクを与えます：

Read the authentication module and its tests.

Find one maintainability problem that can be fixed without changing public behaviour. Explain the proposed change first, then implement it and run the relevant tests.

これは、新しいトイアプリケーションを生成するよう要求するよりも、より良いエージェント評価です。既存のコードは、エージェントに制約を発見し、動作を保持し、関連するファイルを選択し、その作業を検証することを強制します。

なぜPi Coding Agentは編集可能なハーネスなのか

Piの最も重要なアーキテクチャ上のアイデアは、コーディングエージェント自体が編集可能のまま残すべきだというものです。拡張機能システムは、ツールを登録し、ライフサイクルイベントに購読し、ツール呼び出しをインターセプトし、コンテキストを注入または変換し、コマンドを追加し、ターミナルインターフェースを変更できるTypeScriptモジュールを使用します。プロジェクトローカルの拡張機能も/reloadで再読み込みできるため、ハーネスでの実験が驚くほど即座に行えます。

簡略化された形で、Piは次のようになります：

図が単純なのは、Piが制御プレーンを単純に保とうとしているためです。これにより、珍しいオプションが得られます：エージェントに機能が欠けている場合、Piのメンテイナーがそれを追加するのを待つ必要はなく、自分で動作を追加できます。拡張機能は、新しいモデル呼び出し可能なツールを作成し、提案されたbash呼び出しを調査して、独自のポリシーに一致するコマンドをブロックし、ターン前に動的なプロジェクト情報を挿入し、コンパクト化動作を変更し、またはターミナルUI内でカスタムコマンドを公開できます。これは、システムプロンプトを変更するよりもはるかに深い拡張表面です。

MCP統合は、Piの最小限のコアの一部として必須と見なされていません。同じ拡張可能性モデルを通じて追加でき、これはより広い設計と整合しています：専門的な統合は、小さなデフォルトハーネスの上位に存在し、それを永続的に拡大しません。

同じハーネスは、インタラクティブなターミナルの外でも再利用できます。Piは、Node.jsアプリケーションにエージェントセッションを埋め込むためのSDKを同梱しており、非Nodeホスト、IDE、カスタムUI向けにstdin/stdoutでJSONを話すRPCモード（pi --mode rpc）もあります。

4ツールのアイデアは見た目以上に真剣です

最初は、コーディングエージェントのツールを2つのグループに分けて考えました。第一にプリミティブ：ファイルの読み取り、ファイルの変更、コマンドの実行。第二に便利機能：リポジトリ検索、テストランナー、イシュートラッカー、ブラウザツール、デプロイツール、データベースヘルパー、コードインテリジェンス、専門的なプランナー。Piはプリミティブレイヤーを小さく保ち、便利機能レイヤーが任意のままになるようにしています。

これにはアーキテクチャ上の利点があります。Kubernetesインフラストラクチャに取り組むチームと、TypeScriptモノレポを保守するチームでは、同じデフォルトエージェントで互いのツールを搭載することなく、非常に異なるPiを構築できます。ここから、PiはストリップダウンされたClaude Codeの代替品という見た目から、独自のコーディングエージェントを構築するためのフレームワークという見た目へと変わります。

代償はメンテナンスです。カスタム拡張機能に依存し始めると、それらの動作は開発者プラットフォームの一部になります：レビューし、バージョン管理し、Piが進化するにつれて時々更新する必要があります。それが隠れたPiの税金です——エージェントの所有権を得ますが、所有権にはメンテナンスが付随します。

スキルとパッケージがカスタマイズをモジュール化する

すべてのカスタム動作が拡張機能になる必要はありません。Piは、能力の周りに指示、スクリプト、参考資料をパッケージ化するスキルをサポートしています。スキルは段階的開示を使用します：Piは利用可能なスキルをモデルに宣伝しつつ、能力が必要になったときにのみ完全な指示を読み込むことができます。これは、デプロイレビュー、データベース移行、リリース準備、フレームワーク固有のコードレビューなどのワークフローに有用です。すべての会話にページ単位の指示を永続的に注入する代わりに、エージェントは必要に応じて専門的なガイダンスを読み込むことができます。すでにClaude Skillsを構築している場合、メカニクスは馴染み深いものになるでしょう——SKILL.mdのレイアウトとトリガーチューニングについては、開発者向けClaude SkillsとSKILL.mdを参照してください。

Pi Packagesは、拡張機能、スキル、プロンプトテンプレート、テーマをバンドルすることでさらに進みます。パッケージはnpmまたはGitリポジトリからインストールでき、特定のバージョンにピン留めできます：

pi install npm:@foo/pi-tools@1.2.3
pi list

パッケージモデルは強力ですが、パッケージは害のないプロンプトコレクションよりも、実行可能な開発者ツールとして扱うべきです。Pi拡張機能はPiプロセスの権限でコードを実行でき、スキルもモデルにコードの実行を指示できるため、不明なパッケージのインストールは、不明な開発依存関係のインストールとほぼ同じ疑念を払うに値します。

Pi Coding Agentのセッションツリー

多くのコーディングアシスタントは、会話をほぼ線形のトランスクリプトとして扱います。Piはセッションをツリーとして保存するため、以前のポイントに戻り、別のアプローチを試み、1つの履歴を破壊したり、関連のないチャットの山を作ったりするのではなく、セッション内で両方のパスを保持できます。

主要なコマンドは単純です：

/resume
/tree
/fork
/clone
/compact

/treeは現在のセッションツリー内のナビゲーションを可能にします。/forkは以前のユーザーメッセージから新しいセッションを作成し、/cloneは現在アクティブなブランチを別のセッションに複製します。コマンドラインから、pi -cは最近のセッションを継続し、pi -rは過去のセッションを閲覧します。

この区別が明らかになったのは、グリーンフィールドのプロンプトではなく、デバッグパスでPiを初めて使用したときでした。失敗した統合テストについて、キャッシュレイヤーの仮説に従わせた後、その理論が選択されたメッセージからフォークし、トランザクション分離で第2のブランチを開始しました。失敗した調査は、新しいパスを汚染したり、新しいチャットを強制したりするのではなく、対比のために利用可能のまま残りました。これは、デバッグが実際にどのように機能するかを表現する有用なものです：複数の妥当な説明が同時に存在することがよくあるからです。

PiはセッションをJSONLとして永続化し、会話がモデルの制限に近づくと古いコンテキストを自動的にコンパクト化できます。ブランチは、それら間で移動するときにサマリー化することもできます。私はこれを、より目立つコーディングエージェント機能のいくつかよりも高く評価します：良いコンテキスト管理は、インターフェースの別のボタンよりも通常重要であるからです。

コンテキストエンジニアリングは第一級的能力です

Piは、モデルに到達するものをカスタマイズできるようにもします。拡張機能はターン前に情報を注入し、履歴を変更し、コンパクト化に参加できます。デフォルトのコンパクト化システムは、最近の会話を保持しながら古い資料をサマリー化しますが、メカニズムは置き換えたりカスタマイズしたりできます。

高度なチームにとって、これは興味深い可能性を開きます。大きなモノレポは、エージェントが現在触れているファイルの所有権情報のみを注入できます。バックエンドプロジェクトは、データベースファイルがコンテキストに入る際にスキーマメタデータを表面化できます。長時間実行される移行エージェントは、モデルに繰り返し再発見を要求するのではなく、会話の外側に構造化された状態を維持できます。これは私がPiの本当の長期的な強みと考えるものです：コーディングエージェントの品質は、生のモデルの知能よりも、コンテキストエンジニアリング、ツール設計、オーケストレーションによってますます制約されており、Piは開発者にこれらのレイヤーへの異様に直接的なアクセスを与えます。

Pi Coding Agentのセキュリティ：組み込みサンドボックスなし

このレビューで最も重要なネガティブポイントは単純です：Piは組み込みのセキュリティサンドボックスを提供しません。デフォルトで、Piはそれを開始したユーザーとプロセスの権限で実行されます。そのツールは、そのオペレーティングシステムコンテキスト内でアクセス可能なファイルを読み取り、変更し、シェルコマンドを実行できます。

Piにはプロジェクトトラストがありますが、プロジェクトトラストはサンドボックスではありません。プロジェクトトラストは、プロジェクトローカルのPi設定、拡張機能、スキル、プロンプト、および同様のリソースが読み込まれるかを制御します。プロジェクト内で作業している場合、モデル主導のツール呼び出しの周りにファイルシステム、ネットワーク、プロセス、または資格情報の境界を作成しません。実際、Piのドキュメントがこの区別を明確にしていることを私は高く評価しています：弱い擬似サンドボックスは、ユーザーが実際に存在しない境界を信頼する可能性があるため、サンドボックスなしよりも危険になり得るからです。Piは代わりに、意味のある分離がコンテナ、仮想マシン、マイクロVM、または別のポリシー制御ランタイムから来ると期待しています。

使い捨ての個人プロジェクトでは、Gitと通常のオペレーティングシステム権限が十分だと判断するかもしれません。信頼できないリポジトリ、無人エージェント、本番環境資格情報を含むワークステーション、または外部から供給されたコンテンツを処理するエージェントに対しては、より強い分離を使用します。Piのドキュメントは3つのパターンを説明しています：

重要な境界はソースディレクトリだけではありません。シェルコマンドを実行できるエージェントは、SSH設定、クラウド資格情報、パッケージレジストリ、ローカルサービス、ブラウザ状態、およびプロセスに利用可能な他のものと潜在的に相互作用する可能性があります。したがって、本番品質のセットアップは、ファイルシステムマウント、環境変数、ネットワークアクセス、資格情報を一緒に考える必要があります。私の好む評価パターンは次のとおりです：

実際のリポジトリを読み書きでコンテナにマウントしても、エージェントはそのリポジトリを変更できます；コンテナは、マウント、資格情報、能力、ネットワークアクセスが実際に制約されている範囲でのみ役立ちます。Gondolinには関連する注意があります：カスタム拡張機能ツールは、VMに委譲しない限り、まだホストで実行されます。

覚えておくべきもう一つのセキュリティ表面があります：拡張機能とパッケージ。サードパーティの拡張機能は、エージェント環境内で実行されるコードです。インストール前にレビューし、重要な依存関係をピン留めし、パブリックパッケージギャラリーを暗黙のセキュリティレビューとして扱わないでください。

気にするマシンでPiを実行する前に、2つの実用的なチェック：

# Confirm the version you actually have
pi --version

# Disable startup network operations (update checks and install telemetry)
export PI_OFFLINE=1
pi

PI_OFFLINE=1は、更新チェック、パッケージ更新チェック、インストール/更新テレメトリを含む、すべての起動時ネットワーク操作を無効にします。より細かい分離が欲しい場合、PI_SKIP_VERSION_CHECK=1はバージョンチェックのみをオフにし、PI_TELEMETRY=0は更新チェックを有効にしたまま、インストール/更新テレメトリを無効にします。

このセキュリティモデルは、Piを管理されないデフォルトとして大規模なエンジニアリング組織に渡す前に躊躇する主な理由です。Piは強力な環境を構築するための部品を提供しますが、その環境の多くを意図的にあなたに委ねています。

Pi Coding Agent vs Claude Code and OpenCode

Piは、機能数ではなく哲学によって比較される場合に最も意味を成します。ターミナルエージェントの中では、OpenHandsがより近い兄弟です：これもCLIから実行されますが、あなたにそれらを組み立てるよう要求するのではなく、サンドボックスとより大きな組み込みワークフローを同梱します。Claude Codeは、ますます洗練された組み込みの権限、フック、サブエージェントを持っています。OpenCodeは、設定可能なallow、ask、denyルールに加えて、組み込みのエージェントまたはサブエージェントの概念を公開します。Piはスタックのより低い部分から始めます。

これが、Piを「Claude Codeクローン」と呼ぶことが興味深い部分を逃す理由です。Claude Codeのワークフローに満足している場合、Piは自動的にそれを改善しません：Claude Codeは、あなたにそれらの部品を自分で組み立てることを要求せずに、より多くのセキュリティとエージェントオーケストレーション動作を与えます。Piは、プロダクトの前提を変更したいときに興味深くなります。例えば、Anthropic、OpenAI、ローカルモデル間で同じハーネスが欲しい場合。組織に独自のサンドボックスがある場合。すべてのターン前に内部アーキテクチャメタデータを注入するツールが必要場合。コンパクト化が一般的な会話サマリーではなく、構造化されたエンジニアリング状態を生成することを望む場合。それがPiの領域です。

OpenCodeは哲学としてより近いです。なぜなら、それもある程度の設定を提供するからです。それでも、Piはハーネス自体を構築するためのキットのように感じられ、OpenCodeはより多くの完成されたエージェントと権限の概念を公開します。

ここには普遍的な勝者はいません。多くの開発者にとって、Claude Codeの主観的なデフォルトは利点です。他の人にとって、OpenCodeはより良い中間地帯を提供するかもしれません。Piは、「私のコーディングエージェントが異なる方法で動作することを望む」という文が、「私のコーディングエージェントにもう一つの機能が欲しい」という文よりも重要になったときに調査するオプションです。

Pi Coding Agentを使用すべきか？

Pi Coding Agentは、ハーネスを隠すことを拒否するため、技術的に興味深いコーディングエージェントの一つです。デフォルトの実装は意図的に小さいですが、拡張機能API、スキル、パッケージ、プロバイダレイヤー、SDK、RPCモード、セッションツリーにより、4つのデフォルトツールが示唆するよりもはるかに大きな実効表面を持っています。

Piを最も強くお勧めするのは、独自のツールを構築するのが好きな経験豊富な開発者です。AIプラットフォーム作業、実験的なコーディングエージェント研究、専門的なエンジニアリングワークフロー、そしてすでに安全な実行インフラストラクチャを持つチームにとって特に魅力的です。また、コーディング環境全体を毎回変更することなくモデルを比較したい開発者にも有用です。初心者と、インストール直後にエンタープライズスタイルのポリシー制御を期待する組織に対しては、より慎重になるべきです。

欠けているサンドボックスは、Piがデプロイされる方法を変更します。特に、エージェントが無人で動作する許可を与えられた場合、または信頼できない指示に遭遇できる場合です。Piをセキュリティ境界としてではなく、強力なローカル開発プロセスとして扱ってください：信頼できないリポジトリ、無人操作、または貴重な資格情報を含む環境に対しては、オペレーティングシステム、コンテナ、VM、またはベースのサンドボックスを使用し、タスクに必要なリソースのみを公開してください。

私の総合評価は8.4/10です。これは上記の表の平均値ではなく、編集上の判断であり、適切なユーザーにとっては容易に高くなり得ます。Piの最大の弱さと最大の強さは同じものです：エージェントをあなたのために完成させないことです。

Claude Codeから切り替えるべきですか？自動的にではありません。Claude Codeの組み込み権限、サブエージェント、フック、ワークフローがすでにあなたが働く方法に合致している場合、Claude Codeを使用してください。ハーネス、プロバイダ選択、コンテキスト構築、ツールアーキテクチャのより広い所有権を望む場合、Piを評価してください。高度な開発者にとって、選択が排他的である必要はないと仮定することすらありません：Claude Codeが磨かれたデイリードライバーのまま、Piがプログラム可能なエージェント実験室になる可能性があります。十分なカスタマイズの後、その実験室は実際にあなたが好むツールに変わるかもしれません。

ライセンスとコスト

Pi自体はオープンソースであり、MITライセンスの下でリリースされています。これはモデル推論が無料であることを意味しません：実際のコストは、モデルプロバイダ、API使用量、サポートされているサブスクリプション認証、ローカル計算、および選択して実行するサンドボックスインフラストラクチャに依存します。

参考文献

• Pi Coding Agentリポジトリ: https://github.com/earendil-works/pi
• Piウェブサイトとインストーラ: https://pi.dev
• npmパッケージ: https://www.npmjs.com/package/@earendil-works/pi-coding-agent
• GondolinマイクロVM: https://github.com/earendil-works/gondolin
• NVIDIA OpenShell: https://docs.nvidia.com/openshell/about/overview
• ライセンス: MIT