Preparação: instale a sua ferramenta de agents
A metodologia AI Native usa uma ferramenta de agents — um programa de IA que roda no seu computador e cria os assistentes que você vai aprender a construir. Existem três opções equivalentes: Claude Code, Codex e OpenCode. Esta página instala qualquer uma delas passo a passo — pensada para quem nunca usou um terminal. Reserve uns 20 minutos.
Conclua esta instalação antes de avançar para a metodologia. A partir do Nível 2 você vai criar seus primeiros agents — e isso só funciona com a ferramenta instalada e funcionando no seu computador. Não pule este passo.
Passo 1 — Conheça o terminal (PowerShell)
O "terminal" é uma janela onde você digita comandos em vez de clicar em botões. No Windows ele se chama PowerShell. Você vai usá-lo só para instalar e para abrir a ferramenta — nada de programação.
Abra o PowerShell
Pressione a tecla Windows, digite PowerShell e aperte Enter. Vai abrir
uma janela escura com um texto começando com PS C:\Users\….
Saiba diferenciar PowerShell de CMD
Existem dois terminais parecidos. Se a linha começa com PS (ex:
PS C:\Users\Voce>), você está no PowerShell — é o que queremos. Se começa sem
o PS (só C:\Users\Voce>), você está no CMD. Os comandos desta
página são para o PowerShell.
Para colar um comando no PowerShell, copie aqui (Ctrl+C), clique na janela do PowerShell e aperte Ctrl+V (ou clique com o botão direito). Depois aperte Enter para executar.
Passo 2 — Escolha a sua ferramenta de agents
As três opções servem igualmente para a metodologia — você vai usar todas do mesmo jeito: abrindo, descrevendo o seu trabalho e conversando. A escolha prática depende de qual conta de IA você já tem (ou prefere assinar):
| Opção | Conta necessária | Instalação |
|---|---|---|
| A · Claude Code | Claude Pro ou Max (claude.ai) | A mais simples: um comando, sem programas extras |
| B · Codex | ChatGPT Plus/Pro ou chave de API (OpenAI) | Dois passos: instalar o Node.js e depois o Codex |
| C · OpenCode | Funciona com contas e chaves de vários provedores de IA (Claude, OpenAI e outros) — é um programa de código aberto | Dois passos: instalar o Node.js e depois o OpenCode |
Instale só uma. Já assina o Claude? Vá de Opção A. Já assina o ChatGPT? Vá de Opção B. Quer flexibilidade para trocar de provedor de IA depois, ou prefere software de código aberto? Vá de Opção C. Siga apenas a seção da sua escolha e pule as outras duas.
Opção A — Instale o Claude Code
O Claude Code tem um instalador próprio que não exige instalar mais nada.
Tenha uma conta Claude paga
O Claude Code precisa de uma conta Claude Pro ou Max (o plano gratuito não inclui). Crie ou assine em claude.ai antes de continuar.
Rode o instalador no PowerShell
Cole o comando abaixo no PowerShell e aperte Enter. Ele baixa e instala tudo sozinho:
Aguarde a mensagem de conclusão. (Página oficial: code.claude.com/docs/setup.)
Instale o Git for Windows (recomendado)
Não é obrigatório, mas deixa o Claude Code mais completo. Baixe em git-scm.com/downloads/win e instale com as opções padrão — só certifique-se de deixar marcada a opção "Add Git to PATH" durante a instalação.
Feche e reabra o PowerShell
Esse passo é importante: feche a janela do PowerShell e abra de novo. Isso faz o Windows reconhecer o programa recém-instalado.
Abra o Claude Code e faça login
Digite o comando abaixo e aperte Enter. Na primeira vez, ele abre o navegador para você entrar com sua conta Claude:
Confirme que está funcionando
Para checar, rode:
Se aparecer um número de versão, está instalado. Se algo der errado, rode claude doctor — ele
faz um diagnóstico e sugere correções. Veja também a seção Problemas comuns abaixo.
Existe também o app de desktop do Claude para Windows, com interface gráfica. Baixe em claude.com/download. Para acompanhar a metodologia, porém, recomendamos o terminal — é o que será usado nos exemplos.
Opção B — Instale o Codex
O Codex é a ferramenta de agents da OpenAI — escolha esta opção se você já usa o ChatGPT. Você só precisa de uma das três ferramentas — pule esta seção se já instalou outra.
Instale o Node.js
O Codex precisa do Node.js. Baixe a versão LTS em nodejs.org/download e instale com as opções padrão (avançar até concluir).
Feche e reabra o PowerShell e instale o Codex
Depois de instalar o Node.js, feche e reabra o PowerShell. Então cole:
É @openai/codex — com o @openai/ na frente. O erro mais comum é digitar só
codex, que instala um pacote antigo e sem relação com a OpenAI. Copie o comando exatamente como
está acima.
Abra o Codex e faça login
Rode o comando abaixo. Na primeira vez ele pede para você entrar com sua conta ChatGPT (Plus/Pro) ou uma chave de API:
Páginas oficiais: guia rápido e documentação do CLI.
Opção C — Instale o OpenCode
O OpenCode é uma ferramenta de agents de código aberto — escolha esta opção se quiser liberdade para usar contas e chaves de diferentes provedores de IA (Claude, OpenAI e outros) na mesma ferramenta. Você só precisa de uma das três ferramentas — pule esta seção se já instalou outra.
Instale o Node.js
Assim como o Codex, o OpenCode precisa do Node.js. Baixe a versão LTS em nodejs.org/download e instale com as opções padrão (avançar até concluir). Se você já instalou o Node.js, pule este passo.
Feche e reabra o PowerShell e instale o OpenCode
Depois de instalar o Node.js, feche e reabra o PowerShell. Então cole:
É opencode-ai — com o -ai no final. Copie o comando exatamente como está acima.
Conecte a sua conta de IA
O OpenCode não vem com uma IA própria — você conecta a conta que já tem. Rode o comando abaixo, escolha o seu provedor na lista (Claude, OpenAI e outros) e siga as instruções na tela:
Abra o OpenCode
Com a conta conectada, abra a ferramenta:
Documentação oficial: opencode.ai/docs.
Resolvendo problemas comuns
Quase todo problema de instalação no Windows cai em um destes casos. Não se assuste — são rápidos de resolver.
"'claude' não é reconhecido…" (ou 'codex', ou 'opencode')
O programa foi instalado, mas o Windows ainda não sabe onde encontrá-lo. Na maioria das vezes a solução é simples:
- 1º: feche o PowerShell e abra de novo. Teste o comando novamente.
- 2º: se ainda não funcionar, reinicie o computador e teste de novo.
- 3º: se persistir, ajuste a "variável de ambiente PATH" manualmente — veja a seção abaixo.
"O token '&&' não é um separador de instrução válido"
Você está no PowerShell tentando usar um comando do CMD. Use os comandos desta página, que são feitos para PowerShell.
"'irm' não é reconhecido como um comando interno…"
O contrário: você está no CMD, não no PowerShell. Feche, abra o PowerShell (tecla Windows →
digite "PowerShell" → Enter) e tente de novo. Confira: a linha precisa começar com PS.
"A execução de scripts foi desabilitada neste sistema"
O Windows está bloqueando scripts por segurança. Abra o PowerShell e rode o comando abaixo (ele libera só para a sua conta, com segurança) e tente instalar novamente:
Quando perguntar, digite S (ou Y) e Enter.
Entendendo as variáveis de ambiente (PATH)
O PATH é uma lista de pastas onde o Windows procura programas quando você digita um comando. Se a pasta do programa não está nessa lista, o Windows responde que "não reconhece" o comando — mesmo o programa estando instalado. Os instaladores normalmente adicionam a pasta sozinhos; quando isso falha, você adiciona à mão.
Se, depois de reabrir o terminal e reiniciar o computador, o comando ainda não for reconhecido, adicione a pasta do programa ao PATH:
Abra as variáveis de ambiente
Pressione a tecla Windows, digite variáveis de ambiente e clique em "Editar as variáveis de ambiente do sistema". Na janela que abrir, clique no botão "Variáveis de Ambiente…".
Edite o "Path" do usuário
Na parte de cima ("Variáveis de usuário"), clique uma vez em Path para selecionar e depois em "Editar…".
Adicione a pasta do programa
Clique em "Novo" e cole o caminho conforme a ferramenta que você instalou:
| Ferramenta | Cole este caminho |
|---|---|
| Claude Code (instalador próprio) | %USERPROFILE%\.local\bin |
| Codex (via npm) | %APPDATA%\npm |
| OpenCode (via npm) | %APPDATA%\npm |
Salve e teste
Clique em OK em todas as janelas. Feche e reabra o PowerShell e rode
claude --version (ou codex --version, ou opencode --version). Agora
deve funcionar.
Pronto para a metodologia?
Confirme antes de avançar:
- ✓ Instalei uma ferramenta de agents: Claude Code, Codex ou OpenCode
- ✓ Tenho uma conta de IA válida conectada a ela (Claude Pro/Max, ChatGPT Plus/Pro, chave de API ou provedor configurado no OpenCode)
- ✓ O comando da ferramenta (
claude,codexouopencode) abre sem erro - ✓ Consegui fazer login pela primeira vez
Tudo marcado? Você está pronto. A ferramenta entra em uso de verdade a partir do Nível 2 — mas comece pelo Nível 1, que prepara o seu mapa de trabalho.