Codex Meetup Tokyo #1 (2026/03/19 19:00〜)
でakihiro_genaiさんのMulti-Agentsを理解しようという発表で聞いたが、
Codex CLIはsubagentを自動起動しないとのこと。
下記がこのMeetupでのメモ
SubAgentの起動条件
SkillにSubAgent起動しろ、はうごかない。明示的にSubAgent起動して、と言わないと起動しない
descriptionに良い感じに書いても起動してくれない
CodexはSubAgent自動起動しない方針
AGENTS.mdに書くか明示的に呼び出す、が起動させやすい
Claude Codeと起動しやすさはだいぶ違う
公式ドキュメント
を見ると、
Triggering subagent workflows
Codex doesn’t spawn subagents automatically, and it should only use subagents when you explicitly ask for subagents or parallel agent work.
と書かれている。そもそも自動でsubagentは起動しない。このあたりはClaude Codeとかとけっこう違う。
個人的に作ってるリポジトリで、Notionから今日の日報をとってくるsubagent（ .codex/agents/get-daily-report.toml ）があるのだが
自動では使ってくれないしget-daily-reportの存在すら気づいてくれてなさそう。
明示的にget-daily-reportを起動して今日の日報を教えてと言えば使ってくれるが。
— akihiro（あきひろ）| 生成AI活用 (@akihiro_genai) 2026年3月27日
にも記載されているがAGENTS.mdに書くと起動されやすくなるみたい。
試しにAGENTS.mdにsubagent一覧を書いてみた
# AGENTS.md ## Language - 回答は日本語で行うこと。 ## Sub Agents - Codex CLI では sub agent は自動起動されない前提で扱うこと。 - sub agent を使いたい場合は、必要な agent を明示的に選んで呼び出すこと。 - Codex CLI 向けの sub agent 定義は `.codex/agents/` を参照すること。 - このリポジトリでは `.codex/agents` は `.agents/agents` へのシンボリックリンクになっている。 - Markdown の agent 定義は Codex CLI の sub agent としては直接使えないため、必要に応じて `.toml` を追加すること。 ## Available Sub Agents | Name | 役割 | Codex CLI 用定義 | 元の Markdown 定義 | | --- | --- | --- | --- | | `get-daily-report` | 指定した日付、または今日の Notion 日報ページを取得して返す | `.codex/agents/get-daily-report.toml` | `.agents/agents/get-daily-report.md` |
とりあえずget-daily-reportは見つけてくれた。
## Available Sub Agents配下がないと見つけもしてくれなかった。
## Sub Agents配下はなくても良いのかもしれない。
ただ、/subagentsで見るとMainしかないしまだ自動でsubagentsを起動させることはできてない。
あくまでAgent Skills的に、中身を参考にして動作をしてくれただけという感じがする。
get-daily-reportを起動して、最新の日報を教えて
と言えば
Spawnedと出てsubagentsが作られているのがわかるし、
/subagentsでも
Main以外のエージェントができている。
うーむ、というわけでちょっとまだ AGENTS.md を使ってもサブエージェントを自動起動させることにはまだできてないんでちょっと引き続き試行錯誤してみる。
