Paseo 开源工具实战：多 AI 编程代理统一管理，手机电脑平板都能控制

前言

AI 编程工具这两年爆发式增长：Claude Code、Codex、OpenCode、Pi……每个工具都有各自的优势，但切换成本高、管理分散。

有没有一种工具，能够把这些 AI 编程代理统一管起来？

今天介绍一个开源项目 Paseo。它不是一个新的 AI 模型，也不是一个新的 IDE，而是一个统一调度层——跑在本地开发机上，用一个界面管理所有 AI 编程代理，手机、电脑、平板都能随时接入控制。

---

Paseo 是什么

Paseo（GitHub: github.com/getpaseo/paseo）是一个开源的 AI 编程代理统一调度层，核心理念是：

让 AI 编程代理跑在本地开发机上，通过统一界面从任意设备远程管理和调度。

它不是一个新的 AI 模型，不替代 Claude Code 或 Codex，而是叠加在现有工具之上的管理和协调层。

核心价值

根据官方 README ，Paseo 的核心价值在于：

• 多代理统一调度：支持 Claude Code、Codex、GitHub Copilot、OpenCode、Pi 等，通过统一界面管理不同工具的工作状态
• 混合工作流编排：可以用 Claude Code 做规划、Codex 做实现、另一个 Agent 做代码 review，各司其职、协同工作
• 跨设备远程控制：支持 iOS、Android、桌面端、Web 端、CLI，手机电脑平板都能随时接入
• 多会话上下文保持：一个界面同时追踪多个 Agent 的任务进度和上下文
• 本地优先：Agents 运行在本地开发机上，保留原有的开发环境和工具链配置，无需迁移
• 隐私优先：无遥测、无追踪、无强制登录

架构原理

• Daemon：运行在本地开发机上，负责管理 AI 编程任务
• Relay Server：充当中转节点，让公网设备能访问内网 Daemon
• 客户端：手机、平板、电脑，通过 WebSocket 与 Daemon 通信

---

快速上手

安装 CLI

npm install -g @getpaseo/cli

启动 Daemon

paseo daemon start

客户端连接

Paseo 提供多种客户端： 下载地址 Paseo – Run Claude Code, Codex, Copilot, OpenCode from anywhere

• 桌面端：Windows、Mac os
• 移动端：iOS/Android App
• CLI：直接通过命令行操作

---

海外 Relay 的延迟问题

Paseo 官方 Relay 部署在国外。国内用户直连延迟通常在 500ms+，甚至更高。

这个延迟会带来什么问题：

• 命令响应迟钝，操作反馈慢
• 语音控制、视频流等实时功能基本不可用
• 手机上操作经常要等好几秒才有反馈

社区解决方案

针对这个问题，社区主要有两种思路：

方案一：自建 Relay

在国内云服务器上部署 Relay 程序，绕过官方海外节点。常用工具：

• frp：经典内网穿透工具，需要云服务器作为中转
• ngrok：开源方案，支持自定义域名，免费版限制多

这类方案的共同点是：需要额外部署云服务器，2核4G 机器加带宽成本，每月 100-200 元。

方案二：内网穿透直连

将本地 Daemon 直接暴露到公网，不走官方 Relay。

几种主流内网穿透服务对比：

方案	延迟表现	配置复杂度	成本
花生壳	国内中转	图形化，较简单	免费版有限制
frp 自建	取决于服务器带宽	需要改配置	云服务器成本
QuickDesk	国内节点优化	零配置	具有免费额度

综合考虑延迟和配置成本，我这边采用的是QuickDesk 的内网穿透[https://quickdesk.com.cn/]是一个值得考虑的方案——主要是国内节点优化到位，延迟可以从 500ms+ 降低到 50ms 左右，无需自建服务器。

---

实战：Paseo + QuickDesk 内网穿透

环境说明

• 内网开发机：Ubuntu 22.04，局域网 IP 192.168.198.68
• Paseo Daemon：默认监听 localhost:6767
• QuickDesk：已有纳管设备

第一步：创建内网穿透

登录 QuickDesk 控制台，进入"内网穿透"模块。

创建自定义域名

• 点击「添加域名」
• 前缀：paseo-test（可自定义）
• 后缀：由平台分配
• 协议：HTTPS

添加穿透规则

• 点击「添加映射」
• 选择设备：选择已经纳管上平台与编码机器处于同一局域网的设备（纳管流程查看文末附录）
• 映射协议：选择HTTPS
• 公网访问地址： 选择刚刚创建的地址
• 内网映射协议：选择HTTP（Paseo 6767端口暴露的是HTTP服务）
• 内网IP 与 设备端口 填写安装Paseo 的机器ip 与 服务端口 - 192.168.198.68:6767

第二步：客户端连接

或在桌面 App 设置中填入域名和端口。

延迟对比

QuickDesk 内网穿透延时

Paseo 官方的Relay 中继延时

第三步：配置 Paseo Daemon

默认情况下 Daemon 只监听 localhost，需要修改为监听所有网卡：

# 找到配置文件
ls ~/.paseo/config.yml

# 编辑配置
vim ~/.paseo/config.yml

{
  "version": 1,
  "daemon": {
    "listen": "0.0.0.0:6767",  // 将监听网卡改为0.0.0.0
    "hostnames": [
      "localhost",
      ".localhost",
      "paseolocal.ztrust.wjztgw.com" //将获得的公网域名配置进Host
    ],
    "mcp": {
      "injectIntoAgents": false
    },
    "autoArchiveAfterMerge": false,
    "appendSystemPrompt": "",
    "cors": {
      "allowedOrigins": ["https://app.paseo.sh"]
    },
    "relay": {
      "enabled": true
    }
  },
  "app": {
    "baseUrl": "https://app.paseo.sh"
  },
  "agents": {
    "providers": {
      "opencode": {
        "additionalModels": []
      }
    }
  }
}

重启 Daemon：

paseo daemon restart

或者再客户端页面点击restart daemon 按钮

---

总结

Paseo 是一个值得关注的开源项目，它解决了一个实际问题：多 AI 编程工具统一管理。通过本地 Daemon 架构，你可以在手机、平板、电脑上随时接入和控制你的 AI 编程任务。

针对国内用户 Relay 延迟高的问题，QuickDesk 内网穿透是一个实用的优化方案——无需自建服务器，配置简单，延迟提升明显。

附录 — Quickdesk 自有设备纳管

• 点击「添加」

• 选择自有设备，平台设备是QuickDesk 他们推出的IPkvm产品

  

• 点击「一键安装」

  

• 将提供的命令复制到虚拟机 或者linux 机器上执行 ，等待几分钟后，就可以看到设备在线了

  

参考链接

• Paseo GitHub
• QuickDesk 内网穿透文档

---

你们团队用 AI 编程工具吗？有什么统一管理的困扰？欢迎在评论区交流~