国内网络友好Orca 是桌面应用，从官网或 GitHub Releases 下载安装包，安装本身不需要翻墙；运行时它只是在你本地启动你已有的 Agent CLI。模型侧沿用本站其他课程的 DeepSeek 等国内大模型方案即可。
下载安装
打开官网 https://www.onorca.dev 点击 Download，或直接访问 GitHub Releases（github.com/stablyai/orca/releases）：
| 平台 | 安装包 | 说明 |
|---|---|---|
| macOS | Apple Silicon / Intel | 已签名并公证；Electron 应用首次打开可能仍需确认 |
| Windows | installer | 安装后建议在 Settings → Terminal 把默认 shell 设为 PowerShell |
| Linux | AppImage / .deb | 两种格式都可用，选适合发行版的 |
Homebrew（macOS）：Orca 也发布为 Homebrew cask，跟随稳定版自动更新：
brew install --cask stablyai/orca/orca
brew upgrade --cask orca # 升级到最新稳定版
首次启动
第一次打开 Orca 时，它会：
- 请求访问你的 home 目录——为了添加仓库（可以在系统设置里随时收窄）
- 询问是否导入
~/.claude、~/.codex以及 Ghostty 终端设置——如果导入，你已有的 Claude Code / Codex 登录与配置会被自动识别，无需重新配置 - 进入一个空的落地页，等你添加第一个仓库
重要提示Orca 不做模型接入、不做登录代理——它读取你本地已经登录的 Claude Code / Codex 等 CLI 的凭据（
~/.claude、~/.codex）。所以请先按本站 Claude Code / Codex 课程完成对应 CLI 的安装与认证（包括对接 DeepSeek 的配置），Orca 启动 Agent 时会直接复用。更新机制
Orca 默认自动更新，跟踪 stable 稳定版频道。RC（release candidate）版先行发布新功能（常常每天一版）。
- Settings → General → Updates 里的
Check for Updates支持修饰键：Shift+点击—— 包含最新 RC 预发布版Cmd+点击（macOS）/Ctrl+点击（Win/Linux）—— 最新 perf 版
- 任何时候都能从 GitHub Releases 手动下载任意版本
- 不喜欢新版本？旧版永远在 Releases 页，Orca 不会强制降级破坏你的 worktree 数据
平台小贴士
- Windows：默认 shell 可在 PowerShell / CMD 间切换，多数人用 PowerShell；装了 WSL 也可以把 WSL 设为默认
- Linux：首次连接远程主机时需要
make、C++ 编译器与python3来编译终端原生模块，否则远程终端不可用（文件/git/编辑器仍正常） - 旧机器：内存里挂着几十个 Agent PTY 会吃资源，第 03 模块会讲休眠机制缓解
落地练习：安装并验证
- 下载并安装 Orca（对应你平台的安装包）
- 确认你已装好至少一个 Agent CLI（如
claude或codex命令可用） - 启动 Orca，观察首次启动引导的三步
- 在终端跑
command -v orca（装好桌面版后 CLI 会随附，本课第 12 节会用）
怎么判断做对了？——Orca 能正常启动并进入「添加仓库」的落地页，且系统里
claude/codex命令可执行。
卡住了怎么办？ 下载慢就换 GitHub Releases 直链；Windows 上找不到 CLI 就先用桌面应用，CLI 注册在高级课讲。
小结
- 三平台安装包从官网 / GitHub Releases 下载，macOS 另有 Homebrew cask
- 首次启动会导入
~/.claude/~/.codex，复用已有 Agent 登录 - Orca 自动更新稳定版，RC 版可用修饰键点击获取
- 它不接入模型，只编排你本地已有的 Agent CLI
下一节，我们认识 Orca 的界面。