OpenAI torna mais fácil migrar de Claude Code para Codex

OpenAI está tornando a migração do Claude Code para o Codex muito mais fácil

Introdução

Entre as ferramentas de programação com IA, o que costuma ser mais difícil de substituir não é a assinatura.

Mas sim tudo o que o desenvolvedor acumula em torno da ferramenta: um CLAUDE.md cuidadosamente ajustado, dezenas de pequenos truques de fluxo de trabalho, permissões de servidor MCP, comandos de barra, habilidades, memória de projeto e meses de histórico de conversas.

Esses arquivos podem ficar silenciosamente no computador do desenvolvedor, mas juntos formam um manual de operação do fluxo de trabalho de programação com IA. Migrar do Claude Code para outra ferramenta, sem suporte de migração, significa que a maior parte dessa configuração precisa ser reconstruída do zero.

A OpenAI agora está tornando essa troca muito mais fácil.

De acordo com a documentação atual da OpenAI, o aplicativo de desktop do ChatGPT pode importar configurações compatíveis e trabalhos recentes do Claude Code, Claude Cowork e Cursor. O Codex CLI pode importar do Claude Code e do Cursor, preservando a configuração existente em vez de excluí-la ou substituí-la.

Isso pode parecer um simples recurso de conveniência. Mas, na prática, ele muda o nível de atrito que os desenvolvedores enfrentam ao alternar entre diferentes ferramentas de programação com IA.

A OpenAI está empacotando a configuração dos usuários do Claude Code

A OpenAI recentemente consolidou suas instruções de importação de agentes externos em um único fluxo de trabalho.

No aplicativo de desktop do ChatGPT, os usuários podem abrir Configurações → Importar e selecionar agentes compatíveis, como Claude Code, Claude Cowork ou Cursor. No Codex CLI, o ponto de entrada correspondente é:

/import

A documentação oficial atual indica que o aplicativo de desktop pode importar instruções, configurações, habilidades, plugins, projetos e trabalhos recentes. O Codex CLI pode importar configurações compatíveis, arquivos de projeto e conversas recentes do Claude Code ou do Cursor.

O detalhe importante é que a importação é uma cópia, não uma migração destrutiva.

A documentação da OpenAI deixa claro que a importação não altera nem exclui as configurações existentes dos agentes. Em outras palavras, sua configuração do Claude Code ou do Cursor permanece no lugar, enquanto o Codex recebe sua própria versão importada.

Isso faz com que o processo não pareça uma substituição de ferramenta, mas sim uma forma de trazer o ambiente de desenvolvimento existente para uma segunda ferramenta.

O que é migrado é mais do que você imagina

A documentação oficial de importação fornece um mapeamento bastante detalhado da configuração de origem para o destino no Codex.

Item de origem	Destino no Codex
Arquivos de instruções	AGENTS.md
settings.json	config.toml
Habilidades	Habilidades
Plugins	Plugins
Pastas de projetos existentes	Projetos usando as mesmas pastas
Memória de projeto do Claude Code	Memória
Histórico de conversas dos últimos 30 dias	Histórico de conversas do ChatGPT
Configuração de servidor MCP	Configuração MCP do Codex
Ganchos	Ganchos do Codex
Comandos de barra	Habilidades
Subagentes	Agentes do Codex

Portanto, a conversão nem sempre é uma simples cópia de arquivos.

Arquivos de instruções do Claude Code, como CLAUDE.md, são transformados em AGENTS.md. O settings.json do Claude Code é convertido no config.toml do Codex. Comandos de barra são mapeados para habilidades, e subagentes se tornam agentes do Codex.

Essa distinção é importante porque uma importação bem-sucedida não significa necessariamente que o comportamento será idêntico em todos os projetos depois disso.

Os nomes podem mudar,

os formatos de configuração podem mudar, e o modelo de execução também muda junto.

Projetos são reutilizados, não enviados como novas cópias

A migração de projetos é outro detalhe útil.

A documentação da OpenAI explica que pastas de projetos existentes são importadas como projetos usando as mesmas pastas. Portanto, o fluxo de trabalho não exige duplicar todo o repositório para continuar trabalhando no Codex.

A interface de importação também permite que os usuários escolham o que trazer, em vez de forçar uma migração de tudo ou nada.

Isso significa que configurações, instruções, habilidades, plugins, projetos e conversas podem ser revisados como partes independentes da migração.

Você pode continuar conversas antigas após a importação

A migração também tem outro problema prático: conversas antigas podem ser grandes demais para a ferramenta de destino processar de uma só vez.

O Codex lida com isso por meio do gerenciamento de contexto, em vez de simplesmente rejeitar as conversas importadas.

A documentação atual da OpenAI afirma que o Codex CLI pode importar até 50 conversas dos últimos 30 dias. O fluxo de importação do desktop também suporta conversas recentes e permite que os usuários continuem trabalhando a partir de projetos ou conversas importados.

O artigo original descreve a experiência da seguinte forma: quando uma conversa migrada do Claude Code é longa demais, o Codex pode compactar o conteúdo inicial na primeira vez que o usuário continuar aquela conversa importada, liberando contexto para a próxima rodada.

O objetivo prático é simples: a migração não deve terminar com um registro de importação enorme que fique imediatamente inutilizável.

Esse fluxo de importação está em constante expansão

O artigo original acompanha a evolução do recurso em várias versões do Codex.

O artigo relata que o /import apareceu pela primeira vez no Codex CLI 0.140.0, com um escopo mais limitado de importação do Claude Code. Versões posteriores expandiram o fluxo de trabalho, adicionando áreas adicionais de migração e, em seguida, suporte a habilidades do Cursor e sincronização de sessões importadas.

O histórico específico de lançamentos ajuda a entender a velocidade da evolução do recurso, mas para o que é suportado atualmente, a documentação oficial existente é uma referência melhor. Ela confirma que o fluxo de trabalho de importação agora cobre uma gama mais ampla de configurações de agentes e trabalhos recentes do que nas versões iniciais.

Na prática, ainda é uma migração unidirecional

O artigo original faz uma observação mais perspicaz: a documentação de migração foca na importação para o Codex, e não na exportação da configuração do Codex de volta para o Claude Code.

Há uma distinção importante aqui.

A documentação atual da OpenAI suporta atualizações automáticas dos agentes originais para as configurações importadas no aplicativo de desktop do ChatGPT. Os usuários podem ativar a atualização automática em Configurações → Importar e ver o histórico de importações lá.

Isso não significa que edições feitas no Codex sejam automaticamente gravadas de volta no Claude Code ou no Cursor.

A direção ainda importa: o ambiente original pode continuar fornecendo atualizações para a cópia importada, mas a cópia importada não é apresentada como uma camada de sincronização bidirecional.

Para os desenvolvedores, isso significa que, antes de ativar a atualização automática, vale a pena decidir qual ambiente é a fonte de autoridade.

OpenAI e Anthropic estão lidando com a migração de maneiras diferentes

A competição mais ampla

não se limita à OpenAI.

O artigo original aponta que a Anthropic também vem desenvolvendo ferramentas de migração destinadas a trazer o contexto do usuário para o Claude. A documentação de ajuda atual da Anthropic também oferece um processo oficial de exportação de dados para seus usuários do Claude, incluindo histórico de conversas e dados de conta.

Isso cria uma diferença significativa de filosofia.

Se uma plataforma suporta tanto importação quanto exportação, os usuários têm mais liberdade para migrar o contexto que acumularam. Se a migração é principalmente unidirecional, esse recurso também pode se tornar uma ferramenta poderosa para reduzir o atrito dos usuários ao mudar para a plataforma de destino.

Os detalhes técnicos são diferentes, mas a questão estratégica é a mesma: a quem pertencem os fluxos de trabalho de IA acumulados pelos desenvolvedores e quão portáveis eles são?

A OpenAI também colocou o Codex no Claude Code

Antes de expandir seu fluxo de importação, a OpenAI já havia agido na direção oposta.

Seu projeto de código aberto codex-plugin-cc permite que desenvolvedores usem o Codex dentro do Claude Code para revisão de código e delegação de tarefas. O plugin inclui comandos como /codex:review e /codex:transfer, sendo que este último pode criar um thread persistente do Codex a partir de uma sessão do Claude Code.

O repositório é publicado sob a licença Apache-2.0 e é mantido pela OpenAI.

O fluxo de trabalho do /codex:transfer é especialmente relevante para a história da migração.

A documentação do plugin afirma que ele pode pegar a sessão atual do Claude Code e criar um thread persistente do Codex, permitindo que o trabalho continue diretamente no Codex. Essa transferência usa o Codex

o importador de sessões externas de agentes, seguindo as mesmas regras de conversão do histórico de importação do Claude.

Isso é diferente de simplesmente iniciar uma nova conversa no Codex.

O objetivo é transportar o próprio contexto de trabalho através das fronteiras.

Ainda há quatro coisas que não migram bem

Um botão de migração pode eliminar muito atrito, mas não pode tornar dois agentes de codificação diferentes exatamente iguais.

O artigo original destacou quatro áreas onde os desenvolvedores devem esperar precisar de ajustes manuais.

1. Permissões

O Claude Code pode conter regras de permissão cuidadosamente ajustadas em torno de arquivos, comandos, ferramentas e fluxos de trabalho específicos.

O Codex tem seu próprio modelo de permissões e sandbox. Portanto, as configurações relacionadas a permissões importadas precisam ser revisadas, e não se pode assumir que são equivalentes.

A documentação da OpenAI recomenda especificamente revisar as restrições de ferramentas e permissões nas habilidades e agentes importados após a migração.

Um ponto importante é que a migração de permissões diz respeito a preservar a intenção original, não apenas renomear configurações.

2. Ganchos

Ganchos são outra área onde o comportamento pode divergir.

A documentação de importação da OpenAI avisa explicitamente que ganchos importados podem se comportar de forma diferente após a migração e devem ser revisados.

Ganchos simples podem ser transferidos sem problemas. Cadeias mais complexas, com condições, suposições de ambiente ou comportamento assíncrono, podem precisar ser redesenhadas para a ferramenta de destino.

Portanto, nem sempre é uma questão de conversão. Às vezes, é uma questão de redesenho do fluxo de trabalho.

3. O modelo também muda

Esta pode ser a diferença mais óbvia, mas também é uma das mais facilmente ignoradas.

Você pode mover suas instruções, habilidades, configurações de MCP, arquivos de projeto e memória para o Codex, mas o modelo que executa essas instruções ainda é diferente.

Prompts ou arquivos CLAUDE.md ajustados para o comportamento do Claude podem não produzir exatamente os mesmos resultados quando executados por um modelo da OpenAI.

A configuração pode ter sido migrada com sucesso, mas o comportamento por trás dela mudou.

O artigo original aponta que o Codex é projetado em torno dos próprios modelos da OpenAI e dos fluxos de trabalho baseados em Responses. Desenvolvedores que desejam rotear o Codex para provedores personalizados precisam tratar isso como uma tarefa de configuração independente, sem assumir que as configurações de modelo importadas do Claude serão mantidas automaticamente.

4. O histórico de chat tem limites

Nem todas as conversas se qualificam para migração.

A documentação atual da OpenAI mostra que o Codex CLI importa no máximo 50 chats dos últimos 30 dias. O comando /import também tem limitações operacionais: não está disponível durante a execução de tarefas, em sessões remotas ou quando conectado ao daemon do servidor do aplicativo local.

A documentação atual também distingue entre configurações locais e configurações de nível de projeto, o que significa que os desenvolvedores devem verificar exatamente onde os arquivos e configurações estão localizados antes de iniciar a importação.

O resultado é uma regra prática útil:

Importar com um clique não significa que não há necessidade de revisão.

O ativo verdadeiramente valioso não é a assinatura do modelo

Os benchmarks de modelos mudam rapidamente.

Um modelo pode liderar em um mês e ser substituído por outra versão no seguinte. O que muda muito mais lentamente é o fluxo de trabalho ao redor do desenvolvedor.

CLAUDE.md, AGENTS.md, habilidades, servidores MCP, permissões, memória de projeto, comandos e conversas acumuladas tornam-se mais valiosos com o tempo, pois codificam a maneira real como o desenvolvedor trabalha.

Isso torna a portabilidade uma questão competitiva.

Quanto mais reutilizáveis forem essas configurações, menor será a dependência do desenvolvedor em relação a uma plataforma específica de programação com IA.

E essa faca de dois gumes também se aplica nas duas direções.

Padrões abertos como SKILL.md, AGENTS.md e definições de MCP padronizadas facilitam a migração de fluxos de trabalho de uma ferramenta para outra. A interoperabilidade que ajuda a OpenAI a atrair usuários do Claude Code também pode, em última análise, facilitar a saída desses usuários do Codex.

Para os desenvolvedores, a estratégia prática é direta:

Preserve os ativos importantes do fluxo de trabalho em formatos portáveis sempre que possível e evite tornar todo o processo de desenvolvimento dependente de uma ferramenta proprietária.

Perguntas frequentes

O que o Codex pode importar do Claude Code?

O Codex pode importar instruções, configurações, habilidades, plugins, arquivos de projeto, chats recentes, configurações de MCP, ganchos, comandos de barra e subagentes suportados. A documentação da OpenAI também mapeia a memória de projeto do Claude Code para a memória do Codex.

Como importar do Claude Code para o Codex CLI?

Inicie uma sessão local do Codex CLI e execute /import. Em seguida, selecione Claude Code, escolha as configurações suportadas, arquivos de projeto e chats recentes que deseja trazer e revise as configurações importadas.

O Cursor pode ser importado para o Codex?

Sim. A documentação atual da OpenAI mostra que o Codex CLI pode importar do Cursor, e o aplicativo de desktop do ChatGPT pode importar do Claude Code, Claude Cowork e Cursor.

Importar para o Codex excluirá minhas configurações do Claude Code?

Não. A OpenAI afirma explicitamente que a importação não altera ou exclui as configurações existentes do agente. As configurações importadas são trazidas separadamente para o ambiente de destino.

Quantos chats do Claude Code o Codex pode importar?

O Codex CLI pode importar até 50 chats dos últimos 30 dias. O comando /import também tem certas limitações de uso, portanto, é melhor executá-lo em uma sessão CLI local normal.

As habilidades do Claude Code se comportarão exatamente da mesma forma no Codex?

Não necessariamente. Habilidades, ganchos, permissões, plugins e modelos de comando podem depender do comportamento da ferramenta original, portanto, a OpenAI recomenda revisar antes de confiar nas configurações importadas.

Posso transferir diretamente uma sessão do Claude Code para o Codex?

O codex-plugin-cc da OpenAI fornece o comando /codex:transfer, que pode criar um thread persistente do Codex a partir de uma sessão do Claude Code. O plugin foi projetado especificamente para continuar o trabalho do Claude Code no Codex.

Ferramentas relacionadas

• OpenAI Codex: O agente de programação da OpenAI para fluxos de trabalho de desenvolvimento de software.
• Codex CLI: A interface de linha de comando para usar o Codex localmente.
• Claude Code: O agente de programação da Anthropic e o principal ambiente de origem discutido neste guia de migração.
• Cursor: Um editor de código com tecnologia de IA suportado pelos fluxos de trabalho de importação do Codex.
• Plugin OpenAI Codex para Claude Code: O plugin oficial da OpenAI para usar o Codex dentro do Claude Code.

Links relacionados

• Documentação de importação da OpenAI: Guia oficial para importar configurações e trabalhos recentes de outros agentes de IA.
• Documentação do Codex CLI: Documentação oficial para instalar e usar o Codex CLI.
• Plugin OpenAI Codex para Claude Code: Repositório oficial da OpenAI para integração com Claude Code.
• README do plugin Codex: Instruções de instalação e uso do plugin para Claude Code.
• Exportação de dados do Claude: Exportação oficial de dados do Claude pela Anthropic.

Guia sobre dados de conta e conversas.

• OpenAI Developers: principal centro de documentação para desenvolvedores da OpenAI.
• OpenAI Devs no X: postagem dos desenvolvedores da OpenAI citada no artigo de origem.

Resumo

O fluxo de importação atualmente oferecido pela OpenAI elimina uma grande barreira de migração para desenvolvedores que acumularam meses de configurações e contextos no Claude Code ou no Cursor. Instruções, skills, plugins, projetos, configurações de MCP, memória e registros recentes de conversas agora podem ser movidos para o Codex por meio de fluxos de importação suportados.

Uma limitação importante é que a migração não equivale a uma compatibilidade perfeita. Permissões, hooks, prompts, plugins e comportamentos de modelos podem mudar após a migração, portanto, as configurações importadas devem ser revisadas antes do uso.

Elas se tornaram parte dos fluxos de trabalho de produção.

A configuração de codificação com IA mais portável é aquela que mantém instruções valiosas, skills e conhecimento do projeto independentes de qualquer agente único.