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.json diretamente.
  • 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.