webcodex

WebCodex 是一款开源工具，用于连接云端 AI 代理（如 ChatGPT 和 Claude）与本地开发环境。开发者无需将代码上传到托管工作区，WebCodex 允许 AI 代理直接与代码仓库交互、运行命令、使用 Git、执行测试并完成长时间运行的任务——这一切都在开发者自己的机器上进行。 该工具采用 Server/Runner 架构。Server 作为中间层，AI 客户端通过 MCP（Model Context Protocol）或 HTTPS 连接；Runner 则在本地机器上执行操作。这种设计使代码仓库和所有开发者工具都保留在原始机器上，从而保持现有的开发环境不变。 WebCodex 支持两种主要使用模式。日常开发中，用户设置常规的 Server 和 Runner，可持久访问多个项目，并具备完整能力，包括项目探索、编辑、Git 操作、命令执行、测试和代码导航。快速试用时，一条命令的 `share` 模式会启动临时的单项目实例，并打印供 ChatGPT 使用的连接信息。 该工具支持多个平台：Linux（x64/arm64）、macOS（x64/arm64）和 Windows（x64 与 arm64）。Windows 和 macOS 用户建议使用 WebCodex Desktop 应用搭配官方 OpenAI Secure Tunnel，以获得最简单的设置体验。所有平台均提供基于 CLI 的设置方式，并提供自托管和高级配置等额外选项。 核心能力包括：读取、搜索、检查代码并进行受保护的修改；运行命令、测试、格式化工具、编译器和项目专用工具；使用 Git 检查状态和差异；通过可观察的任务处理长时间运行的工作；以及通过 Runtime Console、Workflow Session 证据和 Git/diff 审查支持人工审核。 WebCodex 使用 Rust 构建（通过 Cargo 进行构建），并采用 Apache License 2.0 许可。项目包含全面的文档，涵盖桌面安装、完整设置、快速试用、MCP 集成、部署、故障排除、CLI 参考、AI 辅助设置和安全指南。