<!-- gitea-wiki-mirror:start -->
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Task-7-ClaudeCode模型路由
wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-7-ClaudeCode%E6%A8%A1%E5%9E%8B%E8%B7%AF%E7%94%B1.-
wiki_revision: cfd37f7beab92133e1528104df9553e3e7835aff
synchronized_at: 2026-08-08T03:26:21Z
<!-- gitea-wiki-mirror:end -->

# 7 Claude Code 模型路由

- 类型：开发规则优化
- 所属 Epic：无
- 所属 MVP / 版本：无
- 状态：已完成
- 日期：2026-08-08
- Gitea 工单：http://ilaer.eicp.net:8418/opc/dev_harness/issues/7
- Wiki 页面：Task-7-ClaudeCode模型路由
- Wiki revision：见本地镜像头

## 背景与目标

Claude Code 已通过 `CLAUDE.md` 导入共同开发规则，但没有说明 Opus、Sonnet 和 Haiku 应如何按任务复杂度分工。若每个任务固定依次调用三个模型，会增加重复上下文、Token 和等待时间；如果只用提示语要求 Haiku 只读，又不能真正限制其工具权限。

本任务在 Claude Code 专用入口中增加按需模型路由、结构化交接和 Haiku 只读边界。

## 最终方案

- 目标、范围和修改位置明确的任务默认由 Sonnet 分析、建单和实施。
- 模糊需求、复杂根因、跨模块架构或高风险任务由 Opus/`opusplan` 制定方案。
- Opus 方案必须先由用户确认，再交给 Sonnet 创建工单和实施。
- Haiku 仅用于范围明确的文档、代码入口、日志事实和调用关系检索。
- Haiku 不承担最终根因、技术方案、风险等级和验收结论。
- 当前模型足够时不升级，不固定依次调用三个模型。
- Agent 只交接结构化事实、假设、范围、风险、证据位置和未知项，减少大段重复上下文。
- Haiku 只读必须由工具权限实现；本任务未创建子 Agent 配置，因此未配置只读权限时不得调用 Haiku 处理项目内容。
- Harness 检查三个新增章节及关键边界，防止后续误删。
- 未写死具体模型版本，继续使用模型别名。

实施结果与已确认方案一致。

## 修改文件

- `CLAUDE.md`：增加模型路由、Agent 交接和 Haiku 只读约束。
- `dev_scripts/check_harness.py`：增加 Claude Code 路由规则的结构检查。
- `wiki-docs.json`：登记本任务 Wiki 归档镜像。
- `docs/task/7-ClaudeCode模型路由.md`：本页的自动导出镜像。

## 验收结果

用户于 2026-08-08 明确验收通过。

| 验收标准 | 结果 |
|---|---|
| 保留 `@AGENTS.md` 导入和共同规则来源说明 | 通过 |
| 包含模型路由、Agent 交接和 Haiku 只读约束 | 通过 |
| 不要求每个任务依次调用三个模型 | 通过 |
| Opus 方案经用户确认后由 Sonnet 实施 | 通过 |
| Haiku 不做最终决策 | 通过 |
| Haiku 只读要求工具权限实施 | 通过 |
| 不写死具体模型版本 | 通过 |
| Harness、测试和镜像检查 | 通过 |
| 实现和归档提交分离 | 通过 |

## 测试

- 执行命令：`python -m unittest discover -s tests -v`
- 结果：19/19 通过。
- 执行命令：`python dev_scripts/check_harness.py --strict`
- 结果：通过。
- 执行命令：`python dev_scripts/sync_wiki_docs.py --check`
- 结果：归档前 16/16 映射一致；归档后重新检查 17/17。
- 执行命令：`python -m compileall -q dev_scripts tests`
- 结果：通过。
- 执行命令：`git diff --check`
- 结果：通过。
- **未验证部分**：未创建或运行 Haiku 只读子 Agent，未执行多模型 Token/耗时基准；这些均不在本任务范围内。

## 相关提交

- `3bfe752` `docs: 增加 Claude Code 模型路由 (#7)`
- 归档提交哈希在提交后回写 Gitea 工单，避免归档自引用。