VibeTunnel — 项目简介

VibeTunnel 是一款 macOS 菜单栏应用，能够将任意浏览器变成 Mac 终端，让开发者随时随地远程监控 Claude Code、ChatGPT 等基于终端的 AI 编程助手。与传统 SSH 方案不同，VibeTunnel 无需配置密钥、无需端口转发，一键即可从手机或平板访问本地终端会话。该项目在 GitHub 已有超过 4600 颗星标，定位为 AI 时代开发者的"远程终端伴侣"，属于典型的 Vibe Coding 风格工具——用自然语言描述需求、AI 辅助实现、全平台浏览器访问。

核心功能

浏览器终端访问 用户无需安装任何客户端，只需要在同一网络环境下的任意设备浏览器中打开 localhost:4020，即可看到所有活跃终端会话的实时画面。支持键盘输入、命令输出滚动、历史记录回溯，延迟极低，操作体验接近原生终端。

零配置启动 VibeTunnel 安装后直接显示在 macOS 菜单栏，点击图标即可启动内置服务器。无需注册账号、无需填写配置、无需配置 SSH 密钥或修改路由器设置，对非运维背景的开发者极为友好。

AI 编程助手专属集成 内置 vt --claude 一键启动命令，可自动定位并运行 Claude Code；同时提供 vt --claude-yolo 高权限模式，方便 AI 助手在需要更高系统权限时绕过沙箱限制。该功能解决了开发者"想让 AI 在远程机器上跑任务但又不想配 SSH"的痛点。

会话录制与回放 所有终端会话均以 asciinema 格式自动录制，开发者可随时回放查看 AI 编程助手的工作过程，方便复盘代码生成逻辑、审计 AI 执行步骤，或将录制分享给团队成员作为教学素材。

安全隧道与远程访问 支持三种安全访问模式：① 密码保护模式（本地 Dashboard 加密码）；② Tailscale 模式（通过 Tailscale 虚拟网络从全球任意位置安全连接 Mac）；③ ngrok 模式（一键生成公网可访问的隧道链接并分享给同事或学生）。

移动端适配 专门优化了移动端浏览器体验，解决了传统终端在手机小屏幕上难以操作的问题。开发者可在手机浏览器中直接查看 AI 编程进度、输入命令、监控长时间运行的训练或构建任务。

技术实现

VibeTunnel 采用 Swift/SwiftUI 构建 macOS 原生菜单栏应用，后端使用 Rust 编写高性能终端会话管理服务器，前端提供基于 Web 的实时终端渲染界面。这套架构的核心考量是：终端操作的实时性要求毫秒级响应，传统 Node.js 或 Python 后端难以胜任，而 Rust 的异步 I/O 模型和零成本抽象特性使其成为此类场景的理想选择。Web 前端通过 WebSocket 与 Rust 服务器保持长连接，确保每个按键的传输延迟在体感上接近原生终端体验。

在安全层面，VibeTunnel 将服务器默认绑定在 localhost，仅响应本机请求；Tailscale 和 ngrok 两种远程访问方案均采用加密隧道，防止中间人攻击；密码保护功能使用 bcrypt 哈希存储，确保即使配置文件泄露也无法被轻易破解。asciinema 录制功能由 Rust 端直接拦截 PTY 输出流完成，对应用性能影响极小，录制文件存储在本地 ~/Library/Application Support/VibeTunnel/ 目录下。

项目还提供了 Swift 和 Rust 双后端模式：Swift 后端适合与 macOS 系统深度集成（如 Touch Bar、系统通知等），Rust 后端则更适合高性能场景（如高密度输出日志）。用户可在设置中自由切换。

快速上手

第一步：下载安装 访问 GitHub Releases 页面（github.com/amantus-ai/vibetunnel/releases/latest），下载最新版本的 VibeTunnel.dmg 文件，打开后将 VibeTunnel 应用拖入「应用程序」文件夹。

第二步：启动菜单栏服务 在「应用程序」中找到 VibeTunnel 并启动，应用图标会出现在 macOS 右上角菜单栏。点击图标，在菜单中选择启动服务器，默认端口为 4020。

第三步：浏览器访问本地终端 在同一 Mac 上打开浏览器，访问 http://localhost:4020，即可看到 VibeTunnel 的 Web 终端界面。默认显示空会话，可直接在上方输入框敲命令，或点击右上角新建会话。

第四步：启动 AI 编程助手 如果要在终端中运行 Claude Code，在 VibeTunnel 输入框中执行 vt --claude，应用会自动定位系统中安装的 Claude Code 并启动。此后所有 Claude Code 的输出都会实时同步到浏览器界面，可在手机或平板上随时查看 AI 编程进展。

可选：配置远程访问 在菜单栏设置中，选择「Tailscale 模式」并安装 Tailscale 应用（tailscale.com），即可通过 http://[your-mac-name]:4020 从任何 Tailscale 联网设备访问；或选择「ngrok 模式」填入 ngrok 认证令牌，生成公网 URL 分享给团队成员。

适用人群

远程开发者：在咖啡馆、图书馆或出差途中，需要偶尔查看家中或公司 Mac 上 AI 编程进度的开发者，无需搭建复杂的 VPN 或 SSH 环境。

AI 编程重度用户：日常使用 Claude Code、Codex、OpenCode 等终端 AI 编程助手的开发者，希望在手机或平板上随时查看 AI 工作状态、给 AI 下达新指令。

技术团队负责人：希望远程监控团队成员的 AI 编程进度，或通过 asciinema 回放功能审查 AI 生成的代码质量。

教育场景从业者：教授编程或 AI 辅助开发的讲师，可通过 ngrok 一键分享终端会话链接，让学生实时观看 AI 编程过程。

运维与数据科学从业者：需要在外网环境下远程连接家中高性能 Mac 运行训练任务、监控服务器日志的技术人员。

官方链接：https://github.com/madhavajay/vibetunnel 最新发布：GitHub Releases（amantus-ai/vibetunnel） 开源协议：MIT License 星标数：4600+（截至 2026 年 9 月）