# 协同与全局规则

Claude Code 和 Codex 各有所长。把两者搭配着用,再配上一份合适的全局规则,效率会明显提升。

---

## 各用所长

| 场景 | 更推荐 |
|------|--------|
| 理解需求、规划方案、"我现在该怎么做" | **Claude Code** |
| 执行任务、排查问题、动手直接改 | **Codex** |
| 长篇梳理、文档整理 | Claude Code |
| 跑命令、看报错、快速定位 | Codex |

记不住就两个词:**想清楚用 Claude,动手干用 Codex。** 如果当前只有一个能用,直接用它即可。

---

## 一种顺手的协同方式

1. **先用 Claude Code 规划**:把目标讲清楚,让它产出一份分步方案 / 改动清单,必要时写进项目的 `CLAUDE.md` 或一个 `PLAN.md`。
2. **再用 Codex 执行**:让 Codex 读同一份方案,逐步实现、跑测试、排报错。
3. **回到 Claude Code 复盘**:让它审查 Codex 的改动、补文档、查遗漏。

让两个工具共享同一份**项目说明文件**(Claude 读 `CLAUDE.md`、Codex 读 `AGENTS.md`),它们对项目的理解就能对齐。可以让其中一个工具帮你把另一份生成出来,保持内容一致。

---

## 多 worker 并行时的硬规则

当 Claude Code、Codex 或多个 worker 同时改同一套文档/代码时,最怕的是“好心回退”覆盖别人。建议把下面几条写进本次任务提示或项目规则:

- 明确允许写入的文件白名单;没有列出的文件只读不写。
- 动手前记录目标文件当前 hash / 时间戳;写入前再读一次目标片段,只做增量 patch。
- 不执行 `git checkout -- .`、`git reset --hard`、批量格式化、全仓搜索替换这类会扫到他人改动的操作。
- 发现目标文件已被别人改过,先合并当前内容再补自己的段落,不要用旧快照整文件覆盖。
- 最后报告“改了哪些文件、没碰哪些禁改文件、怎么校验”。

协作时可以让 Claude 更偏规划/审查,让 Codex 更偏执行/验证;但两者都必须遵守同一份文件白名单。

---

## 共享配置时的边界

- Claude Code 的共享规则是 `CLAUDE.md` / `.claude/settings.json`;接 Clomio 时根地址写 `https://api.clomio.ai`,主路径是 `/v1/messages`。
- Codex 的共享规则是 `AGENTS.md` / 受信任项目的 `.codex/config.toml`;接 Clomio 时 base URL 写 `https://api.clomio.ai/v1`,wire API 是 `responses`。
- 两者可以共享同一个 Clomio 控制台账号体系,但 Key 分组要匹配客户端:Claude Code 用 Anthropic/Claude 分组，或使用已开放 Messages 兼容能力的 OpenAI 分组；Codex 用 OpenAI/Codex/GPT 分组。
- 多 worker 同时工作时,把“只允许改哪些文件”写在任务开头;让子代理只读探索,最终写入由主 worker 合并当前文件后做最小 patch。

## 推荐的全局规则

全局规则写在各自的用户级文件里,对所有项目生效:

- Claude Code:`~/.claude/CLAUDE.md`
- Codex:`~/.codex/AGENTS.md`(或项目级 `AGENTS.md`)

下面这几条对新手尤其有用,可按需放进去:

```text
- 用中文回复。
- 动手改动前,先用一两句话说明你打算怎么做。
- 一次只聚焦一个目标,不要发散。
- 改动要小步、可回退;涉及多文件时先列清单再动手。
- 遇到报错,把完整报错和你的判断讲清楚,别默默吞掉。
- 不确定时先问我,不要擅自做破坏性操作(删文件、改全局配置等)。
- 完成后告诉我"做了什么、怎么验证"。
```

> 全局规则不要写太长太细——只放真正通用的偏好,项目专属的放各项目自己的说明文件里。

---

## 一个稳的工作习惯

- **小步提交**:让 AI 每完成一小块就停下来给你看,而不是一口气改一大片。
- **先读后写**:复杂改动前,先让它"只读地"梳理现状、给方案,你确认后再让它动手。
- **报错就喂回去**:把终端里的红字原样发给还能用的那个工具,让它接着排查;两个都不方便时再借助第三方 AI。
- **卡顿先换线路**:见 [网关线路](#/gateway-lines),换条线通常立刻见效。

---

> 想深入单个工具的能力,见 [Claude Code 进阶](#/claude-advanced) 与 [Codex 进阶](#/codex-advanced)。