Guia prático de integrações do OpenAI Codex com o VS Code (2026)

O que "OpenAI Codex no VS Code" significa em 2026

A confusão de nomes é real e vale a pena esclarecer antes de qualquer coisa.

O "OpenAI Codex" original era um modelo de API de 2021 - uma versão do GPT-3 ajustada para código que alimentou o autocomplete inicial do GitHub Copilot. A OpenAI o descontinuou em março de 2023. O que a extensão do VS Code conecta agora é um produto completamente diferente que foi lançado em maio de 2025 e compartilha o nome.

O Codex 2025 é um agente de engenharia de software baseado em nuvem, alimentado por modelos construídos especificamente na família GPT-5: GPT-5.3-Codex, GPT-5.4 e GPT-5.5. Ele executa tarefas em sandboxes isoladas na nuvem pré-carregadas com seu repositório, pode operar de forma autônoma por até 25 horas em trabalhos complexos e gerencia vários fluxos de trabalho em paralelo. A extensão do VS Code é uma das várias superfícies ao lado do app de desktop Codex, da CLI de código aberto, integração com GitHub, Slack e iOS.

O VS Code é uma janela para este sistema - e uma vez que você o entende como um sistema em vez de um plugin, toda a configuração faz mais sentido.

Três formas de executar o Codex no VS Code

Não existe apenas um "Codex no VS Code" - existem três padrões distintos que atendem a diferentes fluxos de trabalho.

A extensão do VS Code (painel lateral) - ID da extensão openai.chatgpt, editor: openai. Esta é a integração principal: um painel de chat lateral que pode ler seus arquivos abertos, aplicar edições no modo Agente, executar comandos de terminal e conectar-se à Codex Cloud para tarefas de segundo plano mais longas.

O Codex CLI no terminal do VS Code - A CLI de código aberto (mais de 88.000 estrelas no GitHub) funciona como um agente de terminal completo dentro do terminal integrado do VS Code. Ela compartilha a configuração com a extensão e alguns desenvolvedores acham que ela é visivelmente melhor para tarefas de raciocínio complexo.

Delegação na nuvem a partir da extensão - É aqui que o Codex diverge de todas as outras ferramentas de IA do VS Code. A partir do painel da extensão, envie uma tarefa para a Codex Cloud: ela é executada em uma sandbox isolada conectada ao seu repositório GitHub, você fecha o VS Code, a tarefa continua rodando e você volta para um diff concluído.

Configuração: instalando a extensão

Três passos:

1. Pressione Cmd+P (Mac) ou Ctrl+P (Windows/Linux) para abrir o Quick Open
2. Cole ext install openai.chatgpt e pressione Enter
3. Clique em Sign in no painel do Codex e autentique-se com sua conta ChatGPT ou chave de API da OpenAI

Você também pode pesquisar por "Codex" no painel de Extensões e procurar pelo editor "openai".

O mesmo ID de extensão funciona no Cursor e no Windsurf - basta substituir o prefixo de URI vscode: por cursor: ou windsurf: no Quick Open. A extensão, a CLI e o arquivo de configuração ~/.codex/config.toml são compartilhados entre os editores, portanto, se você trabalha em vários ambientes, suas configurações acompanham você.

Uma dica de layout: mova o painel do Codex para o lado direito do seu editor. Arraste o ícone da barra lateral para a barra de atividades direita. Com o código à esquerda e o Codex à direita, você tem uma visão dividida natural - muito melhor do que empilhá-lo em cima do explorador de arquivos.

De qual plano você precisa? O Codex está incluído em todos os planos pagos do ChatGPT, começando pelo Plus (US$ 20/mês). Não há assinatura separada para o Codex. O acesso por chave de API funciona para a extensão e para a CLI, mas perde recursos de nuvem, incluindo revisão de código no GitHub e delegação na nuvem. Consulte o guia completo de preços do OpenAI Codex para obter detalhes sobre os níveis.

Dentro da extensão: o que você pode realmente fazer

O seletor de modelo e esforço de raciocínio

O seletor de modelo na parte inferior do painel do Codex é a primeira coisa que difere do chat do GitHub Copilot. Você escolhe explicitamente o modelo e o esforço de raciocínio: GPT-5.3-Codex em baixo/médio/alto, GPT-5.4, GPT-5.4-mini e GPT-5.5. O raciocínio médio lida bem com a maioria das tarefas. Aumente para alto para refatorações complexas onde um minuto extra de pensamento elimina vários loops de correção. Use o GPT-5.4-mini para perguntas de rotina - ele amplia seu orçamento de mensagens em 2,5-3x em relação aos modelos primários.

Referências de arquivos com @

A sintaxe @filename é uma das coisas mais práticas da extensão. Em vez de colar código no chat:

Use @auth.ts e @user.model.ts para adicionar verificação de e-mail
ao fluxo de registro, mantendo o tratamento de erros consistente
com o padrão em @error-handler.ts

O Codex lê todos os arquivos referenciados na íntegra, entende o contexto entre arquivos e faz alterações consistentes em todos eles. A extensão sugere nomes de arquivos automaticamente enquanto você digita @.

Três modos de aprovação

Alterne os modos no seletor abaixo da entrada de chat. O modo Agente é o padrão correto: ele executa npm run test, edita arquivos e verifica se suas alterações compilam - todas as operações locais necessárias para a maioria das tarefas de codificação. O Acesso Total adiciona busca na internet, útil se o Codex precisar buscar documentação no meio da tarefa.

O loop de aprovação de permissões é o ponto de atrito mais relatado na extensão atual. Mesmo com "Allow every time" ativado, o Codex pede aprovação novamente quando um comando varia mesmo que minimamente. É um bug conhecido.

"Até no Linux. Se houver qualquer variação na CLI, ele considera um novo comando que requer nova aprovação. O Claude Code é muito melhor nisso."

u/jimheim, r/ChatGPTCoding

Se o loop de aprovação estiver causando atrito, altere a aprovação para "auto" em ~/.codex/config.toml ou use a versão CLI dentro do terminal, que lida com a reaprovação de forma mais sensata.

O que o Codex faz bem no modo Agente

Tarefas em que o Codex entrega resultados consistentes: "corrija os testes que estão falhando em auth.spec.ts", "adicione suporte ao modo escuro à biblioteca de componentes", "refatore o fluxo de pagamento para usar o novo cliente de API", "adicione comentários JSDoc a todas as funções exportadas". Trabalho independente onde ele pode ler, editar, executar testes e verificar em uma única passagem.

Onde ele tem dificuldade: qualquer coisa que exija feedback visual em tempo real, trabalho iterativo de pixel no front-end e tarefas em que você deseja revisar um plano de execução antes que o código comece a mudar. O Codex não possui um Modo de Plano - ao contrário do Claude Code, ele executa imediatamente. O padrão da comunidade do r/codex e r/ClaudeCode: Codex para trabalho complexo de back-end, Claude Code para front-end e refinamento iterativo.

Delegação na nuvem: o verdadeiro diferencial da extensão

O fluxo de trabalho assíncrono é o que separa o Codex de todas as outras ferramentas de IA no VS Code.

Configuração (uma única vez): Vá para chatgpt.com/codex/settings/environments e conecte um repositório GitHub a um ambiente de nuvem.

Por tarefa:

1. Escolha seu ambiente de nuvem no seletor no painel do VS Code
2. Clique em Run in the cloud
3. Escolha o ponto de partida: branch main para novas funcionalidades, ou seu branch atual para continuar o trabalho em andamento
4. Descreva a tarefa e envie

O Codex começa a trabalhar em uma sandbox isolada. Você pode fechar o VS Code - a tarefa roda na nuvem. O progresso aparece na sua barra lateral quando termina. Revise o diff, aplique-o localmente, itere.

"Ele também pode processar múltiplos fluxos de trabalho em segundo plano enquanto você discute os próximos passos com ele. É incrivelmente bom e economiza muito tempo. O número de solicitações também parece ser razoavelmente alto na assinatura Plus: 30 a 150 a cada 5 horas."

u/pnkpune, r/OpenAI

A configuração na nuvem também alimenta a integração com GitHub: o Codex revisa automaticamente os PRs conforme eles passam de draft para prontos, publica análises diretamente nos pull requests do GitHub e responde a menções de @codex review com detecção de bugs direcionada. Austin Ray, Líder da Equipe AI Dev X na Ramp: "As revisões de PR do Codex pegam bugs que nossa equipe teria perdido, e entregamos com mais confiança por causa disso."

Um limite importante de se conhecer: quando o Codex no modo Agente aplica alterações localmente, não há um fluxo de trabalho de aceitar/rejeitar diff - as edições aterrissam diretamente no seu diretório de trabalho. Esta é a lacuna de UX mais significativa em comparação com a refinada visualização de diff do GitHub Copilot. Faça commit ou stash antes de delegar uma tarefa grande para que o git reset esteja sempre disponível.

Executando o Codex CLI no terminal do VS Code

A CLI é instalada separadamente da extensão:

npm i -g @openai/codex

Em seguida, execute-a dentro do terminal integrado do VS Code:

# Sessão interativa TUI
codex

# Com um prompt inicial
codex "Explique esta base de código para mim"

# Não interativo para scripts
codex exec "Corrija todos os erros de lint em src/"

A CLI e a extensão compartilham ~/.codex/config.toml. Defina os padrões uma vez em vez de alternar na UI em cada sessão:

# ~/.codex/config.toml
model = "gpt-5.3-codex"
approval_mode = "agent"

A combinação que funciona bem: execute a CLI no terminal integrado do VS Code para os prompts, e mantenha o VS Code aberto na mesma pasta para revisão do git diff em tempo real. Você obtém qualquer qualidade de raciocínio que a CLI ofereça ao lado do visualizador de diff limpo do VS Code.

A CLI imprime estatísticas da sessão ao final de cada execução - uso da janela de contexto, limite de taxa de 5 horas restante, contagem total de tokens. Útil para gerenciar os limites do plano Plus.

A CLI também se integra nativamente com repositórios Bitbucket, funciona dentro do Google Colab e notebooks Jupyter, e conecta-se a ambientes Replit. Se você trabalha com outras IDEs, existem guias de integração para PyCharm, IntelliJ e Visual Studio (a IDE completa da Microsoft, não o VS Code).

Codex vs GitHub Copilot no VS Code: eles fazem coisas diferentes

A perspectiva "Codex vs Copilot" perde o sentido. Eles não estão competindo pelo mesmo lugar no seu fluxo de trabalho.

O Copilot está sempre ativo. Ele fornece completamentos de texto fantasma (ghost text) em tempo real conforme você digita, chat inline para perguntas rápidas sobre a função atual, sugestões para a próxima edição e acesso a múltiplos modelos: você pode alternar entre OpenAI GPT-5, Anthropic Claude e Google Gemini dependendo da tarefa. Para trabalho de front-end, alguns desenvolvedores na comunidade acham que o Claude via Copilot produz um código de UI melhor do que o Codex consegue (o Codex é restrito a modelos da OpenAI). Para detalhes completos, consulte nosso detalhamento de preços do Copilot.

O Codex é assíncrono. Você fornece um prompt de tarefa, ele trabalha de forma independente em um ambiente isolado e retorna um resultado concluído. A pontuação de 85,5% no SWE-bench Verified mede a conclusão de tarefas end-to-end autônoma - exatamente para o que ele foi construído.

O padrão que funciona: mantenha o GitHub Copilot ativo para completamentos inline e perguntas rápidas. Coloque de 2 a 3 tarefas maiores no Codex diariamente - as coisas que, de outra forma, você deixaria estacionadas no seu backlog. Volte para conferir os diffs concluídos.

Se você estiver avaliando alternativas ao Copilot de forma mais ampla, o Cursor compete mais diretamente com o Copilot no pair-programming em tempo real. Também existem alternativas ao Cursor que valem a pena considerar dependendo do seu fluxo de trabalho. Nosso guia Claude vs Copilot cobre o lado da Anthropic na comparação.

Preços: quanto você realmente paga

Duas trilhas de cobrança. Para o detalhamento completo, consulte nosso guia de preços do OpenAI Codex.

Assinatura do ChatGPT (Codex incluso):

Os limites são redefinidos em uma janela móvel de 5 horas. A OpenAI adicionou o nível Pro 5x em abril de 2026 diretamente em resposta aos preços do Claude Code - um caminho intermediário claro para desenvolvedores que atingem os limites do Plus, mas não estão prontos para US$ 200/mês.

Chave de API (sem assinatura): Funciona na extensão e na CLI a US$ 1,50/1M de entrada, US$ 6/1M de saída para codex-mini-latest (desconto de 75% em prompt caching). Sem delegação na nuvem, sem revisão de código no GitHub.

Uma dica de gerenciamento de limites: use o GPT-5.4-mini para perguntas rotineiras ("explique esta função", "o que este teste verifica"). Isso amplia sua contagem de mensagens locais em 2,5-3x em relação aos modelos primários, deixando o orçamento do GPT-5.3-Codex para as tarefas que realmente precisam dele.

O veredito honesto

O Codex no VS Code realmente cumpre o que se propõe. A pontuação de 85,5% no SWE-bench se sustenta na prática: refatorações complexas de back-end, trabalho de funcionalidades em vários arquivos e revisão de código que pega bugs que a análise estática ignora.

Os pontos negativos também são reais. O loop de aprovação de permissão na extensão está quebrado desde o lançamento. Não há pré-visualização de diff antes que as alterações locais ocorram - o Copilot lida melhor com isso. A falta de um Modo de Plano significa que você não pode revisar a abordagem antes que a execução comece, o que pega alguns desenvolvedores desprevenidos. E após a mudança na taxa de créditos de abril de 2026, alguns usuários do plano Pro relatam que o GPT-5.5 em intensidade Média se esgota em 3 a 4 tarefas - a seleção do modelo é fundamental para o gerenciamento de limites.

"Eu tenho a licença de US$ 100 do CC e o plano de US$ 20 da OpenAI. Quando o CC não consegue resolver um problema difícil, eu o entrego para o Codex; ele demora uma eternidade, mas resolveu inúmeros problemas que o CC foi incapaz de resolver."

u/SequentialHustle, r/ClaudeAI

Esse é o posicionamento honesto: não é "melhor que o Claude Code ou o Copilot", mas uma ferramenta distinta para um trabalho específico. Se você está gastando tempo em tarefas como "implementar esta funcionalidade a partir de uma especificação" ou "escrever testes para este módulo", US$ 20/mês no Plus para testá-lo por uma semana é uma decisão óbvia.

Para o Codex em outros contextos: guias para Discord, Notion e Slack estão disponíveis. Para a experiência completa de desktop, o guia do app Codex cobre a disponibilidade no macOS e o centro de comando de tarefas paralelas. Se não for a escolha certa, nosso resumo de alternativas ao OpenAI Codex cobre todo o campo.

Experimente o eesel

O Codex cuida da sua fila de desenvolvimento. O eesel cuida da sua fila de suporte.

O eesel implementa agentes de IA que trabalham de forma autônoma dentro de suas ferramentas existentes - Zendesk, Freshdesk, Slack, e-mail e mais de 100 outras. A mesma filosofia de "delegar e voltar para os resultados" do Codex, aplicada às operações de suporte. Os agentes do eesel resolvem tickets, elaboram rascunhos de respostas, fazem a triagem de problemas e escalam casos excepcionais sem interromper sua equipe. Nenhuma interface nova para aprender. Comece gratuitamente - US$ 50 em créditos incluídos, sem necessidade de cartão.

Comece grátis em eesel.ai