iCode Agent · FAQ

Des questions, des réponses.

Comment installer iCode Agent ?

Installez Node.js 22 ou une version plus récente, puis exécutez npm install -g @icodehq/icode-agent. Voir Premiers pas.

Quelle différence entre iCode Workbench et iCode Agent ?

iCode Workbench (pré-1.0) est l’ADE de bureau : il exécute Claude Code, Codex et OpenCode en parallèle, chacun dans son propre worktree Git, avec les tâches, la révision et Mira sur l’ensemble des projets. iCode Agent est l’agent terminal ciblé décrit dans cette FAQ. Ce sont deux produits distincts, et chacun fonctionne seul.

Faut-il Workbench pour utiliser Agent ?

Non. iCode Agent est un CLI autonome — installez-le avec npm et exécutez-le dans n’importe quel dépôt. Workbench n’encapsule ni ne lance actuellement iCode Agent.

Quels modèles puis-je utiliser ?

iCode Agent parle les protocoles openai et anthropic, il fonctionne donc avec les API officielles et tout endpoint compatible. Configurez-en un avec /model.

Faut-il Bun ?

Non. Bun est l’environnement d’exécution de développement pour travailler sur iCode Agent lui-même. Le paquet publié fonctionne avec Node.js 22 ou une version plus récente.

Quelles plateformes sont vérifiées ?

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

iCode Agent téléverse-t-il mon code ?

Il s’exécute localement et ne communique qu’avec l’endpoint de modèle que vous configurez, à l’aide de la clé API que vous fournissez. Votre code source est envoyé à cet endpoint comme contexte pour les tâches que vous lancez ; la politique de données du fournisseur s’applique.

Combien coûte son utilisation ?

iCode Agent est lui-même gratuit et open source (Apache-2.0). Vous ne payez que votre fournisseur de modèle pour les tokens utilisés — et iCode Agent est conçu pour garder ce nombre bas sur les tâches longues.

Comment iCode Agent limite-t-il l’usage des tokens ?

Le contexte est géré à chaque étape : la sortie est plafonnée au fur et à mesure de sa production, les anciens résultats d’outils ne sont réduits que lorsqu’une requête dépasserait son budget, et l’historique qui déborde est résumé en conservant les échanges récents. Voir comment le contexte est géré.

La réduction du contexte fait-elle perdre des informations ?

Un résultat retenu est remplacé par un marqueur qui indique où se trouve encore la sortie complète, afin que l’agent puisse la relire. Les preuves d’échec et les erreurs ne sont jamais retenues, et la réduction ne modifie que la requête envoyée — la session enregistrée conserve chaque résultat.

Où mon travail est-il enregistré ?

Les sessions sont enregistrées automatiquement dans votre répertoire de configuration (~/.icode-agent/). Reprenez la plus récente avec --continue, une session précise avec --resume <id>, ou gérez-les avec /session.

Avec quels agents ou éditeurs fonctionne-t-il ?

iCode Agent est un agent terminal à part entière — vous l’utilisez directement, pas via un autre agent. Sa configuration et ses sessions ne sont lues que par le CLI et le TUI.

Est-il prêt pour la production ?

iCode Agent est en développement expérimental précoce et évolue rapidement. Consultez le journal des modifications pour le contenu de chaque version.