Guia prático de integrações do OpenAI Codex com o VS Code (2026)
Stevia Putri
Katelin Teen
Última edição June 4, 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:
- Pressione
Cmd+P(Mac) ouCtrl+P(Windows/Linux) para abrir o Quick Open - Cole
ext install openai.chatgpte pressione Enter - 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
| Modo | O que o Codex pode fazer |
|---|---|
| Chat | Apenas conversa - sem edições de arquivo, sem execução de comandos |
| Agent (padrão) | Lê arquivos, edita código, executa comandos no seu diretório de trabalho |
| Agent Full Access | Capacidades de Agente mais acesso à rede |
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:
- Escolha seu ambiente de nuvem no seletor no painel do VS Code
- Clique em Run in the cloud
- Escolha o ponto de partida: branch
mainpara novas funcionalidades, ou seu branch atual para continuar o trabalho em andamento - 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.
| Dimensão | GitHub Copilot | OpenAI Codex |
|---|---|---|
| Modo principal | Sugestões em tempo real | Delegação de tarefas assíncronas |
| Escopo da tarefa | Edições em um único arquivo e chat | Projetos de vários arquivos e várias etapas |
| Variedade de modelos | GPT-5, Claude, Gemini | Apenas modelos OpenAI |
| SWE-bench autônomo | 54% | 85.5% |
| Pré-visualização de alteração | Sim (visão de diff, aceitar/rejeitar) | Não (aplicado diretamente) |
| Paralelismo | Uma sessão por vez | Múltiplas tarefas em segundo plano |
| Melhor para | Edição diária | Trabalho independente complexo |
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):
| Plano | Preço | GPT-5.3-Codex por janela de 5h | Tarefas em nuvem por 5h |
|---|---|---|---|
| Free | US$ 0 | Teste limitado | Nenhuma |
| Go | US$ 8/mês | Tarefas leves | Nenhuma |
| Plus | US$ 20/mês | 30-150 mensagens | 10-60 tarefas |
| Pro 5x | US$ 100/mês | 150-750 mensagens | 50-300 tarefas |
| Pro 20x | US$ 200/mês | 600-3.000 mensagens | 200-1.200 tarefas |
| Business | Por assento | Igual ao Plus, extensível | Sim |
| Enterprise/Edu | Contate vendas | Sem limites fixos | Sim |
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.
Perguntas Frequentes
O OpenAI Codex é gratuito para usar no VS Code?
Qual é a diferença entre o OpenAI Codex e o GitHub Copilot no VS Code?
A extensão Codex do VS Code funciona no Cursor e no Windsurf?
openai.chatgpt) é instalada no Cursor e no Windsurf usando o mesmo ID de extensão. No Cursor, use cursor:extension/openai.chatgpt no Quick Open. Todos os três editores compartilham o mesmo Codex CLI subjacente e o arquivo de configuração ~/.codex/config.toml.
