多个工具都写 ~/.claude.json，一起装会冲突吗？（实测兼容）

你会遇到什么

想同时装 agt、deepcode、code-review-graph，它们安装时都会写 ~/.claude.json（MCP/插件注册段），你担心互相覆盖导致某个工具失效或配置丢失。实测结论：可以一起装，不冲突。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

三者都写 ~/.claude.json，但写的是不同 key/段：

JSON 按 key 合并，实测共存时结构完整、无互相覆盖。claude-mem 走独立写面 ~/.claude-mem/，与三者实测兼容。

~/.claude.json 是多工具共享的写面，但它的合并语义是「按 key 合并」：每个工具往自己的段写（agt 写策略/治理段，deepcode/code-review-graph 写各自的 MCP/工具注册段），读的时候各读各的 key——JSON 对象级合并不会互相覆盖，除非两个工具写同一个 key。

确定性推论：共享写面安全与否取决于「key 空间是否隔离」，不是「是不是同一个文件」；实测三工具共存结构完整 = 它们的 key 空间互不重叠；判断新工具能否加入：查它写 ~/.claude.json 的哪些 key，与现有工具比对；claude-mem 走独立目录 ~/.claude-mem/（不同写面），与共享写面者天然隔离——写面分析比「同文件=冲突」的直觉准确得多。

一步步来

1. 直接按各自官方命令安装 — 必做

agt、deepcode、code-review-graph、claude-mem 可同环境共存，无强制顺序。

2. 装完校验 — 必做

python3 -m json.tool ~/.claude.json

必须解析通过；再逐个跑工具冒烟（agt lint-policy / crg build / deepcode 诊断命令），均 exit 0 即正常。

3. 升级后重跑冒烟 — 必做

升级任一工具后重跑冒烟；配置异常时先备份 ~/.claude.json 再排查（站内冲突预检说明 可先看写面冲突）。

怎么确认修好了

冒烟全绿（实测形态）：

agt lint-policy → exit 0
crg build → exit 0
deepcode 诊断命令 → exit 0
python3 -m json.tool ~/.claude.json → 解析通过

其它环境的表现

症状

想同时装 agt、deepcode、code-review-graph，它们安装时都会写 ~/.claude.json（MCP/插件注册段），担心互相覆盖导致某个工具失效或配置丢失。

原因

三者都写 ~/.claude.json，但写的是不同 key/段：agt 写策略/治理段、deepcode 与 code-review-graph 写各自 MCP/工具注册段；JSON 按 key 合并，实测共存时结构完整、无互相覆盖。claude-mem 走独立写面 ~/.claude-mem/，与三者实测兼容。

解法

1. 直接按各自官方命令安装（agt、deepcode、code-review-graph、claude-mem 可同环境共存）。
2. 装完校验：python3 -m json.tool ~/.claude.json 必须解析通过；再逐个跑工具冒烟（agt lint-policy / crg build / deepcode 诊断命令），均 exit 0 即正常。
3. 升级任一工具后重跑冒烟；配置出现异常时先备份 ~/.claude.json 再排查（市场预检 站内冲突预检说明 可先看写面冲突）。