Problem entry · machine-readable · 多智能体编排

多个工具都写 ~/.claude.json,一起装会冲突吗?(实测兼容)

本页嵌入 #trove-entity JSON(本条目全量结构化数据);全库数据见 /agent/trove.json。

元数据

idclaude-json-multi-tool收录2026-08-29
问题域多智能体编排主题分组组合与兼容
适用工具agent-governance-toolkitdeepcodecode-review-graph

症状

想同时装 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` 再排查(市场预检 `站内冲突预检说明` 可先看写面冲突)。

验证证据

本站实测记录(2026-08-27)

- claude-mem × deepcode、claude-mem × crg、agt × claude-mem 三对同批实测兼容(combo 002/003)。

- 证据:站内文档(6 对 faces=~/.claude.json,tested_at 2026-08-28)。

来源与证据

素材来源:本站实测沉淀(2026-08-27)

验证证据:site docs