Orca installiert, aber kein orca-Befehl: Prüfen Sie zuerst, ob es als orca-ide installiert wurde (Stand 2026-10)
Orca installiert sich nicht, oder das Terminal findet danach keinen Befehl: Meist liegen das an Befehlsnamen, am Homebrew-Installationsbefehl oder an der CLI-Registrierung. Unter Linux ist es orca-ide statt orca; Homebrew braucht den Befehl mit dem Tap; meldet die CLI command not found, wird sie unter Settings → General → Orca CLI registriert. SSH verbindet, startet aber kein Remote-Terminal, und die Handy-Kopplung schlägt fehl — die offiziellen Dokumente widmen jedem dieser Punkte einen Satz (geprüft am 2026-10-19).
Aktualisiert 2026-11-13
Richten Sie dieses Tool auf den QCode-Endpunkt — ein Key für Claude, GPT und chinesische Modelle.
- Bezahlung pro Token — aktuelle Preise unter /models
- Zahlung per Karte (Visa / Mastercard), Apple Pay, Google Pay oder Krypto
- Selbstbedienung: aufladen und sofort aktivieren
Ein paar Dinge vorab
Befehls- und Paketnamen
Offiziell wird die CLI unter Linux als orca-ide installiert und überschreibt den GNOME-Screenreader nicht; .deb und .rpm tragen denselben Namen. „Installiert, aber orca tut nichts“ ist also meist keine fehlgeschlagene Installation.
Der vollständige brew-Befehl
Das Cask für diese App ist stablyai/orca/orca, und der offizielle Installationsbefehl lautet brew install --cask stablyai/orca/orca, aktualisiert wird über den Cask-Befehl; dieses Cask folgt nur dem Stable-Kanal, RC-Builds erhalten Sie also über GitHub Releases oder „Nach Updates suchen“ in der App. Das schlichte orca ist seit 2026-09-01 deaktiviert, Grund: fails_gatekeeper_check.
Wo sich die CLI registriert
Wenn das Terminal den Befehl nicht findet, lautet die offizielle Abhilfe: CLI unter Settings → General → Orca CLI registrieren. Unter macOS landet dabei ein Shim in ~/.local/bin; danach prüfen Sie, ob dieses Verzeichnis im PATH Ihrer Shell liegt.
Paketformat ≠ Version
AppImage, .deb und .rpm installieren dieselbe App; offiziell unterscheidet sich nur, wie Updates zu Ihnen gelangen – das AppImage aktualisiert sich selbst an Ort und Stelle, bei .deb und .rpm meldet Orca die neue Version und gibt den Installationsbefehl aus.
Zur Klarstellung: dieselbe App, der Befehlsname ist nicht immer orca
Die offizielle Installationsseite widmet dem einen eigenen Unterabschnitt, und dessen Überschrift nennt den Befehlsnamen: im Text steht, dass unter Linux die Orca-CLI als orca-ide installiert wird, nicht als orca, weil der GNOME-Screenreader (er ist unter Ubuntu und anderen GNOME-Desktops standardmäßig dabei) bereits /usr/bin/orca belegt und Orca ihn nicht überschreibt; im selben Abschnitt werden auch die Paketnamen .deb und .rpm als orca-ide genannt, aus demselben Grund. Unter Linux ist „Ich habe es installiert und orca tut nichts“ also meist keine fehlgeschlagene Installation – dieser Pfad gehörte nie zu Orca. Die erneute Prüfung der Installationsseite am 2026-10-19 lässt die Formulierungen unverändert, und das letzte Release ist v1.4.230.
Am selben Tag gezählt
Die Seite „GitHub Releases latest“, abgerufen am 2026-10-19, liefert v1.4.230, veröffentlicht am 2026-10-19T06:30:00Z, mit Assets unter anderem für orca-macos-x64.dmg, orca-windows-setup.exe und orca-linux.AppImage. Der Snapshot vom 2026-09-23 lieferte noch v1.4.207, veröffentlicht am 2026-09-22T09:44:40Z. Die Lizenz lautet MIT laut der LICENSE-Datei des Repositorys (das Lizenzfeld der API stimmt überein). Zähler, die sich minütlich ändern, etwa Stars und Forks, bleiben aus dem Text dieser Seite heraus – sie gehören in die Vergleichstabelle auf der P4-Seite, in der jede Zahl ihren eigenen Abruftag trägt. Auf dem Handy läuft iOS über den App Store (der interne App-Name in diesem Eintrag ist orca-ide); für Android ist der offizielle Kanal app-release.apk auf der Releases-Seite plus eine kurze Installationsanleitung.
Zeitachse
2026-09-01: In den öffentlichen Metadaten von Homebrew ist dies das disable_date des Orca-Casks, und sein disable_reason lautet fails_gatekeeper_check. Der Abruf vom 2026-09-23 las disabled: true und deprecated: false, und die erneute Prüfung am 2026-10-20 liest dieselben beiden Zustände. Er wurde also nicht „durch Orca ersetzt“, sondern von Homebrew deaktiviert.
2026-09-22: Grundlage der Seite sind sechs offizielle Dokumentationsseiten (install, troubleshooting, ssh, mobile, android-apk, headless Linux server) und die README. 2026-10-19: Das letzte offizielle Release ist v1.4.230; Befehle, Pfade und Paketnamen richten sich nach dieser Dokumentation.
2026-10-19: Das letzte offizielle Release ist v1.4.230, veröffentlicht am 2026-10-19T06:30:00Z; dieselben Release-Notizen melden, dass Orca Server 2.0 bald kommt, während der aktuelle Remote Server weiterhin experimentell ist und Fehler enthalten kann. CLI-Namen, Paketnamen und Cask-Status ändern sich je nach Version, daher nennt jeder Abschnitt den Tag seiner Prüfung.
Selbst beheben vs. Dokumentation
Was die Doku festlegt
Geprüft am 2026-10-19; sieben Aussagen stimmen Wort für Wort mit offiziellen Seiten überein: 1) Unter Linux wird die Orca-CLI als orca-ide installiert, nicht als orca; 2) der GNOME-Screenreader belegt bereits /usr/bin/orca, und Orca überschreibt ihn nicht; 3) der Installationsbefehl ist der mit dem Tap, der Update-Befehl der mit dem Cask, und dieser Cask folgt dem Stable-Kanal; 4) jedes Release enthält ein AppImage, ein .deb und ein .rpm, für x64 wie für arm64; 5) alle drei enthalten dieselbe App, unterschiedlich ist nur, wie Updates bei Ihnen anlangen; 6) bei command not found lautet die Lösung, die CLI unter Settings → General → Orca CLI zu registrieren, und unter macOS landet der Shim in ~/.local/bin; 7) das Angebot zur Handy-Kopplung enthält Gerätekennungen und E2EE-Material und gehört nur zum Ziel-Client. Die offizielle Installationsseite schreibt außerdem, dass Orca eine Desktop-App ist, deren Builds je nach Plattform von GitHub kommen, und dass der macOS-Build signiert und notariert ist, sodass beim ersten Start eine Bestätigung abgefragt werden kann.
⚠️ Häufige Fehlschlüsse
Erstens: „orca eingeben bringt nichts, also ist es nicht installiert“. Unter Linux hieß der Befehl nie orca; die offizielle Seite sagt ausdrücklich, dass er den GNOME-Screenreader nicht überschattet – prüfen Sie daher zuerst orca-ide und PATH. Zweitens: „orca wurde aus brew entfernt, also kann Homebrew Orca nicht installieren“. Deaktiviert ist der gleichnamige Cask ohne Tap (deaktiviert seit 2026-09-01, Grund: fails_gatekeeper_check, bei der erneuten Prüfung am 2026-10-20 weiterhin deaktiviert); das Tap-Paket stablyai/orca/orca ist dieser Weg, die erste Zeile der offiziellen Installationsseite. Drittens: „SSH verbindet, also funktioniert es“. Die offizielle Fehlerbehebungsseite trennt Dateien und Terminals in zwei Dinge und führt einen Fall gesondert auf: Über SSH werden Dateien übertragen, ein ganzer Ordner aber nicht – dafür braucht es rekursives SFTP, und über den systemeigenen sftp-Kanal funktioniert womöglich nur die Hälfte (geprüft am 2026-09-22; Snapshots unter Quellen). Die erneute Prüfung am 2026-10-20 zeigt: Die offizielle Formulierung ist unverändert, all das gilt also weiterhin.
Falsche Installation oder fehlende
Zuerst Befehl und Installationsweg
Der Name: Liefert which orca-ide etwas zurück, und liegt ~/.local/bin in Ihrem PATH? Der Kanal: Haben Sie unter macOS den Cask mit Tap oder die .dmg von GitHub genommen? Beide sind stabil, aber nur der Cask folgt brew upgrade. Stimmen Name und Kanal, erledigen sich die meisten Meldungen „command not found“ von selbst. Ein weiterer Fall gehört zu diesem Schritt (Stand 2026-11-12). Die Meldung: Der Befehl ist vorhanden, bricht aber sofort mit „Unable to determine Orca.app path from symlink: /usr/local/bin/orca“ ab. Die Ursache: Unter macOS ist der Befehl ein symbolischer Link – der Standardpfad der App dafür ist /usr/local/bin/orca – und er muss in das Bundle unter Orca.app/Contents/Resources/bin/orca auflösen; der Launcher schneidet seinen eigenen aufgelösten Pfad bei .app ab, um dieses Bundle zu finden. Ein Link, der außerhalb eines Orca.app auflöst, gibt daher dieselbe Zeile aus. Der in Issue #19120 erfasste Fall ist ein Link, den Ihr Konto nicht lesen kann: 1.4.197 hat ihn mit root als Eigentümer und im Modus lrwx------ veröffentlicht, und macOS prüft bei readlink() die Rechte des symbolischen Links selbst, sodass ein korrektes Ziel trotzdem nicht aufgelöst wurde. Die Lösung: unter Settings → General → Orca CLI erneut registrieren. Nach der Korrektur vom 2026-10-16 veröffentlicht eine neue Registrierung den Link als 0755, und ein nicht lesbarer Link aus einer älteren Version wird als „cannot be read. Register again to repair it.“ gekennzeichnet. Unter einer älteren Version ist der einmalige Ausweg, den das Issue selbst nennt, sudo chmod -h 755 /usr/local/bin/orca. Danach sollte ls -l lrwxr-xr-x anzeigen, wie bei den anderen Befehlen in diesem Verzeichnis.
Dann: Signatur, Remote-Host, Image
Signatur und Freigabe: Der offizielle macOS-Abschnitt hält fest, dass der Build signiert und notarisiert ist und der erste Start weiterhin eine Bestätigung verlangen kann – bei Electron-Apps normal. Der Remote-Rechner: Wenn SSH verbindet, aber kein Terminal startet, sollen Sie laut Doku prüfen, ob auf dem Remote-Rechner Node vorhanden ist und er bei der erstmaligen Relay-Installation Netzwerkzugriff hat; unter Linux zusätzlich make, g++/clang++, python3, danach einmal neu verbinden. Das minimale Image: Ein Server ohne Desktop braucht Xvfb und die gemeinsamen Bibliotheken, gegen die Electron linkt – es fehlen die Bibliotheken, nicht Orca selbst.
Installationsweg wählen
macOS: Die offizielle Zeile ist die mit dem Tap, brew install --cask stablyai/orca/orca, und Upgrades laufen über brew upgrade --cask orca; laut Dokumentation folgt dieses Cask dem Stable-Kanal, RC-Builds erhalten Sie also über GitHub Releases oder „Nach Updates suchen“ in der App. Der schlichte Cask-Name orca gehört einem anderen Artefakt: Die öffentlichen Homebrew-Metadaten, abgerufen am 2026-09-23, lauten disabled: true, disable_date 2026-09-01, disable_reason fails_gatekeeper_check (nicht aus dem Verzeichnis entfernt, und deprecated ist weiterhin false), und bei der erneuten Prüfung am 2026-10-20 weiterhin disabled: true, deprecated: false. Linux: Offiziell liefert jedes Release drei Pakete, AppImage, .deb und .rpm, für x64 wie für arm64, und alle drei enthalten dieselbe App – unterschiedlich ist nur, wie Updates bei Ihnen ankommen: Nur das AppImage aktualisiert sich selbst, .deb und .rpm melden lediglich die neue Version und geben den Installationsbefehl aus. Der Befehlsname lautet orca-ide: Die Pakete .deb und .rpm legen ihn unter /usr/bin/orca-ide ab, beim AppImage registrieren Sie ihn unter Settings → General → Orca CLI, und der Shim landet in ~/.local/bin, also prüfen Sie, ob dieses Verzeichnis im PATH liegt. Ältere Versionen stehen in den GitHub Releases. Headless-Server haben eine eigene offizielle Seite: Installieren Sie zuerst Xvfb sowie die gemeinsam genutzten Bibliotheken, gegen die Electron linkt. Die Arch-Zeile lautet yay -S stably-orca-bin (oder stably-orca-git, aus dem Quellcode gebaut).
Wo QCode ins Spiel kommt
Auf der Installationsseite gibt es keine direkte Verbindung zu QCode: Orca liefert kein Modell mit und hält keine Zugangsdaten, und nach der Installation kommt der Modellzugriff weiterhin aus der eigenen Konfiguration der gestarteten Agent-CLI. Verbindend ist, worauf dieser Key zeigt: Bei einem eigenen Endpunkt ändern Sie base_url und Key dieser CLI. Dass Orca selbst nicht startet, das Remote-Terminal sich nicht öffnet und das Handy nicht gekoppelt wird, ist Sache der Installation; die Endpunkt-Konfiguration steht im Leitfaden für benutzerdefinierte Endpunkte dieser Website. Auf QCode-Seite wird pro Token abgerechnet, die Preise der einzelnen Modelle stehen auf /models. Sie wollen zuerst ein paar neuere Modelle auf QCode testen? «Nutzungspakete» starten bei $4 für ein einmaliges Kontingent, das Sie innerhalb von 7 Tagen nutzen.
FAQ
orca unter Linux eingegeben – keine Reaktion. Installation fehlgeschlagen?
In der Regel ist sie installiert. Die offizielle Installationsseite hat dafür einen eigenen Abschnitt: Unter Linux installiert sich die Orca-CLI als orca-ide, da der mitgelieferte GNOME-Screenreader /usr/bin/orca bereits belegt und Orca ihn nicht überschreibt; bei den Namen von .deb und .rpm gilt derselbe Grund. Ein stilles orca ist also meist eine Namensfrage und keine fehlgeschlagene Installation.
Warum meldet brew install --cask orca, dass dieses Cask deaktiviert ist?
Weil der Cask orca ohne Tap nicht der Release-Kanal dieses Projekts ist. Die öffentlichen Metadaten von Homebrew zeigen am 2026-09-23 disabled: true, disable_date 2026-09-01 und disable_reason fails_gatekeeper_check, während deprecated weiterhin false ist; die erneute Prüfung am 2026-10-20 liest dieselben Werte: disabled ist weiterhin true, deprecated weiterhin false, disable_date und disable_reason unverändert. Die offizielle Installationsseite nennt den getappten Befehl (der Cask-Pfad hinter dem Tap lautet stablyai/orca/orca), aktualisiert wird über den Cask-Befehl, und sagt, dass dieser Cask dem stabilen Kanal folgt.
AppImage, deb oder rpm – welches wählen?
Die offizielle Formulierung: Jedes Release erscheint in drei Paketformaten (sowohl x64 als auch arm64 sind dabei); in allen dreien steckt dieselbe App, unterschiedlich ist nur, wie Updates bei Ihnen anlangen – Sie wählen also danach, „wie Updates zu Ihnen gelangen“, nicht nach Funktionsunterschieden. Für Arch nehmen Sie stably-orca-bin oder stably-orca-git aus dem Quellcode.
Das Terminal meldet für die Orca CLI: command not found – wo behebe ich das?
Die offizielle Troubleshooting-Seite nennt den Registrierungsschritt: CLI unter Settings → General → Orca CLI registrieren. Unter macOS legt sie einen Shim in ~/.local/bin ab; bestätigen Sie dann, dass dieses Verzeichnis im PATH Ihrer Shell liegt. Mit anderen Worten: Eine Neuinstallation ist nicht die Lösung – es fehlt dieser eine Eintrag im PATH.
SSH verbindet, aber das Remote-Terminal startet nicht – was prüfe ich zuerst?
Die offizielle Fehlerbehebungsseite nennt mehrere Bedingungen: Auf dem Remote-Rechner ist Node vorhanden und er hat bei der ersten Relay-Installation Netzwerkzugriff; auf einem Linux-Remote-Rechner kommen make, g++/clang++, python3 als C/C++-Toolchain hinzu; verbinden Sie sich nach der Installation einmal neu, damit Orca seine nativen Module neu installiert. Eine weitere Seite (Headless-Linux-Server) ergänzt die serverseitige Voraussetzung: Ein Server-Image ohne Desktop bringt die gemeinsamen Electron-Bibliotheken nicht mit, daher werden Xvfb und diese Bibliotheken zusammen installiert.
Das Angebot zur Handy-Kopplung sieht in Ordnung aus – warum verbindet es trotzdem nicht?
Die offizielle Headless-Seite teilt die Ursache in zwei Ebenen. Das Kopplungsangebot selbst trägt Geräteberechtigungsnachweise und Material für Ende-zu-Ende-Verschlüsselung, es gehört also nur zum vorgesehenen Client und nicht in Zugriffsprotokolle eines Proxys. Eine fehlgeschlagene Verbindung liegt meist auf der Netzwerkseite: boundEndpoint ist die Adresse, auf der der Prozess lauscht, advertisedEndpoint die, die der Client anwählt; laut Dokumentation kann sich auch ein gültig aussehendes Angebot nicht verbinden, wenn DNS, Firewall, Docker-Port-Veröffentlichung, Tailscale-Richtlinie oder ein Reverse Proxy advertised nicht auf bound weiterleitet.
Quellen
Offizielle Dokumentation (am 2026-09-22 wortgetreu lokal archiviert): Die fünf Seiten install, troubleshooting, ssh, mobile und android-apk liegen unter https://raw.githubusercontent.com/stablyai/orca/HEAD/docs/site/content/docs/<page-name>.mdx; die beiden Seiten headless Linux server und linux glibc compatibility liegen unter docs/reference/; die README befindet sich im Repository-Stammverzeichnis. Die Homebrew-Seite nutzt die öffentlichen Metadaten unter https://formulae.brew.sh/api/cask/orca.json; die Release- und Asset-Namen stammen von https://api.github.com/repos/stablyai/orca/releases/latest. Alles wurde über das öffentliche Internet abgerufen, ohne angemeldeten Zustand.
Zuerst die CLI sichtbar machen
Empfohlene Debug-Reihenfolge: Ist orca-ide im PATH → CLI-Registrierung (Settings → General → Orca CLI) → Node und Toolchain auf dem Remote-Rechner → erst dann der Modell-Endpunkt. Offizieller Wortlaut geprüft am 2026-10-19.
Weiterführende Artikel
Was Orca ADE ist und parallele Worktrees
Die Mechanik steht dort: was es ist, was Parallelität spart, was Sie dafür aufgeben. Hier geht es um Installation und Verbindungsprobleme.
Eigener API-Key und Base URL in Cursor
Wo Keys in Settings → Models hingehören, welcher Bereich die Base URL ändert, warum Tab Ihren Key nicht nutzt, und das QCode-Setup.
GitHub Copilot BYOK für Claude und GPT
BYOK-Einrichtung für VS Code Custom Endpoint und Copilot CLI: URL-Formen, Tarifvoraussetzungen und die JetBrains-Grenze.
Krypto-Zahlungsleitfaden
Neun Coins, 56 Netzwerke, keine Plattformgebühr für KI-Coding-API-Guthaben.
Diese Seite gibt offene Orca-Doku und Repo-Inhalte von Stably wieder. Keine Verbindung zu Orca oder Stably, keine Empfehlung. Befehlsname, Cask-Status, Paketformate sowie SSH- und Handy-Verhalten richten sich nach den am 2026-10-19 erfassten offiziellen Seiten; ändert sich der offizielle Wortlaut, gilt dieser. Verfügbarkeit und Preise der Modelle stehen unter /models.