codex-turbo
English | 简体中文
本仓库是 Codex CLI 的个人配置模板集。秉承 “轻量高效” 的原则，在不引入复杂依赖的前提下，深度挖掘 CLI 原生能力，通过多智能体协作实现高效的任务调度。这套配置仅作为个人实践分享，希望能抛砖引玉，助你构建出最适合自己的 AI 工作流。
💡 不知道如何操作？ 可以将以项目地址发送给 AI 助手（如 Claude Code CLI、Codex CLI 等），让其根据你的实际情况协助合并或新建。
当前项目适配版本：Codex CLI v0.134.0
核心要点
- 💡 并行工作流：
multi_agent = true最大并行度与最小阻塞设计 - 🔧 系统级契约：在
config.toml中通过developer_instructions注入 Agent 并行工作规范，优先级高于AGENTS.md - 🧠 原生记忆：
memories = true自动提取和归并对话记忆，提升上下文连贯性 - 🎯 交互风格：针对 Codex 原生输出“长句堆砌、路径泛滥、视觉挤压”的终端阅读灾难，深度对齐
Claude Code风格。通过强制断行、视觉锚点与极简短句，将混乱的控制台信息转化为层次分明、生动直观的对话体验。
效果展示
应用 terminal-dialog-style 技能后，控制台输出结构更加清晰，支持层次分明的执行反馈与排版效果：
核心文件与目录
.
├── README.md # 中文文档（本页）
├── README.en.md # English Documentation
└── templates/
├── cn/ # 中文模板
│ ├── AGENTS.template.md # 开发原则与输出风格
│ ├── config.template.toml # 系统配置模板
│ ├── agents/ # 子代理配置
│ │ ├── explorer.toml
│ │ └── worker.toml
│ └── skills/ # 技能模板
│ └── terminal-dialog-style/
└── en/ # English Templates
├── AGENTS.template.md # Developer principles & output style
├── config.template.toml # System config template
├── agents/ # Sub-agents config
│ ├── explorer.toml
│ └── worker.toml
└── skills/ # Skills template
└── terminal-dialog-style/
相关文档
快速上手（5 分钟）
目标：把你的 Codex CLI 切到”并行 + 模板化”工作模式。
1. 克隆仓库
git clone <your-repo-url>
cd codex-turbo
2. 复制模板配置
本仓库提供以下模板文件：
| 文件 | 用途 | 目标位置 |
|---|---|---|
templates/cn/config.template.toml | 核心的系统配置（含 developer_instructions 并行工作规范） | ~/.codex/config.toml |
templates/cn/AGENTS.template.md | 开发原则与输出风格指南 | ~/.codex/AGENTS.md |
templates/cn/agents/ | 子代理配置（explorer、worker） | ~/.codex/agents/ |
templates/cn/skills/ | 技能模板（terminal-dialog-style 等） | ~/.codex/skills/ |
config.toml 请根据服务商的要求自行完善 key 等供应商信息。
⚠️ 配置优化提示：自
v1.7.0起，已彻底将原主config.toml配置文件中冗余的子代理[agents.explorer]和[agents.worker]区块完整废弃并删除（程序会自动扫描并载入agents/目录下的配置）。所有子代理相关的职责边界、元数据与执行规范完全由其 TOML 配置文件内部单独定义与维护，保持了主配置极简化。
首次使用（直接复制）：
# 创建目标目录（如不存在）
mkdir -p ~/.codex
# 复制核心配置文件
cp templates/cn/AGENTS.template.md ~/.codex/AGENTS.md
cp templates/cn/config.template.toml ~/.codex/config.toml
# 复制子代理和技能目录
cp -r templates/cn/agents ~/.codex/
cp -r templates/cn/skills ~/.codex/
已有配置（手动合并）：→ 详见 配置迁移指南
说明：本文档按 Codex CLI
v0.134.0适配；不同版本或供应商字段名可能有差异，请以你本地 CLI 支持为准。
常见问题
Q1：开了 multi_agent 一定更快吗？
不一定。只有任务可拆、且无写冲突时才明显提速。
Q2：开了子代理带来什么好处？
- 上下文隔离 — 子代理独立上下文，避免主代理上下文爆炸
- 职责聚焦 — 每个子代理只处理单一任务，输出更精准
- 并行提效 — 独立任务可并行执行，缩短整体耗时
Q3：子代理会增加费用吗？
会。启用子代理后，费用可能上浮 20%~30%，具体涨幅取决于项目规模和任务复杂度。
Q4：子代理开几个合适？
建议默认即可，观察质量和成本，再逐步调整。
Q5：子代理模型和主代理模型不一致怎么办？
通过 worker.toml 或 explorer.toml 的 model 字段单独指定。
Q6：这套模板适合所有人吗？
不是。它是起点模板，最好按你的团队习惯逐步裁剪。
免责声明
本仓库提供的是配置方法论与模板参考，基于 Codex CLI v0.134.0 验证。
成本提示：多智能体并发模式下，Token 消耗可能上升 20%~30%，请根据实际情况合理评估使用。
风险提示：LLM 可能产生错误判断，导致数据误删或代码被错误修改。建议：
- 合理配置沙箱权限与操作确认机制
- 在可控环境中先行测试
- 对重要数据做好备份
使用本模板所产生的一切后果由使用者自行承担。