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.json gespeichert.

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.json direkt.
  • 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.