awesome-codex-subagents

130+现成Codex子代理，即拿即用，开发效率翻倍

这是一个收录了130多个专用Codex子代理（subagents）的精选清单，旨在帮助开发者通过OpenAI Codex CLI更高效地完成各类开发任务。它解决了用户不知道如何为特定场景编写或选择合适子代理的问题，提供了覆盖代码审查、测试、重构、文档生成、数据库操作、DevOps、安全审计等多种用例的现成子代理。每个子代理都有明确的职责和配置，用户可以直接复制使用或作为参考进行定制。项目核心能力在于其丰富的子代理库和清晰的分类，使得开发者能够快速找到并集成所需的自动化助手，从而提升开发效率和代码质量。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 6223

维护状态活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队VoltAgent

所属国家

官网地址https://github.com/VoltAgent/voltagent

GitHubhttps://github.com/VoltAgent/awesome-codex-subagents

定价模式free

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言

技术栈/模型ai-agents,awesome-list,chatgpt,codex,codex-skills,codex-subagents,subagents

GitHub 星标★ 6223

30天Star增速

HF 下载量

上线时间2026-03-17 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

已安装并可使用 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 不会自动派生自定义子代理，必须在提示中显式要求使用该子代理，才会被调用。

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

项目介绍

awesome-codex-subagents 是智能体领域的开源项目，由 VoltAgent 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（6,223）位列前 8%，在智能体分类的 2,499 个项目里位列前 8%。

近 44 天，它的 GitHub 星标从 5,947 增加到 6,223，净增 276。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，无付费版本。

它主要面向的使用场景是：快速为CodexCLI配置特定开发任务的子代理，如代码审查或测试生成。同类可对比的替代方案包括 awesome-claude-code-subagents、awesome-chatgpt-prompts、awesome-ai-agents。

上一篇：WeChatFerry

下一篇：awesome-ai-sdks