
Claude 代码和 Codex 的双向同步——指令、技能、代理、MCP 服务器、钩子、权限。
概览
Claude Code 和 Codex 之间实现连续双向同步——往返无损,而非一次性迁移。 - — Claude → Codex 和 Codex → Claude,运行频率取决于两个主机漂移;非一次性迁移。- — Claude 宽松的 YAML 和 Codex YAML 1.2 严格前置文件均通过多次同步保存,无丢失或震动。- — 用于比较同步→状态 --试运行预览→-应用写入。- — 权限、钩子、标记为安全/部分/手动的自定义命令。- — 每次在 .backups/ 下快照的覆盖,FIFO 保留率(30)。- — 每个 --apply 为 ~/.ai-config-sync-manager/ledgers/ 写入每项 sha256 声明(哈希前后备份路径)。- — 包括技能:code-writer,instructions --排除 mcp 风格过滤。- — Claude Write → Codex sandbox_mode = “workspace-write”等。- — 仅 Claude 的令牌(Read、Bash、TaskCreate、无头 claude -p)和仅 Codex 的令牌(spawn_agent、Codex exec)会自动跨主机翻译并往返。
概述(AI 翻译)
AI 配置同步管理器
Claude Code 和 Codex 之间实现连续双向同步——往返无损,而非一次性迁移。
精彩片段
- 连续双向同步 —
claude → codex和codex → claude,运行频率取决于两个宿主漂移;不是一次性迁移。 - 严格YAML往返 — Claude宽松的YAML和Codex YAML 1.2严格前置信息均通过多次同步保持无丢失或振荡。
- 差分优先工作流程 —
status用于比较→sync --dry-run用于预览→--apply用于写入。 - 风险标记操作 —
permissions、hooks,自定义命令标记为safe/partial/manual。 - 写时备份 — 在
.backups/下快照的每次覆写,FIFO保留率为30。 - 应用账本 — 每个
--apply都写入每项sha256证明(哈希前后,备份路径)到~/.ai-config-sync-manager/ledgers/。 - 选择器语法 —
--include skills:code-writer,instructions --exclude mcp风格过滤。 - 本地语义映射 — Claude
Write→ Codexsandbox_mode = "workspace-write"等。
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
AI Config Sync Manager
Continuous bidirectional sync between Claude Code and Codex — round-trip lossless, not a one-shot migrator.
Highlights
- Continuous bidirectional sync —
claude → codexandcodex → claude, run as often as the two hosts drift; not a one-shot migration. - Strict YAML round-trip — Claude lenient YAML and Codex YAML 1.2 strict frontmatter both preserved across repeated syncs without loss or oscillation.
- Diff-first workflow —
statusto compare →sync --dry-runto preview →--applyto write. - Risk-tagged operations —
permissions,hooks, custom commands labeledsafe/partial/manual. - Backup-on-write — every overwrite snapshotted under
.backups/, FIFO retention (30). - Apply ledger — every
--applywrites a per-item sha256 attestation (before/after hash, backup path) to~/.ai-config-sync-manager/ledgers/. - Selector syntax —
--include skills:code-writer,instructions --exclude mcpstyle filtering. - Native semantic mapping — Claude
Write→ Codexsandbox_mode = "workspace-write", etc. - Prose-level token rewriting — Claude-only tokens (
Read,Bash,TaskCreate, headlessclaude -p) and Codex-only tokens (spawn_agent,codex exec) auto-translate across hosts and round-trip back. - Zero runtime dependencies — single ESM file, Node built-ins only.
- Thin host plugins —
/config-manager:*for Claude,config-manager-*for Codex. - Visual inventory board —
boardrenders a self-contained HTML page of every skill, agent, hook, and MCP server on both hosts, colored by sync status (in-sync / conflict / one-host-only) and grouped into per-area tabs and by agent harness. Jump to the board →
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →