Paseo 是一个自托管的跨平台 AI 编程代理编排系统，通过统一界面远程管理 Claude Code、Codex 和 OpenCode 等编码代理。支持桌面、移动、Web 和 CLI 多端访问，提供语音控制、并行任务执行和隐私优先的本地运行方案。本页提供项目介绍、安装指南、使用方法和架构解析。
Paseo 是一个自托管跨平台 AI 编程代理编排系统，通过统一界面远程管理 Claude Code、Codex 和 OpenCode，支持多端访问、语音控制与隐私优先的本地运行方案。
Paseo 是一个自托管的跨平台 AI 编程代理编排系统，定位为'所有 Claude Code、Codex 和 OpenCode 代理的统一接口'。它并非替代这些 AI 工具，而是提供集中化管理层，让开发者能在单一界面中启动、监控、控制和协调多个 AI 编码代理。项目强调隐私优先，所有代理进程在用户本地机器运行，数据不离开设备。主要用途包括：远程管理服务器上的编码任务、在移动设备上监控和干预 AI 工作流、通过 CLI 自动化执行重复性编码任务，以及利用语音控制实现 hands-free 操作。项目采用开源模式（MIT 许可证），核心组件包括本地 Daemon 服务、多平台客户端和 orchestration skills 系统。
Paseo 解决的核心痛点是 AI 编程工具生态碎片化带来的工作流中断。当前，Claude Code、Codex、OpenCode 等工具各自为政，缺乏统一控制平面，导致开发者需要在不同终端、不同设备间切换，难以实现连续工作流。具体问题包括：设备割裂——桌面端启动的任务无法在手机上监控；提供商锁定——每个工具独立使用，无法根据任务特点灵活切换模型；隐私顾虑——云服务方案可能泄露代码；协作困难——多代理协作缺乏 orchestration 机制。Paseo 通过本地 Daemon 统一管理代理进程，WebSocket 实时通信实现跨设备控制，多提供商抽象层支持灵活切换模型，以及实验性的 skills 系统实现代理间 handoff 和 loop 协作，从而构建完整的本地化 AI 编程工作台。
Paseo 适用于多种开发场景：远程开发者在服务器上运行编码任务，通过手机随时查看进度并发送新指令；团队协作中，用 Claude 进行架构设计后 handoff 给 Codex 实现具体代码；在 CI/CD 流水线中通过 CLI 自动化执行测试和修复；移动开发者在通勤途中通过语音控制审查代码；以及需要严格代码隐私的敏感项目。特别适合：多设备工作者——在桌面编写代码，用手机监控长时间运行的任务；多模型用户——根据任务复杂度在 Claude、Codex 间切换；自动化爱好者——通过 CLI 脚本化编码工作流；隐私敏感项目——金融、医疗等需本地处理的代码。实验性的 orchestration skills 还支持复杂场景如'用 Claude 规划、Codex 实现、Sonnet 验证'的循环工作流。
Paseo 提供多种安装路径，取决于使用场景和设备。桌面用户推荐直接下载安装包：访问 paseo.sh/download 或 GitHub Releases 页面获取适用于 macOS、Windows 或 Linux 的桌面应用，安装后 Daemon 自动启动。CLI/无界面环境使用 npm 全局安装：`npm install -g @getpaseo/cli`，然后运行 `paseo` 启动本地 Daemon 并显示连接 QR 码。移动端需先安装桌面或 CLI 版本生成 Daemon，再在 iOS/Android 应用商店搜索'Paseo'扫码连接。Android 开发者可参考 docs/ANDROID.md 进行本地构建：使用 `npm run android:development` 调试构建或 `npm run android:production` 发布构建，EAS 云构建配置在 packages/app/eas.json 中。所有客户端首次连接需扫描 Daemon 生成的 QR 码完成配对。
Paseo 的使用贯穿任务创建、监控、交互和 orchestration 全流程。基础操作通过 CLI 或客户端界面完成：`paseo run --provider claude/opus-4 'implement user authentication'` 启动新代理任务；`paseo ls` 列出所有运行中的代理；`paseo attach <id>` 实时流式查看输出；`paseo send <id> 'also add tests'` 向运行中代理发送后续指令。远程 Daemon 支持：`paseo --host workstation.local:6767 run 'run tests'` 连接服务器执行任务。高级功能包括语音控制——在移动端按住语音按钮口述任务；以及实验性的 orchestration skills：安装 `npx skills add getpaseo/paseo` 后，可在对话中使用 `/paseo-handoff` 交接任务给其他代理、`/paseo-loop` 设置循环验证（如'用 Codex 修复测试，用 Sonnet 验证，最多 10 次'）、`/paseo-orchestrator` 创建代理团队通过聊天协调工作。完整 CLI 参考见 paseo.sh/docs/cli。
Paseo 的技术实现具有几个关键特点：架构上采用本地 Daemon 为核心，负责代理进程管理、WebSocket 服务和 MCP 控制接口，客户端仅负责 UI 和指令转发，确保低延迟和隐私。数据模型定义在 docs/DATA_MODEL.md，使用 $PASEO_HOME 目录持久化存储代理记录、工作树和配置。项目采用 monorepo 结构（package.json 定义 8 个 workspaces），使用 TypeScript 严格类型检查（docs/CODING_STANDARDS.md 规范），构建系统支持 Nix flakes（flake.nix）。跨平台实现：桌面端基于 Electron（packages/desktop），移动端使用 React Native（packages/app），Web 端为 Next.js（packages/website），CLI 为独立 Node 包（packages/cli）。通信层通过 relay 包中继（packages/relay）支持 NAT 穿透。项目当前版本 0.1.52，处于活跃开发，orchestration skills 标记为不稳定且频繁更新。无遥测设计体现在代码中无跟踪调用，强制登录机制缺失。
Paseo 采用自托管架构，所有 AI 代理进程在本地机器运行，代码不发送到任何第三方服务器。项目无遥测、无跟踪、无强制登录，确保开发环境完全私有。
当前支持 Claude Code、Codex 和 OpenCode 三大主流 AI 编程工具。通过统一抽象层，可在同一界面中切换不同提供商，根据任务需求选择最合适的模型。
在桌面或 CLI 客户端启动 Paseo 后，会显示一个 QR 码。在手机 Paseo 应用中扫描该码即可建立安全连接，之后即可在手机上监控和操控桌面上的代理任务。
Orchestration Skills 是实验性功能，教 AI 代理使用 Paseo CLI 协调其他代理，支持 handoff（任务交接）、loop（循环验证）和 orchestrator（团队协作）。该功能标记为不稳定，频繁更新且可能依赖特定环境，使用需谨慎。
直接使用各工具需分别在各自终端操作，缺乏统一控制。Paseo 提供集中化管理：跨设备访问、并行运行多个代理、语音控制、代理间协作 orchestration，以及统一的日志和状态视图，显著提升多任务工作流效率。