Como instalar e usar o Codex no terminal

O Codex no terminal é um agente de programação que trabalha dentro da pasta do seu projeto. Ele pode ler a estrutura, propor alterações, executar verificações e explicar o que encontrou. O melhor resultado vem de pedidos específicos e de uma revisão humana antes de qualquer publicação.

Antes de instalar

Use um terminal no macOS ou Linux e deixe seu projeto em uma pasta que você reconhece. Se o projeto usa Git, veja o estado atual antes de começar. Isso ajuda a separar suas mudanças das alterações feitas durante a tarefa.

git status

Instale no macOS ou Linux

O instalador oficial baixa a versão indicada para o seu sistema:

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

Feche e abra o terminal se o comando ainda não for reconhecido. Em seguida, confirme a instalação:

codex --version

Entre na sua conta

Na pasta de um projeto, execute:

cd caminho/do/seu/projeto
codex

Na primeira execução, o Codex mostra o fluxo de login. Conclua a autenticação no navegador que ele abrir e volte ao terminal. Para autenticar em outro dispositivo, use:

codex login --device-auth

Faça o primeiro pedido

Comece por algo pequeno, que seja fácil de conferir. Por exemplo:

Explique a estrutura deste projeto e indique por onde começa a aplicação.

Encontre arquivos sem uso e apenas liste os candidatos; não altere nada ainda.

Crie uma página de contato seguindo o padrão visual já usado no site e rode as verificações disponíveis.

Peça que ele mostre o que foi alterado e quais verificações foram executadas. Se a tarefa envolver publicação, chaves, pagamentos ou exclusão de dados, revise cuidadosamente antes de prosseguir.

Comandos úteis

Comando	Para que serve
`codex resume`	Retoma uma conversa anterior.
`codex review`	Abre uma revisão das alterações do projeto.
`codex doctor`	Ajuda a diagnosticar a instalação.
`codex mcp list`	Lista conexões MCP configuradas.
`codex update`	Atualiza a instalação quando houver versão nova.

Um jeito seguro de trabalhar

Diga o resultado que você quer e cite a pasta ou arquivo relevante.
Peça um plano quando a mudança for grande.
Revise a alteração antes de aceitar ou publicar.
Execute os testes adequados ao projeto.
Use Git para registrar uma mudança que você entendeu.

Documentação oficial

A documentação do Codex CLI e a referência de comandos são a fonte certa para instalação e opções atualizadas.