Pi Coding Agent（pi.dev）とは？インストールから使い方を初心者向けに徹底解説

💡 まずは結論：Pi（パイ）は「全部入りじゃない」ことを前提に作られたミニマルなAIコーディングエージェントです。 Claude CodeやCodex CLIが最初からたくさんの機能を持っているのに対し、Piは「自分で好きに拡張する」ことを前提に設計されています。複数のAIプロバイダーを使い分けたい人、自分好みにカスタマイズしたい人に向いています。

本記事では、筆者が実際にLinux環境（Ubuntu 22.04相当）に pi をインストールし、バージョン 0.80.6 であることを確認したうえで、初心者にもわかるよう使い方をまとめました。

🤔 Pi って何？ 一言で言うと

Pi は、ターミナルで動く AIコーディングエージェント（コードを書いてくれるAIアシスタント）です。

一言で言えば、「自分の作業スタイルに合わせてカスタマイズできる、軽量なコーディングAI」 です。

身近な例で言うと、以下のようなツールの仲間です。

• Claude Code（Anthropic製）
• Codex CLI（OpenAI製）
• Gemini CLI（Google製）

これらと同じく「ターミナルで指示を出すと、AIがファイルを読み書きしてコードを書いてくれる」という体験ができます。違いは「最初から機能が詰め込まれているか、自分で組み立てる前提か」です。

⚡ なぜ今「ミニマル」なエージェントが注目されるのか

Claude Code や Codex CLI は非常に便利ですが、反面「やり方をツール側に合わせる」必要があります。

Pi の開発者（Earendil Inc. / badlogic）は、こう考えました。

ハーネス（枠組み）を変えるのではなく、ワークフローを Pi に合わせるべき。

その結果、Pi はあえて以下の機能を「最初から」は入れませんでした。

• サブエージェント（部下となるAI）
• プランモード（計画立案モード）
• 権限ポップアップ（実行許可のダイアログ）
• MCP（外部ツール連携の標準規格）
• 内蔵のToDo管理

これらは「他のツールが勝手に決めていること」であり、Pi では 拡張機能（Extension）やスキル（Skill）、パッケージ で自分で組み立てる設計になっています。

つまり Pi は、「自分で作る人」のためのエージェント です。

🛠️ インストール手順（実際にやってみた）

筆者環境（Node.js v22.22.2 / npm 10.9.7）で実際に導入しました。

Linux / macOS の場合

2つの方法があります。

方法A：curl インストーラー（おすすめ・最短）

curl -fsSL https://pi.dev/install.sh | sh

方法B：npm でグローバルインストール

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

--ignore-scripts は公式が推奨するオプションです。Pi は通常の npm インストールで追加のインストールスクリプトを必要としないため、依存関係のライフサイクルスクリプトを無効化して安全に導入できます。

筆者は方法Bで実行し、added 131 packages in 8s と表示され、無事に導入できました。

Windows の場合

PowerShell 向けのインストーラーが用意されています。

powershell -c "irm https://pi.dev/install.ps1 | iex"

バージョン確認

インストール後、以下で動作確認できます。

pi --version

筆者の環境では 0.80.6 と表示されました。

アンインストール

npm uninstall -g @earendil-works/pi-coding-agent

🔑 認証（AIに使ってもらうモデルを用意する）

Pi 自体は無料のオープンソースソフトですが、AIモデルを動かすには プロバイダーの認証 が必要です。2つの方法があります。

方法1：サブスクリプションでログイン

Pi を起動してから以下を実行します。

/login

対応しているのは以下のサブスクリプションです。

• Claude Pro / Max（Anthropic）
• ChatGPT Plus / Pro（Codex）
• GitHub Copilot

方法2：APIキーを使う

環境変数に APIキー を設定してから起動します。

export ANTHROPIC_API_KEY=ご自身のキー
pi

または、Pi 起動後に /auth と入力してプロバイダーを選び、キーを保存することもできます。

🚀 最初の使い方（ファーストセッション）

プロジェクトのディレクトリに移動して pi を起動します。

cd /path/to/project
pi

起動すると、指示を入力して Enter を押すだけで使えます。

このリポジトリを要約して、チェック（テスト）の実行方法を教えて。

Pi はデフォルトで4つのツールを持っています。

1. ファイルの読み書き
2. シェルコマンドの実行
3. 検索
4. その他の読み取り専用ツール

Pi は現在の作業ディレクトリで動き、そこにあるファイルを編集できます。巻き戻したい時は git などでバックアップを取るのがおすすめです。

📂 プロジェクトごとの指示を出す（AGENTS.md）

Pi は起動時に「プロジェクトの指示ファイル」を読み込みます。これを AGENTS.md と呼びます。

プロジェクトのルートに AGENTS.md を作り、以下のように書きます。

# プロジェクトの指示

- コードを変更したら `npm run check` を実行すること
- 本番のマイグレーションはローカルで実行しないこと
- 回答は簡潔にすること

Pi は ~/.pi/agent/ や親ディレクトリ、カレントディレクトリからこのファイルを自動で探して読み込みます。チームで共有すれば「このプロジェクトの決まり」をAIに覚えさせられます。

🎛️ 4つの動作モード

Pi は状況に合わせて4つのモードを使い分けられます。

スクリプトから使いたい時は pi -p "ファイル一覧を出して" のように Print モードが便利です。--mode json を付けると、処理の流れをJSONのイベントストリームで取得できます。

🧩 カスタマイズの基本（拡張・スキル・パッケージ）

Pi の醍醐味は「自分で機能を足せる」ことです。主なカスタマイズ手段は4つ。

これらをまとめたものを Pi パッケージ といい、npm や git からインストールできます。

pi install npm:@foo/pi-tools
pi install git:github.com/badlogic/pi-doom

「サブエージェントが欲しい」「MCPが使いたい」「計画モードが欲しい」といった要望も、パッケージを入れるか自分で拡張を書くことで実現できます。公式には「50以上の例」が公開されています。

🌐 対応プロバイダー（15種類以上）

Pi の強みの1つが AIモデルの自由度の高さ です。対応プロバイダーは以下の通り。

• Anthropic
• OpenAI
• Google
• Azure
• Bedrock
• Mistral
• Groq
• Cerebras
• xAI
• Hugging Face
• Kimi For Coding
• MiniMax
• NVIDIA
• OpenRouter
• Ollama（ローカル）

セッション中に /model や Ctrl+L でモデルを切り替えられます。Ctrl+P でお気に入りを順番に切り替え可能。独自のプロバイダーやモデルも models.json や拡張で追加できます。

🔄 セッションの「ツリー保存」が便利

Pi のセッションは ツリー構造 で1つのファイルに保存されます。

• /tree で過去の任意のポイントに移動し、そこから別の方針で続行できる
• すべての分岐（ブランチ）が単一ファイルにまとまる
• /export でHTML出力、/share でGitHub Gistにアップロードして共有URLを生成

「あの時別の方針を試したかった」という時、枝分かれを残せるのは大きなメリットです。

⚖️ Claude Code / Codex CLI との違い

同じ「ターミナル系コーディングAI」でも、設計思想は異なります。

筆者の見解：全部入りの Claude Code で満足している人はそのままで良いですが、「複数のAIを使い分けたい」「仕組みを自分でいじりたい」「OSSであることが良い」 という場合は Pi が非常に魅力的です。

💡 筆者が考える「おすすめの使い方」

調査と実際の導入を通して、Pi を一番活かす使い方を3つ提案します。

1. AGENTS.md で「プロジェクトのルール」を最初に決める 他のエージェントでも有効ですが、Pi は拡張性が高い分「何をしてよいか」を最初に明示すると迷いません。テストコマンドや禁止事項を書いておきましょう。

2. サブスクリプション（Claude Max など）と組み合わせる APIキーを都度気にするより、/login でサブスクリプション認証する方が、コストの見通しが立てやすくて安心です。

3. tmux と組み合わせて「疑似的な並列作業」に使う Pi は「バックグラウンド実行」を持ちませんが、tmux で複数のペインに Pi を起動すれば、サブエージェント代わりの並列作業ができます。公式も「tmux で Pi インスタンスを起動」を推奨しています。

🤔 よくある質問（FAQ）

Q. Pi は無料ですか？ Pi 自体は MITライセンスのオープンソースで無料です。ただしAIモデルを動かすには、プロバイダーの APIキー または サブスクリプション料金が別途必要です。

Q. Windows でも動きますか？ はい。公式の Windows セットアップ手順と、PowerShell 用インストーラーが用意されています。

Q. Claude Code とどちらが良いですか？ 「すぐ使えて全部入り」なら Claude Code、「軽量で自分好みに拡張したい」なら Pi です。両方試して自分に合う方を選ぶのがおすすめです。

Q. セッションは保存されますか？ はい。ツリー構造で1ファイルに保存され、/tree で過去のポイントに戻って続行できます。

Q. コーディング以外にも使えますか？ RPC モードや SDK モードを使えば、自分のアプリケーションに Pi を組み込めます。

📝 まとめ

Pi（pi.dev）は、「ミニマルなコア + 自分で拡張」 を信条とする新しいタイプのAIコーディングエージェントです。

• 筆者が実際に Linux に導入し、バージョン 0.80.6 を確認
• インストールは curl 1行 または npm で数秒
• 認証はサブスクリプション /login か APIキー
• 15種以上のAIプロバイダーを切り替えて使える
• サブエージェントやMCPは「最初からは入っていない」が、拡張やパッケージで自分で足せる
• セッションはツリー保存で枝分かれも管理可能

つまり、Pi は「自分のワークフローをAIに合わせるのではなく、AIを自分のワークフローに合わせたい人」のためのツールです。 Claude Code のような全部入りが良い人も多いですが、軽さと拡張性、OSSであることを重視するなら、今すぐ試すべき1本です。

👉 公式サイト: Pi Coding Agent 👉 GitHub: earendil-works/pi 👉 ドキュメント: Pi Documentation 👉 npm: @earendil-works/pi-coding-agent 👉 Discord: Pi Community

---

合わせて読みたい

• 【2026年】Claude Fable 5で金融資産を守る！AIエージェントによる資産管理・監視・最適化の実践ガイド
• 【2026年】Cloudflare Monetization Gateway完全ガイド！Webページ・API・MCPツールに「1回の課金」をかける方法
• 【2026年】A Fable of Codexes完全ガイド — Claudeが指揮するAIワーカー軍団の作り方
• 【2026年】GPT-Live完全ガイド！OpenAIのフルデュプレックス音声AIがChatGPTを根本から変える
• 【2026年】component.galleryを使ってAIのUI生成指示を劇的に上手くする方法！コンポーネント用語図鑑の活用法