codex-turbo

English | 简体中文

本仓库是 Codex CLI 的个人配置模板集，旨在充分利用 CLI 原生能力，实现多智能体自主协调下的并行任务调度。

💡 不知道如何操作？ 可以将以项目地址发送给 AI 助手（如 Claude Code CLI、Codex CLI 等），让其根据你的实际情况协助合并或新建。

当前项目适配版本：Codex CLI v0.115.0

原帖 《Codex CLI 多智能体并行调度配置分享》 已无法编辑，本项目作为后续维护版本持续迭代。

核心要点

• 💡 并行工作流：multi_agent = true 最大并行度与最小阻塞设计
• 🔧 系统级契约：在 config.toml 中通过 developer_instructions 注入 Agent 并行工作规范，优先级高于 AGENTS.md
• 🧠 原生记忆：memories = true 自动提取和归并对话记忆，提升上下文连贯性
• 🔌 WebSocket 支持：responses_websockets_v2 = true 启用实时流式响应；如果当前后端服务或提供商不支持 WebSocket，会自动回退到传统模式
• 🎯 对话风格：强视觉边界、emoji 编号、直而短句的终端输出规范
• 📝 动态契约：主代理任务动态下发清晰的指令模板（目标/动作/结果）
• ⚙️ 并发控制：max_threads = n 自定义单轮最大子任务数
• ⚠️ 风险管控：危险操作确认机制与不可变原则
• 🤖 自定义智能体：手动配置子代理的模型、推理强度、职责描述
• 📋 可复制模板：开箱即用的 AGENTS.template.md 与 config.template.toml

核心文件与目录

.
├── 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.en.md
        ├── config.toml.en.example
        ├── agents/
        └── skills/

相关文档

• FAQ
• CHANGELOG

快速上手（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 等供应商信息。

首次使用（直接复制）：

# 创建目标目录（如不存在）
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，建议按下面的步骤合并。

• 你的现有配置：~/.codex/config.toml、~/.codex/AGENTS.md
• 本仓库模板：templates/cn/config.template.toml、templates/cn/AGENTS.template.md

1. 先备份现有配置

cp ~/.codex/config.toml ~/.codex/config.toml.bak
cp ~/.codex/AGENTS.md ~/.codex/AGENTS.md.bak
[ -d ~/.codex/agents ] && cp -R ~/.codex/agents ~/.codex/agents.bak
[ -d ~/.codex/skills ] && cp -R ~/.codex/skills ~/.codex/skills.bak

如果你本地已经存在 ~/.codex/agents.bak 或 ~/.codex/skills.bak，请先手动处理旧备份，避免再次执行 cp -R 时把目录复制成嵌套结构。

2. 先看差异，再决定怎么合

``...