企业官网建设流程全解析

5 分钟上手 WebCodex：一条 share 命令让 ChatGPT 秒连你的本地仓库

【免费下载链接】webcodexGive cloud AI agents a real development environment on your own machines.项目地址: https://gitcode.com/gh_mirrors/web/webcodex

WebCodex 是一个开源工具，通过 MCP 协议让 ChatGPT、Claude 等云端 AI 直接使用你本地机器上的真实开发环境。它能在 5 分钟内完成一条share命令的临时分享：仓库不离开你的电脑，AI 却可以读代码、跑测试、改文件。本文面向新手，带你走完整条「WebCodex 分享本地仓库 + ChatGPT 接入」的最短路径，无需任何部署经验。

为什么需要 WebCodex：让 ChatGPT 直连本地开发环境

传统做法是把代码贴进聊天框，或者把整个仓库上传到云端托管环境。WebCodex 换了一种思路：

• 代码留在自己的机器上，只暴露受控的 MCP 接口；
• AI 使用真实开发环境：文件、Git、编译器、测试、工具链全部复用；
• 工作可审查：改动通过 Git diff 可见，人工把关不缺席；
• 既能临时试用，也能长期部署：一条命令快速体验，也可以升级到自托管 Server。

AI 客户端（ChatGPT） | MCP / HTTPS v WebCodex（运行在你的机器上） +-- 代码仓库 +-- Git +-- 编译器 / 测试 / 开发工具

连接成功后，整个运行环境可以在界面中一目了然地看到状态：

想深入了解内部架构，可阅读 docs/ARCHITECTURE.md 与 docs/AUTH_MODEL.zh-CN.md。

准备工作：3 个前置条件（1 分钟）

开始之前，确认机器上具备以下条件：

临时试用不需要提前安装 Desktop、执行setup或run——一键流程会自己拉起临时的、单项目的 runtime。

一步分享仓库：webcodex share 命令详解

进入你想让 AI 使用的仓库目录，执行这一条命令：

cd /path/to/your/repository npx --yes @yyjeqhc/webcodex share

这条命令做了什么？它会创建一个临时、单项目、项目级权限（Project-scoped）的 WebCodex runtime，并自动建立一条公网 HTTPS MCP 隧道，用本次的临时凭据保护。看到WebCodex ready后保持终端运行，终端会打印出：

• MCP URL：ChatGPT 等 MCP 客户端要粘贴的地址；
• Credential：本次分享的临时访问令牌。

Linux 与 macOS 通常会自动复制 MCP URL，并可在交互终端按Enter直接打开 ChatGPT 应用设置页；Windows 请手动复制打印的地址。

原理层面：share自管理临时 Server/Runner/session 生命周期，相关实现位于 crates/webcodex-cli/ 与 src/tool_runtime/，普通用户无需关心细节。

ChatGPT 接入 WebCodex：3 步添加 MCP 插件

在 ChatGPT 应用设置中操作（不同套餐与工作区文案可能略有差异）：

第 1 步：开启开发者模式。进入Settings → 账户安全与登录，打开「开发人员模式」开关：

第 2 步：创建插件并粘贴地址。选择Create，粘贴刚才复制的MCP URL；认证方式选择Access token / API key（Bearer 令牌），填入 WebCodex 终端输出的Credential。

第 3 步：点击 Scan Tools。ChatGPT 会拉取 WebCodex 提供的工具列表。成功后你会看到这些工具出现在插件页面里：

这些工具覆盖了读文件、打补丁、运行命令等核心能力，是 AI 操作你本地仓库的「手和眼」。

第一个对话：先只读，再小改

连接成功后，建议按「只读 → 小改」两步验收：

先试一个只读请求（零风险）：

检查这个仓库并总结它的结构。先不要做任何修改。

能得到准确的仓库结构总结，就说明 ChatGPT 已经真正通过了 WebCodex 访问到目标仓库。

再做一个容易审查的小任务：

修复这个仓库里的一个小问题，并运行相关测试。告诉我具体改了什么。

接受结果之前，用 Git 或 WebCodex 的审查界面检查实际改动——AI 的每一次修改都应可审查，这是 WebCodex 设计的核心原则。

常见问题：找不到 Bearer 选项怎么办

如果 ChatGPT 自动尝试 OAuth 并提示does not implement OAuth，或者界面上根本没有 Bearer 令牌输入框，先结束当前分享，换用 URL 内嵌令牌的认证方式：

npx --yes @yyjeqhc/webcodex share --auth query-token

然后把输出的完整/mcp?token=...地址直接粘贴给 ChatGPT，认证选择No authentication，再次 Scan Tools 即可。注意：这个完整地址包含本次临时密钥，不要公开或写入日志。

更多连接排障可查阅 docs/TROUBLESHOOTING.zh-CN.md，各平台与认证方式的完整参考在 docs/MCP.zh-CN.md。

结束临时分享，规划长期使用

• 结束连接：在 WebCodex 终端按Ctrl-C，本次分享立即失效——MCP 地址与临时凭据随之作废，非常适合尝鲜体验。
• 日常长期使用：share是临时方案，正式使用请切换到 完整使用指南，搭建常年的 Server + Runner 架构；Windows/macOS 用户推荐走 Desktop + OpenAI Secure Tunnel 路径。
• 安全提醒：WebCodex 能在配置的项目范围内读写文件、执行命令。只注册确实希望 AI 访问的目录，不要把凭据写进提示词或 Git，完整安全模型见 SECURITY.md。

5 分钟总结：npx --yes @yyjeqhc/webcodex share→ 等待 WebCodex ready → ChatGPT 开启开发者模式并粘贴 URL + Credential → Scan Tools → 先只读后小改。从此，你的云端 AI 助手拥有了一间真正的本地开发车间。🚀

延伸阅读：docs/QUICK_START.zh-CN.md（官方快速试用）、docs/CLI.zh-CN.md（命令与凭据参考）、docs/INDEX.zh-CN.md（完整文档索引）。

【免费下载链接】webcodexGive cloud AI agents a real development environment on your own machines.项目地址: https://gitcode.com/gh_mirrors/web/webcodex