awesome-codex-subagents

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 对话助手 🍴 复刻 703 🐛 待处理 2 👀 关注 27
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 6446
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,无付费版本。

项目预览

awesome-codex-subagents 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类对话助手
开发团队VoltAgent
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
技术栈/模型ai-agents,awesome-list,chatgpt,codex,codex-skills,codex-subagents,subagents
GitHub 星标★ 6446
上线时间2026-03-17 00:00:00
代码更新2026-11-02
仓库体积268 KB
本站数据更新2026-11-08
维护状态活跃
收录时间2026-08-09
浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6446

使用教程

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

环境要求

  • 已安装并可使用 Codex CLI(需能开启 Codex 会话)
  • 本机具备 git 命令,用于克隆仓库
  • 对 ~/.codex/agents/ 或项目内 .codex/agents/ 目录有写入权限

安装与启动步骤

  1. 1克隆仓库

    把仓库下载到本地,后续从中挑选需要的 .toml 子代理文件。注意不要在目标项目里留下多余文件。

    git clone https://github.com/VoltAgent/awesome-codex-subagents.git
    cd awesome-codex-subagents
  2. 2浏览分类找代理

    仓库按 categories/ 下的编号分类组织(如 01-core-development、04-quality-security),按需挑选对应的 .toml 文件。

    ls categories
  3. 3创建全局代理目录

    全局目录中的子代理在所有项目中都可用。README 明确指定路径为 ~/.codex/agents/,不要改成其他位置。

    mkdir -p ~/.codex/agents
  4. 4复制全局代理文件

    把选中的 .toml 复制进全局目录。示例为后端开发子代理,请按实际需要替换文件名。

    cp categories/01-core-development/backend-developer.toml ~/.codex/agents/
  5. 5或配置项目级代理

    项目级目录只对该仓库生效,且在该仓库中优先级高于全局目录。需在项目根目录下执行。

    mkdir -p .codex/agents
    cp categories/04-quality-security/reviewer.toml .codex/agents/
  6. 6刷新 Codex 会话

    复制完成后重启或刷新 Codex 会话,使其重新读取 agents 目录中的配置。

  7. 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···

★ 138 2026-08-09
Helix-AGI 开源

用空间图记忆让AI智能体持续进化,不烧钱不堆子代理。

Helix-AGI is an Agentic AI memory and action system that runs on a continuous daemon···

★ 63 2026-08-09
ling-stack 开源

自带模型,本地管好 AI 队友的对话与审批

Local-first AI teammate workspace. Bring your own models and keep project conversati···

★ 979 2026-10-25
azmx 开源

本地优先、自带密钥,打造完全自主的 AI 代理。

AZMX AI — The sovereign agent platform.

★ 131 2026-08-09
agent-designer 开源

一套技能,让 Claude、Codex、Gemini 协同干活

Portable SKILLs workspace for Claude Code, Codex, and Gemini — issue-driven workflo···

★ 133 2026-08-09
pinchy 开源

自托管企业级 AI 智能体,离线可用,权限审计全掌控

Self-hosted AI agent platform built on OpenClaw. Enterprise-ready, offline-capable, ···

★ 192 2026-08-09
agent-message-queue 开源

用文件系统让本地 AI 智能体互相发消息,零依赖。

File-based message queue for local agent-to-agent communication (Maildir-style)

★ 91 2026-08-09
ghostclaw 开源

让 AI 住在你电脑里,动嘴就能干活

an AI that lives on your computer and does stuff for you. Public beta.

★ 67 2026-08-09
fim-one 开源

一个智能体核心,连接企业所有系统,任意模型可换,自托管更安全。

Source-available agent platform for Global × China enterprises — wire every system···

★ 1587 2026-08-09