Comandos do Codex: Guia Prático para Usar no Terminal

Resposta rápida: os comandos mais importantes do Codex são codex, para abrir a interface interativa; codex login, para autenticar; codex doctor, para diagnosticar problemas; codex review, para revisar mudanças; codex exec, para rodar tarefas sem interface interativa; e codex update, para atualizar quando a instalação permite. No Windows, você pode usar esses comandos no PowerShell dentro da pasta do projeto.

Se você já instalou o Codex, o próximo passo não é decorar uma lista infinita de flags. O mais útil é entender quais comandos resolvem quais situações reais.

Neste guia, você vai ver os principais comandos do Codex CLI, exemplos no PowerShell, quando usar cada um e como evitar os erros mais comuns ao trabalhar com IA dentro de projetos reais.

O que são comandos do Codex?

Comandos do Codex são instruções executadas no terminal para abrir, configurar, diagnosticar ou automatizar o agente de programação da OpenAI.

Na prática, eles servem para controlar como o Codex trabalha com seu projeto. Você pode abrir uma conversa interativa, autenticar sua conta, revisar mudanças, rodar tarefas em modo automático, aplicar resultados de tarefas na nuvem e ajustar permissões.

Se você ainda quer entender a ferramenta antes de decorar comandos, comece pelo guia sobre o que é o Codex da OpenAI. Ele explica o papel do Codex no ecossistema da OpenAI antes de entrar nos atalhos de terminal.

Se você está no Windows, veja também o guia dedicado de [Codex PowerShell](/codex-powershell/). Se ainda não instalou, comece por [como instalar Codex no Windows](/como-instalar-codex-windows/).

Tabela rápida de comandos do Codex

Leitura rápida: estes são os comandos que você mais provavelmente vai usar no começo.

Comando	Para que serve	Quando usar
codex	Abre a interface interativa no terminal	Uso diário dentro da pasta do projeto
codex --version	Mostra a versão instalada	Conferir se o Codex está instalado
codex login	Autentica Codex com conta ChatGPT, API key ou outro método aceito	Primeiro acesso, troca de conta ou erro de login
codex doctor	Gera diagnóstico do ambiente local	Quando algo falha na instalação, auth, Git, terminal ou runtime
codex review	Revisa mudanças de código	Antes de commit, PR ou publicação
codex exec	Roda Codex em modo não interativo	Automação, scripts e tarefas repetíveis
codex update	Verifica e aplica atualização, quando suportado	Manter CLI atualizada
codex app	Abre o app desktop do ChatGPT/Codex	Quando você quer sair do terminal puro

Como usar codex

O comando mais importante é o mais simples:

“powershell codex “

Ele abre o Codex no terminal, dentro da pasta atual.

Por isso, antes de rodar, entre na pasta certa:

“powershell cd C:\caminho\do\projeto codex “

Você também pode iniciar com uma tarefa direto:

“powershell codex "analise este projeto e explique os arquivos principais antes de editar qualquer coisa" “

Esse formato é bom quando você quer já dar um objetivo inicial sem abrir uma sessão vazia.

Como usar codex --version

Use:

“powershell codex --version “

Esse comando mostra a versão instalada.

Ele é útil quando:

• você acabou de instalar;
• o comando codex não parece funcionar direito;
• um tutorial pede uma versão mínima;
• você quer confirmar se o terminal está enxergando a instalação correta.

Se o PowerShell disser que codex não é reconhecido, feche e reabra o terminal. Se continuar falhando, volte ao guia de [instalação do Codex no Windows](/como-instalar-codex-windows/).

Como usar codex login

Use:

“powershell codex login “

Esse comando inicia a autenticação do Codex.

Segundo a documentação oficial da OpenAI, o codex login pode autenticar usando métodos como OAuth do ChatGPT, device auth, API key ou access token via stdin. Para a maioria dos usuários, o caminho mais comum é entrar com a conta ChatGPT ou configurar a API key quando o fluxo pedir.

Use codex login quando:

• você instalou o Codex pela primeira vez;
• trocou de conta;
• a sessão expirou;
• o Codex diz que não está autenticado;
• você quer mudar de ChatGPT para API key ou vice-versa.

Se sua dúvida principal é acesso, planos ou API key, vale criar depois um satélite próprio para codex login, porque essa intenção costuma virar busca técnica bem específica.

Como usar codex doctor

Use:

“powershell codex doctor “

Esse é um dos comandos mais úteis para troubleshooting.

A documentação oficial descreve o codex doctor como um diagnóstico para instalação local, configuração, autenticação, runtime, Git, terminal, app-server e inventário de tarefas/sessões.

Em português simples: ele ajuda a entender por que o Codex não está funcionando como deveria.

Use quando:

• o Codex não abre;
• o login falha;
• comandos não rodam;
• o terminal parece estranho;
• o Git não aparece corretamente;
• o app desktop e o terminal não parecem conversar;
• você quer uma visão geral do ambiente.

Depois de rodar, leia o diagnóstico e corrija um problema por vez. Se aparecer algo que você não entende, peça ao próprio Codex:

“text Explique este resultado do codex doctor em português simples e me diga qual correção devo testar primeiro. “

Como usar codex review

Use:

“powershell codex review --uncommitted “

Esse comando pede ao Codex para revisar mudanças não commitadas.

Ele é útil quando você alterou arquivos e quer uma revisão antes de subir para o GitHub, publicar ou enviar para alguém.

Também existem modos para revisar contra uma branch base ou um commit específico, como:

“powershell codex review --base main “

ou:

“powershell codex review --commit abc123 “

Use codex review para procurar:

• bug provável;
• regressão;
• arquivo esquecido;
• teste faltando;
• risco de segurança;
• mudança grande demais para o objetivo.

Para projetos pequenos, talvez abrir codex e pedir uma revisão já resolva. Para fluxo de desenvolvimento mais sério, codex review deixa a intenção mais clara.

Como usar codex exec

Use:

“powershell codex exec "verifique se este projeto tem testes e diga como rodar" “

O codex exec roda o Codex em modo não interativo. Ele é útil quando você quer uma tarefa direta, com saída no terminal, sem entrar na interface interativa.

A documentação oficial também indica o alias:

“powershell codex e "resuma este projeto" “

Use codex exec para:

• checks repetitivos;
• automações;
• scripts internos;
• análise rápida de projeto;
• tarefas que você quer rodar do mesmo jeito mais de uma vez.

Para começar, use o modo interativo codex. Deixe codex exec para quando você já sabe exatamente o que quer pedir.

Como usar codex update

Use:

“powershell codex update “

Segundo a documentação oficial, esse comando verifica e aplica atualização quando a instalação atual oferece suporte a autoatualização.

Use quando:

• um comando documentado não existe na sua versão;
• você está seguindo tutorial recente;
• o codex doctor sugere atualizar;
• você quer confirmar se há versão nova.

Se o update não estiver disponível no seu tipo de instalação, siga o método de instalação original.

Como usar codex app

Use:

“powershell codex app “

Esse comando abre o app desktop do ChatGPT/Codex quando ele está instalado, ou inicia o caminho de instalação quando está ausente.

No Windows, a documentação oficial indica que o codex app imprime o caminho para abrir no app. Na prática, ele é útil quando você quer sair do terminal e trabalhar com uma interface visual, projetos, revisões e arquivos.

Use o app quando:

• você quer trabalhar com várias tarefas;
• prefere revisar visualmente;
• quer usar browser, previews, plugins ou skills;
• o projeto é maior do que uma sessão simples de terminal.

Flags úteis do Codex

Além dos comandos, algumas flags ajudam bastante.

Flag	O que faz	Exemplo
--cd ou -C	Define a pasta de trabalho antes de iniciar	codex -C C:\projeto
--model ou -m	Escolhe o modelo para aquela execução	codex -m modelo
--sandbox ou -s	Controla a política de sandbox	codex -s workspace-write
--ask-for-approval ou -a	Controla quando o Codex pede aprovação	codex -a on-request
--search	Ativa busca web ao vivo	codex --search
--image ou -i	Anexa imagem ao prompt inicial	codex -i screenshot.png

Para uso local com menos atrito, a documentação cita um padrão como:

“powershell codex --sandbox workspace-write --ask-for-approval on-request “

Isso mantém o Codex com permissão de escrita no workspace e pedindo aprovação quando necessário.

Comandos do Codex no PowerShell

No Windows, a sequência básica fica assim:

“powershell cd C:\caminho\do\projeto codex --version codex login codex “

Depois, para diagnóstico:

“powershell codex doctor “

Para revisar mudanças:

“powershell codex review --uncommitted “

Para tarefa direta:

“powershell codex exec "analise os arquivos principais e diga como rodar o projeto" “

Se você trabalha no Windows, leia também [Codex PowerShell](/codex-powershell/), porque ali o foco é abrir projeto, evitar pasta errada, lidar com WSL2 e corrigir erros comuns no terminal.

Quais comandos devo aprender primeiro?

Se você está começando, aprenda nesta ordem:

1. codex --version
2. codex login
3. codex
4. codex doctor
5. codex review --uncommitted
6. codex exec

Essa ordem é boa porque acompanha a vida real: instalar, autenticar, usar, diagnosticar, revisar e automatizar.

Não comece por comandos avançados. Primeiro crie confiança em projetos pequenos.

Comandos que pedem mais cuidado

Alguns comandos e flags merecem atenção extra.

O principal exemplo é:

“powershell codex --dangerously-bypass-approvals-and-sandbox “

ou:

“powershell codex --yolo “

A própria documentação marca esse tipo de uso como perigoso e indicado apenas para ambientes endurecidos externamente. Em linguagem simples: não use isso em projeto importante só para economizar clique.

Também tome cuidado com:

• comandos que apagam arquivos;
• comandos com acesso fora da pasta do projeto;
• tarefas amplas demais;
• prompts que pedem para "corrigir tudo";
• internet ao vivo em conteúdo não confiável;
• credenciais em arquivos locais.

O Codex é forte justamente porque executa. Por isso, a sua revisão continua fazendo parte do fluxo.

Exemplos de prompts para usar com comandos do Codex

Depois de abrir codex, você pode começar com:

“text Analise este projeto e explique a estrutura. Por enquanto, não altere arquivos. “

Para corrigir bug:

“text Investigue por que o formulário não envia. Antes de editar, diga quais arquivos pretende abrir e qual hipótese vai testar. “

Para revisar:

“text Revise minhas alterações como se fosse um code review. Priorize bugs, regressões e testes faltando. “

Para criar documentação:

“text Crie um README simples explicando instalação, comandos principais e como rodar o projeto localmente. “

Para adaptar comando Linux para PowerShell:

“text Esse comando parece de Bash. Adapte para PowerShell no Windows e explique a diferença. “

Esses prompts funcionam melhor do que "faz aí" porque dão contexto, limite e critério.

Perguntas frequentes sobre comandos do Codex

Qual é o comando principal do Codex?

O comando principal é codex. Rode dentro da pasta do projeto para abrir a interface interativa no terminal.

Como ver a versão do Codex?

Use codex --version. Esse comando ajuda a confirmar se a instalação está funcionando e qual versão está ativa.

Para que serve codex doctor?

codex doctor gera um diagnóstico do ambiente local, incluindo instalação, configuração, autenticação, runtime, Git, terminal e outros pontos que podem causar erro.

Para que serve codex login?

codex login autentica o Codex. Ele é usado no primeiro acesso, quando a sessão expira, quando você troca de conta ou quando precisa configurar outro método de autenticação.

Quando usar codex review?

Use codex review antes de commit, pull request ou publicação, especialmente quando quer revisar mudanças não commitadas, comparar com uma branch ou analisar um commit específico.

Quando usar codex exec?

Use codex exec para tarefas não interativas, automações e checks repetíveis. Para uso inicial, prefira codex no modo interativo.

Posso usar comandos do Codex no PowerShell?

Sim. No Windows, você pode usar comandos do Codex no PowerShell. Abra o terminal dentro da pasta do projeto e rode codex.

Fontes oficiais

• OpenAI Codex manual – CLI command reference
• OpenAI Codex manual – ChatGPT desktop app for Windows
• OpenAI Codex manual – Windows sandbox

Conclusão

Os comandos do Codex ficam simples quando você entende o papel de cada um.

Use codex para trabalhar no terminal, codex login para autenticar, codex doctor para diagnosticar, codex review para revisar mudanças e codex exec para automações. No Windows, comece pelo PowerShell dentro da pasta do projeto e mantenha sandbox e aprovações quando estiver mexendo em algo importante.

Se você quer o passo a passo no Windows, vá para [Codex PowerShell](/codex-powershell/). Se ainda está na etapa de instalação, comece por [como instalar Codex no Windows](/como-instalar-codex-windows/).