iCode Agent · Loslegen
Installiere iCode Agent.
Ein Paket, eine Installation. iCode Agent läuft auf Node.js 22 oder neuer unter Windows, macOS und Linux.
Diese Anleitung behandelt den Terminal-Agenten. Zur Desktop-Umgebung siehe iCode Workbench.
1. Installieren
Installiere es global und führe es dann in einem beliebigen Projekt aus:
npm install -g @icodehq/icode-agent cd ~/my-project icode-agent
Lieber nicht installieren? Führe es einmal mit npx @icodehq/icode-agent aus.
2. Konfiguriere ein Modell
Beim ersten Start richtet iCode Agent ein Modell ein, bevor der Arbeitsbereich geöffnet wird. Er spricht die Protokolle openai und anthropic und funktioniert daher mit den offiziellen APIs und jedem kompatiblen Endpunkt.
- Wähle eine vorhandene Konfiguration oder füge eine hinzu: Protokoll, Endpunkt, Modellname, API-Schlüssel.
- Ein echter Verbindungstest muss erfolgreich sein, bevor etwas gespeichert wird.
- Die Konfiguration wird lokal unter
~/.icode-agent/models.jsongespeichert.
Wechsle jederzeit mit /model oder Ctrl+P das Modell.
3. Gib ihm eine Aufgabe
Formuliere eine Aufgabe in Alltagssprache und drücke Enter:
Fix the failing tests in this repository.
iCode Agent erkundet den Code, nimmt Änderungen vor, führt deine Befehle aus und verifiziert seine eigene Arbeit. Sieh live zu und steuere ihn, wann immer du willst.
Nicht interaktive Nutzung
Für Skripte und CI:
icode-agent -p "run the tests and report failures" # print the final response icode-agent --mode json -p "find TODO comments" # stream events as JSON lines icode-agent -c -p "now fix what you found" # continue the last session
Fehlerbehebung
- Der Arbeitsbereich öffnet sich nie — es ist noch kein Modell aktiv. Schließe die Einrichtung ab oder schreibe
~/.icode-agent/models.jsondirekt. - Ein Befehl schlägt sofort fehl — unter Windows laufen Befehle standardmäßig in PowerShell; setze in den Einstellungen
"shell": "cmd", um CMD zu verwenden. - Eine lange Aufgabe wird langsamer — iCode Agent fasst älteren Kontext zusammen, um Anfragen begrenzt zu halten; er sagt dir, wenn er das tut.
Plattformübergreifende Kompatibilität ist implementiert; die automatisierte Verifikation erfolgt unter Linux, die native Verifikation unter Windows und macOS steht noch aus.
Weiterhin festgefahren? Eröffne ein Issue.