vibe-coding-everywhere Vibe 项目

项目简介

vibe-coding-everywhere 是 LoVC（Life of Vibe Coding）社区推出的一个开源项目，目标是让你随时随地连接到本地的 AI 编程助手。它提供 Web 端和移动端两种客户端，通过 Socket.IO 连接本机运行的 Claude Code CLI、Gemini CLI 或 Codex，把"写代码"这件事从电脑前解放出来——你在手机上、平板上，甚至远程都能控制家里的编程助手继续干活。

项目的核心价值在于"本地运行 + 远程访问"。你的代码和 API Key 始终留在本地，客户端只是一个轻量的遥控器，既保留了本地模型的安全与隐私，又获得了随时随地的便利。

核心功能

• 多助手支持：同时支持 Claude Code CLI、Gemini CLI 和 Codex 三种主流 AI 编程助手，按喜好自由选择。
• Web 聊天界面：服务启动后自带 HTML/JS 聊天 UI，浏览器打开 localhost 即可用，无需额外安装。
• 移动端 App：基于 Expo React Native 构建，支持 iOS 和 Android，让你在手机上随时给编程助手派活。
• PTY 会话保持：Claude 和 Gemini 运行在 PTY 会话里，保留完整的终端交互体验；Codex 则通过 app-server RPC 配合 thread_id 实现线程级续接。
• 工作区目录树：内置工作区树状视图，方便在移动端浏览和切换项目。
• Tailscale 远程访问：可选接入 Tailscale，安全地在公网访问家里的编程助手，无需暴露端口。

技术实现

项目采用前后端分离的架构，整体由三部分组成。服务端基于 Express + Socket.IO + node-pty 构建，负责拉起 Claude CLI、Gemini CLI 或 Codex 进程，并通过 Socket.IO 与客户端双向通信；Web 客户端是直接由服务端托管的 HTML/JS 聊天界面，打开根路径即可访问；移动客户端则是 Expo React Native 应用，面向 iOS 和 Android。

服务端内部按模块划分：config 负责环境配置，utils 提供 ANSI 清理和工作区树等工具函数，prompts 负责系统提示词加载，process 目录专门管理各家 AI 提供商的进程（claude.js、gemini.js、codexAppServerSession.js），routes 处理 Express API 路由，socket 处理 Socket.IO 事件。移动端同样遵循面向服务的架构，组件按功能拆分到 components/chat 等目录下。运行时需要 Node.js v18 以上，并至少安装一个 AI CLI 到 PATH 中。服务默认监听 http://localhost:3456，可通过 PORT 环境变量修改；开发模式支持自动重启。

快速上手

1. 安装依赖：在项目根目录执行 npm install。
2. 启动服务：执行 npm start，服务默认监听 http://localhost:3456。
3. 打开 Web 客户端：浏览器访问 http://localhost:3456，即可开始聊天。
4. 配置 AI 助手：确保 Claude CLI、Gemini CLI 或 Codex 中至少一个已安装并在 PATH 里。
5. 移动端接入：按 Mobile Setup 文档配置 Expo 应用；如需远程访问，可配合 Tailscale 使用。

适用人群

• Vibe Coding 玩家：喜欢用 Claude Code、Gemini CLI 或 Codex 辅助写代码的开发者。
• 移动办公人群：希望在手机、平板上随时调用本地编程助手的用户。
• 注重隐私的开发者：不想把代码和密钥交给云端服务的工程师。
• 多助手体验者：需要在不同 AI 编程助手之间切换比较的用户。

官方链接

• 开源仓库：https://github.com/Life-of-Vibe-Coding/vibe-coding-everywhere