项目地址： yyjeqhc/webcodex

欢迎大家进行使用体验和反馈，希望能够对大家有所帮助。

What's WebCodex

WebCodex 是一个基于 Rust 构建的 AI Agent Runtime，通过 MCP 协议将 GPT、Claude、Gemini、Grok 等线上 Agent 与真实设备和开发环境连接起来。

它不只是让模型读写文件、执行Shell，还支持多设备、多项目、跨平台、ComputerUse、文件传输以 及多个线上窗口协作。简单来说，就是让原本只能待在网页里的Agent，真正参与到你的实际开发和设备 操作中。

Why WebCodex

最初也只是想做一个线上mcp工具，让模型可以操作本地文件系统以及写代码，至少来说，可以不用让我手动粘贴代码改来改去。后来发现，它也可以拥有很强的coding能力，基于CS架构的多设备协作，让它可以实现更多本地agent做不到的效果。当然，它也是可以接入本地agent作为mcp工具使用的。

Why rust

WebCodex 使用 Rust 作为核心开发语言。

对于一个长期运行的 AI Agent Runtime 来说，稳定性、资源占用以及跨平台能力都非常重要。Rust 在保证高性能的同时，通过内存安全机制减少了运行时错误，非常适合构建这类长期运行的基础设施服务。

实际使用中，WebCodex Server + Runner 启动后的内存占用保持在 20MB 以下，即使部署在低配置服务器或者个人设备上，也能够长期稳定运行。

选择 Rust 主要基于以下几点：

高性能与低资源占用：适合作为常驻后台服务运行； 内存安全：降低长时间运行服务中的潜在稳定性问题； 优秀的异步生态：适合处理多 Agent、多设备连接场景； 跨平台支持：可以同时运行在 Linux、Windows、macOS 等环境。 当然，最主要还是本人最熟悉rust，乐于使用rust

最满意的设计

一开始我就不太想使用普通隧道来长期暴露本地MCP。CloudflareTunnel之类的方案临时使用很方便 但如果地址、设备或者连接方式发生变化，线上客户端可能就需要重新配置。 正好我有一台公网服务器，所以WebCodex从一开始就采用了Server+Runner架构：线上Agent 始 终连接一个稳定的Server，而真正执行任务的Runner可以部署在不同设备上。 后来设备越来越多，这套架构也自然演变成了： ·一个用户可以有多台设备； ·一台设备可以有多个项目； ·多个用户也可以共享同一套服务； ·Windows、macOS、Linux等环境可以同时存在。

对我自己来说，这可能是WebCodex最值得长期使用的地方。换电脑、换项目，甚至操作远程服务器 都不需要重新给模型搭一套连接。

技术架构

    GPT / Claude / Gemini / Grok
             |
             |
          MCP Client
             |
             |
      WebCodex Server
             |
    -------------------
    |        |        |
 Runner   Runner   Runner
 Linux    macOS    Windows
    |
    |

filesystem / shell / browser

v0.3.8的新特性

• 1. Computer Use：我简单进行了测试，已知的发个微信消息，打开网页，滚动一下，输入一些文本，剪贴板啥的还是没问题的；由于我没有使用过codex的computer use**，所以不能精确对比来加强这样的；对gpt这样的多模态来说，加上这个，确实会方便很多
• 2. 文件上传下载：上传指定格式的文件都没问题，比如ppt/docx之类的办公类型；过程是很顺畅的，你交代意图，它帮你传递文件
• 3. 多窗口协作：多个gpt窗口之间可以同时使用webcodex来做不同的事，可以理解为本地agent是自动创建，线上的话还需要你手动打开窗口输入prompt这样的，也就是server可以承载围绕同一任务来做
• 4. 多模型客户端支持：本次实际测试了一下，算是全平台集齐了，gpt/claude/grok/gemini 都是可以连接的，你甚至可以让它们凑一起来打牌(bushi)，推荐使用oauth进行连接

一件有趣也很重要的事

现在，WebCodex本身就全是线上窗口自己写，自己评审，创建PR，创建Issue，进行合并这样的，我只是负责想一下需求。我日常的开发工作也几乎全部使用webcodex，而不是本地agent。这算是一个自举的应用。

注意事项

• 1. 依据平台现有规则，正常使用本项目并不会导致封号，使用合理合规
• 2. 本项目提供操作本地文件系统的能力，但并非毫无风险，因此请谨慎使用，及时做好备份工作
• 3. 我的使用强度比较高，记录下来平均每天可以使用4K+工具调用次数，只是gpt平台哈。主要的瓶颈还是在于每天只有24h

未来期望

基于webcodex构建一个天生跨设备端的云端agent，它的编程能力和本地agent没有弱势，在各个平台都能很好的支持，拥有更强的扩展性