Discussão sobre como usar Claude Code e OpenAI Codex no mesmo…
INEMA
Veja o PollySkill q permite converter Skills entre eles
neste Caso o Fundamental é Atualizar os dois arquivos agent.md quando quiser usar o codex e o claude.md quando usar o Claude code, entao o prompt acima ajuda atualizar e o /session-handoff resume o conteudo do contexto de memoria
Você pode usar os dois no mesmo projeto, porque Claude Code e Codex conseguem ler a mesma base de arquivos, mas cada um espera alguns arquivos de configuração com nomes diferentes.
Na prática:
1. Mantenha o mesmo projeto aberto Você não precisa copiar o projeto nem criar outro. Pode abrir o mesmo diretório no VS Code ou no terminal.
2. Deixe os arquivos do Claude Code O Claude usa principalmente:
Claude.md
.claude/
Ali ficam as instruções, regras, agentes, skills e configurações do Claude.
3. Crie os equivalentes para o Codex O Codex usa:
agents.md
.codex/
.agents/
Então você cria um agents.md baseado no Claude.md, coloca configurações e agentes na .codex, e coloca skills na .agents.
4. Use a IA para converter Ele recomenda pedir ao próprio Codex algo como:
Este projeto foi feito para Claude Code. Quero usar Codex também.
Crie um agents.md baseado no Claude.md.
Configure a pasta .codex.
Copie/adapte as skills para .agents.
Adapte os agentes do Claude para o formato do Codex.
Pesquise a documentação do Claude Code e do Codex para garantir que tudo importante foi convertido corretamente.
5. Trabalhe com os dois lado a lado Ele mostra Claude Code aberto de um lado e Codex do outro. Pode usar um terminal para Claude e outro para Codex, dentro do mesmo projeto.
6. Use handoff quando trocar de agente Quando estiver trabalhando no Claude e quiser passar para o Codex, peça um resumo da sessão: arquivos mexidos, decisões tomadas, problema atual e próximos passos. Depois cole esse resumo no Codex.
A lógica é: o conhecimento do projeto é compartilhado; só as configurações específicas mudam. Assim você consegue alternar entre Claude Code e Codex sem perder contexto.
Como usar os dois juntos⌗
Para usar Claude Code e Codex juntos, você pode manter o mesmo projeto aberto e preparar os arquivos que cada ferramenta precisa para funcionar bem.
O Claude Code usa principalmente:
Claude.md
.claude/
O Codex usa:
agents.md
.codex/
.agents/
A ideia é criar no Codex uma estrutura equivalente à que já existe no Claude Code. O arquivo agents.md pode ser baseado no conteúdo do Claude.md, trazendo as mesmas instruções principais do projeto. A pasta .codex pode guardar configurações e agentes específicos do Codex. Já a pasta .agents pode guardar as skills que o Codex deve usar.
Um jeito simples de fazer isso é pedir ao próprio Codex para converter o projeto. Você pode dizer que o projeto foi criado para Claude Code e que agora quer deixá-lo compatível com Codex também. Peça para ele criar o agents.md, configurar a pasta .codex, adaptar os agentes e mover ou copiar as skills para .agents.
Depois disso, você pode trabalhar com os dois lado a lado. Por exemplo, abrir um terminal com Claude Code e outro com Codex, ambos apontando para o mesmo projeto.
Quando quiser passar uma tarefa de um agente para o outro, basta fazer um resumo da sessão: o que foi feito, quais arquivos foram alterados, quais decisões foram tomadas, qual problema ainda está aberto e quais são os próximos passos. Depois, cole esse resumo no outro agente e continue o trabalho.
Em resumo: o projeto continua sendo o mesmo, o conhecimento continua compartilhado, e cada agente usa apenas seus próprios arquivos de configuração. Isso permite alternar entre Claude Code e Codex sem perder contexto.
O conteúdo explica como usar Claude Code e Codex no mesmo projeto, sem precisar duplicar arquivos, recriar contexto ou começar tudo de novo.
A ideia principal é que os dois agentes conseguem trabalhar sobre a mesma base de conhecimento do projeto, como documentos, scripts, referências, decisões, wikis e arquivos internos. O que muda são os arquivos e pastas que cada ferramenta procura para entender as instruções e configurações do projeto.
No Claude Code, as instruções principais ficam em um arquivo chamado Claude.md, junto com a pasta .claude, onde podem estar regras, configurações, agentes e skills. Já no Codex, o equivalente é o arquivo agents.md, além das pastas .codex e .agents.
Para adaptar um projeto feito no Claude Code para também funcionar no Codex, basta criar um agents.md baseado no Claude.md, configurar a pasta .codex, colocar as skills na pasta .agents e adaptar os agentes para o formato usado pelo Codex.
A parte boa é que grande parte do conhecimento do projeto não precisa mudar. Os arquivos principais continuam sendo os mesmos. O que precisa ser ajustado são apenas as convenções específicas de cada ferramenta.
Também é importante manter tudo sincronizado. Quando houver uma mudança grande no Claude.md, o ideal é atualizar também o agents.md. O mesmo vale para skills, agentes e regras importantes.
A mensagem principal é que vale a pena não depender de uma única ferramenta. Usar Claude Code e Codex juntos permite alternar entre eles quando um estiver travado, cometer erros ou não conseguir resolver determinado problema. Assim, o trabalho continua fluindo e o projeto fica mais flexível.
Codex + CCODE
1