rulesync, Ruler ou agentsync: sincronize Claude Code e Codex

Atualização (9 de novembro de 2026): Claude Fable 5.2 e Mythos 5.2 foram lançados - preços, acesso e benchmarks no meu guia do Claude Fable 5.2.

👁 112 leituras

Quando comecei a trabalhar ao mesmo tempo com Claude Code e Codex, cada mudança nas regras exigia duas edições. Eu acrescentava uma regra à memória do Claude e depois me lembrava de que o Codex não a conhecia. Então procurei uma ferramenta que mantivesse uma única versão das regras, skills e servidores MCP e distribuísse o restante automaticamente. Encontrei algumas opções, todas gratuitas e licenciadas pelo MIT. Não instalei nenhuma.

A seguir, comparo quatro das opções mais interessantes e explico por que, para uma pessoa usando duas ferramentas, um script curto foi suficiente - mas, em uma equipe, eu escolheria outra solução.

Uma única fonte de verdade

Essas ferramentas funcionam de maneira parecida. Você mantém regras, skills e definições de servidores MCP em um só lugar, e o programa grava os arquivos nos formatos esperados por cada ferramenta: CLAUDE.md e um arquivo JSON para Claude Code, AGENTS.md e config.toml para Codex, além de arquivos de regras separados para Cursor. O que muda é onde fica essa fonte única, quantas ferramentas são compatíveis e se o conteúdo é distribuído como cópias ou links.

rulesync oferece o suporte mais amplo: regras, comandos, MCP, arquivos de exclusão, subagentes e skills. A lista de ferramentas compatíveis inclui dezenas de opções, entre elas Claude Code e Codex CLI. A instalação é feita com npm install -g rulesync. Para começar, use rulesync import --targets claudecode, que importa um CLAUDE.md existente para a pasta .rulesync/. Em seguida, rulesync generate distribui o conteúdo.

Ruler funciona no nível do projeto. Você escreve as regras em arquivos Markdown na pasta .ruler/, configura ajustes e servidores MCP em ruler.toml e usa ruler apply para gravá-los nos agentes. No Codex, o resultado inclui AGENTS.md, configurações MCP em .codex/config.toml e skills em .agents/skills/. O autor classifica o suporte a skills como experimental. O Ruler exige Node.js versão 20.19 ou posterior.

agentsync foi desenvolvido para configurações globais, não para um único projeto. Você tem um AGENTS.md, uma pasta skills/ e um arquivo mcp.json. O programa conecta esses arquivos a mais de vinte ferramentas compatíveis, desde que as encontre no computador. Em vez de criar cópias, usa links, então uma mudança em um lugar aparece imediatamente em todos os outros. Há uma opção de pré-visualização sem gravação (--check), um modo para observar mudanças (--watch) e a possibilidade de voltar ao backup (--rollback latest). No Windows, criar links para pastas pode exigir o modo de desenvolvedor, caso o sistema não permita um link comum. O autor também alerta para não enviar mcp.json a um repositório compartilhado, porque o arquivo pode conter tokens.

agent-rules-sync vai além. Você o instala com pip install agent-rules-sync e ele funciona como um serviço do sistema: quando você altera uma regra em qualquer ferramenta, o serviço a distribui para as outras. Ele sincroniza regras e skills nos dois sentidos, transfere configurações globais do Claude para repositórios selecionados e combina as listas de servidores MCP.

O Codex já resolve metade do problema

Antes de instalar qualquer ferramenta desta lista, veja do que você realmente precisa. O Codex tem duas opções integradas que resolveram a maior parte do meu problema. A primeira é project_doc_fallback_filenames = ["CLAUDE.md"] em ~/.codex/config.toml: assim, o Codex lê CLAUDE.md sempre que não há um AGENTS.md, compartilhando as regras dos projetos sem precisar copiá-las. A segunda é o formato das skills: uma pasta com o arquivo SKILL.md funciona nas duas ferramentas; muda apenas o local de onde cada uma o lê.

Restavam as regras e as skills globais. Escrevi o AGENTS.md global uma vez e indiquei ao Codex a pasta de memória do Claude como base de conhecimento, para compartilhar também as anotações sobre os projetos. Para as skills, bastou um script que as copia de ~/.claude/skills para ~/.agents/skills sem mexer nas que foram adicionadas manualmente ao Codex. Compartilho o script e explico todo o processo no artigo [pwlink slug=”claude-code-do-codexa”]Como migrar do Claude Code para o Codex[/pwlink].

Tenho seis skills próprias, uma pessoa no teclado e duas ferramentas. Um programa rodando como serviço em segundo plano resolveria um problema que não tenho e criaria outro lugar onde algo poderia dar errado. Também tive um problema com o importador oficial do Codex: ele falhou ao encontrar caracteres poloneses no primeiro arquivo.

Quando vale a pena usar uma ferramenta pronta

O cenário muda em três situações:

• Uma equipe usando ferramentas diferentes. Uma pessoa trabalha no Cursor, outra no Claude Code e uma terceira no Codex, mas as regras do projeto precisam ser iguais em todos eles. Nesse caso, rulesync ou Ruler no repositório organizam algo que ninguém conseguiria manter manualmente.
• Mais de três ferramentas no mesmo computador. Usando Claude Code, Codex, Gemini CLI e Cursor ao mesmo tempo, os links do agentsync podem poupar bastante trabalho.
• Mudanças frequentes nos servidores MCP. Cada ferramenta salva essas configurações em um formato diferente: Codex usa TOML e Claude, JSON. Reescrever tudo manualmente logo causa problemas.

Se você usa duas ferramentas e trabalha sozinho, começaria pelas opções integradas do Codex. Se também quiser conectar Claude Code e Codex no sentido inverso, veja o artigo sobre a [pwlink slug=”wtyczka-codex-claude-code”]extensão oficial do Codex para Claude Code[/pwlink]. Vale adicionar uma ferramenta pronta quando começar a cansar de manter dois lugares em sincronia. No meu caso, depois de mudar uma skill, basta executar um comando: python synchronizuj-skille.py.

Fontes

• rulesync: https://github.com/dyoshikawa/rulesync
• Ruler: https://github.com/intellectronica/ruler
• agentsync: https://github.com/x0c/agentsync
• agent-rules-sync: https://github.com/dhruv-anand-aintech/agent-rules-sync
• OpenAI, instruções personalizadas com AGENTS.md: https://learn.chatgpt.com/docs/agent-configuration/agents-md
• OpenAI, Agent Skills: https://learn.chatgpt.com/docs/build-skills

// continue lendoPlugin Codex para Claude Code: comandos e limite de revisãoGeralComo migrar do Claude Code para o Codex: guia práticoRevistaClaude Opus 5.5 e GPT-6 Astra: plano ou API?Geral