别手搓多Agent了！Codex Windows版用Git Worktree并行跑代码，真的香OpenAI Codex

OpenAI Codex Windows 版完整安装指南：并行 Agent 与 Computer Use 实战

OpenAI Codex 是一款终端原生 AI 编程 Agent，能自主读取代码库、运行命令、提交 PR，并通过 Git Worktree 隔离让多个 Agent 并行工作于同一仓库而不产生冲突。2026 年 3 月 4 日，Codex 桌面应用正式登陆 Windows（macOS 版于 2026 年 2 月 2 日首发）；2026 年 5 月 29 日，v26.527 版本将 Computer Use 功能带入 Windows，让 Codex 能够直接看到屏幕、点击和键入 Windows 应用程序。当前 Codex CLI 最新稳定版为 0.135.0（2026 年 5 月 28 日），安装命令 npm install -g @openai/codex@0.135.0。

Codex-Windows版安装指南-img1.png

Codex Windows 版有什么不同

Codex 在 Windows 上提供两种使用路径，能力略有差异：

特性	Windows 原生 App	CLI + WSL2
并行 Agent 线程	✅	✅
Git Worktree 隔离	✅	✅
Computer Use（操控本地应用）	✅ v26.527 起	❌
手机远程监控（ChatGPT iOS/Android）	✅	❌
PowerShell 原生集成	✅	受限
沙箱安全模式	elevated/unelevated	bubblewrap
GitHub PR 一键创建	✅	✅

核心差异：Windows 的 Computer Use 目前为前台模式（Foreground-only），而 macOS 版支持后台并行执行。对于不需要 GUI 操控、只做代码生成的场景，两条路径体验基本一致。

方式一：安装 Windows 原生 App（推荐日常使用）

系统要求

系统版本	支持状态
Windows 11	推荐，企业部署首选
Windows 10 v1809+	支持，需 ConPTY 现代控制台
旧版 Windows 10	不推荐

同时需要：winget 可用（Windows 包管理器，Windows 11 内置），以及管理员权限（用于初始化沙箱）。

安装步骤

方法 A：Microsoft Store

打开 Microsoft Store，搜索关键词 Codex
找到 OpenAI 官方应用，点击安装
安装完成后用 ChatGPT 账号登录，或填入 OpenAI API Key

方法 B：winget 命令行（推荐自动化场景）

# 在 PowerShell 中执行
winget install Codex -s msstore --accept-source-agreements --accept-package-agreements

# 验证安装
codex --version

方法 C：GitHub Release 直接下载

访问 github.com/openai/codex/releases，下载最新 codex-x86_64-pc-windows-msvc.exe（2026-06-01 发布，246 MB），SHA256 已在 Release 页公示。

配置沙箱安全模式

首次启动后，在 CODEX_HOME\config.toml 中配置沙箱模式：

[windows]
# elevated: 独立低权限沙箱用户 + 防火墙规则 + ACL 边界（推荐）
# unelevated: 企业策略阻止 elevated 时的回退
sandbox = "elevated"

# 如需关闭私有桌面隔离（兼容旧行为）
# windows.sandbox_private_desktop = false

当命令因沙箱无法读取目录而失败时，运行：

/sandbox-add-read-dir C:\your\project\absolute\path

方式二：CLI + WSL2（适合 Linux 工具链用户）

安装 WSL2

# 在管理员 PowerShell 中运行
wsl --install

# 已有 WSL 则更新到最新版
wsl --update

⚠️ Codex CLI 0.115 起不再支持 WSL1，沙箱已迁移至 bubblewrap，必须使用 WSL2。

在 WSL2 中安装 Codex CLI

# 进入 WSL shell 后执行
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# 验证
codex --version

# 或通过 npm 安装（需 Node.js 22+）
npm install -g @openai/codex

性能关键配置

# ❌ 不要在 /mnt/c/... 路径工作（I/O 极慢）
# ✅ 将仓库放在 WSL 原生文件系统
mkdir ~/code && cd ~/code
git clone <your-repo>

方式三：Codex CLI 纯命令行（Windows 原生 PowerShell）

不需要桌面 App，直接在 PowerShell 中使用 CLI 版本：

前置要求

# 检查 Node.js 版本（需要 22+）
node -v

# 如果版本不足，通过 winget 升级
winget install OpenJS.NodeJS.LTS

常见踩坑：不要安装 npm i -g codex（这是 2012 年的无关项目），正确包名为 @openai/codex。

安装与配置

# 安装 Codex CLI
npm install -g @openai/codex

# 设置 API Key（二选一）
# 方式 1：ChatGPT 账号登录
codex auth login

# 方式 2：OpenAI API Key 环境变量
$env:OPENAI_API_KEY = "sk-..."

# 验证
codex --version
codex "解释一下这个项目的目录结构"

通过标准 OpenAI SDK 接口接入时，也可以将模型端点替换为兼容 API 的第三方服务，例如七牛云推理服务支持 OpenAI 兼容接口，无需修改现有 Codex CLI 配置即可切换至国内网络环境。

常用命令速查

# 启动交互模式
codex

# 指定项目目录
codex --cwd C:\your\project "添加单元测试覆盖 auth 模块"

# 引用特定文件
codex --include "schema.sql" "根据这个 schema 生成 CRUD API"

# 非交互模式（适合 CI/CD）
codex --output json "列出所有 API 端点"

# 自动执行（免逐步确认）
codex --permission-mode auto "修复所有 lint 错误"

Codex-Windows版安装指南-img2.png

并行 Agent + Worktree：Windows 上的核心工作流

Codex 的核心优势在于用 Git Worktree 隔离不同 Agent 的工作空间，让多个任务并行而不产生代码冲突。根据 Verdent AI 2026 年 5 月的分析，使用 Worktree 并行模式的开发者报告迭代速度提升 3-5 倍。

启动并行任务（桌面 App）

在 Codex App 中打开项目
选择 Worktree 模式（而非 Local 模式）
为每个任务启动独立 Agent 线程
在 App 内并排查看各 Agent 的进度和 diff

每个 Agent 获得独立的 git worktree，互不干扰，完成后可选择：合并 PR、丢弃，或继续迭代。

典型并行场景

# 在 Codex App 中，同时启动：
Agent 1：给 auth 模块补充单元测试
Agent 2：重构 database 连接池
Agent 3：修复 issue #412 的 API 返回格式问题

三个任务在独立 worktree 中并行执行，互不干扰，每个完成后生成可审查的 diff 和可直接创建的 PR。

Writer/Reviewer 双 Agent 模式

Agent A（实现）	Agent B（审查）
实现新功能
	在独立 worktree 中审查 diff，检查边界情况
根据审查意见修复

Computer Use：让 Codex 操控 Windows 应用

2026 年 5 月 29 日上线的 Computer Use 功能（v26.527）让 Codex 能直接看到屏幕、点击和键入 Windows 应用，适合测试、调试、浏览器工作流和重复性开发任务。

启用 Computer Use

# 在 Codex App 对话框中直接描述任务
"打开 Chrome，访问 http://localhost:3000，
截图登录页，填入测试账号并提交，截图结果"

"在 Postman 中运行 /api/users 接口，
把响应截图贴到 issue #502 的评论里"

当前限制：

Windows 版为前台执行模式，任务进行时不能切换窗口
macOS 版支持后台并行，Windows 版尚不支持
地区限制：欧洲经济区（EEA）、英国、瑞士目前不在首批覆盖范围

手机远程监控（ChatGPT iOS/Android）

启动 Computer Use 任务后，可在手机 ChatGPT App 中：

实时查看 Codex 的操作进度
在任意位置介入、暂停或重定向任务
将 PC 变成托管执行节点，手机作为监控终端

常见报错与排查

错误 1385：沙箱用户无法登录

症状：沙箱用户创建成功，但 Windows 策略阻止其启动沙箱命令
原因：组策略或 OU 配置限制了登录权限

解决方案：联系 IT 团队检查组策略，或临时切换 unelevated 模式：

[windows]
sandbox = "unelevated"

IDE 扩展无响应

# 安装 C++ 构建工具
winget install --id Microsoft.VisualStudio.2022.BuildTools -e

# 安装后必须完全重启 VS Code（不是 reload window）

WSL2 中 I/O 过慢

# 将仓库从 Windows 分区迁移到 WSL 原生分区
mv /mnt/c/projects/myapp ~/code/myapp
cd ~/code/myapp
codex

提交诊断日志

问题排查时发送：CODEX_HOME\.sandbox\sandbox.log 注意：不要发送 CODEX_HOME\.sandbox-secrets\ 目录内容（含敏感凭证）。

常见问题

Q：Codex Windows 版需要什么 ChatGPT 订阅计划？ 并行 Agent 线程和 Worktree 功能需要 ChatGPT Plus、Pro、Business 或 Team 计划，基础功能可用 OpenAI API Key 替代。Computer Use 功能目前需要 Plus 及以上计划。也可以通过接入第三方兼容 API（如七牛云 AI 推理服务）来调用底层模型能力，具体可参考接入文档。

Q：Codex CLI 和 Codex 桌面 App 有什么区别？ CLI（@openai/codex）是命令行工具，适合脚本、CI/CD 集成和 IDE 插件场景。桌面 App 在 CLI 能力基础上增加了可视化任务管理界面、并行 Agent 面板、内置 diff 审查、Computer Use 和手机远程监控。两者共享会话状态，可随时切换。

Q：Windows 上 Codex 能否接入私有部署的模型？ 可以，通过在 CLI 的 config.toml 中配置自定义 baseURL 实现，支持任何兼容 OpenAI API 格式的端点。

Q：企业环境如何批量部署 Codex？ 使用 winget install 配合 IT 管理工具批量推送；config.toml 可通过组策略分发；sandbox = "unelevated" 模式适合管理员权限受限的受管设备。

Q：Computer Use 是否会访问个人数据？ 权限按用户显式请求的任务范围限定，Codex 不会主动访问请求范围外的应用或文件。敏感环境建议在企业网络隔离条件下使用，并定期审查沙箱日志。

Codex-Windows版安装指南-img3.png

延伸资源

Codex CLI Windows 官方文档：developers.openai.com/codex/windo…
Codex CLI GitHub Releases（含 SHA256 校验）：github.com/openai/code…
七牛云 AI 推理服务 OpenAI 兼容接入：www.qiniu.com/ai/chat
七牛云 API Key（兼容 OpenAI/Anthropic 标准）：portal.qiniu.com/ai-inferenc…

本文内容基于 2026 年 6 月 OpenAI Codex 官方文档及 v26.527 / CLI 0.135.0 版本数据，建议定期查阅官方 Changelog 以跟进功能迭代。下一步建议先用 winget install Codex -s msstore 完成安装，再尝试在一个真实项目中启动两个并行 Worktree Agent——感受并行工作流与传统顺序开发的效率差距。