iCode Agent · FAQ

Perguntas, respondidas.

Como instalo o iCode Agent?

Instale o Node.js 22 ou mais recente e execute npm install -g @icodehq/icode-agent. Veja Primeiros passos.

Qual é a diferença entre o iCode Workbench e o iCode Agent?

O iCode Workbench (pré-1.0) é o ADE para desktop: ele executa Claude Code, Codex e OpenCode em paralelo, cada um em seu próprio worktree do Git, com tarefas, revisão e Mira entre projetos. O iCode Agent é o agente de terminal focado descrito nestas perguntas frequentes. São produtos separados, e qualquer um funciona sozinho.

Preciso do Workbench para usar o Agent?

Não. O iCode Agent é uma CLI independente — instale com o npm e execute em qualquer repositório. O Workbench atualmente não encapsula nem inicia o iCode Agent.

Quais modelos posso usar?

O iCode Agent fala os protocolos openai e anthropic, então funciona com as APIs oficiais e qualquer endpoint compatível. Configure um com /model.

Preciso do Bun?

Não. O Bun é o runtime de desenvolvimento para trabalhar no próprio iCode Agent. O pacote publicado roda no Node.js 22 ou mais recente.

Quais plataformas são verificadas?

A compatibilidade multiplataforma está implementada para Windows, macOS e Linux. A verificação automatizada é feita no Linux; a verificação nativa no Windows e no macOS ainda está pendente.

O iCode Agent envia meu código?

Ele roda localmente e conversa apenas com o endpoint de modelo que você configurar, usando a chave de API que você fornecer. Seu código é enviado a esse endpoint como contexto para as tarefas que você executar; aplica-se a política de dados do próprio provedor.

Quanto custa executá-lo?

O iCode Agent em si é gratuito e de código aberto (Apache-2.0). Você paga apenas ao seu provedor de modelo pelos tokens que usar — e o iCode Agent foi feito para manter esse número baixo em tarefas longas.

Como o iCode Agent mantém o uso de tokens baixo?

O contexto é gerenciado em cada fronteira: a saída é limitada conforme é produzida, resultados de ferramenta mais antigos são reduzidos apenas quando uma requisição excederia seu orçamento, e o histórico que transborda é resumido mantendo um trecho recente do final. Veja como o contexto é gerenciado.

Reduzir o contexto perde informação?

Um resultado retido é substituído por um marcador que indica onde a saída completa ainda está, para que o agente possa lê-la de volta. Evidências de falha e erros nunca são retidos, e a redução altera apenas a requisição enviada — a sessão salva mantém todos os resultados.

Onde meu trabalho é salvo?

As sessões são salvas automaticamente no seu diretório de configuração (~/.icode-agent/). Retome a mais recente com --continue, uma específica com --resume <id>, ou gerencie-as com /session.

Com quais agentes ou editores ele funciona?

O iCode Agent é um agente de terminal próprio — você o usa diretamente, não por meio de outro agente. Sua configuração e suas sessões são lidas apenas pela CLI e pela TUI.

Está pronto para uso em produção?

O iCode Agent está em desenvolvimento experimental inicial e muda rapidamente. Veja o changelog para saber o que cada versão inclui.