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.jsondirectamente. - 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.