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

公開 更新 著者 永上裕之マルチエージェント
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のそれぞれで、3体のサブエージェントが仕事を分担する様子を並べた図
Claude CodeとCodexのそれぞれで、3体のサブエージェントが仕事を分担する様子を並べた図(イメージ)

比較表

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

Codex のサブエージェントの特徴

調査・テスト・ログ分析を並列で進め、結果を集約する図
調査・テスト・ログ分析を並列で進め、結果を集約する図(イメージ)

Codex の公式ドキュメントでは、「メインのエージェントは要件・判断・最終的な成果に集中させ、調べもの・テスト・ログの分析は専門のサブエージェントに並列で任せる」という使い方が勧められています。

カスタムエージェントは、.codex/agents/ に TOML で書きます。

name = "researcher"
description = "公式ドキュメントを読んで、事実と出典だけを集める調査係"
developer_instructions = "頼まれたテーマについて、事実・出典URL・確認日を表にして返す。推測で埋めない。"

全体の設定は config.toml の [agents] にあり、同時に動かす数の上限や、サブエージェントに使うモデルを決められます。

Claude Code のサブエージェントの特徴

Claude Code では、Markdown の先頭に設定を書き、本文に指示を書きます。tools で使える道具を絞れるので、「読むだけの検算係」のような安全な役割を作りやすいのが特徴です。くわしくはClaude Codeのマルチエージェント入門で解説しています。

仕事での使い分けの考え方

全体の指示書(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引き継いだ道具から、使わせないものを外す
modelsonnet・opus・haiku などのモデルを指定する
maxTurns何手で止めるかの上限を決める
skills起動時にスキルの中身を読み込ませておく
memoryセッションをまたいで覚える範囲を決める
isolationworktree にすると、リポジトリの一時的な写しの中で作業させる

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エージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事