官方 docs · 核于 2026-10-19

Orca 装完之后找不到 orca 命令：先确认它装成了 orca-ide（2026-10 核对）

Orca 装不上、装完在终端里敲不出命令，症结通常在命令名、Homebrew 安装命令和 CLI 注册这几处：Linux 上它装成 orca-ide 而不是 orca，Homebrew 要用带 tap 的那条命令，CLI 提示 command not found 时要在 Settings → General → Orca CLI 里注册；SSH 连上但远端终端起不来、手机配对连不上这两件，官方 docs 也各有一句（核于 2026-10-19）。

更新于 2026-10-22

把这个工具接到 QCode 端点：一把 key 调 Claude、GPT 与国产模型。

按 token 计费，实时单价见 /models
支付宝、微信支付、信用卡、加密货币均可付款
充值后自助开通、立刻生效

创建账号查看定价

#orca-ide 命令名#带 tap 的 brew#AppImage 自更新#SSH 与手机配对

排障前先知道的几点

orca-ide

命令行名与包名

官方写明 Linux 上的 Orca CLI 装成 orca-ide，不去遮蔽 GNOME 自带的读屏软件；.deb 与 .rpm 用的是同一个名字。所以「装完敲 orca 没反应」多半不是没装上。

带 tap

brew 那条要写全

stablyai/orca/orca 才是这个 cask，官方给的安装命令是 brew install --cask stablyai/orca/orca，升级用带 cask 的那一条命令；这个 cask 只跟 stable 通道，要 RC 版得去 GitHub Releases 或应用内的 Check for Updates。裸 orca 那个自 2026-09-01 起 disabled，原因是 fails_gatekeeper_check。

~/.local/bin

CLI 注册在哪

终端提示命令找不到时，官方的处置是在 Settings → General → Orca CLI 里注册 CLI；macOS 上装出来的是 ~/.local/bin 里的 shim，接着确认这个目录在 shell 的 PATH 里。

同一应用

包格式≠不同版本

AppImage、.deb、.rpm 装的是同一个应用，官方说差别只在更新怎么送达：AppImage 自己原地更新，.deb 与 .rpm 由 Orca 提示版本并给出安装命令。

先说清楚：装的是同一个应用，命令名不一定叫 orca

官方 install 页把这件事单独立了一个小节，标题写的就是命令名这一节：正文说 Linux 上 Orca CLI 装成 orca-ide 而不是 orca，理由是 GNOME 自带的读屏软件（Ubuntu 等 GNOME 桌面默认就装着）已经占着 /usr/bin/orca，Orca 不去遮蔽它；同一节里 .deb 与 .rpm 的包名也一并交代了，写的还是 orca-ide，理由相同。所以「装完敲 orca 没反应」在 Linux 上多半不是安装失败，而是这条命令本来就不叫 orca。2026-10-19 复核官方 install 页，这几处表述都没变，最新 release 是 v1.4.230。

当天数得出来的

2026-10-19 抓到 GitHub Releases 的 latest 是 v1.4.230，published 2026-10-19T06:30:00Z，资产里同时有 orca-macos-x64.dmg、orca-windows-setup.exe 与 orca-linux.AppImage 这几类构建。2026-09-23 抓到的那一版是 v1.4.207，published 2026-09-22T09:44:40Z。许可按仓库 LICENSE 文件本体核为 MIT（API 的 license 字段同值）。star、fork 这类按分钟漂的计数不放本页正文——P4 那张横评表才放，且每个数都带当天抓取时刻。手机侧 iOS 走 App Store（列表里那个 app 的内部名是 orca-ide），Android 官方给的是 releases 上的 app-release.apk 与一页安装指引。

时间线

2026-09-01

2026-09-01：Homebrew 公开元数据里 orca 这个 cask 的 disable_date 就是这天，disable_reason 为 fails_gatekeeper_check；2026-09-23 抓到时该 cask 的 disabled 是 true、deprecated 是 false，2026-10-20 复核仍是这两个状态。也就是说它不是「被 Orca 取代」，是被 Homebrew 停了。

2026-09-22

2026-09-22：本页引用的官方文档是 install、troubleshooting、ssh、mobile、android-apk、headless Linux server 这六页与 README。2026-10-19：官方最新 release 是 v1.4.230；页面里的命令、路径与包名以这批文档为准。

2026-10-19

2026-10-19：官方最新 release 是 v1.4.230，published 2026-10-19T06:30:00Z；同一批 release 说明写着 Orca Server 2.0 即将到来，当前的 Remote Server 仍属实验性质、可能还有 bug。命令行名、包名、cask 状态这类都会随版本变，所以每个小节都标了核对于哪天。

能自己排 vs 得看官方

官方文档写明的

核于 2026-10-19，能在官方页面逐字对上的有七条：1) Linux 上 Orca CLI 装成 orca-ide 而不是 orca；2) GNOME 自带的读屏软件已经占着 /usr/bin/orca，Orca 不去遮蔽它；3) 安装命令是带 tap 的那一条，升级命令是带 cask 的那一条，这个 cask 只跟 stable 通道；4) 每个发布都出 AppImage、.deb、.rpm 三种 Linux 包，x64 与 arm64 都有；5) 三种包装的是同一个应用，差别只在更新怎么送达；6) command not found 的解法是在 Settings → General → Orca CLI 注册 CLI，macOS 的 shim 落在 ~/.local/bin；7) 手机那条 offer 是一份含设备凭据与 E2EE 材料的能力，只该发给目标客户端。另外官方 install 页还写着 Orca 是桌面应用、构建按平台从 GitHub 取，macOS 版已签名公证，首次启动仍可能要求确认。

⚠️ 常见的想当然

一，「敲 orca 没反应就是没装上」：Linux 上它本来就不叫 orca，官方明写不遮蔽 GNOME 读屏软件，先看 orca-ide 与 PATH。二，「brew 里 orca 被下架了所以 Orca 不能用 Homebrew 装」：被停的是那个没带 tap 的同名 cask（自 2026-09-01 起 disabled，原因是 fails_gatekeeper_check，2026-10-20 复核仍然 disabled），带 tap 的 stablyai/orca/orca 才是这条路，官方 install 页第一句就是它。三，「SSH 能连就能干活」：官方 troubleshooting 页把 files 与 terminals 分成两件事，还单列了一条——SSH 能传文件，但单独下整个文件夹不行；整目录下载要递归 SFTP，系统自带的 sftp 通道上可能只成一半。（2026-09-22 核，快照见来源栏）2026-10-20 再核一次，官方页面没改口，这几条仍然成立。

「装错了」与「真没装上」怎么分

先查命令与安装路径

名字：which orca-ide 有没有东西、PATH 里有没有 ~/.local/bin。通道：macOS 用的是带 tap 的 cask 还是 GitHub 上的 .dmg，两者都是稳定版，但只有前者会跟着 brew upgrade 走。名字和通道都对上之后，大多数「命令找不到」会自己消失。

再查签名、远端与镜像

签名与放行：官方 macOS 一节写明这个版本已签名公证，首次启动仍可能要求确认，这在 Electron 应用上是正常现象。远端机器：SSH 连上但终端起不来，官方让确认远端有 Node、首次 relay 安装时能出网，Linux 上还要有 make、g++/clang++、python3，装完重连一次。最小镜像：无图形界面的服务器要自己补上 Xvfb 与 Electron 依赖的共享库，缺的是共享库而不是 Orca 本体。

装的时候选哪条路

macOS：官方给的是带 tap 的那条 brew install --cask stablyai/orca/orca，升级是 brew upgrade --cask orca；这个 cask 跟的是 stable 通道，要 RC 构建得走 GitHub Releases 或应用内的 Check for Updates。裸 orca 这个 cask 名被别的产物占着：Homebrew 的公开元数据 2026-09-23 抓到的是 disabled: true、disable_date 2026-09-01、disable_reason 是 fails_gatekeeper_check（不是「下架」，deprecated 仍然是 false）；2026-10-20 复核时仍是 disabled: true、deprecated 仍是 false。Linux：官方在 install 页列出 AppImage、.deb、.rpm 三种包（x64 与 arm64 都有），装的是同一个应用，差别只在更新怎么送达——AppImage 自己原地更新，.deb 与 .rpm 由 Orca 提示版本并给出安装命令；命令行名是 orca-ide，.deb 与 .rpm 装完会把它放到 /usr/bin/orca-ide，用 AppImage 则要在 Settings → General → Orca CLI 里注册，装出来的 shim 在 ~/.local/bin，记得确认它在 PATH 里。旧版本在 GitHub Releases 上。无图形界面的服务器另有官方一页：先装 Xvfb 与 Electron 要链的共享库。Arch 那条路是 yay -S stably-orca-bin，或者用从源码构建的 stably-orca-git。

这和 QCode 有什么关系

装这一侧和 QCode 没有直接关系：Orca 不含模型，也不替你保管凭据，装完之后模型访问仍然来自被启动的那个 agent CLI 自己的配置。关系在于那把 key 指到哪——走自有端点时改的是那个 CLI 的 base_url 与 key；Orca 本身起不来、远端终端开不了、手机配不上，都是安装这一侧要解决的事；端点写法见站内那篇自定义端点指南。QCode 侧按 token 计费，各模型单价见 /models。想先在 QCode 上换几个新模型试试？按量包 ¥26 起买一笔额度，7 天内用完为止（人民币充值 ¥30 起）。

常见问题

Linux 上敲 orca 没反应，是安装失败吗？

通常不是没装上。官方 install 页专门为命令行名开了一节：Linux 上 Orca CLI 装成 orca-ide，因为 GNOME 自带的读屏软件已经占了 /usr/bin/orca，Orca 不去遮蔽它；.deb 与 .rpm 的包名也是同一个道理。敲 orca 没反应，多半是命令本来就不叫 orca。

为什么 brew install --cask orca 报这个 cask 被禁用？

因为 orca 这个不带 tap 的 cask 不是本项目的发布通道。Homebrew 公开元数据 2026-09-23 显示它 disabled: true、disable_date 2026-09-01、disable_reason 为 fails_gatekeeper_check（同时 deprecated 仍是 false），2026-10-20 复核：disabled 仍是 true、deprecated 仍是 false，disable_date 与 disable_reason 也没有变。官方 install 页给的是带 tap 的那条（tap 后面的 cask 路径写作 stablyai/orca/orca），升级用带 cask 的那一条命令，并说明该 cask 跟 stable 通道。

AppImage、deb、rpm 该选哪个？

官方原话是每个发布都出这三种包（x64 与 arm64 都有），装的是同一个应用，差别只在更新怎么送达，所以选型看的是这一条 —— 也就是说选型的依据是「更新怎么送到你手上」，不是功能差异。要 Arch 那条就走 stably-orca-bin 或从源码构建的 stably-orca-git。

终端里提示 Orca CLI 是 command not found，该去哪里修？

官方 troubleshooting 页给的是注册这一步：在 Settings → General → Orca CLI 里注册 CLI。macOS 上它会往 ~/.local/bin 放一个 shim，接着确认这个目录在你的 shell PATH 里。换句话说这不是重装能解决的，缺的是 PATH 里那一条。

SSH 连上了但远端终端开不起来，先查什么？

官方 troubleshooting 页列了几点：确认远端有 Node、首次 relay 安装时能出网；Linux 远端补上 make、g++/clang++、python3 这套 C/C++ 工具链；装完重连一次，让 Orca 重装它的原生模块。另一页（headless Linux server）补了服务器侧的前提：无图形界面的服务器镜像不带 Electron 的共享库，要连 Xvfb 与那些共享库一起装。

手机配对那张 offer 看起来没问题，为什么连不上？

官方 headless 页把原因拆成两层：配对用的 offer 本身带着设备凭据与端到端加密材料，只该发给目标客户端，也不要落到代理访问日志里；而连不上通常是网络那侧——boundEndpoint 是进程在听的地址，advertisedEndpoint 是客户端要拨的地址，官方写明只要 DNS、防火墙、Docker 端口发布、Tailscale 策略或反向代理没把 advertised 路由到 bound，一张看起来合法的 offer 照样连不上。

信息来源

官方文档（2026-09-22 原样抓回本地归档）：install、troubleshooting、ssh、mobile、android-apk 五页在 https://raw.githubusercontent.com/stablyai/orca/HEAD/docs/site/content/docs/<页名>.mdx；headless Linux server 与 linux glibc 兼容两页在 docs/reference/ 下；README 在仓库根。Homebrew 侧用 https://formulae.brew.sh/api/cask/orca.json 的公开元数据；发布与资产名用 https://api.github.com/repos/stablyai/orca/releases/latest。全部为公网抓取，不带任何登录态。

先让 CLI 被认出来

排障顺序建议：orca-ide 在不在 PATH → CLI 注册（Settings → General → Orca CLI）→ 远端 Node/工具链 → 再谈模型端点。官方口径核于 2026-10-19。

创建账号

查看模型与实时单价查看套餐