首页 / 开源热榜 / orca / 使用教程

Orca 教程：并行代理之前先收紧权限

更新于 2026-09-23 · NGJOO AI 实验室 · 约 11 分钟

Orca 把 Codex、Claude Code、OpenCode、Pi 等命令行代理放进同一个 Electron 工作台。每个并行任务使用独立 Git worktree，终端、文件、浏览器、diff 和任务状态集中显示。它还支持 SSH 工作区、手机伴侣和 Computer Use。

截至 2026-09-23，最新公开 release 是 v1.4.207，发布于 2026-09-22。main 的 package.json 当前写 1.4.197，说明发布标签和源码清单可能短时不同，安装时以 release 资产为准。

1. 先看懂权限从哪里来

Orca 不提供模型额度。它启动用户已有的 CLI agent，并继续使用这些 agent 的登录态或订阅。一个会话可能同时接触项目目录、shell、Git、浏览器、GitHub、Linear、SSH 密钥和转发端口。账号切换器还能读取 Claude 与 Codex 的用量状态。

Computer Use 可以操作可见桌面界面；Design Mode 会把网页元素的 HTML、CSS 和截图送入提示。手机端通过仓库 cloud/ 下的 relay 与桌面主机配对。启用每一项之前，都要把它当成新增权限面处理。

2. 安装 v1.4.207

普通用户直接从官方安装说明选择 macOS、Windows 或 Linux 构建。macOS 也可以使用 Homebrew：

brew install --cask stablyai/orca/orca

Arch Linux 可使用 yay -S stably-orca-bin。源码开发环境由 package.json 指定 Node.js 24；这与下载预编译桌面包是两条路径。headless Linux 另有 orca serve 指南，不应直接把服务端口暴露到公网。

3. 用临时仓库验证 worktree

只连接一个已经登录的 CLI agent，不导入多余账号。
新建临时 Git 仓库，让两个代理分别修改不同的小任务。
确认两个任务落在不同 worktree，逐一查看 diff 和测试结果。
人工选中结果并处理冲突，再执行合并。

worktree 解决的是文件隔离，不会替用户判断代码质量。终端命令、测试、依赖变更和提交内容仍需审查。等本地路径稳定后，再添加第二个代理、GitHub 或 Linear。

4. SSH、移动端和遥测

SSH worktree 可以在远程主机编辑文件、运行 Git 和终端，并支持自动重连与端口转发。建议为 Orca 使用单独 SSH key、受限远程账号和明确的转发端口，不要复用高权限运维账号。

手机端适合看完成通知和补发指令，但通知文本可能暴露项目内容。配对前阅读官方 telemetry 文档，检查匿名数据收集和退出方法；设备丢失或成员离开时撤销配对。

验证边界：本轮只核对官方 README、package.json、telemetry 入口和 GitHub Releases。未下载安装包，未启动 Electron、orca serve、CLI agent、SSH、移动 relay 或 Computer Use，也未授予 GitHub、Linear 和模型账号权限。

5. 与 Sandcastle 对比

Sandcastle也用 Git worktree 并行运行编码代理，官方路径更偏 Docker 容器、Web 仪表盘和 GitHub App。Orca 提供原生桌面终端、内置浏览器、SSH 工作区和移动伴侣。团队在服务器集中托管任务时可先看 Sandcastle；开发者要操作本机现有 CLI agent 时，Orca 更贴近桌面工作流。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

先判断这个项目是否适合你

适合谁用

适合同时比较多个编码代理结果、用 worktree 隔开并行改动、在远程主机运行代理，或需要从手机继续监控长任务的开发者。若只开一个终端代理且不需要图形界面、远程会话或任务集成，Orca 会增加一层桌面应用和权限配置。

原教程未展开的系统信息

核心功能

并行 worktree
同一提示可分发给五个代理，每个代理使用独立 Git worktree，用户比较结果后再合并选中的实现。
终端与代码审查
应用提供可拆分终端、持久滚动记录、文件编辑器和 diff 行内批注，可把修改意见送回代理。
远程和移动协作
SSH worktree 支持远程文件、Git、终端、重连和端口转发；移动端可查看任务、接收完成通知并补发指令。

架构与数据流

Orca 是 Electron 桌面应用。它在工作区中管理终端、CLI 代理、Git worktree、内置 Chromium、GitHub/Linear 任务和 SSH 会话；orca CLI 还能创建 worktree、截屏、点击和填表。手机通过仓库内 cloud/ 的 relay 与桌面主机配对。模型推理和账号计费仍由用户选择的外部代理提供商处理。

常见问题

Orca 会附送 Codex 或 Claude Code 额度吗？

不会。官方说明 Orca 使用用户自己的代理订阅或登录态；各模型提供商的费用、速率限制和条款仍单独生效。

Orca 的并行任务为什么要用 Git worktree？

每个代理在独立 worktree 改文件，可减少多个任务互相覆盖。合并前仍需人工检查 diff、测试和冲突，worktree 本身不会判断哪份实现正确。

Orca 的 Computer Use 应该直接开吗？

先不要给长期或全局权限。该功能可操作可见桌面界面，应先在低权限账号和临时仓库中限制可访问应用，并保留关键写入和提交的人工确认。

Orca 手机端为什么需要单独看隐私边界？

手机会通过 relay 与桌面主机配对并查看代理状态。启用前应核对官方 telemetry 文档、配对设备、网络出口和通知内容，离职或丢失设备后立即撤销配对。

Orca 和 Sandcastle 怎样选？

Orca 偏向本机桌面工作台、终端、浏览器、SSH 和移动接续；Sandcastle 偏向 Docker 容器、Web 仪表盘和 GitHub App 驱动的集中任务。按部署位置和权限模型选择。