Primeiros passos02 / 16
Instalar e preparar o Noea
Nesta página
Para começar, instale o aplicativo de desktop Noea e prepare pelo menos um Agente de programação. O aplicativo orienta você na instalação, no login e na verificação da conexão.
Escolha um instalador
Acesse a seção de download do Noea e escolha a versão para seu sistema operacional e processador.
| Sistema | O que escolher |
|---|---|
| macOS | Apple silicon, macOS 13 ou posterior. Atualmente não há instalador para Mac com Intel. |
| Windows | x64 para processadores Intel ou AMD; ARM64 para dispositivos Windows com ARM. |
| Linux | x86_64 ou ARM64, conforme seu processador. Há pacotes AppImage e .deb. |
No macOS, abra a imagem de disco e instale o aplicativo. No Windows, execute o instalador; a instalação é feita para o usuário atual sem exigir privilégios de administrador. No Linux, use AppImage ou .deb conforme sua distribuição.
Prepare seu primeiro Agente
Se nenhum Agente estiver pronto quando o Noea iniciar, o guia de configuração será aberto.
- Escolha um Agente na lista e clique em Instalar.
- Aguarde o download e siga o painel de detalhes para fazer login e autorizar o acesso.
- Aguarde a verificação da conexão pelo Noea. Somente o status Pronto indica que a verificação foi concluída com sucesso.
- Escolha a opção de começar a usar o Noea e entre na área de trabalho.
O Noea oferece suporte atualmente a Codex, Claude Code, OpenCode e CodeBuddy Code. Basta um para começar. Adicione outros depois em Ajustes → Agente.
O Noea baixa o ambiente de execução necessário para o Agente, portanto você não precisa instalar o Node.js antes. O progresso do download e da preparação aparece no aplicativo.
Faça login pelo método do Agente
O login pode abrir um navegador, um terminal integrado ou um terminal do sistema, ou solicitar uma chave de API. Siga as instruções do Agente selecionado.
O Codex prefere login pelo navegador no macOS e no Windows, e por código de dispositivo no Linux. O OpenCode é configurado conectando um provedor de modelos. Para contas de provedores, chaves de API e endpoints personalizados, consulte Agentes, modelos e uso.
O Noea verifica a conexão novamente depois do login. Se continuar solicitando login ou informar uma falha, abra o painel de detalhes do Agente para ver o motivo.
Mesmo que você já use um Agente em outra ferramenta de terminal, confira o status dele na lista do Noea para saber se está pronto aqui.
Resolva problemas de download ou verificação
Downloads e solicitações dos Agentes usam as configurações de proxy HTTP(S) do sistema. Variáveis de ambiente de proxy têm prioridade quando definidas. Esse mecanismo não oferece suporte a proxies SOCKS.
Se um download falhar, confira a rede e o proxy e tente novamente no mesmo local. Um status de preparação durante uma breve pausa no recebimento de dados não significa necessariamente que o download falhou.
Se a instalação funcionar, mas a verificação falhar, use o painel de detalhes do Agente para refazer o login, corrigir as configurações do provedor ou resolver problemas de rede. Você pode copiar os diagnósticos ao pedir ajuda; consulte Solução de problemas.
Abra seu projeto
Na área de trabalho, escolha Abrir Pasta… e selecione sua pasta de código. O Noea abre ou cria um projeto vinculado. Você não precisa de um documento completo de requisitos, servidores MCP ou Skills para acompanhar o primeiro tutorial.
Continue com Seu primeiro fluxo de trabalho.