Codex に大きめの仕事を頼むと、「関係するコードを調べる」「テストを回す」「仕様書と照らし合わせる」といった別々の作業を、1つのエージェントが順番にこなすことになります。調べる範囲が広いほど時間がかかり、会話の中身も長くなります。
こうした仕事を 複数のエージェントに分けて並行して進め、結果を1つの回答にまとめる のが Codex の サブエージェント です。調べものやレビューのように読むことが中心の作業を分担させると、待ち時間を減らしやすくなります。
この記事では、サブエージェントが始まる条件、モデルの引き継ぎ、config.toml の設定、社内で使い回せるカスタムエージェントの作り方、承認とサンドボックスの扱いを整理し、チームで使う前に決めておきたいことをまとめます。製品の内容は、2026年11月11日に OpenAI の公式ドキュメント「Subagents」で確かめた範囲に絞りました。
結論: 読む作業から分担させ書く作業は1本にまとめる
先に要点をまとめます。
- サブエージェントは頼んだときに始まる。 利用者がはっきり頼むか、
AGENTS.mdやスキルの指示が求めたときに動きます。ChatGPT Work で推論の強さを Ultra にした場合は、Codex が自分から分けることがあります - 並行させるのは読む作業から。 公式ドキュメントは、調査・テスト・不具合の切り分け・要約などの読み取り中心の作業に向くとし、複数のエージェントが同時にコードを編集すると衝突しやすいと注意しています
- 使用量は増える。 サブエージェントはそれぞれがモデルとツールを使うため、1つのエージェントで進めるより多くのトークンを使います。同時に開くスレッドの数は設定で上限を決められます
- 守りの設定は親のセッションで決める。 サブエージェントは親のサンドボックスと承認の設定を引き継ぎ、カスタムエージェントのファイルでは変えられません
サブエージェントでできること
サブエージェントは、親のエージェントから作業の一部を任される専門のエージェントです。それぞれが並行して作業し、結果は親のエージェントが1つの回答にまとめます。公式ドキュメントでは、コードベースの調査や、複数の段階に分かれる機能追加のように並行しやすい仕事で役に立つと説明されています。
法人の業務に当てはめると、次のような使い方が考えられます。
| 業務の例 | 分け方の例 | 向き不向き |
|---|---|---|
| プルリクエストのレビュー | 影響範囲を調べる役・不具合や安全性の問題を探す役・ドキュメントと照らし合わせる役 | 読む作業が中心なので向いている |
| 不具合の切り分け | 関係するコードを探す役・再現を試す役 | 原因の候補を並行して確かめられる |
| 既存システムの調査 | モジュールごとに調べる役を分ける | 範囲がはっきり分かれていれば向いている |
| 複数のファイルの同時編集 | 画面ごと・機能ごとに編集する役を分ける | 編集が重なると衝突しやすいので慎重に |
表の最後の行のように、書く作業を並行させるのは注意が要ります。公式ドキュメントでも、同時に編集すると衝突が起き、調整の手間が増えると書かれています。最初は「調べるのは並行・直すのは1本」と決めておくと失敗が少なくなります。
使える画面と始め方
公式ドキュメントでは、現在の Codex ではサブエージェントの仕組みが既定で有効になっていると説明されています。動きは ChatGPT のデスクトップアプリ・Codex CLI・IDE 拡張に表示されます。ChatGPT Work では、対象のアカウントにサブエージェントの仕組みと動きが表示されます。
始め方はシンプルで、プロンプトでサブエージェントや並行作業をはっきり頼みます。
- 作業をどう分けるかを書く(例: 「認証まわり・決済まわり・管理画面の3つに分けて、それぞれサブエージェントで調べて」)
- それぞれに何を返してほしいかを書く(例: 「関係するファイル名と処理の流れを箇条書きで」)
- 最後にどうまとめるかを書く(例: 「3つの結果をまとめて、影響の大きい順に並べて」)
チームの決まりとして使わせたい場合は、AGENTS.md やスキルに「この種類の作業はサブエージェントに分けて調べる」と書いておく方法もあります。AGENTS.md の書き方はAGENTS.md の書き方の記事をご覧ください。
実行中のサブエージェントを見る・止める
| 画面 | できること |
|---|---|
| Codex CLI | /subagents でスレッドを切り替える |
| デスクトップアプリ・IDE 拡張 | サブエージェントのスレッドと状態が表示される |
| Web のサイドバー | 動きを表示するだけ。個別に止める・方向を変える操作はない |
止めたい・やり直させたい・閉じたいときは、どの画面でも Codex に会話で直接頼みます。
モデルと推論の強さの引き継ぎ
サブエージェントは、別に設定しない限り、親のエージェントのモデルと推論の強さを引き継ぎます。公式ドキュメントでは、手間のかかる作業には gpt-6.1-sol、範囲を絞った速さ重視の作業には gpt-6-luna が例として挙げられています。
全員の既定値は config.toml の [agents] で決められます。
| 設定 | 意味 |
|---|---|
agents.enabled |
サブエージェントの仕組みを使うか。既定は true |
agents.max_concurrent_threads_per_session |
同時に開くサブエージェントのスレッド数の上限(メインのスレッドは数えない)。未設定なら Codex が決める。旧名の agents.max_threads も使える |
agents.default_subagent_model |
サブエージェントの既定のモデル |
agents.default_subagent_reasoning_effort |
サブエージェントの既定の推論の強さ |
agents.interrupt_message |
作業が中断されたときに、そのことをモデルに見える形で記録するか。既定は true |
モデルや推論の強さを呼び出しのときに指定した場合は、そちらが default_subagent_* より優先されます。公式ドキュメントにある設定例は次のとおりです。
[agents]
max_concurrent_threads_per_session = 8
使用量を気にする会社では、まず上限を小さめにして始め、利用状況の見える化で増え方を確かめてから広げるのが安全です。モデルごとの向き不向きはモデルと推論の強さの使い分けの記事にまとめています。
カスタムエージェントを作る
毎回プロンプトで役割を説明する代わりに、役割ごとの カスタムエージェント を TOML ファイルで用意できます。公式ドキュメントでは、置き場所は次の2つです。
| 置き場所 | 効く範囲 |
|---|---|
~/.codex/agents/ |
その人のすべての作業 |
<repo>/.codex/agents/ |
そのリポジトリでの作業 |
1つのファイルに1つのエージェントを書きます。必ず書くのは name・description・developer_instructions の3つで、model・model_reasoning_effort などは必要に応じて書きます。features.shell_tool や skills.config で使える機能を絞ることもできます。公式ドキュメントにある、レビュー前に証拠を集める役の例です。
name = "pr_explorer"
description = "Read-only codebase explorer for gathering evidence before changes are proposed."
model = "gpt-6-luna"
model_reasoning_effort = "high"
developer_instructions = """
Stay in exploration mode.
Do not edit files.
Trace the real execution path, cite files and symbols, and avoid proposing fixes unless the parent agent asks for them.
Prefer fast search and targeted file reads over broad scans.
"""
使うときは、プロンプトで名前を出して頼みます。公式ドキュメントの例では「pr_explorer に影響するコードの流れを調べさせ、reviewer に本当のリスクを探させ、docs_researcher に確かめさせて」という書き方が紹介されています。Codex は name の値でエージェントを見分けます。
組み込みのエージェントとして default・worker・explorer があり、同じ名前のカスタムエージェントを作るとそちらが優先されます。社内で使うときは、組み込みと重ならない名前にしておくと混乱しません。
公式の例にある役割の分け方
| 用途 | エージェント | 役割 |
|---|---|---|
| プルリクエストのレビュー | pr_explorer |
コードベースを調べて証拠を集める。編集しない |
reviewer |
正しさ・安全性・テストのリスクを探す。編集しない | |
docs_researcher |
ドキュメントの MCP サーバーで API を確かめる。コードを変えない | |
| 画面の不具合の調査 | code_mapper |
関係するコードの流れを探す |
browser_debugger |
ブラウザで不具合を再現する。アプリのコードは編集しない | |
ui_fixer |
的を絞って修正する |
チームでレビューに使うなら、レビューの観点を reviewer の指示文にまとめてリポジトリの .codex/agents/ に置くと、誰が頼んでも同じ観点で見てもらえます。GitHub でのレビューの進め方はプルリクエストのレビューの記事をご覧ください。
承認とサンドボックスは親のセッションで決まる
チームで使う前にいちばん押さえておきたいのがここです。
- サブエージェントは親の設定を引き継ぐ。 親のターンのサンドボックスと承認の設定がそのまま使われます
- カスタムエージェントでは変えられない。
sandbox_mode・approval_policy・model_provider・mcp_serversはカスタムエージェントのファイルでは上書きできず、親のセッションで決めます - 指示文はサンドボックスではない。 「Do not edit files」と書いても、別の読み取り専用サンドボックスが作られるわけではありません。編集させたくないなら、親のセッションを読み取り専用で始めます
- 承認の依頼は別のスレッドから届くことがある。 対話型の CLI では、メインのスレッドを見ている間にも別のスレッドから承認の依頼が出ることがあります。どのスレッドからの依頼かが表示され、
oキーでそのスレッドを開いてから答えられます - 対話しない実行では失敗として返る。
codex execなどで新たな承認が必要になった操作は失敗し、エラーが親の作業に返ります
ChatGPT Work では、サブエージェントは親のチャットのツールを使い、手元の承認の設定はありません。サンドボックスと承認の考え方そのものはサンドボックスと承認ポリシーの記事で解説しています。
なお、Codex の hooks には SubagentStart・SubagentStop というイベントがあり、サブエージェントの開始と終了で社内のスクリプトを動かせます(公式ドキュメント)。サブエージェントの利用を記録したい場合の使い方はhooks の記事をご覧ください。
チームで使う前に決めておくこと
社内にサブエージェントを広げるときは、次の順番で決めていくと手戻りが少なくなります。
- 並行させてよい作業を決める: まずは調査・レビュー・不具合の切り分けなど読む作業に限り、複数のエージェントによる同時編集は試験チームで様子を見てから判断する
- 同時に開く数の上限を決める:
agents.max_concurrent_threads_per_sessionを小さめに設定し、使用量の増え方を確かめてから見直す - サブエージェントの既定のモデルを決める: 調べる役は速さ重視のモデル、判断する役は手間のかかる作業向けのモデルなど、役割に合わせて
default_subagent_modelと呼び出し時の指定を使い分ける - 共通のカスタムエージェントを用意する: レビューの観点や調査の手順を TOML に書き、リポジトリの
.codex/agents/で共有する。名前は組み込みのdefault・worker・explorerと重ならないようにする - 守りの設定を親のセッションでそろえる: 編集させない作業は読み取り専用で始めることを手順書に書き、指示文だけに頼らない
- 社員に操作を伝える: CLI の
/subagents・承認の依頼の見分け方・Web 版では止められないことを、社内の手順書に1枚でまとめておく
まとめ
Codex のサブエージェントは、調査やレビューなどを複数のエージェントに分けて並行して進め、結果を1つにまとめる仕組みです。利用者が頼んだときか AGENTS.md やスキルの指示があるときに始まり、別に設定しない限り親のモデルと推論の強さを引き継ぎます。役割ごとのカスタムエージェントを TOML で用意すれば、チームで同じ観点の作業を頼めます。一方で使用量は1つのエージェントより増え、サンドボックスと承認は親のセッションで決まるため、指示文だけで編集を止めることはできません。読む作業から分担させ、上限と守りの設定を決めてから広げるのが安全です。
この記事の内容は、2026年11月11日時点の OpenAI 公式ドキュメントの記載に基づいています。設定の項目やモデルの名前は変わることがあるため、使う前に最新の記載をご確認ください。デジライズでは、サブエージェントに任せる作業の切り分けから、カスタムエージェントの設計、サンドボックスと承認の設定、社内向け手順書づくりまでを開発チームと一緒に進める Codex の法人導入支援のご相談を承っています。「まず1つのチームで試したい」という段階からでもお問い合わせください。
確認日:2026年11月11日。提供条件・機能・料金は変更されるため、最新情報は各公式ページをご確認ください。
デジライズの実績はデジライズ全体の社内集計値です。Codex の機能・対応環境・料金・提供条件は記事の公開・更新時点の OpenAI 公式情報に基づき、変更される場合があります。導入効果は企業や業務によって異なります。



