rulesync・Ruler・agentsyncでClaude CodeとCodexの設定を同期する方法
Claude CodeとCodexのルールやスキル、MCP設定をまとめる4つのツールを比較。個人で使う場合に、標準機能と短いスクリプトで済ませる方法も紹介します。
更新(2026年11月9日):Claude Fable 5.2とMythos 5.2がリリースされ、料金・提供範囲・ベンチマークはClaude Fable 5.2まとめで解説しています。
👁 111閲覧数
Claude CodeとCodexを並行して使い始めたとき、ルールを変えるたびに2か所を編集する必要がありました。Claudeのメモリにルールを追加してから、Codexには反映していないことに気づく。そこで、ルールやスキル、MCPサーバーの設定を1か所で管理し、ほかのツールへ自動で反映する方法を探しました。見つけたツールはいくつかあり、どれも無料でMITライセンスでしたが、私はどれもインストールしませんでした。
この記事では、特に気になった4つを比較します。個人で2つのツールを使う場合、短いスクリプトで十分だった理由と、チームで使うなら別の選択肢を検討する理由も紹介します。
設定同期ツールの概要
- rulesync: ルール、コマンド、MCP、サブエージェント、スキルなど、数十種類のツールに対応。npmでインストール
- Ruler: プロジェクト内の1つの
.ruler/フォルダーで管理し、ruler applyで反映。スキル対応は現在実験的 - agentsync: グローバルのAGENTS.md、スキルフォルダー、MCPファイルを管理。コピーではなくリンクを使い、バックアップとロールバックにも対応
- agent-rules-sync: ファイルを常時監視し、双方向で同期するデーモン
- 私の選択: Codexの標準機能と約100行の自作スクリプト
設定を一元管理する仕組み
これらのツールは、基本的には同じ考え方で動きます。ルール、スキル、MCPサーバーの定義を1か所に置き、各ツールが読み込める形式で書き出します。たとえばClaude Code向けのCLAUDE.mdとJSONファイル、Codex向けのAGENTS.mdとconfig.toml、Cursor向けの個別のルールファイルです。違いは、一元管理する場所、対応するツールの数、コピーとリンクのどちらで設定を配布するかです。
rulesyncは最も幅広い機能を備えています。ルール、コマンド、MCP、無視設定ファイル、サブエージェント、スキルを扱い、Claude CodeやCodex CLIを含む数十種類のツールに対応します。npm install -g rulesyncでインストールできます。まずrulesync import --targets claudecodeを実行して、既存のCLAUDE.mdを.rulesync/フォルダーに取り込みます。その後、rulesync generateで各ツール向けに設定を反映します。
Rulerはプロジェクト単位で動作します。ルールは.ruler/フォルダー内のMarkdownファイルに、設定とMCPサーバーはruler.tomlに記述します。ruler applyを実行すると、各エージェント向けに設定を書き出します。CodexにはAGENTS.md、MCP設定には.codex/config.toml、スキルには.agents/skills/が使われます。作者はスキル対応を実験的としています。RulerにはNode.js 20.19以降が必要です。
agentsyncは、特定のプロジェクトではなくグローバル設定を中心に設計されています。AGENTS.md、skills/フォルダー、mcp.jsonを用意すると、パソコン上で見つかった対応ツール20数種類にリンクを作成します。コピーではなくリンクを使うため、1か所の変更がすぐにすべてのツールに反映されます。書き込みを行わない確認モード(--check)、変更の監視(--watch)、バックアップからの復元(--rollback latest)にも対応します。Windowsで通常のリンクを作成できない場合、フォルダーへのリンクには開発者モードが必要です。また作者は、トークンが含まれることがあるため、mcp.jsonを共有リポジトリに入れないよう注意を促しています。
agent-rules-syncは、さらに自動化を進めたツールです。pip install agent-rules-syncでインストールすると、システムサービスとして動作します。どのツールでルールを変更しても、ほかのツールに反映されます。ルールとスキルを双方向で同期し、Claudeのグローバル設定を指定したリポジトリに反映するほか、MCPサーバーの一覧も統合します。
Codexの標準機能でできること
こうしたツールをインストールする前に、本当に必要な機能を確認してみてください。私の場合、Codexに組み込まれた2つの機能で、問題の大半を解決できました。1つ目は、~/.codex/config.tomlにproject_doc_fallback_filenames = ["CLAUDE.md"]を設定する方法です。AGENTS.mdがない場所ではCodexがCLAUDE.mdを読み込むため、ファイルをコピーせずにプロジェクトのルールを共有できます。2つ目は、スキルの形式です。SKILL.mdを含むフォルダーは両方のツールで使えますが、読み込む場所は異なります。
残ったのは、グローバルなルールとスキルでした。グローバルのAGENTS.mdを1つ作り、Claudeのメモリフォルダーを知識ベースとして参照するようCodexに指示しました。これでプロジェクトのメモも共有できます。スキルについては、~/.claude/skillsから~/.agents/skillsにコピーし、Codexで手動作成したスキルには触れないスクリプトを用意しました。手順とスクリプトは、[pwlink slug=”claude-code-do-codexa”]Claude CodeからCodexへ移行する方法[/pwlink]の記事で紹介しています。
私は自作スキルを6つ使っていて、作業するのは1人、使うツールは2つです。バックグラウンドで動くサービスを導入しても、存在しない問題を解決する一方で、新たな故障箇所を増やすだけです。Codex公式インポーターを使ったときも、最初のファイルに含まれていたポーランド語の文字を処理できず、失敗しました。このインポーターの確認はポーランド語で行ったもので、日本語でのテストではありません。
設定同期ツールを導入するタイミング
次の3つの状況では、選択肢が変わってきます。
- チーム内で異なるツールを使う場合。ある人はCursor、別の人はClaude Code、さらに別の人はCodexを使い、プロジェクトのルールをそろえたい場合です。rulesyncやRulerをリポジトリで使えば、手作業では維持しにくい設定を整理できます。
- 1台のパソコンで3つを超えるツールを使う場合。Claude Code、Codex、Gemini CLI、Cursorを同時に使うなら、agentsyncのリンク機能で手間を大きく減らせます。
- MCPサーバーの設定を頻繁に変更する場合。各ツールで設定形式が異なります。CodexはTOML、ClaudeはJSONを使うため、手動で書き直すとミスにつながりやすくなります。
1人で2つのツールを使うなら、まずCodexの標準機能から試すのがおすすめです。Claude CodeとCodexを双方向に連携させる場合は、[pwlink slug=”wtyczka-codex-claude-code”]Claude Code向けのCodex公式プラグイン[/pwlink]についての記事も参考になります。2か所の設定を手作業で管理するのが負担になってから、専用ツールを追加すれば十分です。私の場合、スキルを変更した後に実行するのはpython synchronizuj-skille.pyの1コマンドだけです。
参考リンク
- 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「AGENTS.mdを使ったカスタム指示」: https://learn.chatgpt.com/docs/agent-configuration/agents-md
- OpenAI「Agent Skills」: https://learn.chatgpt.com/docs/build-skills


