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 — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Несколько вещей перед разбором
Имя команды и пакета
Официально: в Linux Orca CLI ставится как orca-ide и не перекрывает экранную читалку GNOME; у .deb и .rpm то же имя. Так что «поставил, а orca не работает» — обычно не провал установки.
Полная команда brew
Нужный cask — это stablyai/orca/orca, и официальная команда установки — brew install --cask stablyai/orca/orca, обновление идёт через cask-команду; этот cask следует только каналу stable, а сборки RC берутся из GitHub Releases или пункта Check for Updates в самом приложении. cask «просто orca» с 2026-09-01 в статусе disabled, причина — fails_gatekeeper_check.
Место регистрации CLI
Когда терминал не находит команду, официальное решение — зарегистрировать CLI в Settings → General → Orca CLI. На macOS там появляется shim в ~/.local/bin, после чего проверьте, что этот каталог есть в 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. Повторное чтение install-страницы 2026-10-19 оставляет формулировки прежними, а последний release — v1.4.230.
Что насчитали в тот день
Страница latest в GitHub Releases, снятая 2026-10-19, отдаёт 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. Лицензия — MIT по самому файлу LICENSE в репозитории (поле license в API совпадает). Счётчики, которые меняются по минутам — звёзды и форки, — на эту страницу не выносим: для них есть сравнительная таблица на странице P4, где у каждого числа стоит дата выгрузки. На телефонах iOS идёт через App Store (внутреннее имя в листинге — orca-ide), для Android официально выложены app-release.apk на странице релизов и короткая инструкция по установке.
Хронология
2026-09-01: в публичных метаданных Homebrew у cask с именем orca disable_date именно этот, а disable_reason — fails_gatekeeper_check. При получении 2026-09-23 стояло disabled: true и deprecated: false, и повторная сверка 2026-10-20 читает те же два состояния. То есть его не «заменил Orca», его отключил Homebrew.
2026-09-22: источник страницы — шесть страниц официальной документации (install, troubleshooting, ssh, mobile, android-apk, headless Linux server) и README. 2026-10-19: последний официальный релиз — v1.4.230; команды, пути и имена пакетов на странице опираются на эту документацию.
2026-10-19: последний официальный release — v1.4.230, published 2026-10-19T06:30:00Z; в тех же notes о релизе сказано, что Orca Server 2.0 скоро появится, а текущий Remote Server всё ещё экспериментальный и может содержать ошибки. Имена команд, пакетов, статус cask меняются с версией, поэтому в каждом разделе указана дата сверки.
Что сам, что по докам
Что написано в документации
Сверено 2026-10-19; с официальными страницами дословно сходятся семь пунктов: 1) в Linux Orca CLI ставится как orca-ide, а не orca; 2) скринридер GNOME уже занимает /usr/bin/orca, и Orca его не перекрывает; 3) команда установки — вариант с tap, обновление — cask-команда, и этот cask следует каналу stable; 4) каждый release выходит в трёх пакетах — AppImage, .deb и .rpm, и для x64, и для arm64; 5) в них одно и то же приложение, различается только способ доставки обновлений; 6) при command not found помогает регистрация CLI в Settings → General → Orca CLI, на macOS shim попадает в ~/.local/bin; 7) предложение сопряжения с телефоном содержит учётные данные устройства и материалы E2EE, и его следует передавать только целевому клиенту. Официальная страница install также пишет, что Orca — настольное приложение, сборки которого берутся с GitHub по платформам, и что сборка для macOS подписана и заверена, так что при первом запуске может быть запрос подтверждения.
⚠️ Частые заблуждения
Первое: «ввёл orca — тишина, значит не установлено». В Linux команду так и не называли orca; официальная страница прямо говорит, что Orca не перекрывает скринридер GNOME, так что сначала проверьте orca-ide и PATH. Второе: «orca убрали из brew, значит Homebrew не поставит Orca». Отключён одноимённый cask без tap (disabled с 2026-09-01, причина — fails_gatekeeper_check, на повторной сверке 2026-10-20 он всё ещё disabled), а вот cask с tap, stablyai/orca/orca, — это и есть путь, первая же строка официальной страницы установки. Третье: «SSH подключился — значит работает». Официальная страница разбора разделяет файлы и терминалы на две вещи и выносит отдельный случай: по SSH файлы передаются, но забрать папку целиком он не может — нужна рекурсивная SFTP, и по системному каналу sftp может сработать только половина (проверено 2026-09-22, снимки в разделе источников). Повторная сверка 2026-10-20: формулировки официальных страниц не изменились, так что всё это по-прежнему верно.
Не то или не установлено
Сначала команда и путь установки
Имя: возвращает ли which orca-ide хоть что-то и есть ли ~/.local/bin в PATH. Канал: на macOS вы поставили cask с tap или .dmg с GitHub; оба из стабильных, но за brew upgrade идёт только cask. Когда имя и канал совпадают, большинство случаев «command not found» исчезает само.
Дальше: подпись, удалённый хост, образ
Подпись и допуск: в официальном разделе 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» в самом приложении. Имя cask без tap, просто orca, занято другим продуктом: в публичных метаданных 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: по официальным данным каждый релиз выходит в трёх пакетах — AppImage, .deb и .rpm, и для x64, и для arm64, — и устанавливает одно и то же приложение, различается только то, как обновление до вас доходит: AppImage обновляется сам, а .deb и .rpm только сообщают о новой версии и дают команду установки. Имя команды — 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 не поставляет моделей и не хранит ваши учётные данные, и после установки доступ к моделям по-прежнему идёт из конфигурации запущенного CLI агента. Связь в том, куда смотрит этот ключ: на своём эндпоинте вы меняете base_url и ключ именно того CLI; то, что Orca сам не запускается, удалённый терминал не открывается и телефон не сопрягается, решается на стороне установки; как писать эндпоинт, описано в руководстве по своему эндпоинту на сайте. Со стороны QCode оплата идёт за токены, а цены моделей указаны на /models. Хотите сначала попробовать на QCode несколько новых моделей? «Разовые пакеты» — от $4 за разовую квоту, которую вы используете за 7 дней.
Частые вопросы
Набрал orca на Linux — тишина: установка не удалась?
Обычно установка прошла успешно. На официальной странице install имя команды вынесено в отдельный раздел: в Linux Orca CLI ставится как orca-ide, ведь экранный диктор, входящий в GNOME, уже занимает /usr/bin/orca, и Orca его не перекрывает; пакеты .deb и .rpm названы по той же причине. Так что «orca не отвечает» — в основном вопрос имени команды, а не отсутствия установки.
Почему brew install --cask orca сообщает, что этот cask отключён?
Потому что cask orca без тапа — не канал релизов этого проекта. Открытые метаданные 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 даёт команду с тапом (путь 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 даёт шаг регистрации: зарегистрировать CLI в Settings → General → Orca CLI. На macOS там появляется shim в ~/.local/bin, а дальше проверьте, что этот каталог есть в PATH вашей оболочки. Иными словами переустановка тут не поможет: не хватает одной записи в PATH.
SSH подключается, а удалённый терминал не запускается — что проверять первым?
Официальная страница troubleshooting называет несколько условий: на удалённом хосте есть Node и есть выход в сеть при первой установке relay; для удалённого Linux добавьте связку инструментов C/C++ — make, g++/clang++, python3; установив, переподключитесь один раз, чтобы 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 compatibility, — в каталоге 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.
Похожие материалы
Что такое Orca ADE и параллельные worktree
Механика — там: что это, что экономит параллельная работа и чем за неё платят. Здесь — установка и сбои подключения.
Свой API-ключ и Base URL в Cursor
Куда вводить ключи в Settings → Models, где меняется Base URL, почему Tab не использует ваш ключ и как подключить QCode.
GitHub Copilot BYOK для Claude и GPT
Настройка BYOK в VS Code Custom Endpoint и Copilot CLI: формы URL, требования к тарифу и ограничение JetBrains.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Это пересказ публичной документации и репозитория Orca от Stably; связи с Orca и Stably нет, одобрения тоже. Имя команды, статус cask, форматы пакетов и поведение SSH/смартфона только по официальным страницам, снятым 2026-10-19; новая официальная формулировка важнее. Доступность моделей и цены указаны на /models.