iCode Agent · Primeros pasos

Instala iCode Agent.

Un paquete, una instalación. iCode Agent se ejecuta en Node.js 22 o posterior, en Windows, macOS y Linux.

Esta guía cubre el agente de terminal. Para el entorno de escritorio, consulta iCode Workbench.

1. Instalar

Instálalo globalmente y ejecútalo en cualquier proyecto:

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

¿Prefieres no instalarlo? Ejecútalo una vez con npx @icodehq/icode-agent.

2. Configura un modelo

En el primer inicio, iCode Agent configura un modelo antes de abrir el espacio de trabajo. Habla los protocolos openai y anthropic, así que funciona con las API oficiales y cualquier endpoint compatible.

  • Elige una configuración existente o añade una: protocolo, endpoint, nombre del modelo, clave de API.
  • Una prueba de conexión real debe pasar antes de guardar nada.
  • La configuración se guarda en local en ~/.icode-agent/models.json.

Cambia de modelo en cualquier momento con /model o Ctrl+P.

3. Dale una tarea

Escribe una tarea en lenguaje natural y pulsa Enter:

Fix the failing tests in this repository.

iCode Agent explora el código, hace cambios, ejecuta tus comandos y verifica su propio trabajo. Míralo en vivo y dirige cuando quieras.

Uso no interactivo

Para scripts y 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

Solución de problemas

  • El espacio de trabajo no se abre: aún no hay ningún modelo activo. Termina el flujo de configuración o escribe ~/.icode-agent/models.json directamente.
  • Un comando falla de inmediato: en Windows, los comandos se ejecutan en PowerShell de forma predeterminada; establece "shell": "cmd" en la configuración para usar CMD.
  • Una tarea larga se ralentiza: iCode Agent resume el contexto antiguo para mantener acotadas las peticiones; te avisará cuando lo haga.

La compatibilidad multiplataforma está implementada; la verificación automatizada se realiza en Linux y la verificación nativa en Windows y macOS está pendiente.

¿Sigues atascado? Abre un issue.