Instalação da CLI do Agente AI

Esta página é a entrada unificada de instalação local dos AI Agent CLIs do HagiCode. O HagiCode atualmente oferece suporte ativo a 11 Agent CLIs: Claude Code, Codex, GitHub Copilot, OpenCode, Hermes, QoderCLI, Kiro, Kimi, Gemini, DeepAgents e Codebuddy.

Como usar esta página

Verifique primeiro a tabela para obter o estado de suporte atual e o modo de configuração e, em seguida, continue com os documentos de instalação, autenticação, ACP, permissão e solução de problemas mantidos pelo fornecedor. O escopo do suporte e o modo de configuração são preocupações distintas.

Prepare antes o Node.js 24+

A maioria dos CLIs com instalação com um clique depende do Node.js e do npm, e o Desktop também usa o node e o npm do seu sistema (o Desktop não inclui mais o Node.js). Prepare primeiro a versão 24 ou superior seguindo Instalar o Node.js e, depois da instalação, conclua o login ou a autenticação: o assistente de inicialização lista apenas os CLIs detectados na máquina.

Matriz de suporte atual

Ferramenta	Estado atual	Modo de configuração	Entrada oficial de instalação	Entrada de referência oficial	Notas
Claude Code	Atualmente suportado	Instalação com um clique	Primeiros passos	Visão geral	Caminho de instalação guiada padrão.
Codex	Atualmente suportado	Instalação com um clique	Repositório CLI OpenAI Codex	Documentos do OpenAI Codex	Caminho de instalação guiada padrão.
GitHub Copilot	Atualmente suportado	Instalação com um clique	Instalar a CLI do Copilot	Visão geral da CLI do Copilot	Caminho de instalação guiada padrão.
OpenCode	Atualmente suportado	Instalação com um clique	Documentos da CLI do OpenCode	Documentos OpenCode	Geralmente precisa de um login ou /connect etapa após a instalação.
Hermes	Atualmente suportado	Instalação/autenticação manual	Instalação Hermes	Guia de início rápido da Hermes	Com suporte agora, mas as etapas de instalação local e autenticação permanecem manuais.
QoderCLI	Atualmente suportado	Instalação com um clique	Início rápido do Qoder	Qoder ACP	Conclua o fluxo de login do fornecedor após a instalação.
Kiro	Atualmente suportado	Instalação com um clique	Instalação Kiro	Autenticação Kiro, Kiro ACP	O instalador oficial abre o fluxo de autenticação da primeira execução.
Kimi	Atualmente suportado	Instalação com um clique	Kimi - Primeiros passos	Referência Kimi ACP	Conclua o fluxo de login do fornecedor após a instalação.
Gemini	Atualmente suportado	Instalação/autenticação manual	Instalação, execução e lançamentos do Gemini CLI	Configuração de autenticação Gemini CLI	Com suporte agora, mas você mesmo instala e autentica a CLI local.
DeepAgents	Atualmente suportado	Instalação/autenticação manual	Visão geral da CLI do DeepAgents	DeepAgents ACP	Compatível agora, mas você precisa de um local funcional deepagents --acp primeiro.
Codebuddy	Atualmente suportado	Instalação com um clique	Instalação CLI do CodeBuddy	CodeBuddy ACP	Caminho de instalação guiada padrão.

Glossário estadual

• Atualmente suportado significa que a CLI pertence à faixa de suporte ativa atual do HagiCode.
• Instalação com um clique significa que o HagiCode fornece um ponto de entrada de instalação guiada; algumas CLIs ainda exigem login do fornecedor ou etapa de autenticação após a instalação.
• Instalação/autenticação manual significa que a CLI é suportada agora, mas você deve concluir a instalação local ou o fluxo de autenticação antes que o HagiCode possa detectá-la e usá-la.
• Somente compatibilidade herdada significa que o iFlow CLI é mantido apenas por compatibilidade com dados antigos; ele não faz parte da faixa de suporte ativo atual e não deve ser considerado uma opção recomendada hoje.

Próximas etapas recomendadas

• Para preparar primeiro o ambiente básico, continue com Instalar o Node.js e, se precisar, leia a Introdução ao OpenSpec.
• Se você deseja um gateway local para várias ferramentas compatíveis com OpenAI, continue com Instalação e uso do OmniRoute.
• Para conhecer o caminho geral de instalação e pré-requisitos como Node.js e Git, volte ao Guia de instalação.
• Se você chegou aqui a partir de uma postagem histórica no blog, trate esta página e a visão geral da instalação como a atual fonte perene de verdade.