Codex Workbench

Codex Workbench 是一个不修改 Codex CLI 本体的 Windows 桌面工作流管理器。它可以用原生模式启动 Codex，也可以为 Claude-like、Kiro-like 和 Hybrid 工作方式创建彼此隔离的 CODEX_HOME。

当前功能

• Codex 原生模式：不设置环境覆盖，不生成文件。
• Claude-like：快速理解、最小编辑、持续验证的实现循环。
• Kiro-like：Requirements、Design、Tasks 规格驱动流程。
• Hybrid：根据复杂度在快速循环与规格流程之间选择。
• 界面主题：支持跟随 Windows、浅色和深色，选择会在本机持久保存。
• 运行会话：保存由管理器启动的记录，实时检查和结束 Codex 终端进程。
• 规格中心：扫描或创建项目内的 .kiro/specs/<feature>，并在 VS Code 中打开规格文档。
• 环境检查：已安装时只显示版本；缺少 Codex CLI 时才显示安装入口。
• 启动独立 PowerShell Codex 会话。
• 启动普通或独立用户数据目录的 VS Code 窗口。
• 启动前预览所有托管文件。
• 覆盖托管文件前自动备份。
• 不读取、展示或复制原生 config.toml 中的密钥。

安全边界

原生 Codex 目录默认为 %USERPROFILE%\.codex，或者当前环境中的 CODEX_HOME。Codex Workbench 不写入这个目录。

托管模式位于：

%LOCALAPPDATA%\com.codexworkbench.manager\
├── profiles\
│   ├── claude\home\
│   ├── kiro\home\
│   └── hybrid\home\
├── ide\
└── backups\

隔离配置不会复制原生认证文件或 MCP 密钥。因此首次启动每个隔离模式时可能需要登录，并单独配置所需 MCP。

本地开发

要求：

• Node.js 20+
• Rust stable
• Codex CLI
• Windows WebView2 Runtime

安装并运行：

npm install
npm run dev

检查前端与 Rust 测试：

npm run web:build
npm test

构建桌面程序：

npm run build

当前 tauri.conf.json 将 bundle.active 设为 false，构建会生成可执行程序但不创建安装包。完成图标、签名和更新策略后可启用安装包。

已知限制

• 工作模式改变的是 Codex 的指令和工作流，不会把 OpenAI 模型替换为 Anthropic Claude 或 AWS Kiro。
• 已经运行的 Codex 会话不会热切换，必须启动新会话。
• 普通 VS Code 模式可能复用已有进程；需要严格环境隔离时保留“独立 IDE 实例”选项。
• VS Code 可能将启动请求交给已有编辑器进程，因此会话中心将其作为启动记录，而不把它误报为可结束的独立进程。