NCA Social Media
Aktualisiert:
Autor:
Roland Golla
Grünes Terminal Fenster mit OPENCODE MAC Schriftzug, Apple Notebook links, Rakete rechts

OpenCode auf dem Mac installieren: Der Befehl läuft, das Programm fehlt

OpenCode ist ein KI Helfer, der in einem schwarzen Fenster auf deinem Mac läuft. Dieses Fenster heißt Terminal. Diese Anleitung bringt dich in vier Schritten dahin. Du brauchst kein Vorwissen.

Auf dem Mac hast du es leichter als unter Windows. Der offizielle Befehl mit bash läuft sofort durch. Genau da beginnt aber die Mac Falle. Die Installation meldet Erfolg, und beim ersten Start kommt das:

Code: 
          
zsh: command not found: opencode

Das ist kein Fehler von dir. Das Programm liegt auf der Platte, nur in einem Ordner, den dein Mac nicht durchsucht. Wir gehen deshalb den Weg über Homebrew. Der legt alles dorthin, wo dein Mac auch nachschaut.

Zweite Stolperfalle: Macs mit Apple Chip nutzen andere Pfade als alte Intel Macs. Wir klären das im ersten Schritt, danach passt der Rest von allein. Wir nutzen diese Anleitung auch in unseren Vibe Coding Schulungen, damit im Training keine Zeit fürs Setup draufgeht. Für Windows Rechner gibt es die OpenCode Anleitung für Windows.

Inhalt

OpenCode auf dem Mac mit NCA: Schnelle Hilfe vom Experten

Wir arbeiten jeden Tag mit Terminal Agents. OpenCode und Claude Code gehören zu unserem Stack, dazu lokale Modelle über Ollama und Qwen3 Coder. Wir wissen also genau, wo Mac Nutzer hängen bleiben.

Wir holen Teams beim Onboarding ab, begleiten im 1:1 Mentoring und in der Vibe Coding Beratung. Danach geht es um Best Practices, CI/CD Pipelines und Security bei KI Code. Läuft ein Projekt aus dem Ruder, helfen wir beim Retten von Vibe Coding Projekten.

Lass uns sprechen

Finde das passende Angebot für dein Projekt

Anfrage-Konfiguration

Starten Sie Ihre Anfrage

Projektart
Infos
Nachricht

Eliminierung technischer Schulden mit PHPStan, Rector PHP und PHPUnit. Über 20 Jahre Praxiserfahrung in skalierbaren Backends.

CORE EXPERTISE

Gesetzliche Konformität & Inklusion. Optimierung von Performance und Conversion durch radikal nutzerzentriertes, universelles Design.

BFSG COMPLIANT

Skalierbare KI-Systeme mit echtem Code Ownership. CI/CD, Backup-Strategien und Infrastruktur, die mit deinem Team wächst.

ENTERPRISE READY

Terminal öffnen: Zwei Tasten reichen auf dem Mac

Drücke Command und Leertaste, tippe Terminal und drücke Enter. Fertig, das ist dein Terminal.

Dort tippst du Befehle ein und drückst Enter. Nach jedem Befehl wartest du, bis wieder eine neue Zeile erscheint. Die Zeile sieht so aus:

Code: 
          
deinname@MacBook-Pro ~ %

Wichtig ist nur das % am Ende. Dann läuft zsh, die Standard Shell auf jedem aktuellen Mac. Steht dort ein $, läuft die alte bash. Das funktioniert genauso, nur heißt die Einstellungsdatei später anders.

Geschafft, wenn: deine Zeile mit einem Prozentzeichen endet.

Schritt 1: Apple Chip oder Intel herausfinden

Dieser Schritt kostet fünf Sekunden und spart dir später viel Sucherei. Tippe den Befehl und drücke Enter.

Code: 
          
uname -m

Steht dort arm64, hast du einen Mac mit Apple Chip. Also M1, M2, M3, M4 oder neuer. Steht dort x86_64, ist es ein älterer Intel Mac.

Warum das zählt: Die beiden Varianten legen Programme in unterschiedliche Ordner. Apple Chip nutzt /opt/homebrew, Intel nutzt /usr/local. Fast jede Fehlermeldung im nächsten Schritt hängt an diesem Unterschied.

Geschafft, wenn: du weißt, ob bei dir arm64 oder x86_64 steht.

Schritt 2: Homebrew einrichten

Homebrew ist der Paketmanager für den Mac. Damit installierst du Entwickler Werkzeuge mit einem Befehl. Prüfe zuerst, ob er schon da ist:

Code: 
          
brew --version

Kommt eine Zahl, springe direkt zu Schritt 3. Kommt command not found, holst du Homebrew mit diesem Befehl. Er fragt nach deinem Mac Passwort und braucht ein paar Minuten.

Code: 
          
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Jetzt das Wichtigste für Apple Chip Macs: Homebrew landet in /opt/homebrew, und dein Terminal schaut dort nicht nach. Deshalb kennt es den Befehl brew danach trotzdem nicht. Diese zwei Zeilen lösen das ein für alle Mal:

Code: 
          
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Die erste Zeile schreibt den Pfad dauerhaft in deine Einstellungsdatei. Die zweite macht ihn sofort im offenen Fenster aktiv. Auf einem Intel Mac brauchst du das nicht, dort liegt Homebrew schon im richtigen Ordner.

Du darfst auf deinem Rechner nichts installieren, weil es ein Firmen Mac ist? Dann überspringe Homebrew und nimm in Schritt 3 den Weg über das offizielle Skript. Der schreibt nur in deinen eigenen Benutzerordner.

Geschafft, wenn: brew --version eine Zahl zeigt, zum Beispiel 4.4.15.

Schritt 3: OpenCode installieren

Jetzt kommt OpenCode selbst. Ein Befehl, einmal Enter. Wir nehmen den offiziellen Tap des Projekts, weil der immer die aktuellste Version liefert.

Code: 
          
brew install anomalyco/tap/opencode

Der Tap heißt anomalyco und nicht mehr sst. Hinter OpenCode steht seit 2026 die Firma Anomaly Innovations. Alte Anleitungen im Netz nennen noch den sst Tap, der ist nicht mehr der richtige Weg.

Ohne Homebrew nimmst du das offizielle Skript. Es erkennt Chip und System selbst:

Code: 
          
curl -fsSL https://opencode.ai/install | bash

Achtung, hier sitzt die Mac Falle vom Anfang: Das Skript legt OpenCode in ~/.opencode/bin ab, wenn es keinen besseren Ordner findet. Dein Terminal durchsucht diesen Ordner nicht. Mit diesen zwei Zeilen kennt es den Befehl:

Code: 
          
echo 'export PATH="$HOME/.opencode/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Nimm nur einen der beiden Wege. Homebrew, Skript und npm parallel führen dazu, dass Updates ins Leere laufen, weil noch eine alte Version im Pfad liegt. Prüfe zum Schluss, was da ist:

Code: 
          
opencode --version
which -a opencode

Geschafft, wenn: eine Versionsnummer erscheint und der zweite Befehl genau einen Pfad zeigt.

Schritt 4: OpenCode starten und KI verbinden

OpenCode arbeitet immer in dem Ordner, in dem du es startest. Mit cd wechselst du in deinen Projektordner, danach startest du das Programm.

Code: 
          
cd ~/Documents/mein-projekt
opencode

Die Tilde steht für deinen Benutzerordner. Du musst deinen Namen also nicht tippen. Wer den Pfad nicht kennt: Ordner im Finder suchen, ins Terminal ziehen, fertig.

Beim ersten Start fehlt noch die KI. Du tippst im Programm /connect und wählst einen Anbieter aus. Der Zugang wird gespeichert, beim nächsten Mal geht es sofort los.

Du kannst Anthropic, OpenAI oder Google verbinden. Genauso laufen lokale Modelle über Ollama, ganz ohne Daten an US Anbieter. Auf einem Mac mit Apple Chip und genug Arbeitsspeicher ist das ein realistischer Weg. Welches Modell zu dir passt, zeigt unser Guide zur Modellauswahl und die Übersicht der Vibe Coding Modelle.

Ein Tipp für den Anfang: Mit der Tab Taste schaltest du um. Plan Mode schaut sich dein Projekt nur an. Build Mode schreibt Code. Starte mit Plan Mode.

Geschafft, wenn: OpenCode läuft und auf deine erste Frage antwortet.

Fehlermeldungen auf dem Mac und was sie bedeuten

Was auf dem Bildschirm steht Was los ist Was du tust
zsh: command not found: opencode Das Programm liegt in einem Ordner, den dein Mac nicht durchsucht Pfad in die ~/.zshrc eintragen oder über Homebrew installieren
zsh: command not found: brew Homebrew fehlt oder ist auf dem Apple Chip nicht im Pfad brew shellenv in die ~/.zprofile eintragen, siehe Schritt 2
bad CPU type in executable Eine Intel Datei auf einem Mac mit Apple Chip brew reinstall anomalyco/tap/opencode, dann liegt die arm64 Version da
EACCES permission denied bei npm install -g Der globale npm Ordner gehört dem Systembenutzer Nicht mit sudo arbeiten, sondern Homebrew oder das offizielle Skript nehmen
Update läuft durch, die Version bleibt gleich Zwei Installationen liegen parallel im Pfad which -a opencode ausführen und die überzählige Version entfernen
OpenCode kann nicht geöffnet werden, Entwickler nicht verifiziert Gatekeeper blockt die heruntergeladene Desktop App In den Systemeinstellungen unter Datenschutz und Sicherheit freigeben
Kein Fehler, aber die Oberfläche flackert Das Standard Terminal von Apple kommt bei manchen Layouts nicht mit Ein modernes Terminal wie Ghostty oder WezTerm nutzen
OpenCode startet, kennt aber kein Modell Es ist noch keine KI verbunden Im Programm /connect tippen

Aktualisieren und entfernen

OpenCode wird oft verbessert. Über Homebrew holst du die neueste Version mit einem Befehl:

Code: 
          
brew upgrade opencode

Hast du den Weg über das Skript genommen, rufst du es einfach erneut auf. Es überschreibt die alte Datei.

Und wenn du OpenCode wieder loswerden willst, kommt nach dem Entfernen noch das Aufräumen der Einstellungen:

Code: 
          
brew uninstall opencode
rm -rf ~/.config/opencode
rm -rf ~/.opencode

Damit läuft dein Setup. Der nächste Schritt ist der Umgang damit: gute Prompts schreiben und Code Qualität mit KI Agenten sichern.

Aus unseren Schulungen: Der Mac ist nicht automatisch fertig

Der Mac gilt als der einfache Weg, und meistens stimmt das auch. Trotzdem hängen Teilnehmer genau an zwei Stellen: Homebrew liegt auf dem Apple Chip nicht im Pfad, und das Installationsskript legt die Datei in einen Ordner, den niemand kennt. Beides ist in zwei Zeilen erledigt, wenn man weiß welche. Deshalb schicken wir dieses Dokument vor der Schulung raus.

Ein laufender Agent ist der Anfang, nicht das Ziel. Ohne Regeln entsteht Code, den später niemand prüfen will. Genau da setzen wir an: mit automatisierten Code Reviews, klaren Best Practices und einer ehrlichen Tool Übersicht. Wer den Werkzeugkasten breiter sehen will, findet ihn bei den Vibe Coding Tools und im Überblick zu Vibe Coding.

CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.

NCA Vibe Coding Consulting

Roland Golla ist Entwickler aus Leidenschaft – seit über 20 Jahren. Er hat hunderte Projekte begleitet, von Legacy-Refactoring bis KI-Integration. Bei Vibe Coding verbindet er das Beste aus beiden Welten: Die Geschwindigkeit von KI-generiertem Code mit der Qualität professioneller Softwareentwicklung. Kein Bullshit, keine Agentur-Floskeln – direkte Hilfe von jemandem, der selbst täglich im Code steckt.

E-Mail Kontakt

Häufige Fragen zur OpenCode Installation auf dem Mac

Die Fragen, die uns in Schulungen und im Support am häufigsten begegnen, wenn Mac Nutzer OpenCode zum ersten Mal lokal installieren.

Wie installiere ich OpenCode auf dem Mac 2026?

In vier Schritten. Chip prüfen mit uname -m, Homebrew einrichten, dann brew install anomalyco/tap/opencode eingeben. Danach startest du OpenCode in deinem Projektordner mit dem Wort opencode und verbindest mit /connect eine KI. Zusammen dauert das etwa zehn Minuten.

Warum sagt der Mac command not found opencode 2026?

Weil das Programm in einem Ordner liegt, den dein Terminal nicht durchsucht. Das offizielle Skript legt die Datei nach ~/.opencode/bin ab. Trage den Pfad in deine ~/.zshrc ein oder installiere stattdessen über Homebrew. Dann ist der Befehl sofort bekannt.

Welcher Homebrew Tap ist für OpenCode richtig 2026?

Der Befehl lautet brew install anomalyco/tap/opencode. Hinter OpenCode steht seit 2026 die Firma Anomaly Innovations. Ältere Anleitungen nennen noch sst/tap/opencode. Die offizielle Formel brew install opencode gibt es auch, sie hinkt aber oft hinter der aktuellen Version her.

Was mache ich nach der Homebrew Installation auf Apple Silicon 2026?

Homebrew landet in /opt/homebrew und ist dort nicht automatisch im Pfad. Trage einmal eval mit brew shellenv in deine ~/.zprofile ein und führe die Zeile zusätzlich im offenen Fenster aus. Danach kennt jedes neue Terminal den Befehl brew.

Brauche ich Adminrechte für OpenCode auf dem Mac 2026?

Für Homebrew fragt der Installer nach deinem Mac Passwort. Auf einem gesperrten Firmenrechner geht es auch ohne: Das offizielle Skript von opencode.ai schreibt nur in deinen eigenen Benutzerordner. Danach musst du den Pfad einmal selbst in die ~/.zshrc eintragen.

Wie öffne ich das Terminal auf dem Mac?

Command und Leertaste drücken, das Wort Terminal tippen, Enter drücken. Das Fenster ist dein Terminal. Dort gibst du Befehle ein und bestätigst jeden mit Enter. Endet die Zeile mit einem Prozentzeichen, läuft zsh und du bist richtig.

Homebrew, npm oder das Skript, was ist besser?

Homebrew, wenn du ihn schon nutzt, weil Updates dann über brew upgrade laufen. Das Skript, wenn du keine Adminrechte hast. Npm nur, wenn Node bei dir sowieso gepflegt wird. Wichtig ist nur: nimm einen Weg und bleib dabei.

Warum wirkt mein Update nicht?

Weil zwei Installationen parallel im Pfad liegen. Der Rechner nimmt die erste, die er findet, und das ist oft die alte. Führe which -a opencode aus. Zeigt der Befehl mehr als einen Pfad, entfernst du die überzählige Version und startest das Terminal neu.

Läuft OpenCode auf einem alten Intel Mac?

Ja. Es gibt Versionen für Apple Chip und für Intel, Homebrew wählt automatisch die richtige. Der Unterschied liegt nur im Pfad: Intel nutzt /usr/local, Apple Chip nutzt /opt/homebrew. Lokale Modelle über Ollama sind auf Intel Macs allerdings deutlich langsamer.

Was kostet OpenCode?

OpenCode selbst ist Open Source und kostenlos. Kosten entstehen nur beim KI Anbieter, den du verbindest. Wer lokale Modelle über Ollama nutzt, zahlt gar nichts. Ein Mac mit Apple Chip und viel Arbeitsspeicher ist dafür eine gute Basis.

Welche KI verbinde ich mit OpenCode?

Das entscheidest du. Anthropic, OpenAI und Google gehen genauso wie lokale Modelle über Ollama. Du tippst im Programm /connect und wählst aus. Der Zugang wird gespeichert und beim nächsten Start sofort genutzt.

Was ist der Unterschied zwischen Plan Mode und Build Mode?

Plan Mode schaut sich dein Projekt nur an und ändert nichts. Build Mode schreibt Code. Mit der Tab Taste wechselst du zwischen beiden. Für den Anfang ist Plan Mode die sichere Wahl, weil du erst siehst was passieren soll.