项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6446
使用教程
环境要求
- 已安装并可使用 Codex CLI(需能开启 Codex 会话)
- 本机具备 git 命令,用于克隆仓库
- 对 ~/.codex/agents/ 或项目内 .codex/agents/ 目录有写入权限
安装与启动步骤
-
1克隆仓库
把仓库下载到本地,后续从中挑选需要的 .toml 子代理文件。注意不要在目标项目里留下多余文件。
git clone https://github.com/VoltAgent/awesome-codex-subagents.git cd awesome-codex-subagents -
2浏览分类找代理
仓库按 categories/ 下的编号分类组织(如 01-core-development、04-quality-security),按需挑选对应的 .toml 文件。
ls categories -
3创建全局代理目录
全局目录中的子代理在所有项目中都可用。README 明确指定路径为 ~/.codex/agents/,不要改成其他位置。
mkdir -p ~/.codex/agents -
4复制全局代理文件
把选中的 .toml 复制进全局目录。示例为后端开发子代理,请按实际需要替换文件名。
cp categories/01-core-development/backend-developer.toml ~/.codex/agents/ -
5或配置项目级代理
项目级目录只对该仓库生效,且在该仓库中优先级高于全局目录。需在项目根目录下执行。
mkdir -p .codex/agents cp categories/04-quality-security/reviewer.toml .codex/agents/ -
6刷新 Codex 会话
复制完成后重启或刷新 Codex 会话,使其重新读取 agents 目录中的配置。
-
7在提示中显式委派
Codex 不会自动派生自定义子代理,必须在提示词中明确要求使用某个子代理,否则不会生效。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
[agents](位于 .codex/config.toml) | 否 | 若使用 Codex 的代理配置方式,代理相关配置需放在该配置段的 [agents] 下。 | [agents] |
如何确认成功
重启或刷新 Codex 会话后,在提示中显式点名该子代理,观察它是否被正确调用;未显式委派则不会自动触发。
常见问题
Q:复制 .toml 后为什么没有任何反应?
A:Codex 不会自动派生自定义子代理,必须在提示中显式要求使用该子代理,才会被调用。
Q:全局目录和项目目录冲突时以哪个为准?
A:项目内的 .codex/agents/ 在该仓库中优先级更高,会覆盖同名的全局代理。
Q:代理文件应该放哪里?
A:全局代理放 ~/.codex/agents/(所有项目可用),项目专用代理放 .codex/agents/,路径需与官方文档一致。
Q:需要把整个仓库都复制过去吗?
A:不需要,只复制你实际要用的 .toml 文件到上述目录即可。
注意事项
- 只依据 README:目录路径必须严格使用 ~/.codex/agents/ 或 .codex/agents/,不要自创路径
- 项目级代理优先级高于全局代理,同名时注意覆盖关系
- 复制后需重启或刷新 Codex 会话才能生效
- 必须显式委派,Codex 不会自动生成自定义子代理
核心亮点
- 子代理覆盖范围广,从代码审查到数据库操作等130+场景,满足多样化需求
- 每个子代理有明确职责和配置,可直接复制使用,降低使用门槛
- 项目持续更新,社区贡献活跃,能紧跟Codex功能演进
不足之处
- 依赖OpenAI Codex CLI,对非Codex用户不适用
- 子代理质量参差不齐,部分可能未经充分测试
- 文档/社区待观察
适用场景
- 快速为Codex CLI配置特定开发任务的子代理,如代码审查或测试生成
- 学习如何编写高效子代理,参考现有最佳实践
- 作为团队内部AI辅助开发的标准子代理库,统一工作流
替代项目
awesome-claude-code-subagents、awesome-chatgpt-prompts、awesome-ai-agents
上一篇:WeChatFerry
下一篇:awesome-ai-sdks
同类项目推荐
utah
开源
用事件驱动打造可靠耐用的个人 AI 代理,任务不丢不乱。
Universally Triggered Agent Harness - An OpenClaw-like Inngest-powered personal agen···
Helix-AGI
开源
用空间图记忆让AI智能体持续进化,不烧钱不堆子代理。
Helix-AGI is an Agentic AI memory and action system that runs on a continuous daemon···
ling-stack
开源
自带模型,本地管好 AI 队友的对话与审批
Local-first AI teammate workspace. Bring your own models and keep project conversati···
azmx
开源
本地优先、自带密钥,打造完全自主的 AI 代理。
AZMX AI — The sovereign agent platform.
agent-designer
开源
一套技能,让 Claude、Codex、Gemini 协同干活
Portable SKILLs workspace for Claude Code, Codex, and Gemini — issue-driven workflo···
pinchy
开源
自托管企业级 AI 智能体,离线可用,权限审计全掌控
Self-hosted AI agent platform built on OpenClaw. Enterprise-ready, offline-capable, ···
agent-message-queue
开源
用文件系统让本地 AI 智能体互相发消息,零依赖。
File-based message queue for local agent-to-agent communication (Maildir-style)
ghostclaw
开源
让 AI 住在你电脑里,动嘴就能干活
an AI that lives on your computer and does stuff for you. Public beta.
fim-one
开源
一个智能体核心,连接企业所有系统,任意模型可换,自托管更安全。
Source-available agent platform for Global × China enterprises — wire every system···
