Guia de instalação

O HagiCode oferece três métodos de instalação. Escolha primeiro um caminho de acordo com o seu cenário de uso, depois confirme os pré-requisitos desse caminho e, por fim, siga para a página de instalação correspondente.

Escolha um método de instalação

Seu cenário	Método recomendado
Uso pessoal local no Windows	Instalação pela Microsoft Store
Uso pessoal local no macOS / Linux, ou Windows sem acesso à Store	Instalação do Desktop
Servidor, NAS, compartilhamento em equipe ou necessidade de isolamento do ambiente	Instalação com Docker Compose

Instalação pela Microsoft StoreEntrada recomendada por padrão no Windows, com instalação e atualizações posteriores pela loja oficial.

Instalação do DesktopFluxo gráfico de instalação e gerenciamento. Indicado para macOS / Linux e para usuários do Windows que precisam baixar o pacote de instalação manualmente.

Instalação com Docker ComposeIndicado para cenários que exigem isolamento de ambiente, implantação padronizada ou colaboração em equipe.

Preparação antes da instalação

Cada caminho tem pré-requisitos diferentes:

Método de instalação	Node.js	Git
Microsoft Store / Desktop	Você mesmo precisa instalar a versão 24 ou superior	Você mesmo precisa instalar
Docker Compose	Não é necessário no host	Não é necessário no host

O Desktop não inclui mais o Node.js

O Desktop inclui apenas o runtime .NET necessário para executar o HagiCode Server e não fornece mais o Node.js. Ele procura node e npm no PATH do sistema e instala pacotes gerenciados, como os Agent CLIs, no diretório global do npm da sua máquina. Instale o Node.js 24 ou superior antes de abrir o Desktop pela primeira vez; veja Instalar o Node.js.

Instalar o Git

O Desktop detecta node, npm e git ao iniciar, e o “Projeto de demonstração” da caixa de diálogo “Novo Projeto” da interface principal também precisa do Git para clonar o repositório de exemplo oficial. Escolha uma das opções abaixo de acordo com o seu sistema:

• Windows: execute winget install --id Git.Git -e ou baixe o instalador em git-scm.com.
• macOS: execute xcode-select --install ou, com o Homebrew, execute brew install git.
• Debian / Ubuntu: execute sudo apt-get install -y git.
• Fedora: execute sudo dnf install -y git.

Depois de instalar, reabra o terminal e confirme que os comandos estão disponíveis:

node --version
npm --version
git --version

Instale tudo antes de abrir o Desktop

O Desktop lê o PATH do sistema ao iniciar. Se você instalar o Node.js ou o Git com o Desktop já aberto, feche-o por completo e abra-o novamente.

Agent CLI

O HagiCode trabalha com um Agent CLI instalado e já autenticado na sua máquina. O assistente de inicialização lista apenas os CLIs detectados localmente, portanto instale e faça login em pelo menos um antes de entrar no assistente. Os CLIs compatíveis atualmente, as formas de instalação e os pontos de entrada oficiais são mantidos em Instalação do AI Agent CLI.

Instalação de softwares relacionados

Instalar o Node.jsPrepare o Node.js 24+ e o npm, dos quais o Desktop e a maioria dos Agent CLIs dependem.

Introdução ao OpenSpecVá ao site de documentação independente do OpenSpec para conhecer as formas de instalação, os conceitos centrais e o fluxo de trabalho orientado por especificações.

Instalar o AI Agent CLIVeja os Agent CLIs compatíveis atualmente e diferencie a instalação com um clique da instalação / autenticação manual.

Próximos passos

1. Escolha o método de instalação na tabela acima e conclua primeiro os pré-requisitos.
2. Conclua a instalação e faça a primeira inicialização; em seguida, siga a Configuração do assistente de inicialização para criar o Hagicoder padrão e o seu primeiro projeto.
3. Para conhecer o fluxo de propostas do OpenSpec, leia a Introdução ao OpenSpec e Criar uma sessão de proposta.