iCode Agent · Primeiros passos
Instale o iCode Agent.
Um pacote, uma instalação. O iCode Agent roda no Node.js 22 ou mais recente, no Windows, macOS e Linux.
Este guia cobre o agente de terminal. Para o ambiente desktop, veja o iCode Workbench.
1. Instale
Instale globalmente e execute em qualquer projeto:
npm install -g @icodehq/icode-agent cd ~/my-project icode-agent
Prefere não instalar? Execute uma vez com npx @icodehq/icode-agent.
2. Configure um modelo
Na primeira inicialização, o iCode Agent configura um modelo antes de abrir o espaço de trabalho. Ele fala os protocolos openai e anthropic, então funciona com as APIs oficiais e qualquer endpoint compatível.
- Escolha uma configuração existente ou adicione uma: protocolo, endpoint, nome do modelo, chave de API.
- Um teste de conexão real precisa passar antes de qualquer coisa ser salva.
- A configuração é armazenada localmente em
~/.icode-agent/models.json.
Troque de modelo a qualquer momento com /model ou Ctrl+P.
3. Dê uma tarefa a ele
Digite uma tarefa em linguagem natural e pressione Enter:
Fix the failing tests in this repository.
O iCode Agent explora o código, faz alterações, executa seus comandos e verifica o próprio trabalho. Acompanhe ao vivo e oriente quando quiser.
Uso não interativo
Para scripts e 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
Solução de problemas
- O espaço de trabalho nunca abre — ainda não há um modelo ativo. Conclua a configuração inicial ou escreva
~/.icode-agent/models.jsondiretamente. - Um comando falha imediatamente — no Windows, os comandos rodam no PowerShell por padrão; defina
"shell": "cmd"nas configurações para usar o CMD. - Uma tarefa longa fica mais lenta — o iCode Agent resume o contexto mais antigo para manter as requisições dentro do limite; ele avisará quando fizer isso.
A compatibilidade multiplataforma está implementada; a verificação automatizada é feita no Linux, e a verificação nativa no Windows e no macOS está pendente.
Ainda com problemas? Abra uma issue.