一句话定位

核心指标

二、安装 SOP

2.1 Codex CLI 安装

# 方式一：一键安装脚本（推荐）
curl -fsSL https://raw.githubusercontent.com/openai/codex-cli/main/install.sh | sh

# 方式二：Homebrew
brew install openai/codex/codex

# 方式三：npm 全局安装
npm install -g @openai/codex
codex --version

# 一键安装脚本
curl -fsSL https://raw.githubusercontent.com/openai/codex-cli/main/install.sh | sh

# npm
npm install -g @openai/codex

# 方式一：PowerShell 一键安装（推荐）
irm https://raw.githubusercontent.com/openai/codex-cli/main/install.ps1 | iex

# 方式二：npm
npm install -g @openai/codex

codex --version
# codex-cli 0.87.0+（2026年最新）

2.2 Codex CLI 登录认证

# 方式一：ChatGPT 订阅登录（需要 Plus/Team 账号）
codex
# 选择 1 → 网页验证 → 提示 "Signed in to Codex"

# 方式二：API Key 登录（国内用户推荐）
# Linux/macOS
export OPENAI_API_KEY=sk-xxxx

# Windows PowerShell
$env:OPENAI_API_KEY="sk-xxxx"

# 方式三：国内代理（修改 base_url）
# ~/.codex/config.toml
model_provider = "openai"
[model_providers.openai]
name = "openai"
base_url = "https://your-proxy.com/v1"   # 国内兼容 API 端点
requires_openai_auth = true

2.3 Claude Code Dynamic Workflows 技能安装

# 在 Claude Code 或 Codex 中直接说：
"/dynamic"           # 激活动态工作流模式
# 或在 Claude Code Desktop：
/skills              # 查看已注册技能列表
# 找到 "dynamic-workflow" 确认已激活

1. 安装 Skill   → 跟 Codex 说"安装这个 skill"，Skill 自动注入工具链
2. 调用指令     → 在对话框输入 /dynamic
3. 描述任务     → 描述目标，LLM 自动生成编排脚本、启动子代理、进入 /goal 模式执行

三、Codex CLI 配置速查

3.1 config.toml 结构

# ~/.codex/config.toml
# 配置文件位置：CLI 和 IDE 扩展共用同一份

model_provider = "openai"        # 模型供应商
model = "gpt-5-codex"           # 模型选择
model_reasoning_effort = "high" # 推理强度

disable_response_storage = true  # 禁用响应存储（节省空间）

[model_providers.openai]
name = "openai"
base_url = "https://api.openai.com/v1"
wire_api = "responses"         # 使用 Responses API
requires_openai_auth = true

# approval_policy = "manual"   # manual / auto（高风险操作需审批）
# sandbox_mode = true           # 沙盒模式，隔离危险操作

3.2 AGENTS.md 多层级配置（洋葱模型）

~/.codex/AGENTS.md          # 用户级（最外层）
/project/AGENTS.md          # 项目级（中间层）
/project/src/AGENTS.md      # 模块级（最内层）

<!-- ~/.codex/AGENTS.md（全局默认） -->
## 全局默认配置
- 代码缩进：2 个空格
- 字符串引号：单引号
- 测试文件后缀：*.spec.js

<!-- /project/AGENTS.md（项目特殊要求） -->
## 项目特殊要求
- 必须使用 TypeScript 4.8+
- API 响应必须包含 `status` 字段
- 禁止使用 `any` 类型

3.3 权限配置

# approval_policy 控制高风险操作
approval_policy = "manual"   # 建议 / 自动编辑 / 全自动

# sandbox_mode 沙盒隔离
sandbox_mode = true          # 隔离文件系统、shell、网络操作

3.4 IDE 集成

# JetBrains IDE：搜索 "Codex" 插件，安装后即可使用
# VS Code：搜索 "Codex" 插件
# GitHub 网页端：Copilot Pro+ / Enterprise 订阅可直接用 Claude + Codex

四、Codex 动态工作流技能使用

4.1 核心指令

4.2 三种运行模式详解

「使用 Codex 动态工作流的目标模式，
帮我把当前项目从 Vue2 迁移到 Vue3，并保持所有测试通过。」

「用 Codex 动态工作流创建一个架构子代理和一个编码子代理，
让架构代理先输出迁移计划，再让编码代理按计划实现。」

「先用工作包模拟模式生成完整任务拆解和执行计划，
不要修改任何文件，只给我看计划。」

4.3 工作原理

STEP 1  你描述任务目标（自然语言）
  ↓
STEP 2  LLM 自动生成 JavaScript 编排脚本
        包含：任务拆分、并行/串行逻辑、验证机制、收敛条件、错误处理
  ↓
STEP 3  JS 脚本自动调度执行
        子代理结果只存在 JS 变量里
        主 Agent 只接收最终答案（主上下文不膨胀）

五、Claude Code Dynamic Workflows 完整使用

5.1 Claude Code Desktop 快速上手

# Claude Code Desktop 中直接使用：
/dynamic              # 激活动态工作流
/deep-research        # 内置深度研究工作流（仓库分析、技术债扫描）

5.2 Claude Code Dynamic Workflows 的关键限制

5.3 Claude Code Dynamic Workflows 适用场景

✓ 仓库级 Bug 排查
✓ 全局代码迁移（Vue2 → Vue3 等）
✓ 安全审计
✓ 技术债扫描
✓ 多方案交叉研究
✗ 改一个函数、修一个接口（过于简单）

5.4 Claude Code Skills 安装（中文技能合集）

# 查看合集文档
# https://github.com/laolaoshiren/claude-code-skills-zh
# 精选 18 个原创可安装技能，复制即装

六、Claude Code + Codex 协作生态

6.1 Claude Code + Codex 并行使用

# 在 Claude Code Desktop 中调用 Codex：
# 安装 OpenAI Codex Plugin CC（官方开源）
# Claude Code 用户可直接在工作流中调用 Codex
# 用 AI 自动审查和修复代码

6.2 Claude Code Dynamic Workflows 社区资源

6.3 GitHub 平台集成

GitHub Copilot Pro+ / Enterprise：
→ 网页端 / 移动版 / VS Code / JetBrains
→ 可同时使用 Claude 和 Codex
→ 多模型协同开发

6.4 OpenAI Codex macOS 应用（2026年2月）

OpenAI Codex 新版 macOS 应用特性：
✓ 多智能体并行作业
✓ 工作树隔离（各 agent 修改操作互不干扰）
✓ 技能系统（工具 + 规范打包为可复用模块）
✓ 后台定时工作流（自动化重复性工作）

七、与 Claude Code 原生 Dynamic Workflows 对比

传统方案 vs 动态工作流

八、自建动态工作流系统思路

四部分架构

两条落地路径

🚀 路径 A：直接用现成技能
   安装 → /skills 确认激活 → /dynamic → 选运行模式 → 描述目标

⚙️ 路径 B：自建动态工作流系统
   Codex CLI 插件 / 任意语言多 Agent 控制器
   → 接入 Codex / GPT-5
   → 自定义调度逻辑

九、踩坑与排障

十、相关链接