Como levar o seu fluxo do Claude Code para o Codex (e vice-versa)

Resposta curta: a maior parte do seu fluxo já é portátil, porque mora no repositório e não na ferramenta. O que atravessa sozinho: instruções de projeto, scripts, testes e convenções. O que precisa de tradução: o nome do arquivo de instruções, os comandos personalizados e a configuração de servidores MCP. Reserve uma hora, não uma semana.

O que atravessa sem esforço

Tudo que é do projeto. Os dois agentes de IA leem os arquivos do seu repositório, rodam os seus comandos e obedecem às suas convenções. Se o seu fluxo depende de um script de verificação, de uma suíte de testes e de um documento explicando as regras da casa, ele já é portátil e você não vai perceber a troca.

É um bom argumento para investir mais no repositório do que na configuração da ferramenta: o primeiro sobrevive à troca, o segundo não.

O que precisa ser traduzido

• O arquivo de instruções. Claude Code lê CLAUDE.md, Codex lê AGENTS.md. Não copie o conteúdo: deixe um apontando para o outro, senão os dois divergem em duas semanas.
• Comandos personalizados. Cada ferramenta tem o próprio formato e a própria pasta. É reescrita mecânica, e é onde a hora é gasta.
• Servidores MCP. O protocolo é o mesmo, o arquivo de configuração não. O servidor em si funciona nos dois.
• Hooks e automações. Formatos diferentes, mesma ideia.

O que não atravessa de jeito nenhum

O histórico de conversa. Sessão é da ferramenta, e não há formato comum. Se você depende de uma conversa longa cheia de contexto, a troca custa recomeçar aquela conversa: vale escrever no repositório o que ficou decidido nela, antes de trocar.

Precisa escolher?

Não, e essa é a parte que muita gente descobre tarde. As duas ferramentas leem o mesmo repositório e podem conviver. Rodar as duas dá algo que trocar não dá: quando você pede a mesma revisão a modelos de empresas diferentes, os pontos onde eles discordam são um mapa do que merece a sua atenção.

E se eu rodar as duas ao mesmo tempo?

Aí entra o único cuidado sério: elas não podem editar os mesmos arquivos ao mesmo tempo. Dois agentes de IA no mesmo diretório se sobrescrevem sem erro na tela. Dê a cada um a sua cópia do projeto, numa branch separada, com git worktree.

Vale a pena tentar antes de migrar de vez?

Vale, e é barato: instale a segunda ferramenta, aponte o arquivo de instruções para o que já existe, e passe uma tarefa real. Uma tarefa real diz mais que qualquer comparativo, inclusive este.