Como usar o Codex do ChatGPT: Guia prático completo

Uma tarefa pequena e bem delimitada, como corrigir uma mensagem de erro, é um bom primeiro teste para trabalhar com o Codex. Você pode começar por um problema que conhece, acompanhar as mudanças e conferir se o resultado funciona no projeto.

Este guia ajuda você a entender os principais pontos de acesso, preparar um projeto, escrever instruções claras e verificar o que mudou. A escolha entre o aplicativo para computador, o terminal e uma extensão depende do seu fluxo de trabalho e de onde você prefere acompanhar os arquivos.

Uma correção simples também ajuda a separar uma resposta em texto de uma alteração feita nos arquivos do projeto. Assim, você começa com um teste de baixo risco e consegue comparar o comportamento antes e depois.

Principais pontos

• Escolha uma tarefa específica que você saiba avaliar.
• Use a interface que combina com o seu ambiente de programação.
• Inclua o contexto e os critérios de aceitação no pedido.
• Confira os arquivos alterados e teste o resultado.
• Considere o plano e a forma de cobrança adequados ao seu uso.
• Comece por um projeto conhecido, com comandos de teste acessíveis.

Comece por um projeto que você já conhece e consiga verificar por conta própria.

O que o Codex pode fazer em um projeto

O Codex serve para pedir ajuda em tarefas de programação usando instruções em linguagem natural e contexto do projeto. Em vez de apenas responder, pode ajudar a compreender arquivos, propor mudanças no código e revisar alterações.

Um trecho de código isolado pode responder a uma dúvida específica. Em um projeto, o agente também pode considerar arquivos relacionados e trabalhar em mudanças mais amplas, desde que você acompanhe as ações. Nem toda tarefa deve ser executada sem supervisão: o resultado ainda exige revisão e testes.

Um diff é uma comparação que mostra as linhas adicionadas, removidas ou alteradas em um conjunto de arquivos. Ele permite ver o que mudou, não apenas ler a explicação do agente. Em 2026, o Codex passou a oferecer edição em linha nos diffs, revisão de pull requests em um painel lateral e suporte a vários repositórios no mesmo projeto.

Para avaliar uma alteração, compare o diff com o comportamento esperado, em vez de aceitar apenas uma explicação do agente.

O Codex é uma experiência de programação dentro do aplicativo ChatGPT, ao lado de Chat e Work. Para quem procura entender o que é o Codex do ChatGPT, a diferença principal está no trabalho com contexto e arquivos, não só na geração de texto.

O Codex GPT pode apoiar programação, revisão e investigação de problemas. Saber se é bom para você depende de a tarefa exigir contexto de código, edição e revisão, além da sua disposição para conferir o resultado.

Para avaliar uma alteração, compare o diff com o comportamento esperado, em vez de aceitar apenas uma explicação do agente.

Como usar o Codex do ChatGPT para começar

No computador, abra o aplicativo ChatGPT e escolha Codex para entrar na experiência dedicada à programação. Esse espaço reúne as ferramentas voltadas ao trabalho com projetos, arquivos e tarefas de código.

O acesso começa pelo aplicativo ChatGPT para computador, disponível para macOS e Windows, mas a franquia de uso depende do plano da conta. Em 2026, Chat, Work e Codex estão disponíveis no aplicativo em todos os planos, inclusive no Free.

Para começar, abra o aplicativo, entre na conta que pretende usar e selecione Codex. Depois, escolha um projeto ou repositório compatível com a tarefa. Se você estiver usando um computador compartilhado, confirme a conta ativa antes de selecionar arquivos do trabalho.

Em 9 de julho de 2026, a OpenAI anunciou a incorporação do aplicativo Codex ao novo aplicativo ChatGPT para macOS e Windows. Quem já tinha o aplicativo Codex pode atualizá-lo normalmente para receber o novo aplicativo ChatGPT para computador.

O aplicativo ChatGPT anterior passa a se chamar ChatGPT Classic. Essa mudança de nome não significa que você precise iniciar pelo aplicativo antigo: a experiência dedicada ao Codex fica dentro do aplicativo ChatGPT para computador.

Quem procura um download do Codex deve distinguir o aplicativo para computador dos outros meios de acesso. A disponibilidade global do aplicativo não significa que todos os planos tenham a mesma franquia ou os mesmos recursos.

O acesso Codex fica associado à conta com que você entrou, então uma conta errada pode levar ao ambiente ou aos arquivos incorretos. Confirme que está na conta certa antes de iniciar uma tarefa vinculada a um projeto.

Qual interface do Codex combina com seu fluxo de trabalho

Se você quer trabalhar no repositório aberto no terminal, o Codex CLI é uma escolha mais direta do que iniciar uma sessão no navegador. Para tarefas delegadas, o Codex na web pode ser mais conveniente; a extensão para IDE aproxima a edição do código no editor.

A escolha depende do contexto necessário e de onde você prefere revisar mudanças. O aplicativo para computador ajuda a iniciar uma sessão dedicada, enquanto o terminal e a extensão se encaixam em fluxos locais.

O Codex na web favorece tarefas delegadas em nuvem. O CLI e a extensão se encaixam em fluxos locais, onde você acompanha o repositório e as ferramentas do ambiente.

O aplicativo para computador é útil quando você quer abrir uma sessão de programação sem começar no editor ou no terminal. A extensão, por sua vez, aproveita os arquivos e trechos que já estão abertos na IDE.

O Codex do ChatGPT é bom quando a interface oferece o contexto necessário e deixa clara a revisão das mudanças. Para uma tarefa curta em um arquivo aberto, o editor pode ser prático; para delegar trabalho, a nuvem pode se encaixar melhor.

Escolha a interface que deixa mais fácil conferir os arquivos afetados antes de aceitar as mudanças.

Quanto custa o Codex e quais planos dão acesso

O preço vai de US$ 0 por mês no Free a planos individuais pagos e opções Business por usuário. Em 2026, os valores estão em dólares americanos e não são convertidos para reais nesta comparação.

O plano Free oferece acesso para tarefas leves, enquanto o Plus inclui Codex na web, CLI, extensão para IDE e iOS. O plano adequado depende dos canais que você usa e da frequência das tarefas.

No Free, o uso no aplicativo para computador depende da disponibilização do GPT-6 Luna em velocidade Standard. O Go se destina a algumas sessões de programação focadas por semana, com a mesma condição de disponibilização do modelo.

O Plus inclui mais pontos de acesso, como a web, o terminal e a extensão para IDE, além de integrações na nuvem. Em 2026, o plano custa US$ 20 por mês.

O Pro tem três preços mensais: US$ 100, US$ 200 e US$ 500. O modo Ultrafast está incluído na opção de US$ 500; não atribua esse recurso às outras opções do Pro.

O Business custa US$ 20 por usuário por mês com cobrança anual ou US$ 25 por usuário por mês com cobrança mensal. A contratação exige pelo menos dois usuários.

Os preços dos planos ChatGPT não são a única diferença a considerar: acesso à web, CLI, IDE e recursos de equipe podem pesar mais que o custo mensal. Compare o preço com os canais e o tipo de tarefa de que você realmente precisa.

Como funcionam os limites de uso do Codex

A franquia não corresponde a um número idêntico de mensagens para todas as tarefas: o modelo e a complexidade mudam o consumo. Uma sessão longa ou uma tarefa grande pode usar mais da franquia do que uma solicitação curta.

Em 2026, ChatGPT Work e Codex compartilham preços, créditos e limites de uso. A quantidade de mensagens também depende de a tarefa ser executada localmente ou na nuvem.

As faixas são estimativas, não cotas fixas nem garantia de uso. O modelo escolhido, o tamanho e a complexidade da tarefa e a execução na nuvem alteram a quantidade de mensagens possível.

Mensagens locais e conversas na nuvem compartilham a franquia do plano. Também podem existir limites semanais, então o consumo não depende apenas do período de cinco horas mostrado na estimativa.

Essas diferenças importam quando você deixa uma tarefa extensa em andamento ou pede mudanças em vários arquivos. Uma solicitação que precisa analisar contexto amplo tende a consumir mais que uma pergunta objetiva sobre uma única função.

Em 14 de outubro de 2026, às 12h PDT, equivalente a 19h UTC, GPT-5.5 deixa de estar disponível no Codex com autenticação do ChatGPT. Sessões autenticadas com chave de API não são afetadas por essa indisponibilidade.

As mensagens estimadas não funcionam como um contador previsível para cada pessoa. Use as faixas como referência aproximada e acompanhe o saldo do plano durante sessões longas.

Como preparar o projeto antes de pedir alterações

Antes de delegar uma alteração, abra a pasta que contém o projeto real, não uma pasta genérica com vários projetos. A pasta correta permite que o Codex trabalhe com contexto relevante e evita confundir arquivos de repositórios diferentes.

Confira primeiro o conteúdo do projeto e o estado do repositório Git. O Git registra alterações em arquivos e permite comparar mudanças entre versões, o que ajuda a entender o que já estava modificado.

• Abra a pasta correta, que contém o projeto que você pretende alterar.
• Leia o README.md para encontrar instruções e informações básicas.
• Localize os arquivos principais, como a entrada do aplicativo e os módulos centrais.
• Confirme que dependências e comandos de teste estão documentados.
• Verifique o estado do repositório Git e as mudanças já presentes.

O README.md pode descrever como iniciar o projeto, instalar dependências e executar testes. O .gitignore identifica arquivos que não devem entrar no controle de versão, como arquivos locais de configuração.

Um repositório local pode usar os arquivos e as ferramentas instaladas na máquina. Isso ajuda quando a tarefa depende do ambiente existente, mas torna importante saber qual pasta está aberta e quais arquivos fazem parte dela.

Se houver arquivos de configuração, credenciais ou dados que não devem ser alterados, identifique-os antes de pedir mudanças. Não delegue uma tarefa até saber quais arquivos ou configurações precisam permanecer intactos.

O estado do Git também mostra se outras pessoas ou tarefas já alteraram o projeto. Se houver mudanças locais que você ainda não salvou, confira-as antes de começar outra tarefa.

Como escrever instruções que geram mudanças úteis

Um pedido útil descreve uma mudança observável, como exibir uma mensagem quando um formulário recebe um campo obrigatório vazio. O resultado esperado deve dizer o que a pessoa verá ou o que o sistema fará.

Especifique o comportamento, os arquivos relevantes e uma forma de verificar a mudança. Um pedido claro reduz interpretações diferentes, embora não garanta que o Codex acerte de primeira.

Defina o resultado e os arquivos envolvidos

Nomeie a função ou a tela afetada e descreva a resposta desejada. Se você souber quais arquivos cuidam do formulário, cite-os para limitar a busca e fornecer contexto técnico.

Por exemplo, indique que o campo de e-mail precisa ser validado antes do envio e que a mensagem deve aparecer junto ao campo. Se a validação vive em um componente e em um teste, mencione os dois caminhos.

Acrescente restrições e critérios de aceitação

Inclua critérios que permitam decidir se a solução atende ao pedido. Comandos de teste como npm test ou pytest ajudam quando já fazem parte do projeto.

• Comportamento esperado: o formulário exibe uma mensagem se o campo obrigatório estiver vazio.
• Contexto técnico necessário: cite o componente e a função de validação envolvidos.
• Limites do que não deve mudar: preserve o estilo visual e as regras dos demais campos.
• Comando ou condição de teste: execute o teste do formulário ou o comando documentado.

Um pedido possível é: “No formulário de cadastro, impeça o envio quando o campo obrigatório de e-mail estiver vazio. Exiba uma mensagem ao lado do campo, sem alterar o estilo dos outros campos. Atualize o teste do formulário e execute npm test.”

Se o projeto usa outra ferramenta, nomeie o comando de teste correto em vez de copiar um exemplo que não se aplica. Você também pode pedir que o Codex explique o plano antes de editar arquivos, sobretudo quando o escopo ainda não está claro.

Critérios vagos, como “melhore o formulário”, não deixam evidente o que deve mudar ou como testar. Se não for possível dizer como você vai reconhecer a solução correta, refine o critério antes de enviar a tarefa.

Como executar uma tarefa no aplicativo para computador

Para uma primeira sessão, escolha uma correção pequena e peça ao Codex que explique o plano antes de modificar vários arquivos. Uma mudança curta, como ajustar uma mensagem de erro, costuma ser mais fácil de acompanhar e testar localmente.

O Free permite tarefas leves no aplicativo para computador, sujeito à disponibilização do GPT-6 Luna em velocidade Standard. O aplicativo apresenta Chat e Work ao lado do Codex, que mantém uma experiência dedicada à programação.

1. Abra Codex e selecione o projeto que você preparou.
2. Descreva o objetivo e indique os limites da mudança.
3. Acompanhe as perguntas e as mudanças propostas durante a tarefa.
4. Confira os arquivos modificados e teste o comportamento localmente.

Chat e Work ficam disponíveis no mesmo aplicativo, mas o espaço Codex é voltado a tarefas de programação. Use essa experiência para contextualizar uma alteração em arquivos, em vez de tratar o pedido apenas como uma pergunta geral.

Para um teste inicial, peça que uma mensagem apareça quando um formulário receber um campo obrigatório vazio. O resultado é observável e você pode verificar o comportamento no próprio projeto.

Leia o plano antes que o agente altere vários arquivos. Se o plano incluir mudanças fora do pedido, corrija o escopo antes de permitir que a tarefa avance.

Ao terminar, abra o projeto e confirme o resultado na tela ou no fluxo afetado. Depois da tarefa, confirme que o resultado está no projeto que você pretendia alterar.

Como instalar o Codex CLI no Windows

No Windows, você pode instalar o Codex CLI pelo instalador independente executado no PowerShell. Essa opção instala a interface de linha de comando para você iniciar tarefas no terminal do repositório.

Use o comando completo no PowerShell para instalar o Codex CLI:

powershell -ExecutionPolicy ByPass -c “irm https://chatgpt.com/codex/install.ps1 | iex”

Depois da instalação, rode codex –version para verificar se o comando está disponível. Para iniciar a autenticação, use codex login.

A versão independente não é a única opção. Se você já usa Node.js, pode instalar o pacote npm globalmente com npm install -g @openai/codex.

O pacote @openai/codex declara compatibilidade com Node.js 16 ou posterior. Essa alternativa pode se encaixar em um ambiente em que você já administra ferramentas de desenvolvimento pelo npm.

Instalar o CLI não determina por si só se a sessão será autenticada com ChatGPT ou com chave de API. São escolhas de autenticação distintas, que não devem ser confundidas com o processo de instalação.

Se o PowerShell não reconhecer o comando após a instalação, feche e reabra o terminal para atualizar o ambiente de comandos. Rode codex –version antes de iniciar uma sessão para confirmar que o comando está disponível.

O que fazer com o Codex CLI depois da instalação

No terminal, o Codex CLI pode inspecionar arquivos, editar código e executar comandos dentro do fluxo do repositório. O trabalho local aproveita os arquivos e as ferramentas que já estão instalados na máquina.

Você pode escolher o modelo, o nível de raciocínio, as permissões e os comandos da tarefa. Assim, o uso do CLI se adapta tanto a uma alteração acompanhada quanto a uma atividade repetível.

Trabalhe no repositório e escolha as permissões

Abra o terminal no repositório que deve ser alterado e peça uma tarefa com escopo definido. O Codex CLI pode usar as ferramentas já instaladas na máquina, como as que o projeto chama durante o desenvolvimento.

Escolha permissões coerentes com o trabalho solicitado. Uma tarefa de leitura pode exigir menos ações do que uma alteração que precisa editar arquivos e executar testes.

Para uma tela que não se comporta como esperado, você pode fornecer uma imagem com codex –image. No modo interativo, também pode colar uma imagem no compositor para que ela sirva de contexto visual.

Automatize comandos e revise alterações

O comando codex exec chama o Codex CLI em fluxos repetíveis e pipelines. Use esse caminho quando precisar incorporar uma solicitação a um processo que executa etapas semelhantes.

O CLI também permite revisar alterações não commitadas, um commit específico ou a comparação com uma branch-base. Essas revisões apresentam achados priorizados sem modificar a árvore de trabalho.

Quando você precisar continuar uma conversa anterior, codex resume retoma uma sessão. Isso ajuda a recuperar o contexto de uma tarefa interrompida sem recomeçar do zero.

Para automação, faça primeiro uma execução manual e confira se o comando afeta os arquivos esperados. Antes de automatizar uma tarefa, execute primeiro o comando manualmente e confira o resultado.

Como usar o Codex no VS Code

No VS Code, abra a pasta do projeto e use os arquivos ou trechos selecionados para dar contexto à solicitação. Um trecho específico ajuda a concentrar o pedido em uma função sem exigir que você descreva todo o repositório.

A extensão do Codex pode usar arquivos abertos, trechos selecionados e conversas recentes para explicar ou editar código. O contexto disponível ajuda a tornar a solicitação mais precisa.

Dê contexto com arquivos e trechos abertos

Para começar, abra a pasta do projeto no Visual Studio Code, abra os arquivos relevantes e selecione a extensão do Codex. Inclua uma instrução sobre o resultado desejado e indique o trecho que deve receber a mudança.

Arquivos abertos e trechos selecionados ajudam a explicar como uma função se conecta ao restante do código. Conversas recentes também podem dar continuidade a uma solicitação, desde que ainda tratem do mesmo objetivo.

O VS Code é um editor de código gratuito, usado por muitas pessoas como ambiente de desenvolvimento. O editor e a extensão do Codex são componentes distintos: um organiza o trabalho com código, a outra acrescenta recursos de programação assistida.

Revise o diff dentro do fluxo do editor

A extensão mostra um resumo e um diff junto ao código. Leia as linhas alteradas no editor e, se necessário, peça ajustes na mesma conversa, indicando o trecho ou o comportamento que precisa mudar.

Uma tarefa rápida pode ser executada localmente pela extensão. Uma tarefa mais longa pode ser delegada ao Codex na web e revisada depois no editor, separando a execução do trabalho da análise dos arquivos.

O Visual Studio Code se apresenta como editor com suporte a desenvolvimento multiagente e recursos de IA. Isso não o torna o próprio Codex: a extensão integra a ferramenta ao fluxo do editor.

Antes de aceitar a edição, leia o diff no editor e peça ajustes se algum arquivo saiu do escopo.

Como revisar e testar o código antes de aceitar

O primeiro sinal de que uma tarefa terminou é um diff que corresponde ao pedido, não apenas uma mensagem de conclusão. Leia as mudanças antes de integrar o resultado ao restante do projeto.

Confira os arquivos, os critérios e os testes disponíveis antes de aceitar uma alteração. Testes automatizados ajudam a avaliar funções e fluxos, mas não substituem a leitura do que foi modificado.

• Veja quais arquivos foram alterados e se todos pertencem à tarefa.
• Compare o comportamento implementado com os critérios de aceitação.
• Leia o diff para encontrar mudanças inesperadas ou incompletas.
• Execute os testes disponíveis no projeto.
• Confirme o comportamento esperado na função ou no fluxo afetado.

Um teste pode passar mesmo que o diff revele uma mudança não solicitada. Por exemplo, uma correção na validação pode funcionar, mas também alterar o estilo de campos que não faziam parte do pedido.

Git permite comparar mudanças e consultar o histórico de versões. Essa comparação ajuda a separar o que a tarefa acrescentou do que já existia no repositório.

Se o resultado envolve mais de uma função, percorra os fluxos afetados antes de integrar a alteração. Verifique tanto o caso principal quanto a condição que motivou o pedido.

Para outros cuidados com resultados gerados por IA, consulte os termos de uso e revisão humana. Eles tratam dos serviços do DicaIA, não das regras próprias do Codex.

Se o teste falhar, registre a mensagem de erro exata e peça uma correção limitada ao problema observado.

Quando delegar tarefas à nuvem e quando trabalhar localmente

Uma tarefa que pode ser descrita e delegada separadamente pode começar com codex cloud, enquanto uma alteração dependente dos arquivos locais pode ficar no CLI. A escolha do ambiente muda o modo como você acompanha o contexto e aplica o resultado.

O Codex CLI trabalha no repositório local com arquivos e ferramentas instalados na máquina. A nuvem separa uma tarefa do ambiente local, o que pode ser conveniente quando você quer delegar trabalho.

Use o Codex na nuvem para tarefas delegadas

O comando codex cloud permite iniciar conversas na nuvem. Use-o para uma tarefa que você consegue explicar separadamente, como investigar uma mudança ou trabalhar em uma solicitação com limites claros.

A conveniência da nuvem não significa que ela compartilhe automaticamente o estado do seu repositório local. Antes de aplicar um resultado, confirme quais arquivos e condições ele considera.

Volte ao repositório local para aplicar o resultado

Depois da tarefa na nuvem, volte ao repositório local para aplicar e conferir o resultado. O CLI pode trabalhar com os arquivos e as ferramentas instalados na máquina, que talvez não correspondam ao ambiente da tarefa delegada.

Uma mudança local pode depender de arquivos ainda não salvos ou de uma configuração específica. Confira a branch ativa e o estado dos arquivos antes de combinar o resultado com alterações existentes.

Use a nuvem quando a tarefa puder ser separada do trabalho local; prefira o repositório local quando a mudança depender diretamente do seu ambiente. Confira a branch e o estado dos arquivos locais antes de aplicar qualquer resultado da nuvem.

Como a cobrança da API difere da assinatura do ChatGPT

Uma assinatura do ChatGPT não cobre o uso da API, que é cobrado separadamente. Na sessão do Codex, a forma de autenticação determina se o consumo acompanha a assinatura ou os preços da API.

Uma chave de API segue os preços da API e não inclui determinados recursos na nuvem, como revisão de código no GitHub e integração com Slack.

Em 2026, o uso da API é cobrado separadamente do uso incluído em uma assinatura do ChatGPT. Por isso, uma sessão autenticada com chave de API não deve ser tratada como parte da franquia da assinatura.

O Codex autenticado com chave de API é cobrado pelos preços da API. Esse acesso não inclui recursos na nuvem como revisão de código no GitHub e integração com Slack.

Durante uma sessão do Codex CLI autenticada com chave de API, rode /status para verificar o estado da sessão e os limites restantes. O comando ajuda a acompanhar o uso sem confundir essa sessão com o acesso da conta do ChatGPT.

Se a sessão usa uma chave de API, rode /status para conferir o estado e os limites restantes.

O que equipes precisam saber sobre segurança e administração

Para uma equipe, o Business oferece um espaço de trabalho dedicado com controles administrativos e autenticação empresarial. Esses recursos ajudam a administrar o acesso, mas não eliminam a necessidade de regras internas sobre dados e repositórios.

No plano Business, os dados empresariais não são usados para treinamento por padrão. Essa configuração vale para esse plano e não representa uma promessa de segurança absoluta.

Controles administrativos do Business

Em 2026, o Business inclui um espaço de trabalho dedicado e controles administrativos essenciais. O plano também oferece SAML SSO e MFA, recursos de autenticação empresarial usados para administrar o acesso.

Esses controles se aplicam ao Business e não devem ser presumidos em outros planos. Uma equipe pode definir quem entra no espaço de trabalho e como os usuários devem autenticar suas contas.

Tratamento dos dados empresariais

Os dados empresariais do Business não são usados para treinamento por padrão. A expressão “por padrão” descreve a configuração indicada para esse plano, sem garantir que todo risco de acesso ou exposição desapareça.

Antes de compartilhar arquivos, confirme as regras internas para informações pessoais, códigos privados e documentos de trabalho. A equipe também precisa saber quais usuários podem acessar cada repositório e quais dados está autorizada a enviar.

Para orientações gerais sobre privacidade e manejo de dados, consulte a política de privacidade do DicaIA. Ela trata do DicaIA e não substitui as políticas do Codex ou as regras internas da equipe.

Antes de compartilhar arquivos de trabalho, confira as regras de acesso e manejo de dados da equipe. O padrão de uso de dados do Business não substitui essa verificação.

Antes de conectar um repositório de trabalho, confirme quem pode acessá-lo e quais dados a equipe está autorizada a compartilhar.

Conclusão

Para começar com segurança, escolha uma alteração pequena cujo resultado você consiga testar. Uma tarefa conhecida ajuda você a entender o fluxo e a perceber se as mudanças correspondem ao pedido.

Escolha a interface que combina com o projeto e revise cada mudança antes de aceitá-la. O diff e os testes ajudam a conferir se o código atende ao critério definido.

Abra um repositório conhecido e escreva uma tarefa com um resultado observável, como corrigir uma validação sem alterar outros campos. Abra o projeto, descreva o comportamento esperado e confira cada arquivo que o Codex alterar.