5 分钟上手 WebCodex一条 share 命令让 ChatGPT 秒连你的本地仓库【免费下载链接】webcodexGive cloud AI agents a real development environment on your own machines.项目地址: https://gitcode.com/gh_mirrors/web/webcodexWebCodex 是一个开源工具通过 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 分钟开始之前确认机器上具备以下条件条件说明Node.js 18执行node -v检查版本Git 一个代码仓库建议是版本控制良好的项目方便 AI 改动后审查Linux / macOS / Windows x64主流平台均可直接走完整流程临时试用不需要提前安装 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 URLChatGPT 等 MCP 客户端要粘贴的地址Credential本次分享的临时访问令牌。Linux 与 macOS 通常会自动复制 MCP URL并可在交互终端按Enter直接打开 ChatGPT 应用设置页Windows 请手动复制打印的地址。原理层面share自管理临时 Server/Runner/session 生命周期相关实现位于 crates/webcodex-cli/ 与 src/tool_runtime/普通用户无需关心细节。ChatGPT 接入 WebCodex3 步添加 MCP 插件在 ChatGPT 应用设置中操作不同套餐与工作区文案可能略有差异第 1 步开启开发者模式。进入Settings → 账户安全与登录打开「开发人员模式」开关第 2 步创建插件并粘贴地址。选择Create粘贴刚才复制的MCP URL认证方式选择Access token / API keyBearer 令牌填入 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考