img-0

Pi-Agent installieren

KI,

Die Installation des Pi Coding Agents (pi.dev) unter Windows 11 läuft unkompliziert über Node.js. Da Pi als minimalistisches Terminal-Werkzeug konzipiert ist, benötigen Sie ein Terminal (am besten das moderne Windows Terminal) und eine installierte Node.js-Umgebung.

Hier ist die Schritt-für-Schritt-Anleitung:

1. Voraussetzungen prüfen

Stellen Sie sicher, dass Node.js auf Ihrem System installiert ist. Öffnen Sie Ihre Eingabeaufforderung (cmd) oder die PowerShell und prüfen Sie die Version:

Bash

 
node -v
npm -v

Falls nicht installiert: Laden Sie sich einfach die aktuelle LTS-Version von der offiziellen Node.js-Webseite herunter und installieren Sie diese.

2. Pi Agent installieren

Die offizielle Empfehlung für die Installation unter Windows lautet, das npm-Paket global zu installieren. Der Parameter --ignore-scripts wird empfohlen, um die Installation schlank und sicher zu halten:

Bash

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

3. Pi Agent starten & Einrichten

Wechseln Sie im Terminal in den Ordner Ihres Programmierprojekts und starten Sie den Agenten:

Bash

 
cd C:\Pfad\zu\Ihrem\Projekt
pi

KI-Modelle & API-Keys einrichten

Beim ersten Start müssen Sie dem Pi Agenten mitteilen, welches Sprachmodell (z.B. Anthropic Claude, OpenAI ChatGPT oder DeepSeek) verwendet werden soll.

  • Über das Terminal-Menü: Tippen Sie im laufenden Pi-Fenster einfach /login ein. Sie können dort Ihren bevorzugten Anbieter auswählen und Ihren API-Key direkt hinterlegen (dieser wird sicher in ~/.pi/agent/auth.json gespeichert).

  • Alternativ über Umgebungsvariablen: Sie können den Key auch vor dem Start in Ihrer PowerShell setzen (Beispiel für Anthropic):

    PowerShell

     
    $env:ANTHROPIC_API_KEY="ihr-api-key"
pi

Nützliche Windows-Bedienungshinweise

  • Neue Zeile im Prompt: Nutzen Sie Shift + Enter (oder Ctrl + Enter im Windows Terminal), um einen Zeilenumbruch zu machen, ohne die Nachricht direkt abzuschicken.

  • Bilder einfügen: Sie können Bilder direkt per Ctrl + V oder per Drag-and-drop in das Terminal ziehen, falls Sie visuelle Vorlagen nutzen möchten.

API-Key speichern: Dauerhaft für Ihren Benutzer (Permanent)

Wenn Sie möchten, dass der Pi Agent (oder andere Skripte) auch nach einem Neustart des PCs immer auf den Key zugreifen können, müssen Sie ihn im Benutzerprofil von Windows hinterlegen.

Verwenden Sie dazu diesen Befehl:

PowerShell

 
[System.Environment]::SetEnvironmentVariable("OPENROUTER_API_KEY", "Ihr_OpenRouter_API_Key_Hier", "User")

💡 Wichtig nach der permanenten Einrichtung: Damit die Änderung aktiv wird, müssen Sie Ihr aktuelles PowerShell- oder Terminal-Fenster einmal schließen und neu öffnen.

Überprüfen, ob es geklappt hat

Sie können in einer neuen PowerShell-Sitzung ganz einfach prüfen, ob Windows den Key geladen hat, indem Sie ihn ausgeben lassen:

PowerShell

 
$env:OPENROUTER_API_KEY

Wenn Ihr Key jetzt im Terminal angezeigt wird, ist alles perfekt eingerichtet und der Pi Agent kann darauf zugreifen!

Recommended for you