<p data-line="1" class="code-line">Claude Codeで複雑なタスクを実行すると、コンテキストが肥大化して精度が落ちる問題がありました。サブエージェント機能で解決できたので、備忘録として残します。</p>
<h2 id="%E3%82%B3%E3%83%B3%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E8%82%A5%E5%A4%A7%E5%8C%96%E3%81%AE%E8%AA%B2%E9%A1%8C" data-line="3" class="code-line"><a class="header-anchor-link" href="#%E3%82%B3%E3%83%B3%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E8%82%A5%E5%A4%A7%E5%8C%96%E3%81%AE%E8%AA%B2%E9%A1%8C" aria-hidden="true"></a> コンテキスト肥大化の課題</h2>
<p data-line="5" class="code-line">Claude Codeで大きなタスクを処理すると、会話履歴が膨らみ、モデルの注意が分散します。結果として、指示の見落としや不正確な出力が発生しやすくなります。</p>
<p data-line="7" class="code-line">サブエージェントは、この問題を <strong>タスクの分離</strong> で解決します<sup class="footnote-ref"><a href="#fn-242a-1" id="fnref-242a-1">[1]</a></sup>。メインの会話から独立した別プロセスで動作し、専門的な作業を完了後に結果だけを返します。</p>
<h2 id="%E7%B5%84%E3%81%BF%E8%BE%BC%E3%81%BF%E3%82%B5%E3%83%96%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88" data-line="9" class="code-line"><a class="header-anchor-link" href="#%E7%B5%84%E3%81%BF%E8%BE%BC%E3%81%BF%E3%82%B5%E3%83%96%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88" aria-hidden="true"></a> 組み込みサブエージェント</h2>
<p data-line="11" class="code-line">Claude Codeには、用途別に3種類のサブエージェントが用意されています<sup class="footnote-ref"><a href="#fn-242a-2" id="fnref-242a-2">[2]</a></sup>。それぞれ得意な領域が異なるため、タスクに応じて使い分けます。</p>
<table data-line="13" class="code-line">
<thead data-line="13" class="code-line">
<tr data-line="13" class="code-line">
<th>名前</th>
<th>用途</th>
<th>モデル</th>
</tr>
</thead>
<tbody data-line="15" class="code-line">
<tr data-line="15" class="code-line">
<td>General-purpose</td>
<td>複数ステップのタスク全般</td>
<td>Sonnet</td>
</tr>
<tr data-line="16" class="code-line">
<td>Plan</td>
<td>実装計画の作成（読み取り専用）</td>
<td>Sonnet</td>
</tr>
<tr data-line="17" class="code-line">
<td>Explore</td>
<td>コードベースの検索・調査（読み取り専用）</td>
<td>Haiku</td>
</tr>
</tbody>
</table>
<p data-line="19" class="code-line">タスクの内容に応じてClaude Codeが自動で選択しますが、明示的に指定することもできます。</p>
<h2 id="%E3%82%B5%E3%83%96%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%82%92%E8%87%AA%E4%BD%9C%E3%81%99%E3%82%8B" data-line="21" class="code-line"><a class="header-anchor-link" href="#%E3%82%B5%E3%83%96%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%82%92%E8%87%AA%E4%BD%9C%E3%81%99%E3%82%8B" aria-hidden="true"></a> サブエージェントを自作する</h2>
<p data-line="23" class="code-line">独自のサブエージェントは、以下の手順で作成します<sup class="footnote-ref"><a href="#fn-242a-3" id="fnref-242a-3">[3]</a></sup>。</p>
<ol data-line="25" class="code-line">
<li data-line="25" class="code-line">Claude Codeのチャットで<code>/agents</code>と入力してEnter</li>
<li data-line="26" class="code-line">エディタが開くので、Markdown + YAML形式で定義を記述</li>
<li data-line="27" class="code-line">ファイルを保存して閉じる</li>
</ol>
<p data-line="29" class="code-line">以下はコードレビュー用サブエージェントの例です。</p>
<div class="code-block-container"><div class="code-block-filename-container"><span class="code-block-filename">code-reviewer.md</span></div><pre class="language-markdown"><code class="language-markdown code-line" data-line="31"><span class="token front-matter-block"><span class="token punctuation">---</span>
<span class="token front-matter yaml language-yaml"><span class="token key atrule">name</span><span class="token punctuation">:</span> code<span class="token punctuation">-</span>reviewer
<span class="token key atrule">description</span><span class="token punctuation">:</span> コード品質とセキュリティをレビューする
<span class="token key atrule">tools</span><span class="token punctuation">:</span> Read<span class="token punctuation">,</span> Grep<span class="token punctuation">,</span> Glob
<span class="token key atrule">model</span><span class="token punctuation">:</span> sonnet</span>
<span class="token punctuation">---</span></span>

あなたはコードレビュアーです。
以下の観点でレビューしてください。

<span class="token list punctuation">-</span> コードの可読性
<span class="token list punctuation">-</span> エラーハンドリング
<span class="token list punctuation">-</span> セキュリティリスク
</code></pre></div><p data-line="47" class="code-line">作成したファイルは、プロジェクト用なら<code>.claude/agents/</code>に、全プロジェクト共通なら<code>~/.claude/agents/</code>に保存します<sup class="footnote-ref"><a href="#fn-242a-4" id="fnref-242a-4">[4]</a></sup>。</p>
<p data-line="49" class="code-line">YAMLフロントマターで設定できる主要なフィールドは以下の通りです。</p>
<table data-line="51" class="code-line">
<thead data-line="51" class="code-line">
<tr data-line="51" class="code-line">
<th>フィールド</th>
<th>必須</th>
<th>説明</th>
</tr>
</thead>
<tbody data-line="53" class="code-line">
<tr data-line="53" class="code-line">
<td><code>name</code></td>
<td>はい</td>
<td>小文字とハイフンで構成するID</td>
</tr>
<tr data-line="54" class="code-line">
<td><code>description</code></td>
<td>はい</td>
<td>エージェントの目的</td>
</tr>
<tr data-line="55" class="code-line">
<td><code>tools</code></td>
<td>いいえ</td>
<td>使用可能なツール（カンマ区切り）</td>
</tr>
<tr data-line="56" class="code-line">
<td><code>model</code></td>
<td>いいえ</td>
<td>sonnet / opus / haiku / inherit</td>
</tr>
</tbody>
</table>
<h2 id="%E4%BD%BF%E7%94%A8%E4%B8%8A%E3%81%AE%E7%95%99%E6%84%8F%E7%82%B9" data-line="58" class="code-line"><a class="header-anchor-link" href="#%E4%BD%BF%E7%94%A8%E4%B8%8A%E3%81%AE%E7%95%99%E6%84%8F%E7%82%B9" aria-hidden="true"></a> 使用上の留意点</h2>
<p data-line="60" class="code-line">サブエージェントを使う際は、以下の点に注意してください。</p>
<ul data-line="62" class="code-line">
<li data-line="62" class="code-line"><strong>コンテキストの明示的な受け渡し</strong>：メインの会話と独立しているため、必要な情報はプロンプトで明示的に渡します</li>
<li data-line="63" class="code-line"><strong>結果の要約</strong>：結果はメインに要約して返されるため、詳細な中間結果が必要な場合は別途ファイル出力を指示します</li>
</ul>
<section class="footnotes">
<span class="footnotes-title">脚注</span>
<ol class="footnotes-list">
<li id="fn-242a-1" class="footnote-item"><p data-line="65" class="code-line"><a href="https://docs.anthropic.com/en/docs/claude-code/sub-agents" target="_blank" rel="nofollow noopener noreferrer">Subagents - Claude Code Docs</a> <a href="#fnref-242a-1" class="footnote-backref">↩︎</a></p>
</li>
<li id="fn-242a-2" class="footnote-item"><p data-line="66" class="code-line"><a href="https://docs.anthropic.com/en/docs/claude-code/sub-agents#built-in-subagents" target="_blank" rel="nofollow noopener noreferrer">Subagents - Built-in subagents - Claude Code Docs</a> <a href="#fnref-242a-2" class="footnote-backref">↩︎</a></p>
</li>
<li id="fn-242a-3" class="footnote-item"><p data-line="67" class="code-line"><a href="https://docs.anthropic.com/en/docs/claude-code/sub-agents#managing-subagents" target="_blank" rel="nofollow noopener noreferrer">Subagents - Managing subagents - Claude Code Docs</a> <a href="#fnref-242a-3" class="footnote-backref">↩︎</a></p>
</li>
<li id="fn-242a-4" class="footnote-item"><p data-line="68" class="code-line"><a href="https://docs.anthropic.com/en/docs/claude-code/sub-agents#subagent-locations" target="_blank" rel="nofollow noopener noreferrer">Subagents - Subagent locations - Claude Code Docs</a> <a href="#fnref-242a-4" class="footnote-backref">↩︎</a></p>
</li>
</ol>
</section>


Claude Codeのサブエージェントで複雑なタスクを分割処理する