Codexのカスタムエージェントの作り方とClaude Codeとの違い

この記事の要点
- Claude Code も Codex も、メインのAIが役割の違うAIに仕事を分けて結果をまとめる考え方は同じ
- 定義は Claude Code が .claude/agents/ の Markdown、Codex が .codex/agents/ の TOML
- 両方使うなら、役割分担の設計を共通にして書き方だけ変えると迷わない
活用例:Codex と Claude Code を併用するチームの役割分担
- 部署
- 開発・業務改善
- 使うもの
- Codex・Claude Code
- AIに任せる
- 役割ごとのサブエージェントでの作業
- 人が決める
- 役割分担の設計と全体の指示書
Claude Code と Codex は、どちらも「サブエージェント」に仕事を分けて並列に進められます。ただ、定義の書き方や動き方には違いがあります。両方を使う人ほど、違いを知っておくと設定の迷いが減ります。
この記事では、両社の公式ドキュメント(2026年10月7日確認)にもとづいて、サブエージェントの違いを比べます。
結論:考え方は同じ、書き方が違う
どちらも「メインのAIが、役割の違うAIに仕事を分けて、結果をまとめる」という考え方は同じです。違うのは、定義ファイルの形式と、任せ方の細かい動きです。仕事の分け方(役割分担)を先に決めておけば、どちらのツールにもほぼそのまま当てはめられます。

比較表
| 項目 | Claude Code | Codex |
|---|---|---|
| 定義する場所 | .claude/agents/(プロジェクト)・~/.claude/agents/(自分用) | .codex/agents/(プロジェクト)・~/.codex/agents/(自分用) |
| 形式 | Markdown+先頭の設定(YAML) | TOML ファイル |
| 必須の項目 | name・description | name・description・developer_instructions |
| 任せ方 | 説明文をもとに自動で任せる・名前を指定して頼む | 頼んだときや、AGENTS.md・スキルの指示で任せる |
| 並列の動き | 独立した仕事を複数体で同時に進める | 複数体を同時に動かし、全部そろってからまとめて返す |
| 全体の指示書 | CLAUDE.md | AGENTS.md |
Codex のサブエージェントの特徴

Codex の公式ドキュメントでは、「メインのエージェントは要件・判断・最終的な成果に集中させ、調べもの・テスト・ログの分析は専門のサブエージェントに並列で任せる」という使い方が勧められています。
カスタムエージェントは、.codex/agents/ に TOML で書きます。
name = "researcher"
description = "公式ドキュメントを読んで、事実と出典だけを集める調査係"
developer_instructions = "頼まれたテーマについて、事実・出典URL・確認日を表にして返す。推測で埋めない。"
全体の設定は config.toml の [agents] にあり、同時に動かす数の上限や、サブエージェントに使うモデルを決められます。
Claude Code のサブエージェントの特徴
Claude Code では、Markdown の先頭に設定を書き、本文に指示を書きます。tools で使える道具を絞れるので、「読むだけの検算係」のような安全な役割を作りやすいのが特徴です。くわしくはClaude Codeのマルチエージェント入門で解説しています。
仕事での使い分けの考え方
- 普段使っているツールで始める:どちらでも役割分担はできます。慣れているツールで、まず2〜3体の分担を試します。
- 全体の指示書を育てる:Claude Code なら CLAUDE.md、Codex なら AGENTS.md に、仕事のルールや「完成の条件」を書いておくと、サブエージェントの出来がそろいます。
- 使う量に気をつける:どちらも、複数のAIが同時に考える分だけ利用量が増えます。公式ドキュメントにも、一人で進めるより多くのトークンを使うと書かれています。
全体の指示書(CLAUDE.md・AGENTS.md)に書くこと

サブエージェントの出来をそろえるには、全体の指示書に「仕事のルール」を書いておくのが近道です。Codex の公式ドキュメントでも、AGENTS.md に入れるとよい内容として、作業の場所、手順の実行方法、守るべきルール、「完成とは何か」と確かめ方が挙げられています。
| 書くこと | 例 |
|---|---|
| 仕事の目的 | 見積書の下書きを作り、人が確認して送る |
| 守るルール | 単価は単価表からだけ使う/送信は人が行う |
| 完成の条件 | 「要確認」の行が一覧になっている/合計と計算式が合っている |
| 確かめ方 | 検算係が単価表と照らし合わせて差分を報告する |
Claude Code では CLAUDE.md、Codex では AGENTS.md にこの内容を書いておくと、どのサブエージェントも同じルールで動きます。
自社のアプリの中でサブエージェントを組む方法は、Agent SDK のサブエージェントで解説しています。
よくある質問
Codexでサブエージェントを作るには、何から始めればいいですか?
手順は3つです。 ①プロジェクトに .codex/agents/ のフォルダを作る ②役割ごとに TOML のファイルを1つ置き、name・description・developer_instructions を書く ③メインの会話で「調べものは researcher に任せて」のように役割の名前を出して頼む。最初は「調べる係」「確かめる係」の2つだけにすると、どこで結果がずれたかを追いやすくなります。
カスタムエージェントとサブエージェントは別のものですか?
Codex では、自分で定義した役割を カスタムエージェント と呼び、それをメインのエージェントが呼び出して動かすものがサブエージェントです。つまり「カスタムエージェントを定義して、サブエージェントとして動かす」という関係です。名前と説明文が呼び出しの手がかりになるので、description には「何を頼まれたら動く係か」をはっきり書きます。
Codexのマルチエージェントは、いくつ同時に動かせますか?
同時に動かす数の上限は、config.toml の [agents] で決めます。数を増やすほど速くなる一方で、使う量と確認の手間も増えます。まずは2〜3から始め、待ち時間が長い作業(調べもの・テスト・ログの分析)だけを並列に回すのが安全です。上限の既定値や項目名は変わることがあるので、使う前に公式ドキュメントで確かめてください。
両方を同時に使うことはできますか?
できます。たとえば、調べものと下書きを片方で行い、もう片方に検算や見直しを頼む、という分担も考えられます。どちらの結果を正本にするかを先に決めておくと混乱しません。
どちらから始めればいいですか?
いま毎日使っている方から始めるのがおすすめです。役割分担の設計(調べる係・書く係・確かめる係)は共通なので、片方で決めた分け方は、もう片方にもほぼそのまま移せます。
Claude Code 側で最近変わったことはありますか?
2026年10月の更新で、サブエージェントごとに考える深さ(effort)を指定できるようになり、記憶の要約を早めに始める設定も加わりました。役割ごとの選び方はサブエージェントのeffortとモデルの使い分けでまとめています。
サブエージェントを並べると確認の画面が増えすぎませんか?
増えやすくなります。Claude Code では、確認の画面を減らす「オートモード」を使うと、別のAIが操作を見張りながら作業を進めます。削除・外への送信・本番への反映のように必ず止めたい操作は、権限の禁止ルールにも書いておくのが安全です。モードの違いはClaude Codeのオートモードとは?でまとめています。
サブエージェントを数十体まとめて動かしたいときは?
Claude Code では、ダイナミックワークフローを使います。Claude が書いた台本(スクリプト)が段取りを持ち、1回で数十〜数百のサブエージェントを動かして、会話には最後の答えだけを返します。依頼文に ultracode と入れるか「ワークフローで」と頼むと始まり、うまくいった台本は保存して使い回せます。サブエージェントとの違いはClaude Codeのワークフローとは?でまとめています。
Claude Code で「係どうしが話し合う」形はありますか?
あります。Claude Code の エージェントチーム は、まとめ役のセッションが複数の仲間(チームメイト)を起動し、共有のタスク一覧と直接のメッセージで作業を進めます。サブエージェントより費用がかかるため、公式ドキュメントでは「まず3〜5人から」をすすめています。実験的な機能で既定はオフです。詳しくはClaude Codeのエージェントチームとは?で解説しています。
両方で並列に作業させるとき、ファイルの取り合いはどう防ぎますか?
Claude Code では、claude --worktree 名前 で git の worktree(別の作業フォルダ) を作って起動すると、セッションごとに変更が分かれます。サブエージェントにも同じ分け方を指定できます。手順はClaude Codeのworktreeとは?でまとめています。
「別の目で確かめる係」を、モデルを替えて置けますか?
Claude Code では2通りあります。1つは、確かめる係のサブエージェントに別のモデルを指定する方法です。もう1つは アドバイザー(/advisor)で、作業中の要所だけ、強いモデルが会話全体を読んで助言します。係を作らずに「方針を決める前」「完了と言う前」の確認を足せるのが利点で、相談のたびに利用量は上乗せされます。詳しくはClaude Codeのアドバイザーとは?で解説しています。
Claude Code のサブエージェント定義で、よく使う項目は?
最初は tools(使える道具)と model(使うモデル)の2つを決めるだけで十分です。 公式ドキュメント「Create custom subagents」(2026年11月3日確認)では、ほかにも次の項目が用意されています。
| 項目 | できること |
|---|---|
tools | 使える道具を絞る(書かなければ引き継ぐ) |
disallowedTools | 引き継いだ道具から、使わせないものを外す |
model | sonnet・opus・haiku などのモデルを指定する |
maxTurns | 何手で止めるかの上限を決める |
skills | 起動時にスキルの中身を読み込ませておく |
memory | セッションをまたいで覚える範囲を決める |
isolation | worktree にすると、リポジトリの一時的な写しの中で作業させる |
Codex 側は TOML で書くため項目名や形は違いますが、「道具を絞る」「モデルを選ぶ」「作業場所を分ける」という決めごとは共通です。effort(考える深さ)の決め方は サブエージェントのeffortとモデルの選び方、作業場所の分け方は Claude Code の worktree の使い方 で説明しています。
料金や提供範囲はどう確かめればいいですか?
変わることがあるため、各社の公式ページで最新の情報を確認してください。
出典:OpenAI「Subagents」(Codex 公式ドキュメント、2026年10月7日確認) https://learn.chatgpt.com/docs/agent-configuration/subagents / Anthropic「Create custom subagents」(2026年10月7日確認) https://code.claude.com/docs/en/sub-agents / Anthropic「Orchestrate teams of Claude Code sessions」(2026年10月24日確認) https://code.claude.com/docs/en/agent-teams / Anthropic「Consult a stronger model with the advisor」(2026年10月29日確認) https://code.claude.com/docs/en/advisor
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


