Como instalar o Codex CLI no Windows e começar a usar agentes de IA

Neste artigo, o foco principal é o vídeo abaixo. Nele, o professor Alessandro Ferreira, especialista em inteligência artificial e modelagem 3D, mostra passo a passo como instalar o Codex CLI no Windows e dar os primeiros passos com um agente de IA dentro do terminal.

Se você prefere aprender vendo a tela, comece pelo vídeo. O professor mostra como abrir o navegador, encontrar a página oficial, copiar o comando de instalação, abrir o terminal no Windows, fazer login com a conta do ChatGPT e testar se o Codex abriu corretamente.

O que é o Codex CLI?

O Codex CLI é o agente de programação da OpenAI que roda localmente no terminal. Em vez de trabalhar apenas em uma janela de chat, você abre uma pasta do computador e conversa com um agente capaz de ler arquivos, entender o projeto, sugerir alterações, editar código e executar comandos dentro daquele diretório.

Segundo a documentação oficial da OpenAI, o Codex CLI está disponível para macOS, Windows e Linux. No Windows, ele pode ser usado nativamente pelo PowerShell, com o sandbox do Windows, ou pelo WSL2 quando você precisa de um ambiente Linux.

Em termos simples: o Codex CLI leva a inteligência artificial para perto dos seus arquivos de trabalho. Por isso ele é especialmente útil para quem programa, cria sites, automatiza tarefas, estuda IA ou quer entender como funcionam os agentes modernos.

Antes de instalar

Para acompanhar o tutorial, você precisa de três coisas básicas:

Um computador com Windows, de preferência Windows 11 ou Windows 10 atualizado.
Um navegador, como Google Chrome ou Microsoft Edge.
Uma conta ChatGPT com acesso ao Codex, ou uma chave de API da OpenAI caso prefira pagar por uso.

No vídeo, a recomendação é entrar com a conta do ChatGPT. Para quem está aprendendo, esse caminho costuma ser mais simples do que configurar uma API key, porque o próprio Codex abre o navegador e conduz o login.

Comando de instalação do Codex CLI

A página oficial para conferir os comandos atualizados é esta:

Página oficial do Codex CLI na OpenAI

No Windows, abra o PowerShell ou o Terminal do Windows e rode:

irm https://chatgpt.com/codex/install.ps1 | iex

Em macOS ou Linux, o comando oficial de instalação é:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Depois de instalar, você inicia o Codex com:

codex

Como esses comandos podem mudar com o tempo, sempre vale conferir a página oficial antes de instalar em outro computador.

Passo a passo no Windows

1. Abra a página oficial

Abra o Chrome ou o Edge e pesquise por Codex install. Entre no resultado oficial da OpenAI, ou acesse diretamente a página do Codex CLI pelo link acima.

Na página, procure a opção de instalação para Windows. Copie o comando mostrado ali.

2. Abra uma pasta no Terminal

No Explorador de Arquivos do Windows, entre no Disco Local (C:) ou em qualquer pasta onde você queira trabalhar. Clique com o botão direito em uma área vazia e escolha Abrir no Terminal.

Esse detalhe é importante: clique em uma área vazia, não em cima de uma pasta. Assim o terminal abre exatamente no local que você escolheu.

3. Cole o comando de instalação

No terminal, cole o comando copiado. No Windows Terminal, normalmente basta clicar com o botão direito do mouse para colar. Depois pressione Enter.

O instalador vai detectar o seu sistema automaticamente. Se aparecer alguma pergunta com y/n, o y significa yes, ou seja, sim. Digite y e pressione Enter quando quiser confirmar.

4. Inicie o Codex

Quando a instalação terminar, rode:

codex

Na primeira execução, o Codex vai pedir login. Escolha a opção de entrar com sua conta do ChatGPT, confirme no navegador e volte para o terminal quando a autenticação terminar.

5. Confirme a pasta de trabalho

Ao abrir em uma pasta, o Codex pode perguntar se você confia naquele diretório. Isso acontece porque o agente pode ler arquivos, editar código e executar comandos dentro da pasta selecionada.

Para testar, você pode confirmar. Mas para trabalhar de verdade, o ideal é abrir o terminal dentro de uma pasta específica do seu projeto, não na raiz do disco C.

E se aparecer erro?

Erros de instalação normalmente acontecem por dois motivos: falta alguma ferramenta no computador, ou alguma variável de caminho do Windows não foi configurada corretamente.

A dica prática do vídeo é simples: copie a mensagem de erro, cole no ChatGPT ou no Gemini e peça:

Explique este erro e me dê o comando para resolver no Windows.

Depois rode o comando sugerido e teste de novo em uma nova aba do terminal. Isso é importante porque algumas correções só passam a valer depois que você fecha a aba antiga e abre outra.

Ferramentas que ajudam: Git e Node.js

O Codex CLI tem instalador próprio, mas quem vai usar agentes de IA para criar sites, automatizar tarefas ou programar vai encontrar com frequência duas ferramentas importantes:

Git: usado para baixar projetos, controlar versões e trabalhar com repositórios.
Node.js: usado em muitos projetos web, ferramentas de linha de comando e automações modernas.

Se algum erro mencionar Git, procure por git install, baixe o instalador oficial do Git para Windows e avance nas opções padrão.

Se algum erro mencionar Node, procure por node js download, baixe o Windows Installer no site oficial e siga a instalação padrão.

Como testar se ficou tudo certo

Depois de instalar ou corrigir algum erro, faça este teste:

Abra uma nova aba no Terminal do Windows.
Feche a aba antiga.
Digite codex e pressione Enter.
Veja se o Codex abre sem repetir o erro anterior.

Esse processo evita um problema comum: a janela antiga do terminal pode continuar com configurações antigas do sistema. Por isso, sempre teste em uma aba nova.

Por que aprender isso agora?

Instalar o Codex CLI não é apenas instalar mais uma ferramenta. É dar o primeiro passo para entender como funciona a inteligência artificial agêntica: IAs que não apenas respondem perguntas, mas analisam contexto, usam ferramentas, executam comandos e ajudam a produzir resultados concretos.

Esse tipo de habilidade já aparece em áreas como programação, design, modelagem 3D, automação, criação de conteúdo, marketing e produtividade profissional. Quem aprende a trabalhar com agentes ganha uma vantagem prática: consegue transformar ideias em tarefas executadas com muito mais velocidade.

Links úteis

Quer aprender inteligência artificial na prática?

Ferramentas como o Codex mostram que aprender IA deixou de ser teoria distante. Hoje, você pode usar agentes para estudar, criar projetos, organizar arquivos, escrever prompts melhores e automatizar partes do trabalho.

No curso de Inteligência Artificial da Escola Habilidade, você aprende esses conceitos com linguagem simples, exemplos reais e aplicação prática para o dia a dia.

Ver curso de Inteligência Artificial