一、这是什么项目
GPT-WebCodex 是一款Windows 桌面应用，由独立开发者 @3169657175 创建，MIT 协议，截至 2026 年 9 月已收获 205 个 GitHub Star，语言为 Python + Electron。
它解决的核心痛点是：当 Codex / Cursor 额度用完时，如何继续使用网页版 ChatGPT 来操作本地项目——读文件、写代码、跑测试、构建产物，全部在 ChatGPT 网页对话里完成。
项目信息
GitHub: 3169657175/gpt-webcodex
协议：MIT · 语言：Python + Electron · 最新：v0.4.3（2026-08-29）
二、核心功能一览
| 功能 | 说明 |
|---|---|
| 网页 ChatGPT 直接操作本地项目 | 通过 Coding Tools MCP 读取文件、搜索代码、新建/修改文件、执行命令、查看 Git Diff 和日志 |
| 项目上下文自动识别 | workspace_context 一次返回项目类型、入口文件、Git 分支、测试/构建命令、AGENTS.md 指令等 |
| Agent 自动工作流 | 内置 agent_workflow，支持 Bug 诊断、新功能开发、重构、测试修复、构建发布等完整开发任务 |
| Git / Worktree 安全隔离 | 每个任务在独立 Worktree 中修改和验证，查看 Diff 后一键应用到主工作区，不污染主分支 |
| 长任务后台执行 | 测试、构建、复杂 Agent 工作流转入后台运行，不再表现为"卡死" |
| Windows 桌面任务通知 | 任务完成/失败/中断时弹出系统通知，支持点击回到 ChatGPT |
| 内置便携环境 | 安装包自带 Python 3.12 + Coding Tools MCP Runtime，无需系统安装 Python 或 Docker |
| 构建验证 | 自动识别 Node.js / Electron / Python 等项目，自动选择测试和构建命令 |
三、关键机制详解
Coding Tools MCP Runtime
GPT-WebCodex 的核心是内置的 Coding Tools MCP Runtime（v0.4.9）。它通过 OpenAI Tunnel 连接到 ChatGPT，让 ChatGPT 能调用本地 MCP 工具：
exec_command— 在工作区内执行命令workspace_context— 一次返回项目全局上下文agent_workflow— 完整开发任务工作流document_workflow— PDF / DOCX / Markdown 处理view_image— 查看项目内图片task_control— 任务暂停/继续/停止/恢复
Git Worktree 隔离
这是 v0.2.4 最值得关注的改进。每个代码任务在独立的 Git Worktree 中执行：
- 任务开始 → 记录主工作区快照
- 在隔离 Worktree 中修改和验证
- 查看 Diff → 一键应用到主工作区 / 一键丢弃
- 主工作区同时有未提交改动时，拒绝静默覆盖
这对长时间开发任务特别有用——你不需要担心 ChatGPT 改坏东西，随时可以回滚。
任务恢复与后台执行
刷新页面、切换聊天或 Runtime 重启后，任务状态仍可读取。支持暂停、继续、停止，并定时主动汇报进度。任务中心记录当前步骤、正在运行的命令、测试结果、修改过的文件等完整信息。
安全设计
Runtime API Key 使用 Electron safeStorage / Windows DPAPI 加密存储；本地 MCP 默认只监听 127.0.0.1；日志自动隐藏 key/token/secret 等敏感字段。
四、下载与安装
GPT-WebCodex 免费开源，安装方式有两种：
方式一：直接下载安装包（推荐普通用户）
- web-mcp-assistant-setup-0.4.3.exe（约 124MB）
- 双击安装，打开后选择工作目录即可
- Windows 可能会弹出安全提示，确认文件来源是本仓库 Release 后运行即可
方式二：从源码构建（开发者）
git clone https://github.com/3169657175/gpt-webcodex
cd gpt-webcodex
npm install
npm run start源码包含完整的 Electron 应用结构和 Coding Tools MCP 集成，适合需要定制或参与贡献的用户。
接入 ChatGPT 步骤
- 安装后打开助手，选择你的项目工作目录
- 按"接入指南"创建 OpenAI Tunnel 和 Runtime API Key
- 在 ChatGPT 中创建自定义 MCP / 连接器
- 完成第一次只读工具测试
五、我的判断
优点
- 真正实用 — Codex/Cursor 额度用完时的完美替代方案
- Worktree 隔离 — 长时间任务不怕搞坏主分支，可恢复可回滚
- 零配置 — 自带 Python 3.12 + MCP Runtime，无需额外安装
- 中文界面 — 管理中心全中文，适合国内用户
- MIT 协议 — 可自由使用和修改
注意点
- 目前仅支持 Windows 平台
- 需要手动配置 OpenAI Tunnel，对不熟悉网络配置的用户有一定门槛
- v0.4.3 仍有多个 open issues，部分边界场景可能不稳定
- 单次安装包 124MB，首次下载需注意空间
如果你是 ChatGPT Plus 用户，Codex 额度用完后想继续用网页版 ChatGPT 操作本地工程，GPT-WebCodex 是目前 Windows 平台上最值得试的开源方案——Worktree 隔离和任务恢复机制让它在长任务场景下比直接使用 Codex 更可控。