还在办公室才能盯 AI 写代码?你早就该"全身而退"了。做开发的人都懂这种感觉:让 AI 编码助手跑一个任务,自己去喝杯咖啡,结果在茶水间接到消息说代码炸了——等你冲回来,错误日志已经刷了 200 行。又或者,周末在家想看看那个重构任务进展到哪了,结果只能远程登录桌面,交互体验一塌糊涂。Paseo 这个开源项目,就是来解决这个痛点的:把 AI 编码助手装进手机,随时随地监控、接管、指挥你的 Agent。一句话介绍
Paseo 是一个本地运行的 Daemon + 多端客户端系统,通过同一个界面管理 Claude Code、Codex、OpenCode 等主流 AI 编码 Agent,支持手机、桌面、Web、CLI 全平台。
它解决什么问题?
1. 多 Agent 聚合管理
大多数团队现在不止用一个大模型:Claude Code 写核心逻辑强,Codex 做代码补全顺,OpenCode 跑自动化脚本……但每套工具各自一套 CLI,看日志得开好几个终端。Paseo 的核心思路是一个 Daemon 接管所有 Agent:你只需要打开 Paseo,不管在手机还是桌面,所有 Agent 的状态、输出、进度一目了然。2. 跨设备无缝衔接
在桌面开了任务,出门等公交时掏出手机看一眼进度;回家坐在沙发上,用 CLI 补一句新需求。Agent 不会因为你换设备就断了。Paseo 的 Daemon 在后台持续运行,Agent 任务不受客户端连接状态影响。3. 隐私优先,不做数据生意
这是 Paseo 和很多"云端 AI 平台"最本质的区别:它没有遥测、没有强制登录、不收你的代码。你的代码在你的机器上跑,API 密钥由你自己保管,Paseo 只是帮你更好地组织和管理 Agent,不碰你的数据。4. Voice 模式:双手解放
用语音直接给 Agent 下指令,适合开车时、做饭时,或者双手正在调试硬件的场景。Hands-free 开发不是噱头,是真实需求。
怎么安装和使用?
环境要求
只需要一台 Mac/Linux/Win 机器,以及至少一个已配置好的 Agent CLI:
桌面客户端(最简单)
从下载桌面版,打开后 Daemon 自动启动,无需额外配置。手机连接:桌面版 Settings 里扫 QR 码即可。CLI 方式(适合服务器/远程)
npm install -g @getpaseo/clipaseo
终端会显示一个 QR 码,用手机扫码连接。这个模式也适合无头服务器场景。连接远程机器
paseo --host workstation.local:6767 run "run the full test suite"
Skills:让 Agent 学会"协作编排"
Paseo 还有一个亮点:内置了一套 Skills,教你的 Agent 如何用 Paseo 编排其他 Agent: | |
|---|
/paseo-handoff | 在不同 Agent 之间交接任务(比如用 Claude 规划,用 Codex 实现) |
/paseo-loop | 让 Agent 按验收标准循环执行,配合验证器用(也叫 Ralph Loops) |
/paseo-advisor | 召唤一个"顾问 Agent",给你提供第二意见,不抢实际工作 |
/paseo-committee | 组建两人 Agent 委员会,做根因分析和方案规划 |
npx skills add getpaseo/paseo
装好后,在任何 Agent 对话里调用这些 Skill 即可。这套机制让单 Agent 干活变成了多 Agent 协作工作流,是 Paseo 最有意思的部分。
技术架构一览
Paseo 是一个 npm workspace 单体仓库(monorepo),包含: | |
|---|
packages/server | Daemon 核心:Agent 生命周期管理、WebSocket API、MCP Server |
packages/app | Expo 移动端(iOS/Android/Web) |
packages/cli | 命令行工具(paseo run/ls/logs/wait) |
packages/desktop | |
packages/relay | |
packages/website | |
适合谁用?
- 同时用多个 AI 编码工具(Claude Code + Codex 等)
- 做 AI 辅助开发,想把 Agent 干活变成可编排的工作流
- 只需要一个 Agent 单跑,不需要多 Agent 协作
- 机器没有固定 IP 或稳定的网络环境(远程连接依赖 Daemon 地址)
当前状态(2026 年 5 月)
- 6k GitHub Stars,553 Forks
- 活跃开发:最近提交就在今天(May 13, 2026),全仓库 3,281 次提交
- 支持平台:桌面(Electron)、移动(iOS/Android)、Web、CLI
- 内置 Provider:Claude Code、Codex、GitHub Copilot (ACP)、OpenCode、Pi,以及一键接入 Cursor、Qwen Coder、Kimi Code 等社区 Provider
总结
Paseo 解决的不是"有没有 AI 写代码"的问题,而是"AI 在跑代码的时候,我怎么高效地管它"的问题。如果你已经在用 Claude Code 或 Codex,或者同时跑多个 Agent,它能显著提升你的工作流组织能力。开源 + 本地优先,隐私也有保障。