Orca 是一个强大的 AI 编排器，让你能够同时运行和管理多个并行的 AI 编程智能体（如 Claude Code、Codex 等）。本教程将指导你在不同平台上完成 Orca 的安装和基本配置。

1. 部署前准备

核心概念理解

  • Orca 是编排器，不是智能体本身：它本身不包含 AI 能力，而是为你已有的 CLI 智能体提供一个统一的运行和管理环境。你需要拥有并配置好至少一个支持的智能体（如 Claude Code、Codex）的账号和订阅。
  • 并行工作树：Orca 的核心优势是能让多个智能体在各自独立的 Git 工作树中并行工作，你可以对比结果并择优合并。

环境要求

  • 桌面端：macOS、Windows 或 Linux 操作系统。
  • 移动端：iOS 或 Android 设备，用于远程监控。
  • 已有 CLI 智能体：确保你已安装并在终端中可运行至少一个支持的 CLI 智能体（如 claude、codex 命令）。

2. 安装 Orca

Orca 提供多种安装方式，以适应不同的使用场景。

方式一：桌面客户端（推荐）

这是最完整的使用方式，提供图形界面和所有功能。

macOS

  • 直接下载：从 onOrca.dev 下载 Apple Silicon 或 Intel 版本的 .dmg 文件，双击安装。

  • 使用 Homebrew：

    1
    brew install --cask stablyai/orca/orca

Windows

  • 从 onOrca.dev 下载 .exe 安装程序并运行。

Linux

  • AppImage：从 onOrca.dev 下载 .AppImage 文件，赋予执行权限并运行。

    1
    2
    chmod +x Orca-*.AppImage
    ./Orca-*.AppImage

  • Arch Linux (AUR)：

    1
    yay -S stably-orca-bin

方式二：移动端（远程监控）

用于在手机上监控任务进度和发送后续指令。

  • iOS：在 App Store 搜索 “Orca” 下载，或加入 TestFlight 获取测试版。
  • Android：从官方渠道下载 0.0.44 版本的 APK 文件进行安装。

方式三：无头 Linux 服务器（高级）

如果你希望在远程 VPS 上运行 orca serve 作为服务，请参考官方提供的无头 Linux 服务器指南。这通常涉及安装 Node.js 环境，并使用 npm 或 pnpm 全局安装 Orca 的服务器组件。

3. 首次启动与配置

  1. 启动应用：安装完成后，启动 Orca 桌面应用。
  2. 添加智能体账户：Orca 需要与你的智能体账户关联才能工作。
    • 在设置中找到“Accounts”或“Providers”部分。
    • 选择你想要添加的智能体（如 Claude Code、Codex）。
    • 按照提示登录你的智能体账户。这通常需要你通过浏览器完成 OAuth 认证，然后将生成的令牌或凭证粘贴回 Orca。
  3. 配置 Git 仓库：Orca 围绕 Git 工作树构建。你需要添加一个现有的 Git 仓库，Orca 会基于它创建并行的工作树。
  4. 安装可选组件（如果需要）：根据提示，你可能需要安装 gh (GitHub CLI) 等工具以获得完整的 GitHub 集成体验。

4. 基本使用流程

  1. 创建并行任务：在 Orca 的主界面，选择你想使用的多个智能体，输入一个任务提示（Prompt），然后点击运行。
  2. 监控进度：你可以在桌面端或移动端实时观察每个智能体在其终端中的输出和进度。
  3. 查看与对比结果：任务完成后，Orca 会展示每个智能体产生的代码变更和文件。你可以方便地对比它们的工作成果。
  4. 选择并合并：选择你认为最好的一个版本，或手动合并不同智能体的优秀部分，然后将变更提交到主分支。

5. 高级功能配置

  • SSH 远程工作树：在设置中配置 SSH 连接信息，即可将计算密集型任务分发到远程高性能服务器上运行。
  • 设计模式：这是一个用于前端开发的强大功能。在 Orca 中打开一个内置的 Chromium 浏览器窗口，点击任何 UI 元素，其 HTML、CSS 和截图会自动发送给智能体作为上下文。
  • Orca CLI：高级用户可以通过命令行 orca worktree create、orca snapshot 等命令来脚本化你的工作流。

6. 故障排查与社区支持

  • 智能体未找到：确保你已在系统 PATH 中安装了对应的 CLI 智能体，并且可以通过终端命令直接调用（如在终端输入 claude --version）。
  • 认证失败：请重新登录你的智能体账户。注意，Orca 会为不同的智能体单独管理认证信息。
  • 性能问题：并行运行多个智能体会消耗较多 CPU 和内存。请根据你的机器配置，适当调整并行任务数量。

若遇到问题，可以通过以下渠道获取帮助：

  • 官方文档：访问 Docs → 获取详细指南。
  • 社区：加入 Discord 或关注 Twitter / X @orca_build 获取更新和支持。
  • 隐私设置：可以在设置中查看和禁用匿名使用数据收集。

总结

Orca 为同时使用多个 AI 编程助手提供了一个高效、专业的解决方案。通过以上步骤，你就可以开始利用并行智能体的能力，提升代码生成、审查和问题解决的效率。

如果你对某个特定配置（如设置 SSH 远程工作树，或集成特定智能体）有更深入的问题，建议查阅官方文档或加入其社区讨论。