Cela semble peu, mais le fondamental de l'Agent est simplement lire, écrire, modifier et exécuter. De nombreuses capacités plus complexes peuvent être dérivées de ces primitives.

Beaucoup de produits d'Agent préparent tout : plans, sous-Agents, MCP, approbations de permissions et listes de tâches, et l'utilisateur n'a qu'à configurer.

PI vous donne un squelette d'Agent fonctionnel, que vous pouvez personnaliser. Pour un mode de planification, utilisez des fichiers ou des extensions ; pour des sous-Agents, lancez plusieurs instances de PI avec tmux ou écrivez vos propres extensions ; pour se connecter à MCP, installez les extensions correspondantes.

Il ressemble à une maison en plancher avec des installations sanitaires et électricité. Comment vous serez-vous à l'intérieur, dépendra de votre aménagement ultérieur.

Installation

Méthode 1 : laisser l'Agent s'occuper de l'installation

Si vous utilisez déjà Codex, Claude Code ou d'autres Agents pouvant interagir avec le terminal, vous pouvez lui envoyer ce bloc de code complet :

Installez et vérifiez l'Agent PI Coding en fonction de l'environnement de votre ordinateur actuel :

1. Vérifiez l'OS, l'architecture de l'CPU, Node.js, npm, et le Node.js et npm réellement en vigueur dans le PATH actuel；
2. PI nécessite Node.js >= 22.19.0. Si ce n'est pas le cas, indiquez la solution d'upgrade, sans modifier directement l'environnement；
3. Installez via le package officiel npm @earendil-works/pi-coding-agent, en conservant l'option --ignore-scripts de l'official；
4. Exécutez `pi --version` et `pi --help` pour la validation；
5. Ne lisez, ne imprimez, ne modifiez aucun API Key ou identifiants de connexion；
6. Dites-moi comment se connecter via /login à un abonnement existant, et comment faire une validation en lecture seule dans un répertoire de test vide；
7. Si un problème survient, vérifiez d'abord les documents du dépôt officiel et du site officiel, sans deviner les paramètres.

Méthode 2 : faire l'installation vous-même, étape par étape

Étape 1 : Vérifier Node.js et npm

Ouvrez le terminal sur macOS ou Linux, et PowerShell sur Windows, puis exécutez :

node -v
npm -v

Les exigences de Node.js pour le package npm de PI sont :

>= 22.19.0

Si node -v est inférieur à cette version, commencez par mettre à jour Node.js. Si vous avez plusieurs versions (nvm, Homebrew, Node système), prenez le temps de vérifier :

which node
which npm

Souvent, vous pensez avoir mis à jour, mais le terminal utilise toujours la version ancienne. Ce piège est très courant dans les outils CLI.

Pour Windows, une exigence supplémentaire. PI utilise par défaut Git Bash pour exécuter des commandes Bash. Une fois Git for Windows installé, c'est tout.

Étape 2 : Installer PI

Commande d'installation officielle via npm :

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

Notez que l'option --ignore-scripts doit être conservée. Elle interdit aux dépendances d'exécuter des scripts de viecyle au moment de l'installation, ce qui n'est pas nécessaire pour l'installation normale de PI.

Le site officiel propose également un script d'installation par un seul clic :

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

Toutes ces options sont possibles. Cependant, curl | sh est vraiment le plus simple.

Vérification après l'installation :