Markdown 版本

AI-translated from English; not yet reviewed by a fluent editor.

# 将一项 Claude Code 编码任务从 Opus 委派给 Haiku，并验证结果

> 基于文档的 Claude Code 工作流：把一项范围明确的代码修改从 Opus 主代理交给项目 Haiku 子代理，检查实际模型及差异，并在不预设节省的前提下解读用量。

By BIG CHANGE Editorial

Published: 2026-10-20T10:17:38.691Z
Updated: 2026-10-20T10:17:38.691Z
Canonical: https://bigchange.ai/blog/claude-code-opus-haiku-subagent-coding-guide

![Conceptual charcoal illustration of a reviewer using a laptop trackpad beside a generic two-column code diff with one orange changed section.](https://bigchange.ai/api/media/file/opus-haiku-diff-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code 可以为项目子代理分配独立模型和工具，同时由主对话负责规划和审查。对于一项获授权的代码仓库修改，Opus 主代理可将范围明确的实现步骤交给 Haiku。真正有用的结果是经过检查的代码修改，以及实际运行模型的记录。仅设置较便宜的模型，不能证明节省了费用。

## 重要变化

- **发生了什么变化：**项目代理文件可为指定名称的编码执行代理请求`model: haiku`，而主会话使用 Opus。
- **为何重要：**主代理可以审查更小的执行任务，但开发者仍要判断差异是否满足原始验收检查。
- **需要注意：**模型覆盖设置、组织政策、权限、审查和重试都可能改变实际模型及总用量。宣称成本优势前应先核实。

## 从你已获授权负责的任务开始

你需要自己控制的 Git 仓库、修改权限、Claude Code 对两个模型系列的使用权限，以及一项小到能通过差异评估的授权修改。记录起始提交、范围内文件或行为、现有验收命令，以及通过检查的含义。使用干净的工作副本运行。命令必须来自你的项目；本指南无法为未知仓库提供有意义的测试。

开始前检查`claude --version`、服务商及计费安排，还有实际生效的模型限制。在 Anthropic API 上，当前别名`opus`和`haiku`分别解析为 Opus 5.5（`claude-opus-5-5`）和 Haiku 5.5（`claude-haiku-5-5`）；这对模型需要 Claude Code v2.1.293 或更高版本。其他服务商可能将相同别名映射到较早代际。组织的`availableModels`政策可能阻止或替换选择。在主会话中使用`/model`并记录显示的准确主模型。确定授权预算，并检查真实的账户或服务商控制；给模型的提示不是有保证的支出上限。[Anthropic 模型配置文档](https://code.claude.com/docs/en/model-config)说明当前映射及限制。

## 1. 定义项目 Haiku 执行代理

在项目中创建一个名称唯一的文件，例如`.claude/agents/bounded-code-worker.md`，审查文件后，使用以下方式启动 Opus 主代理：`claude --model opus`，或用以下命令选择 Opus：`/model`。此示例是执行代理定义，不是测试任务：

```markdown
---
name: bounded-code-worker
description: Implements one explicitly bounded, authorized repository change and reports the diff and checks for parent review.
model: haiku
tools: Read, Glob, Grep, Edit, Bash
permissionMode: default
---
```

在代理文件结尾的`---`后立即添加以下自然语言系统提示：仅实现主代理交付的任务和文件范围。修改前，检查相关代码和指定验收检查。如果缺少任务、权限或必要输入，停止并报告缺口。作出最小的相关修改。在允许时运行原始检查，报告准确命令和结果。返回修改文件、差异目的、剩余失败及未能验证的工作。没有明确授权，不得提交、发布、部署或扩大任务。

该`tools`列表提供工具；它**不会**将读取或 shell 命令限制在指定路径内。委派前检查项目与组织的实际权限，尤其是 shell 访问。此流程中主代理应保持 Manual/default 权限模式：Anthropic 文档说明，若主代理处于`acceptEdits`、`auto`或`bypassPermissions`，就会覆盖执行代理的`permissionMode`。若这是新建 agents 目录中的首个文件，且代理未出现，可重启 Claude Code。[子代理手册](https://code.claude.com/docs/en/sub-agents)解释这些控制。

可选的`isolation: worktree`为执行代理提供独立工作副本。文档规定其起点为仓库默认分支，可能不同于主代理当前提交。使用或比较修改前，将起始修订与已记录的任务基线核对。运行原始验收检查仍需要干净、获授权的工作副本。

## 2. 委派、检查，再接受或拒绝

向主代理提供与真实任务相关的指令，使用自己的文件边界和检查命令：

> 简要规划这项授权修改。仅将指定实现委派给`bounded-code-worker`。由你保留原始验收标准和最终审查。执行代理返回后，向我显示准确差异和检查结果。在我审查前，不得接受或扩大修改。

执行代理运行时打开`/tasks`，记录其行内显示的模型。这才是运行时检查；代理文件或提示中的`haiku`只是请求。Claude Code v2.1.242 或更高版本会在此显示运行模型。已完成的后台任务会在`/tasks`中保留约 30 秒，应及时查看并保留记录。若错过该行，将模型验证标记为未完成，不要从文件推断。

阅读实际差异，检查每个修改文件，并在自己控制的工作副本中亲自运行**原始**验收命令。修改需要时补充针对性检查。仅在行为、范围及检查均符合任务时接受结果。如果执行代理提前停止或只返回部分工作，应在继续或修复前查看已改内容。若使用独立 worktree，合并至主工作副本前先审查。

有关用 AI 助手核查仓库故障的相关方法，请参阅我们的[AI Goal 修复与验证指南](https://bigchange.ai/blog/ai-goal-failing-repository-check-guide)。该工作流不配置此处使用的 Opus 到 Haiku 委派。

如果`/tasks`显示其他模型或替换警告，请检查调用的模型参数、代理文件头配置、`CLAUDE_CODE_SUBAGENT_MODEL`以及受管理的模型列表。在当前 Claude Code 中，调用模型优先于文件头配置，其后为环境默认值，再后为主模型；v2.1.251 之前环境设置优先。`CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1`（v2.1.257+）可覆盖定义，已安装 mod 的`agent.spawn`钩子也可替换调用模型。修正实际覆盖来源，或停止运行。不要将非 Haiku 的结果改称为 Haiku。

## 3. 记录用量，不虚构节省

在这次受控会话前后读取`/usage`。按模型记录输入、输出与缓存 token、显示的成本估算、服务商或方案、已接受差异、原始检查结果，以及所需审查或返工。Session 区块按模型汇总整个会话，并非这个指定执行代理的精确账单。方案归属百分比是近似的本地日或周历史，不是此次任务测量。API 账户以 Claude Console 为权威计费来源。订阅用户的会话美元估算不是额外账单。若用量显示仅为上次已知值，应标记为过期。

若要宣称委派在**这项**任务上节省了费用，应与另行授权的单模型运行比较：从相同干净起始修订出发，采用相同任务和验收标准。计入主代理规划与审查、执行代理调用、重试及返工，只比较已接受的结果。一对运行仍只是特定任务的观察。没有此基线，应报告已验证模型路线与代码结果，节省未知。[Anthropic 成本指南](https://code.claude.com/docs/en/costs)解释用量显示和计费限制。

此流程依据当前文档，不是 BIG CHANGE 实际运行 Claude Code 或测量任务的结果。不要将组织尚未批准给已配置服务商的代码或秘密发送出去。这里使用 Claude Code 原生 Opus 和 Haiku 选择；其他模型服务商需要单独规定的网关或编排工作流及独立检查。

## 来源及延伸阅读

- [Anthropic：创建自定义子代理](https://code.claude.com/docs/en/sub-agents)——项目代理文件、模型优先级、`/tasks`、权限与 worktree 行为。当前手册于 2026 年 10 月 20 日核查；它说明功能，不证明本指南未运行示例的结果。
- [Anthropic：模型配置](https://code.claude.com/docs/en/model-config)——当前别名、服务商差异、版本要求及受管理模型控制。使用时确认已安装版本和服务商。
- [Anthropic：有效管理成本](https://code.claude.com/docs/en/costs)——`/usage`字段、估算及订阅与 API 计费差异，不证明本任务存在节省。
- [Anthropic：配置权限](https://code.claude.com/docs/en/permissions)——修改代码的执行代理运行前需要检查的实际工具权限规则。

## Sources

- [创建自定义子代理——Claude Code 文档](https://code.claude.com/docs/en/sub-agents) — 项目代理文件、文件头配置、模型优先级与覆盖、/tasks 查看、权限继承及 worktree 行为的主要产品手册。不验证本指南未运行的任务或节省。
- [模型配置——Claude Code 文档](https://code.claude.com/docs/en/model-config) — 当前 Anthropic API 上 Opus、Haiku 别名和 ID、其他服务商映射、最低版本及受管理 availableModels 限制的主要来源。读者必须核查本地实际解析。
- [有效管理成本——Claude Code 文档](https://code.claude.com/docs/en/costs) — 解释 /usage 会话 token 与估算字段、本地方案归属、过期显示、订阅与 API 计费，以及 Console 的计费权威性。不提供指定执行代理的精确账单或测得的任务节省。
- [配置权限——Claude Code 文档](https://code.claude.com/docs/en/permissions) — 解释修改代码的执行代理相关的实际 shell 和文件权限。子代理工具列表本身不是文件系统路径边界。