
WebCodex 是一款把网页版 ChatGPT 接入本地电脑的开源开发平台,让 GPT 直接读取、搜索、修改本地项目代码并运行测试。版本 v0.4.1,Apache-2.0 许可证,GitHub Stars 1.5k,Forks 182。
工具概览与方案对比
文章正文
Codex 客户端有 5 小时限额,一个任务做到一半额度就没了,恢复还要等几个小时。WebCodex 解决的就是这个痛点:把 ChatGPT 网页端几乎用不完的额度,接到本地项目上干活。
配置完成后,网页版 GPT 能列出本地项目、查看文件目录、读取代码内容,还能直接修改文件。本地有哪些项目、项目里有哪些文件,它都能列出来。
工具简介
WebCodex 是开发者 yyjeqhc 在 GitHub 开源的工具,用 Rust 编写,Apache-2.0 许可证,当前版本 v0.4.1,最后更新 2026 年 9 月 10 日,项目累计 1544 次提交,更新日志在 GitHub Releases 页面持续发布。
适用场景
适合 Codex 额度不够用、手头有 ChatGPT 网页订阅、需要 AI 继续处理本地代码文件的场景。电脑需保持开机且 WebCodex 运行中,项目始终留在本地机器,不用上传到云端工作区。
方案对比
WebCodex 和 codex-with-chatgpt 对比,区别 vs Codex 客户端执行,两者定位不同:
| 维度 | WebCodex | codex-with-chatgpt |
|---|---|---|
| 执行方式 | 网页版 GPT 直连本地 | 网页规划+客户端执行 |
| 额度消耗 | 走网页端额度 | 仍耗客户端额度 |
| 配置复杂度 | 四步,稍多 | 较简单 |
| 许可证 | Apache-2.0 | 见其仓库 |
客户端额度耗尽时,WebCodex 是理想的替代方案,全程不依赖 Codex 客户端额度。
功能亮点
- 代码理解与编辑:读取、搜索、检查配置好的项目,执行受控修改
- 真实工具链:跑命令、测试、格式化、编译器等本机开发工具
- Git 操作:查看状态和差异,仓库操作全程可见可审查
- 长任务处理:作业保持可观察,不依赖单次对话长连接
- 多端支持:Windows x64、macOS、Linux x64/arm64 均可部署
配置部署与使用指南
技术栈与运行环境
WebCodex Desktop 支持 Windows x64 与 macOS,核心用 Rust 编写,版本 v0.4.1,Apache-2.0 许可证。网页端使用 GPT-5.6 Sol 模型,强度开到 High 即可满足日常开发。
安装与部署提示
整个配置分四步:安装桌面端、在 OpenAI 开放平台拿隧道信息、桌面端填配置、网页版连接。下载地址在 GitHub Releases,最后更新 2026 年 9 月,更新日志随版本发布。

安装完成后打开 WebCodex Desktop,先放在一边,去 OpenAI 开放平台拿两项配置信息。
配置步骤详解
第二步在 OpenAI 开放平台创建 Tunnel,Tunnel 可以理解为网页版 ChatGPT 连接电脑的通道。创建好后复制 Tunnel ID 备用,注意给 Tunnel 选择默认的 workspace。

接着在 API Keys 页面创建密钥,建议选 Restricted key 受限密钥,只授予 Tunnels 所需的 Read + Use 权限。Key 只显示一次,创建后立即复制保存。

第三步回到 WebCodex Desktop,首页点击第一个卡片,选择本地项目文件夹,展开安全隧道配置,把 Tunnel ID 和 API Key 分别填入对应输入框,点击「配置 WebCodex」等待启动。

只需添加希望 AI 处理的项目文件夹,不需要把整块硬盘都加进去。回到首页点击「查看运行诊断」,重点看本地服务、Runner 和项目是否就绪。

截图与演示说明
第四步配置 ChatGPT 网页版。进入设置,在账户安全与登录里开启开发人员模式,先打开这个开关,后面才能添加自定义插件。

进入 ChatGPT 插件页面,点击右上角的添加插件。

连接方式选隧道,选择前面创建的 Tunnel,身份验证选无身份验证。这是官方隧道连接方式对应的设置,不用把 API Key 填进 ChatGPT。

创建好后按页面提示授权自定义插件,作者给它起名 localGPT,名字可以自己取一个好认的。

配置结束后开始测试:在聊天窗口输入 @,选择刚添加的 localGPT 插件。

发一句话测试:「请列出 WebCodex 中可用的项目,再列出我刚添加的项目下的顶层文件,先不要修改任何内容。」下图是连接测试结果,能列出项目和目录后,再选一个实际文件让它读取内容,能读到才算真正连通。

使用期间记得让电脑和 WebCodex 保持运行,项目在本地,电脑断开网页就无法继续操作文件。
常见问题
问:WebCodex 是什么?
WebCodex 是一款开源工具,让 ChatGPT、Claude 等 AI 智能体直接操作本地电脑上的代码和开发工具,项目文件始终留在本地。
问:怎么配置 WebCodex?
四步:安装 WebCodex Desktop,在 OpenAI 平台创建 Tunnel 和受限 API Key,桌面端填入两项信息并选择项目文件夹,最后在 ChatGPT 网页版添加自定义插件并授权。
问:WebCodex 和 codex-with-chatgpt 有什么区别?
codex-with-chatgpt 让网页版做规划、客户端执行,仍消耗 Codex 额度。WebCodex 与它的区别在于网页版 GPT 直连本地操作,全程走网页端额度。
问:WebCodex 免费吗?
工具本身按 Apache-2.0 许可证开源免费,需要自备 ChatGPT 订阅账号,网页端聊天额度按订阅计划提供。
安全风险提示
WebCodex 可在项目边界内读写文件并执行命令,建议只注册需要 AI 处理的项目根目录。API Key 选 Restricted key 并只授 Read + Use 权限,凭证不要出现在提示词、日志和 Git 仓库中。配合版本控制使用,改动可通过 Git 差异审查。
下载说明
GitHub 项目开源地址:https://github.com/yyjeqhc/webcodex
桌面端安装说明:https://github.com/yyjeqhc/webcodex/blob/main/docs/desktop-install.md
原文链接:https://www.xiaomaw.cn/6860.html
原文标题:【会员文章】Codex零额度无限用ChatGPT完成本地项目(作者:小马)