一个用于同步 Claude Code 和 Codex 之间配置文件的工具(包括 CLAUDE.md、AGENTS.md、技能、钩子、MCP 等),通过符号链接和格式转换防止设置分叉。

Stars

7

7 天增长

暂无数据

Fork 数

0

开放 Issue

0

开源协议

MIT

最近更新

2026-07-28

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它解决了使用多个 AI 编程 agent 时配置漂移的实际问题,提供了安全的交互式设置、备份/恢复以及可选的自动同步功能,并仔细处理了格式差异和平台限制。

适合谁使用

  • 同时使用 Claude Code 和 Codex 的开发者
  • 共享项目级 agent 配置的团队
  • 希望避免手动同步和配置漂移的高级用户

典型使用场景

  • 在 Claude 和 Codex 之间同步项目特定设置(技能、CLAUDE.md、MCP)
  • 一次性将全局设置应用于两个 agent
  • 在 macOS 上自动检测并同步更改,防止配置分叉

项目优势

  • 交互式且安全:在更改前显示差异、请求确认并提供备份
  • 支持多种配置类型:技能、CLAUDE.md/AGENTS.md、钩子、MCP、子 agent、规则
  • macOS 上通过 launchd 和 fswatch 实现自动同步,并提供仅通知模式
  • 尊重工具限制:跳过某个 agent 不支持的项目(例如 Codex 中的 SessionEnd 钩子)

使用前须知

  • 自动同步仅适用于 macOS(需要 launchd 和 fswatch)
  • 需要 Bun 运行时,并且 TOML 解析器可能存在边缘情况(多行字符串处理)
  • Windows 上符号链接支持取决于开发者模式;git 符号链接可能变为纯文本文件

README 快速开始

agents-sync

Claude Code と Codex に分かれてしまった設定を、1つにまとめて、以後ずれないように同期するツールです。

CLAUDE.mdAGENTS.md.claude/skills/.agents/skills/ のように、 同じ内容が2か所に置かれていると、使用するコーディングエージェントごとに設定が独自に分岐していってしまいます。(= 意図した分岐であればよいですが、片方の変更がもう片方に同期されない、ということが起きます)
agents-sync は、片方を実ファイル・もう片方をSymlink(同じファイルを参照させる)にすることで、この分岐をなくします。

対応ツール / モード

項目対応
ハーネスClaude Code / Codex
手動同期macOS / Linux / Windows
自動同期macOS(launchd)

インストール

一度だけ行う作業です。

1. ダウンロードする

ZIP をダウンロード

ダウンロードした ZIP を展開してください。置き場所はどこでも構いません。

2. セットアップする

展開したフォルダをそのままClaude CodeまたはCodexに渡して、「これを導入して」と指示してください。どちらに渡しても構いません。 セットアップは両方のツールに登録するので、以後はClaude CodeとCodexのどちらからでも呼び出せます。

エージェント向けの手順: 展開先のフォルダで bun src/cli.ts setup を実行して登録状況を表示し、内容をユーザーに見せて確認を得てから bun src/cli.ts setup --apply で登録します。登録の向きはスキル同期と同じ規約です。~/.claude/skills/agents-sync が展開先の skill/ フォルダを指し、~/.codex/skills/agents-sync はその ~/.claude/skills/agents-sync を指します(実体は展開先の1つだけ)。

注意:スキルはマシンに1つだけ入れる

agents-sync は、マシンに1つだけ入れる前提のスキルです。 対象が1つのプロジェクトだけであっても、プロジェクトの中にコピーせず、上記のセットアップ(~/.claude/skills/~/.codex/skills/ への登録)を使ってください。

  • 中身がプロジェクトに依存しません … 書かれているのは agents-sync の操作手順で、 どのプロジェクトでも同じです。プロジェクトごとに変わるのは設定ファイルです
  • プロジェクトに置くと、自分自身が同期対象になります.claude/skills/agents-sync/ に置くと、 agents-sync がそれを .agents/skills/ へリンクし、ツールの説明書がそのリポジトリに コミットされてしまいます
  • プロジェクトに置くと、agents-sync 自身が居場所を見失います … スキルは ~/.claude/skills/agents-sync(または ~/.codex/skills/agents-sync)を手がかりに、自分の本体がどこにあるかを割り出しています

操作の流れ

セットアップ後、エージェントに実行を頼むと、以下の流れで作業を進めてくれます。

最初に、どこへ入れるかを聞かれます

対象によって書き換える範囲がまったく違うため、実行前に聞かれるようになっています。

選択肢何をするか
特定のプロジェクト内への導入(推奨)1つのプロジェクトだけが対象です。設定はそのプロジェクトの中に作られ、他には一切影響しません
グローバル設定の変更~/.claude~/.codex(全プロジェクト共通の設定)が対象です
全プロジェクトへの導入マシン全体を探して、見つかったプロジェクトを1件ずつ片付けます。時間が掛かります

初めて使うときは、特定のプロジェクト内への導入から始めるのが安全です。 影響がそのプロジェクトの中で閉じているので、気に入らなければそこだけ元に戻せます。

次に、いまの差分が表示されます

まず、Skills・CLAUDE.md / AGENTS.md・MCP などの項目ごとに、 両ツールの設定がどれだけ食い違っているかの一覧が表示されます。ここでは表示だけで、まだ何も変わりません。

何をまとめるかを聞かれます

一覧を見たうえで、まとめる対象を選べます。すべてそのままで進めても、安全な既定になっています。 この時点ではまだ同期されません。

次に「実ファイルをどちら側に置くか」を聞かれます。項目ごとではなく、プロジェクト共通の設定です。 Claude 側(.claude/CLAUDE.md.claude/skills/)が既定で、Codex 側(`AGE

项目描述

Claude Code と Codex の設定を1つに保つ同期ツール(symlink + 双方向変換)

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

Jakubantalik
精选
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI 与机器学习AI 智能体
1,191
makecindy
精选
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI 与机器学习大语言模型
958
mereyabdenbekuly-ctrl
精选
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI 与机器学习AI 智能体
859