跳转到内容
全部开发指南

Paseo 是什么？一个界面同时管 Claude Code、Codex 等 7 种 coding agent

AIGoCode发布于 更新于

Paseo 是什么？一个界面同时管 Claude Code、Codex 等 7 种 coding agent 封面

手上同时开两三个 coding agent 已经很常见了。Claude Code 在一个终端里改后端，Codex 在另一个终端里补测试，哪个卡在等你确认，得一个个标签页点过去看。

离开电脑更麻烦。人一走，agent 停在一个权限确认上干等半小时，回来一看什么都没做。

Paseo 就是冲这两件事来的。它是一个开源的 agent 开发环境，给 Claude Code、Codex、Copilot、OpenCode、Pi、Antigravity、Muse Code 这 7 种 agent 做了统一入口，桌面、手机、网页、命令行都能用，agent 始终跑在你自己的机器上。项目在 GitHub 上已经超过 2 万 Star，采用 Apache-2.0 协议。

Paseo 原文配图 1

先搞懂它是怎么搭的

Paseo 自己不带模型，也不做 agent，干的是管家的活。

你的电脑上跑一个本地服务，叫 daemon，所有 agent 都由它拉起和托管。桌面 app、手机 app、网页和 CLI 都只是连上来的客户端，看到的是同一批 agent、同一份状态。

所以在桌前开的任务，出门掏出手机能接着看输出、批权限、追加指令，还是同一个会话。手机端不是只能看通知的简化版，iOS 和 Android 都是原生的完整应用。

手机连回电脑有两种方式：一种是端到端加密的中继，在桌面 app 的 Settings → 你的主机 → Pair Device 里配对；另一种是不用中继，直接通过 TCP、Tailscale 或其他 VPN 连接。

隐私方面，Paseo 没有遥测和追踪，也不强制登录。各家 agent 的登录和凭据仍由各自的 CLI 管理，你本机的工具、配置和 skill 都照常可用。

Paseo 原文配图 2

一个窗口里同时跑好几个

桌面 app 打开就是完整的工作台：agent 对话、编辑器、终端、diff、PR，还有一个内置浏览器，分屏怎么摆自己定。

并行靠 git worktree。每个 agent 一个独立目录、一条独立分支，互不干扰。worktree 默认放在 Paseo 的数据目录下，按源仓库分组；一个 workspace 用完归档后，Paseo 会运行清理步骤并删掉对应的 worktree。

在仓库根目录放一个 paseo.json，可以配置新建 worktree 时自动执行的准备命令，比如装依赖：

{
  "worktree": {
    "setup": ["npm ci"]
  },
  "scripts": {
    "web": { "command": "npm run dev", "type": "service" }
  }
}

setup 里还可以加上把 .env 从源目录复制过来之类的命令，Paseo 会提供源目录路径的环境变量供你引用；归档时要做的清理工作（比如清缓存）写在 teardown 里。标成 service 的是常驻进程，例如前端 dev server，多个分支同时跑也不用手动错开端口。

要基于某个 PR 开一个 worktree，机器上装好并登录 gh，然后按 PR 号拉出来：

paseo workspace create --isolation worktree --mode checkout-pr --pr-number 2186

想在多个 worktree 里并行跑任务、逐个看 diff 和效果，官方文档里有一页专门讲这个流程。

Paseo 原文配图 3

agent 还能指挥 agent

这是 Paseo 里最有意思的一块。Paseo 内置了编排能力：agent 可以自己建 worktree、拉起别的 agent、给它们发消息，而且可以跨厂商。

比如在 Claude Code 里说一句：开一个 Codex 只读审一遍这个分支，审完把问题汇总给我。Codex 就会作为子 agent 跑起来，你随时可以点进去看它在做什么。

不想在对话里操作，用 CLI 也一样：

paseo run --provider codex --background "Review this branch without changing files"
paseo ls -a

项目还配了三个 Skill，一条命令装上：

npx skills add getpaseo/paseo
  • /paseo-handoff：把工作从一个 agent 交给另一个。作者自己的用法是 Claude 做规划，再交给 Codex 实现。
  • /paseo-advisor：拉一个 agent 当参谋，只给第二意见，不接手干活。
  • /paseo-committee：找两个风格相反的 agent 组成小组，先退一步查根因，再出方案。

不同模型擅长的活不一样，以前得自己在两个终端之间复制粘贴，现在可以让它们自己交接。如果你平时主要在 Codex 里开多个会话，也可以看看这篇 Codex 多会话并行的用法。

Paseo 原文配图 4

语音和插件

Paseo 支持两种语音用法：听写是把你说的话转成文字填进输入框；语音模式是直接对话，可以口头布置任务、一起理思路。语音模式能开 agent、管 agent，说出口的指令和手敲的一样有效，碰到删除文件这类操作，还是看一眼再放行。

Paseo 还有一套插件系统。插件跑在 daemon 上，写一次就能出现在桌面、网页、iOS 和 Android 所有客户端里，可以加界面、侧边栏、斜杠命令，也能改 agent 的配置、环境和 MCP server，甚至把新的 coding agent 接成 provider。安装命令是 paseo plugin add owner/slug，也支持从 Git 或本地目录装。官方提醒：插件能访问 daemon 所在机器和已连接的客户端，只装你信任的代码。

装起来

前提是机器上至少装好一个 agent CLI，并且已经登录能用，比如 Claude Code 或 Codex。

桌面端（推荐）：到 paseo.sh/download 或 GitHub Releases 下载安装包，打开 app，daemon 会自动启动，不用再装别的。手机连接时在 Settings 里找到你的主机，点 Pair Device。

服务器：没有桌面环境的机器，装 CLI 再启动 daemon：

npm install -g @getpaseo/cli
paseo

启动时会问你是否开启端到端加密的中继，拒绝的话就用直连或 VPN。桌面、手机和网页客户端都可以连上这台主机。

Docker：官方也提供了镜像 ghcr.io/getpaseo/paseo，可以同时运行 daemon 和自托管的网页界面，默认端口 6767，启动时用环境变量设置访问密码。需要哪些 agent CLI，在基础镜像上自己加装。

CLI 能做 app 里能做的所有事，常用的几个：

paseo run --provider codex --worktree feature-x "implement feature X"
paseo ls
paseo attach abc123
paseo send abc123 "also add tests"

paseo ls 列出正在跑的 agent，attach 实时看某个 agent 的输出，send 给它追加任务。加上 --host 参数还能把任务派到另一台机器的 daemon 上跑。

想用代码集成的，还有 TypeScript SDK @getpaseo/client，可以拿来做 issue 联动、看板或自己的编排服务。

写在最后

Paseo 做的事情不复杂：一个本地 daemon 托管所有 agent，多端客户端连上来看同一份状态，再加上 worktree 并行和跨厂商编排。对同时用 Claude Code 和 Codex 的人来说，最直接的收益是不用守在电脑前，也不用在终端之间来回搬运上下文。

只想用手机远程看 Codex 任务的，也可以先看看 Codex 手机远程控制。需要给 Claude Code 和 Codex 接入稳定的模型服务，可以到 AIGoCode 查看支持的模型和使用文档。

GitHub：github.com/getpaseo/paseo