iCode Agent · Premiers pas

Installez iCode Agent.

Un seul paquet, une seule installation. iCode Agent fonctionne avec Node.js 22 ou une version plus récente, sous Windows, macOS et Linux.

Ce guide couvre l’agent terminal. Pour l’environnement de bureau, voir iCode Workbench.

1. Installez

Installez-le globalement, puis exécutez-le dans n’importe quel projet :

npm install -g @icodehq/icode-agent
cd ~/my-project
icode-agent

Vous préférez ne pas l’installer ? Exécutez-le une fois avec npx @icodehq/icode-agent.

2. Configurez un modèle

Au premier lancement, iCode Agent configure un modèle avant l’ouverture de l’espace de travail. Il parle les protocoles openai et anthropic, il fonctionne donc avec les API officielles et tout endpoint compatible.

  • Choisissez une configuration existante ou ajoutez-en une : protocole, endpoint, nom du modèle, clé API.
  • Un test de connexion réel doit réussir avant tout enregistrement.
  • La configuration est stockée localement dans ~/.icode-agent/models.json.

Changez de modèle à tout moment avec /model ou Ctrl+P.

3. Confiez-lui une tâche

Tapez une tâche en langage naturel et appuyez sur Entrée :

Fix the failing tests in this repository.

iCode Agent explore le code, effectue des modifications, exécute vos commandes et vérifie son propre travail. Regardez-le en direct et orientez-le quand vous le souhaitez.

Utilisation non interactive

Pour les scripts et la 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

Dépannage

  • L’espace de travail ne s’ouvre jamais — aucun modèle n’est encore actif. Terminez la configuration ou écrivez directement ~/.icode-agent/models.json.
  • Une commande échoue immédiatement — sous Windows, les commandes s’exécutent dans PowerShell par défaut ; définissez "shell": "cmd" dans les paramètres pour utiliser CMD.
  • Une tâche longue ralentit — iCode Agent résume le contexte ancien pour garder les requêtes bornées ; il vous préviendra quand il le fait.

La compatibilité multiplateforme est implémentée ; la vérification automatisée est effectuée sous Linux, et la vérification native sous Windows et macOS est en attente.

Toujours bloqué ? Ouvrez une issue.