ApexCode

一个界面，统一使用 Claude Code、Codex、Copilot、OpenCode 和 Pi。

---

在你自己的机器上并行运行 agent。无论在手机上还是在桌前，都可以推进并交付工作。

• 自托管： Agent 在你的机器上运行，并使用完整的本地开发环境。继续使用你的工具、配置和技能。
• 多提供商： 用同一个界面访问 Claude Code、Codex、Copilot、OpenCode 和 Pi。为每个任务选择合适的模型。
• 语音控制： 用语音模式口述任务，或直接讨论问题。需要时可以免手操作。
• 跨设备： 支持 iOS、Android、桌面端、网页端和 CLI。可以在桌前开始工作，在手机上查看进展，也可以从终端编排流程。
• 隐私优先： ApexCode 没有遥测、追踪，也不会强制登录。

快速开始

ApexCode 会运行一个名为 daemon 的本地守护进程，用来管理你的 coding agents。桌面应用、移动应用、网页应用和 CLI 等客户端都会连接到这个服务。

前置条件

你至少需要安装并配置好一个 agent CLI，并完成对应的凭据登录：

• Claude Code
• Codex
• GitHub Copilot
• OpenCode
• Pi

桌面应用（推荐）

从 paseo.sh/download 或 GitHub releases 页面 下载。打开应用后，daemon 会自动启动，不需要额外安装其他内容。

如果要用手机连接，扫描设置中显示的二维码即可。

CLI / 无界面模式

安装 CLI 并启动 ApexCode：

npm install -g @getpaseo/cli
paseo

终端中会显示一个二维码，任何客户端都可以扫码连接。这个方式适合服务器和远程机器。

完整安装和配置说明见：

• 文档
• 配置参考

CLI

应用里能做的事，也都可以在终端里完成。

paseo run --provider claude/opus-4.6 "implement user authentication"
paseo run --provider codex/gpt-5.4 --worktree feature-x "implement feature X"

paseo ls                           # 列出正在运行的 agent
paseo attach abc123                # 实时查看输出
paseo send abc123 "also add tests" # 发送后续任务

# 在远程 daemon 上运行
paseo --host workstation.local:6767 run "run the full test suite"

更多内容见完整 CLI 参考。

技能

技能会教你的 agent 使用 ApexCode 来编排其他 agent。

npx skills add getapex/apex

之后可以在任意 agent 对话中使用：

• /apex-handoff — 在 agent 之间交接工作。例如先用 Claude 做计划，再交给 Codex 实现。
• /apex-loop — 让 agent 围绕清晰的验收标准循环执行，也就是 Ralph loops；也可以搭配 verifier。
• /apex-advisor — 启动一个单独的 agent 作为顾问，提供第二意见，但不把工作本身委托出去。
• /apex-committee — 组成一个由两个不同取向 agent 构成的委员会，用来后退一步、分析根因并产出计划。

开发

Monorepo 包结构速览：

• packages/server：ApexCode daemon（agent 进程编排、WebSocket API、MCP 服务器）
• packages/app：Expo 客户端（iOS、Android、网页端）
• packages/cli：用于 daemon 和 agent 工作流的 paseo CLI
• packages/desktop：Electron 桌面应用
• packages/relay：用于远程连接的 relay 包
• packages/website：官网和文档站点（paseo.sh）

常用命令：

# 运行所有本地开发服务
npm run dev

# 分别运行单个端
npm run dev:server
npm run dev:app
npm run dev:desktop
npm run dev:website

# 构建 server 相关部分
npm run build:server

# 仓库级检查
npm run typecheck

社区

• paseo-relay — Go 实现的自托管 relay

自托管 relay TLS

自托管 relay 默认使用 ws://，除非显式启用 TLS。如果 relay 位于 nginx 后方并使用 443 端口，可以这样启动 daemon：

PASEO_RELAY_ENDPOINT=127.0.0.1:8080 \
PASEO_RELAY_PUBLIC_ENDPOINT=relay.example.com:443 \
PASEO_RELAY_USE_TLS=true \
paseo daemon start

等价配置如下：

{
  "daemon": {
    "relay": {
      "enabled": true,
      "endpoint": "127.0.0.1:8080",
      "publicEndpoint": "relay.example.com:443",
      "useTls": true
    }
  }
}

最小 nginx WebSocket 代理配置：

server {
  listen 443 ssl;
  server_name relay.example.com;

  ssl_certificate /etc/letsencrypt/live/relay.example.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/relay.example.com/privkey.pem;

  location /ws {
    proxy_pass http://127.0.0.1:8080;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
  }
}

---

许可证

AGPL-3.0