Codex 5 小时额度不够用？用 WebCodex 把 ChatGPT 网页接到本地电脑

第一步：下载正确的安装包

只从 WebCodex 官方 GitHub Releases 下载：

打开 WebCodex Releases

截至本文发布时，最新版是 v0.4.1。

Windows 用户下载哪个文件

Windows x64 下载：

webcodex-desktop-v0.4.1-win32-x64-setup.exe

下载 Windows x64 安装程序

如果不知道自己的 Windows 架构，可以在 PowerShell 中运行：

[System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture

结果为 X64 才使用当前 Desktop installer。如果结果为 Arm64，不要继续安装本文提供的 x64 Desktop 包。

Mac 用户下载哪个文件

点击屏幕左上角苹果菜单，选择“关于本机”。

如果看到 M1、M2、M3、M4 或更新的 Apple 芯片，下载：

webcodex-desktop-v0.4.1-darwin-arm64.dmg

下载 Apple Silicon DMG

如果是 Intel 处理器，下载：

webcodex-desktop-v0.4.1-darwin-x64.dmg

下载 Intel Mac DMG

也可以在 Mac 终端运行：

uname -m

第二步：校验安装包

校验不是强制操作，但非常建议新手养成这个习惯。它可以确认下载文件没有损坏，也没有被替换。

官方 v0.4.1 校验值：

Windows 校验方法

在下载目录打开 PowerShell：

Get-FileHash .\webcodex-desktop-v0.4.1-win32-x64-setup.exe -Algorithm SHA256

将输出与表格中的 Windows SHA256 比较，必须完全一致。

Mac 校验方法

Apple Silicon：

cd ~/Downloads
shasum -a 256 webcodex-desktop-v0.4.1-darwin-arm64.dmg

Intel Mac：

cd ~/Downloads
shasum -a 256 webcodex-desktop-v0.4.1-darwin-x64.dmg

如果校验值不一致，请删除文件并从官方 Release 页面重新下载，不要继续安装。

第三步：安装 WebCodex Desktop

Windows 安装步骤

1. 双击 webcodex-desktop-v0.4.1-win32-x64-setup.exe。
2. 按安装向导完成安装。
3. 安装结束后启动 WebCodex。
4. 确认主窗口能够正常打开。

如果 Windows 安全功能显示警告，先确认三个条件：

• 文件来自官方 GitHub Release。
• 文件名与本文一致。
• SHA256 校验完全一致。

不要为了安装一个应用而关闭 Microsoft Defender 或全局降低系统安全设置。

Mac 安装步骤

1. 双击下载的 DMG。
2. 将 WebCodex 拖入 Applications 文件夹。
3. 推出 DMG。
4. 从“应用程序”打开 WebCodex。

推荐安装位置：

/Applications/WebCodex.app

不要长期从 DMG 或 Downloads 文件夹直接运行。

Mac 提示无法打开怎么办

WebCodex v0.4.1 的 macOS 构建采用 ad-hoc 签名，尚未通过 Apple notarization，因此第一次启动可能被 Gatekeeper 拦截。

正确方法：

1. 先正常打开一次 WebCodex。
2. 关闭系统的阻止提示。
3. 打开“系统设置”。
4. 进入“隐私与安全性”。
5. 找到 WebCodex 被阻止的信息。
6. 点击“仍要打开”。
7. 再次确认“打开”。

不要全局关闭 Gatekeeper，也不要照抄来历不明的终端解除命令。

第四步：创建 OpenAI Secure Tunnel

安装 Desktop 后先不要急着启动 Tunnel。我们需要先在 OpenAI Platform 创建一个 Tunnel，并生成一把权限受限的 API key。

打开：

OpenAI Tunnels 页面

登录后：

1. 确认当前选择的是正确组织。
2. 点击创建 Tunnel。
3. 名称填写 WebCodex Desktop 或其他容易识别的名称。
4. 创建后记录 Tunnel ID。

Tunnel ID 是稍后填入 WebCodex Desktop 和 ChatGPT 的标识。

如果没有创建按钮，可能是账号角色、组织设置或功能开放范围导致。重装 WebCodex 无法解决 OpenAI Platform 账号权限问题。

第五步：创建 Restricted API key

打开：

OpenAI API Keys 页面

创建一把 Restricted key，名称可以写：

WebCodex Tunnel

只授予 Tunnel 需要的权限：

Tunnels: Read
Tunnels: Use

其他权限保持禁用，除非 OpenAI 当前页面明确要求增加新的 Tunnel 权限。

API key 通常只完整显示一次。立即将它保存到本机密码管理器。

不要把 API key：

• 发到聊天窗口。
• 放进博客截图。
• 写进 Git 仓库。
• 发到 Issue 或群聊。
• 填进 ChatGPT 的 MCP 连接表单。

第六步：在 Desktop 中保存 Tunnel 配置

打开 WebCodex Desktop，进入：

设置 → OpenAI Tunnel 网络

也可以在“连接”页面展开：

可选：检查 ChatGPT 安全隧道配置

填写：

点击“保存配置”。

成功时应看到：

当前来源：本机配置文件（优先）

保存后 API key 输入框变空是正常现象。WebCodex 不会把已保存密钥重新显示出来。

Tunnel ID 和 API key 到底有什么区别

这是整个教程最容易出错的地方：

本机 WebCodex 使用 API key 连接 OpenAI Tunnel 服务。ChatGPT 只需要 Tunnel ID，不需要也不应该看到 API key。

Desktop 如何保存 API key

macOS 保存位置：

~/Library/Application Support/dev.webcodex.desktop/secrets/tunnel-config.json

Windows 保存位置：

%LOCALAPPDATA%\dev.webcodex.desktop\secrets\tunnel-config.json

这个文件包含未加密 API key，不要放入 Git 或共享备份。

第七步：选择“在此电脑使用 WebCodex”

第一次配置时选择：

Local Full Runtime / 在此电脑使用 WebCodex

不要选择：

• “连接现有 Server”，这是给已经有远程 WebCodex Server 的用户使用的。
• “快速共享项目”，这是临时体验方式，关闭后连接会结束。

选择 Local Full Runtime 后，Desktop 会自动管理本机 Server 和 Runner。新手不需要手工安装服务，也不需要打开多个命令行窗口。

第八步：选择要交给 ChatGPT 的项目

点击“选择文件夹”，选择一个真实项目目录。

建议第一次选择：

• 一个 Git 仓库。
• 一个你熟悉、可以接受测试修改的项目。
• 不包含重要私人资料的目录。
• 文件数量适中的项目。

不建议第一次就选择整个用户目录，例如：

C:\Users\你的用户名

或者：

/Users/你的用户名

整个用户目录可能包含 SSH key、浏览器数据、个人文档和其他敏感文件，也通常不是一个完整 Git 仓库。

选择项目后，点击“配置 WebCodex”。

第九步：确认本地 Runtime 已准备好

回到 WebCodex 首页，展开“查看运行诊断”。至少检查三项：

Service：运行中 / Ready
Runner：已连接 / Ready
Project：Ready

Project 显示的路径必须是你刚才选择的目录。

如果看到 project_not_loaded 或“项目尚未就绪”：

1. 点击“重新加载项目”。
2. 等待 Desktop 重新加载自己的 Runner。
3. 再次确认 Project 路径。
4. 仍失败时打开“活动”页面查看错误。

不要因为项目没加载成功就直接授权整个磁盘。

第十步：设置 Tunnel 网络

进入：

设置 → OpenAI Tunnel 网络

可以选择：

自定义代理示例：

http://127.0.0.1:7890

如果 Tunnel 已经运行，修改网络模式前要先停止 Tunnel，保存后再重新启动。无需重启整个 Desktop。

第十一步：启动 OpenAI Secure Tunnel

确认 Service、Runner 和 Project 都是 Ready 后，进入：

连接 → OpenAI Secure Tunnel

点击：

启动安全隧道

第一次启动时，WebCodex 会自动下载并校验固定版本的 OpenAI tunnel-client。普通用户不需要手工安装这个组件。

成功后会看到类似提示：

OpenAI Secure Tunnel 已就绪，等待 ChatGPT 连接

系统允许时，Desktop 还会把 Tunnel ID 复制到剪贴板。

请注意：Tunnel 已就绪只说明本机已经连上 OpenAI Tunnel，并不代表 ChatGPT 配置完成。

第十二步：在 ChatGPT 创建连接

打开 ChatGPT 的应用、连接器或插件管理页面，创建新的自定义 MCP 连接。

填写：

不要填写：

• Server URL。
• localhost。
• /mcp URL。
• OAuth Client ID。
• OAuth Client Secret。
• Restricted API key。
• WebCodex token。

如果页面让你输入 OAuth Client ID 或 Client Secret，说明连接方式选错了。返回上一步，将连接方式切换为 Tunnel。

确认风险提示后创建连接。

为什么 ChatGPT 要选择 No authentication

看到这里，很多人会疑惑：刚才不是创建了 API key 吗，为什么 ChatGPT 又选择 No authentication？

因为这两项负责不同的事情：

• Restricted API key 用于本机 tunnel-client 连接 OpenAI Tunnel 服务。
• ChatGPT 使用 Tunnel ID 找到对应 Tunnel。
• WebCodex 的 MCP authorization 保留在本机，由 tunnel-client 注入。
• ChatGPT 不需要看到本机 WebCodex 凭据。

所以 Tunnel + No authentication 才是正确组合。

第十三步：做一次真正的连接测试

不要只看 Desktop 中的绿色状态。只有 ChatGPT 实际读取到项目，才能证明整条链路打通。

在普通 ChatGPT 聊天中新建对话，启用刚创建的 WebCodex 连接。

先发送：

使用 WebCodex，列出当前可用项目，并列出当前项目的顶层文件。只读取，不修改任何内容。

然后测试读取：

使用 WebCodex，读取当前项目的 README.md 前 100 行，并用中文总结。不要修改文件。

再测试只读命令：

使用 WebCodex，在当前项目运行 git status，并告诉我结果。不要运行其他命令。

前三项都成功后，再进行写入测试：

使用 WebCodex，在当前项目创建 webcodex-test.txt，内容为 hello；读取确认后删除。不要修改其他文件。

这个测试同时验证了：

• ChatGPT 找到了 Tunnel。
• Tunnel 能到达本机 Server。
• Runner 正常在线。
• 项目权限正确。
• 文件读取和写入可用。
• 命令执行可用。