AI Config Sync
lllloo/ai-config-sync
Sincronize configs Claude/Codex entre máquinas via Git privado
Ver no GitHubFerramenta Git para sincronizar configurações, agents, skills e rules do Claude Code/Codex entre múltiplos dispositivos. Mantém um repositório privado como fonte única de verdade para todos os seus ambientes.
Instalação
npx convez-ai lllloo/ai-config-sync1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Manter configurações do Claude Code sincronizadas entre laptop, desktop e servidor
- Versioná-lo skills e agents globais com controle de mudanças
- Onboarding de novo equipamento sincronizando todas as personalizações em um comando
Veredito

Solução prática e bem estruturada para quem trabalha com Claude em múltiplos ambientes. Implementação direta sem dependências externas e com testes inclusos tornam confiáveis as sincronizações críticas de configuração.
README
A tradução para o português deste README ainda está na fila.
ai-config-sync
跨裝置同步 Claude Code / Codex 設定的私有 Git repo 工具。
這是一個 GitHub Template:點 Use this template 建立自己的私有 repo,再執行 npm run init 清空作者範例後填入自己的設定。詳見下方「Fork 後初次設定」。
同步項目:~/.claude/CLAUDE.md、~/.claude/settings.json、~/.claude/statusline.sh、全域 agents、全域 skills、全域 rules、~/.codex/AGENTS.md、~/.codex/config.toml(過濾版)、~/.codex/agents/
目錄命名:
claude/(無點)— 要同步到~/.claude/的全域設定codex/(無點)— 要同步到~/.codex/的全域設定(AGENTS.md、config.toml、agents).claude/、.codex/— 本 repo 專用的 Claude Code / Codex 本地設定,不參與同步.agents/skills/— 本地 skill 實體目錄(已納入版控),.claude/skills與.codex/skills皆為 symlink 指向此處,跨工具共用
使用方式
# 比較本機 vs repo 差異(不寫任何東西)
npm run diff
# 同時比較設定與 skills 差異
npm run status
# 本機設定 → repo(上傳)
npm run to-repo
# repo 設定 → 本機(套用,會先預覽再確認)
npm run to-local
# 比較本機 vs repo 的 skills 差異(不自動同步)
# 本機多裝者會同時列出 (A) 加入 repo 與 (B) 從本機移除 兩種建議指令
npm run skills:diff
# 新增 skill 到 skills-lock.json
npm run skills:add -- https://skills.sh/<org>/<repo>/<skill>
npm run skills:add -- <name> <source>
# 從 skills-lock.json 移除 skill
npm run skills:remove -- <name>
# 執行單元測試(node:test,零外部相依)
npm test
指令別名
可直接用 node sync.js 搭配簡寫:
| 指令 | 別名 |
|---|---|
diff | d |
status | s |
to-repo | tr |
to-local | tl |
skills:diff | sd |
skills:add | sa |
skills:remove | sr |
init | — |
旗標
| 旗標 | 說明 |
|---|---|
--dry-run | 預覽操作,不實際寫入(適用 to-repo / to-local) |
--verbose | 顯示詳細路徑與檔案大小 |
--version | 顯示版本號 |
--help | 顯示指令說明 |
# 範例:預覽 to-repo 會做什麼,不實際寫入
node sync.js to-repo --dry-run
# 範例:顯示詳細差異資訊
node sync.js diff --verbose
Fork 後初次設定
如果你是從 template 建立自己的 repo(而不是回到自己已有的設定 repo),執行以下流程清空作者範例:
# 1. 從 template 建立自己的 repo 後 clone
git clone <your-new-repo-url>
cd <your-new-repo>
# 2. 清空作者個人內容為空骨架(會互動確認,可加 --dry-run 預覽)
npm run init
# 3. 修改 package.json 的 name 與 description 為你自己的
# 4. 在主力機把本機現有設定推上 repo
npm run to-repo
git add . && git commit -m "init: my settings" && git push
# 5. 其他裝置 clone 後直接 to-local 即可
npm run init 會:
- 把
claude/CLAUDE.md、codex/AGENTS.md、claude/settings.json、skills-lock.json重置為空骨架(由.example範本覆寫) - 刪除
claude/rules/下作者個人化規則檔 - 不會動
claude/agents/、codex/agents/、claude/skills/、.agents/skills/、sync.js、test/(這些對所有人都有用)
新裝置部署
如果你已經完成 Fork 後初次設定,第二台之後的機器只要:
git clone <your-repo-url>
cd <your-repo>
npm run to-local
檔案說明
| 檔案 | 說明 |
|---|---|
sync.js | 主腳本,實作所有指令邏輯(無外部相依) |
test/sync.test.js | 同步邏輯純函式單元測試(使用 Node.js 內建 node:test) |
test/settings.test.js | settings.json 相關純函式單元測試 |
test/codex-config.test.js | Codex config.toml 過濾同步測試 |
package.json | 定義所有 npm 指令 |
claude/CLAUDE.md | 對應 ~/.claude/CLAUDE.md |
claude/settings.json | 對應 ~/.claude/settings.json |
claude/statusline.sh | 對應 ~/.claude/statusline.sh |
claude/agents/ | 對應 ~/.claude/agents/(以 package 子目錄組織) |
claude/skills/ | 對應 ~/.claude/skills/ |
claude/rules/ | 對應 ~/.claude/rules/(CLAUDE.md 的模組化拆分,支援 frontmatter paths: 做 path-specific scoping) |
codex/AGENTS.md | 對應 ~/.codex/AGENTS.md(Codex 全域指示,跨專案規則) |
codex/config.toml | 對應 ~/.codex/config.toml 的可攜欄位(過濾版) |
codex/agents/ | 對應 ~/.codex/agents/(以 package 子目錄組織,.toml 格式) |
skills-lock.json | 全域 skills 清單(跨裝置 source of truth) |
claude/CLAUDE.example.md | Fork 後 npm run init 用的空骨架範本 |
claude/settings.example.json | 同上,設定檔範本(僅基本 permissions) |
codex/AGENTS.example.md | 同上,Codex 全域指示範本 |
skills-lock.example.json | 同上,空 skills 清單範本 |
Exit Code
| Code | 說明 |
|---|---|
0 | 成功(diff 模式:無差異) |
1 | diff 模式:有差異(可用於 CI 判斷) |
2 | 錯誤 |
注意事項
settings.json的model、effortLevel、defaultShell、env.CLAUDE_CODE_USE_POWERSHELL_TOOL為裝置特定設定,to-repo 時自動排除,to-local 時保留本機值;env其他 key 皆跨裝置同步codex/config.toml只同步可攜欄位:personality、web_search、tui.status_line、features.memories、features.goals、memories.generate_memories、memories.use_memories、plugins.*.enabledcodex/config.toml會排除model、model_reasoning_effort、projects.*、marketplaces.*、windows、tui.model_availability_nux與未知欄位;to-local 時保留本機未受管理欄位.agents/skills/是本地 skill 實體目錄,已納入版控;.claude/skills與.codex/skills以 symlink 共用同一份來源- Claude agents 儲存於
claude/agents/,以 package 子目錄分組(awesome-claude-code-subagents/、everything-claude-code/);Codex agents 儲存於codex/agents/,同樣以 package 子目錄分組(awesome-codex-subagents/),Codex CLI 會遞迴掃描子目錄 - Skills 不在自動同步範圍內,用
npm run skills:diff查看差異;本機多裝者會列出npm run skills:add(加入 repo)與npx skills remove(從本機移除)兩種建議 - JSON 寫入使用 atomic write(先寫暫存檔再 rename),避免中途斷電導致檔案損壞
- 每次 to-repo / to-local 操作會記錄到
.sync-history.log(已加入 .gitignore)