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

# Claude Code のコード作業を Opus から Haiku に委任し、結果を検証する

> 範囲を限定したコード変更を Opus の親からプロジェクトの Haiku サブエージェントへ渡し、実際のモデルと差分を確認して、節約を前提にせず使用量を読む、文書に基づく Claude Code の手順です。

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 に渡せます。有用な結果は確認済みのコード変更と、実行モデルの記録です。安価なモデルを設定しただけでは費用の節約を立証できません。

## 大きな変化

- **何が変わるか：**親セッションが Opus を使う一方、プロジェクトのエージェントファイルは名前を付けたコード担当に`model: haiku`を要求できます。
- **なぜ重要か：**親はより小さい作業をレビューできますが、差分が元の受け入れ確認を満たすかは開発者が判断します。
- **注意点：**モデルの上書き、組織の方針、権限、レビュー、再試行によって、実際のモデルや総使用量が変わります。費用面の利点を述べる前に確認してください。

## すでに担当権限のある作業から始める

自分が管理する 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 とファイル権限を説明します。サブエージェントのツール一覧だけではファイルシステムのパス境界になりません。