title: "Pi(OSSコーディングエージェント)を試す前の安全点検|npmを--ignore-scriptsで取得し、実行前に静的チェックする手順"
tags:
- AIエージェント
- npm
- Pi
- ClaudeCode
- セキュリティ
private: false
はじめに
「Goodbye Claude, hello Pi」というブログが、Hacker Newsで586ポイントを集めました※4。OSSのコーディングエージェント「Pi」に乗り換えた、という内容です。
Piは、公式READMEによると、権限システムを標準では持ちません※2。ファイルやコマンドを自由に実行できるため、試す前の点検が、いつもより重要になります。
この記事では、Piを実行する前にできる、安全点検の手順を示します。
- npmで、スクリプトを実行せずに取得する
- 取得したパッケージの、ライフサイクルスクリプトを静的に点検する
-
CLAUDE.mdとAGENTS.mdの共通化を確認する - 隔離環境で試す、最初の手順を決める
実施日は2026-11-09です。環境はLinux、Node v22.23.4、Python 3.13です。筆者はPiを実行していません。 取得した外部のコードを実行する操作が、実行環境の自動判定で止められたため、回避せずに見送りました。この記事の内容は、取得と静的点検までです。
1. 前提:Piとは
公式サイトとREADMEの説明をまとめます※2※3。
| 項目 | 内容 |
|---|---|
| 位置づけ | 最小のエージェントハーネス(ターミナル用のコーディングエージェント) |
| 提供 | Earendil Inc.と貢献者。MITライセンス |
| 必要な環境 | Node.js 22.19以上 |
| 利用モード | 対話型TUI、print / JSON、RPC、SDK |
| 標準で持たないもの | サブエージェント、プランモード、権限システム |
| 拡張 | TypeScriptのモジュール。npmやgitから配布 |
| GitHub | 118.2kスター、15.1kフォーク(2026-11-09取得) |
READMEは、権限システムについて、ファイルシステム、プロセス、ネットワーク、認証情報へのアクセスを制限する仕組みを持たないと書いています。より強い隔離には、コンテナやサンドボックスを勧めています※2。
2. npmで、スクリプトを実行せずに取得する
公式のnpm手順にも --ignore-scripts が付いています※2。このオプションは、インストール時に、依存パッケージが持つ preinstall や postinstall を実行しないようにします。
mkdir -p pi-check && cd pi-check
npm install --ignore-scripts --prefix ./inst @earendil-works/pi-coding-agent
取得したバージョンの確認です。
grep -E '"(name|version|license)"' inst/node_modules/@earendil-works/pi-coding-agent/package.json
結果です。
"name": "@earendil-works/pi-coding-agent",
"version": "1.5.0",
"license": "MIT",
筆者の環境で、サイズと構成を確認しました。
du -sh inst/node_modules # 158M
ls inst/node_modules | wc -l # 79(スコープ付きは1件として数えます)
ls inst/node_modules/@earendil-works
@earendil-works 配下には、次の8つが入っていました。
pi-agent-core pi-ai pi-codemode pi-coding-agent pi-mcp pi-schema pi-telemetry pi-tui
必要なNodeは >=22.19.0 と、package.json に書かれています。筆者のNodeはv26.8.2で、条件を満たしていました。
3. ライフサイクルスクリプトを静的に点検する
--ignore-scripts で取得しても、後から npm rebuild などを実行すると、スクリプトが動く場合があります。実行する前に、どのパッケージが、どんなスクリプトを持つかを知っておくと安全です。
3.1 点検スクリプト
node_modules 内の package.json を走査し、preinstall、install、postinstall、prepare を持つパッケージを列挙します。Python 3.13の標準ライブラリだけで動きます。
#!/usr/bin/env python3
"""node_modules 内の package.json を走査し、install系ライフサイクルスクリプトを持つパッケージを列挙する。
--ignore-scripts で取得したパッケージを「実行前に」点検するための静的チェック(Python 3.13、標準ライブラリのみ)。"""
import json, os, sys
root = sys.argv[1]
hooks = ("preinstall", "install", "postinstall", "prepare")
total = 0; found = []
for dp, dn, fn in os.walk(root):
if "package.json" in fn:
try: d = json.load(open(os.path.join(dp, "package.json"), encoding="utf-8"))
except Exception: continue
if not d.get("name") or not d.get("version"): continue
total += 1
s = d.get("scripts", {}) or {}
hit = {k: s[k] for k in hooks if k in s}
if hit: found.append((d["name"], d["version"], hit))
print(f"packages scanned: {total}")
for n, v, h in sorted(set((n, v, json.dumps(h, ensure_ascii=False)) for n, v, h in found)): print(f" {n}@{v}: {h}")
print("lifecycle hooks found:", len(found))
3.2 実行結果
python3 -I audit_scripts.py inst/node_modules
実際の出力です。
packages scanned: 127
@google/genai@2.21.0: {"preinstall": "echo 'preinstall: no-op'", "prepare": "node scripts/prepare.js"}
@isaacs/nonrecursive-glob-match@1.1.0: {"prepare": "tshy && bash scripts/build.sh"}
balanced-match@4.0.4: {"prepare": "tshy"}
brace-expansion@5.0.12: {"prepare": "tshy"}
gaxios@7.3.1: {"prepare": "npm run compile"}
gcp-metadata@8.1.2: {"prepare": "npm run compile"}
google-auth-library@10.9.1: {"prepare": "npm run compile"}
google-logging-utils@1.1.3: {"prepare": "npm run compile"}
lru-cache@11.5.3: {"prepare": "tshy && bash scripts/build.sh"}
minimatch@11.0.3: {"prepare": "tshy"}
protobufjs@7.6.6: {"postinstall": "node scripts/postinstall"}
standardwebhooks@1.1.1: {"prepare": "npm run build"}
undici@8.12.3: {"prepare": "husky && node ./scripts/platform-shell.js"}
web-streams-polyfill@3.3.3: {"prepare": "npm run build"}
lifecycle hooks found: 14
127個のパッケージを走査し、14個がライフサイクルスクリプトを持っていました。
3.3 結果の読み方
| 区分 | パッケージ | 内容 |
|---|---|---|
postinstall |
protobufjs@7.6.6 |
node scripts/postinstall を実行する |
preinstall |
@google/genai@2.21.0 |
echo 'preinstall: no-op'。何もしない |
prepare |
他の12個 | ビルド用(tshy、npm run compile など) |
prepare は、一般にnpmの仕様として、レジストリから依存として入れる場合には実行されず、開発時(ローカルでの npm install やgit経由の取得)に使われます。筆者はこの仕様を、今回の環境で試していません。公式のnpmドキュメントで確認してください。
注意すべきは postinstall を持つパッケージです。protobufjs は、広く使われているライブラリです。筆者は、scripts/postinstall の中身を読んでいません。スクリプトの実行を許可する前に、中身を読むのが安全です。
この点検は、悪意の有無を判定するものではありません。スクリプトの存在を知るためのものです。
3.4 うまくいかなかった点
- スクリプトの中身(
scripts/postinstallなど)までは、確認していません。 - 依存の依存まで走査した結果で、
node_modulesに展開されたものだけが対象です。 -
npm auditのような、既知の脆弱性の確認は、この記事では行っていません。
4. CLAUDE.md と AGENTS.md を共通化する
ブログの著者は、Claude Codeが CLAUDE.md、他のツールが AGENTS.md を使うため、コピーかシンボリックリンクが必要だと書いています※1。Piは、AGENTS.md と SYSTEM.md を文脈設計の仕組みに挙げています※3。
ブログによると、Anthropicは AGENTS.md への対応を発表済みです※1。ただし、筆者はその公式の記述を確認していません。対応状況は、利用中のバージョンで確認してください。
シンボリックリンクで共通化する手順を、一時ディレクトリで試しました。
echo "# rules" > AGENTS.md
ln -s AGENTS.md CLAUDE.md
ls -l
git init -q . && git add AGENTS.md CLAUDE.md && git ls-files -s
結果です。
-rw-r--r-- 1 root root 8 AGENTS.md
lrwxrwxrwx 1 root root 9 CLAUDE.md -> AGENTS.md
100644 e4dce001483aafa30db213c87b139909893f64ff 0 AGENTS.md
120000 47dc3e3d863cfb5727b87d785d09abf9743c0a72 0 CLAUDE.md
gitは、CLAUDE.md をモード 120000(シンボリックリンク)として記録しました。内容は AGENTS.md と同じです。
注意点:Windowsでは、シンボリックリンクの扱いに設定が必要な場合があります。チームにWindows利用者がいる場合は、コピーを生成するスクリプトも検討してください。この点は、筆者は検証していません。
5. 隔離環境で試す、最初の手順
Piは権限システムを持たないため、先に隔離を用意します※2。READMEの推奨に沿った考え方を、手順に直します。筆者は実行していません。
| 手順 | 内容 |
|---|---|
| 1 | 使い捨てのコンテナを用意する(ホストの重要なディレクトリはマウントしない) |
| 2 | 本番の認証情報を持ち込まない。環境変数にも入れない |
| 3 | ネットワークは、必要な接続先だけを許可する |
| 4 | プロジェクトは、コピーまたは読み取り専用でマウントする |
| 5 |
npm install -g --ignore-scripts @earendil-works/pi-coding-agent で入れる※2 |
| 6 |
pi を起動し、/login でプロバイダを接続する |
| 7 | 小さなタスクで試し、実行されたコマンドを記録する |
| 8 | 権限ゲートの拡張を入れる場合は、先にサンプルのコードを読む |
READMEは、npm版が、推移的な依存のバージョンを固定しないと書いています※2。再現性が必要な場合は、ロックファイルで固定してください。
5.1 同じ日の話題と合わせて
同じ日に、Claude Codeの「Don't Ask Again」で秘密が保存される件が、HNで515ポイントを集めました。承認ルールを保存する設計が、秘密の保存になる、という話です。
Piは、承認ルールを持たないため、その経路は生まれません。ただし、制限もないため、隔離と認証情報の管理が、利用者側の責任になります。どちらが安全かは、運用で決まります。
6. 筆者がまだ確認できていないこと
- Piの実行、対話動作、拡張、権限ゲートの挙動。
-
pi.devの公式インストールスクリプト(この環境から接続できませんでした)。 - ブログの数字(244リリース、4分の3超、約3,000トークン)の再計測。
-
protobufjsなどのpostinstallの中身。
まとめ
- Piは、権限システムを標準で持たないOSSのエージェントハーネスです。試す前の点検と隔離が重要です。
-
--ignore-scriptsで取得し、スクリプトを静的に点検すると、実行前に、存在を知ることができます。筆者の環境では、127パッケージ中14個がライフサイクルスクリプトを持っていました。 -
CLAUDE.mdとAGENTS.mdは、シンボリックリンクで共通化できます。 - 筆者は、Piを実行していません。実行環境が整い次第、隔離して試します。
※本記事の記載内容は筆者個人の見解であり、所属する会社や組織の立場や方針とは一切関係ありません。
筆者情報
【Tomcat-zhou】|AI/AX/AIセキュリティ専門家
AI戦略洞察、AI駆動開発の方法論設計と現場で回る仕組みづくりをしています。
noteで戦略洞察 / Zenn・Qiitaで技術・方法論を書いています。
AIセキュリティ・AIコンサル・AIエージェント開発・AI活用・AI駆動開発教育、AI人材育成サービスを一体で提供。
X: @ZY20240528
LinkedIn: Tomcat-zhou
Facebook: zhou yi
note: Tomcat-zhou
Zenn: Tomcat-zhou
参考資料
- Goodbye Claude, hello Pi(caleb.software、2026-09-21公開・2026-11-07更新)
- earendil-works/pi(GitHub、2026-11-09取得)
- Pi 公式サイト(pi.dev、2026-11-09取得)
- Hacker News フロントページ(2026-11-09取得)
タグ
AIエージェント npm Pi ClaudeCode セキュリティ AGENTS.md OSS
