Se o terminal ainda parece uma tela onde qualquer comando pode quebrar tudo, não comece pelo projeto que paga suas contas. Abra uma pasta de teste. É nela que o Codex CLI faz mais sentido no primeiro dia.
O Codex é um agente de código que roda no terminal. Você entra numa pasta, pede para ele explicar o projeto, procurar um erro ou alterar um arquivo, e acompanha o que acontece sem sair dali. A parte boa é essa proximidade com o código. A parte que pede cuidado também: quando você libera edição e comandos, a conversa passa a mexer de verdade no seu computador.
Por isso este guia não começa com “deixe a IA construir um aplicativo”. Vamos instalar, entrar na conta e fazer uma primeira tarefa pequena. Nada heroico. Melhor terminar entendendo o que aconteceu do que sair com vinte arquivos modificados e nenhuma ideia de como voltar.
Antes de instalar: escolha onde você pode errar
Você precisa de uma conta aceita pelo Codex, um terminal funcionando e uma pasta de projeto. Para o primeiro teste, use um projeto pequeno, uma cópia de um repositório ou até uma pasta criada só para experimentar.
Eu não começaria pelo sistema em produção, pelo projeto de um cliente ou pela única cópia de algo importante. O Codex pode trabalhar apenas como leitor, mas também pode editar arquivos e executar comandos quando recebe permissão. Ter uma rota de fuga muda completamente a experiência.
Se o projeto usa Git, confira o estado antes de abrir o agente:
git statusHá alterações que você ainda não salvou? Faça um commit ou guarde o trabalho antes de continuar. O Git não é obrigatório para abrir o Codex, mas é o jeito mais simples de comparar mudanças e desfazer uma tentativa ruim.
Instalando no macOS ou Linux
Na documentação oficial consultada em 29 de agosto de 2026, a OpenAI mostra este instalador standalone:
curl -fsSL https://chatgpt.com/codex/install.sh | shQuando terminar, feche e abra o terminal se o comando ainda não aparecer. Depois execute:
codexSe a tela inicial do Codex abrir, a instalação funcionou. Se o terminal disser que não encontrou o comando, não baixe um executável aleatório para “resolver rápido”. Primeiro reabra o terminal e confira o troubleshooting na página oficial.
E no Windows?
A página do Codex tem uma aba específica para Windows. Use o método exibido nela no momento da instalação: developers.openai.com/codex/cli.
Essa recomendação é menos empolgante do que colar um comando pronto aqui, mas é mais honesta. O instalador pode mudar, e copiar a linha de macOS/Linux no PowerShell só porque ela apareceu primeiro é um ótimo jeito de começar a manhã brigando com o terminal.
Depois da instalação, abra um novo PowerShell ou Prompt de Comando e rode codex. Se aparecer “comando não encontrado”, feche todas as janelas do terminal e tente outra vez para atualizar o PATH. Persistindo o erro, volte à documentação oficial da versão instalada.
O primeiro login acontece na interface oficial
Na primeira execução, o Codex apresenta os métodos de autenticação disponíveis. Escolha Sign in with ChatGPT ou outra opção mostrada pelo próprio programa e siga o fluxo no navegador.
Não cole senha, token, código 2FA ou cookie dentro da conversa com o agente. O Codex não precisa receber essas informações como texto para autenticar sua conta.
Sua primeira tarefa deve ser pequena — quase sem graça
Entre na pasta que você separou para o teste. No macOS e Linux, o caminho costuma ser:
cd caminho/da/pasta
codexNo Windows, navegue até a pasta pelo PowerShell ou Prompt de Comando e execute codex.
Agora peça algo que não altere arquivos:
Explique a estrutura deste projeto sem modificar nenhum arquivo.Esse pedido parece simples demais, e é justamente por isso que funciona. Você descobre quais arquivos o agente lê, como ele descreve o projeto e se entendeu a pasta certa. Se a resposta começar falando de outro sistema, é melhor perceber agora.
Depois, experimente uma tarefa observável: localizar onde uma mensagem de erro é gerada, apontar testes relacionados a um arquivo ou sugerir uma mudança sem executá-la.
Cinco comandos que vale guardar
O Codex tem comandos de barra que ajudam a entender e controlar a sessão:
/statusmostra a configuração atual;/permissionspermite escolher o que o agente pode fazer;/modeltroca o modelo e o esforço de raciocínio;/reviewrevisa alterações;/initcria um arquivoAGENTS.mdcom instruções para o projeto.
Você não precisa decorar tudo. Eu começaria por /status e /permissions. Saber onde está e o que está autorizado evita boa parte das surpresas.
Antes de deixar o agente editar
Confirme novamente o estado do repositório. Se quiser um checkpoint explícito:
git add .
git commit -m "checkpoint antes do Codex"Faça então uma mudança pequena e específica. Em vez de “melhore o projeto”, peça para alterar uma mensagem, adicionar um teste ou explicar primeiro o plano. Leia o diff antes de aceitar mais trabalho.
Permissões automáticas economizam cliques, mas também permitem que um pedido mal entendido avance mais rápido. No início, alguma fricção é útil. É o momento em que você aprende o que o agente considera óbvio — e o que você precisa dizer com todas as letras.
Se algo sair do controle
Pare a tarefa. Veja quais arquivos mudaram com git status e confira o diff. Se você criou um checkpoint, pode restaurar o estado conhecido e reformular o pedido.
O pior momento para descobrir que não havia backup é depois de uma alteração ampla. Por isso o primeiro teste deve caber em poucos minutos e ser fácil de desfazer.
Atualização e desinstalação
No macOS e Linux, a documentação repete o instalador standalone como método de atualização:
curl -fsSL https://chatgpt.com/codex/install.sh | shNo Windows, siga a instrução atual da aba correspondente. A página consultada não apresenta no texto renderizado um comando universal de desinstalação. Não invente uma flag: use o método indicado pela instalação ou o gerenciador de aplicativos do sistema quando aplicável.
O que eu faria no primeiro dia
Instalaria o Codex, abriria uma cópia de projeto e pediria três coisas: explicar a estrutura, localizar um trecho específico e propor uma mudança sem executá-la. Depois liberaria uma edição pequena, revisaria o diff e desfaria de propósito para testar o caminho de volta.
O objetivo do primeiro dia não é provar que a IA consegue programar. É descobrir se você entende o que ela fez, onde ela mexeu e como recuperar o projeto quando a conversa toma outro rumo.
