DAO-Code-Installationsanleitung: macOS in 5 Minuten zum Laufen bringen (2026)

Diese Anleitung richtet sich an macOS-Nutzer, die DAO-Code erstmals installieren und einen ersten Terminal-Agent-Auftrag sicher ausführen möchten. Sie vergleicht die Installationswege, erklärt die Architekturprüfung für Apple Silicon und Intel, zeigt die DeepSeek-API-Konfiguration und führt durch eine nachvollziehbare Abnahmeprüfung.

Unsere Entscheidung: Für eine reguläre Installation wählen Sie das offizielle Installationsskript und damit die native Binärdatei. Für einen kurzen Test genügt npx; nur wenn Sie DAO-Code selbst verändern möchten, installieren Sie den Quellcode. Docker, Xcode und eine lokale Metal-Modellumgebung sind für DAO-Code nicht erforderlich.

Diese DAO-Code-Installationsanleitung ist für drei Gruppen gedacht: macOS-Nutzer, die DAO-Code zum ersten Mal starten; Tester, die eine saubere Mac-Umgebung reproduzierbar prüfen möchten; und Entwickler, die später iOS- oder macOS-Projekte auf einem entfernten Mac bearbeiten wollen. Der dokumentierte Stand wurde am 03.09.2026 anhand der offiziellen Projektdateien und der DeepSeek-Dokumentation geprüft.

Vor dem Terminal: Welcher Installationsweg passt?

DAO-Code ist laut offiziellem Repository ein plattformübergreifender Terminal-Coding-Agent für DeepSeek V4. Die Aufgabe des Programms besteht darin, Anweisungen im Terminal entgegenzunehmen, Dateien zu untersuchen, Code vorzuschlagen und – nach Bestätigung – kontrollierte Befehle auszuführen. Die Bezeichnung ist wichtig: Es handelt sich nicht um ein Web3-Smart-Contract-Werkzeug. Für die Installation gibt es daher auch keine sachliche Begründung, Docker, Xcode oder eine lokale GPU-Beschleunigung vorauszusetzen.

Das offizielle Repository nennt mehrere Wege:

• Native Binärdatei über install.sh: beste Wahl für die normale Nutzung. Die Installationsdateien werden passend zur CPU-Architektur ausgewählt.
• npx: geeignet für einen einmaligen oder kurzen Test, ohne eine dauerhafte Installation in den Vordergrund zu stellen.
• npm- oder Quellcode-Installation: sinnvoll, wenn Sie den Code untersuchen, anpassen oder lokal weiterentwickeln möchten.

Die Release-Seite führt v0.4.7 als neueste formale Veröffentlichung. Im Entwicklungszweig master steht in der package.json dagegen 0.4.17. Diese beiden Angaben dürfen nicht vermischt werden: Eine formale Release-Binärdatei ist nicht automatisch identisch mit dem aktuellen Stand des Entwicklungszweigs. Prüfen Sie deshalb vor dem Download, ob Sie eine stabile Veröffentlichung oder bewusst den Entwicklungsstand benötigen. Quellen: offizielle Releases und aktuelle package.json im Master-Zweig.

Welche Variante ist für eine erste DAO-Code-macOS-Installation richtig? Wenn Sie nur einen Auftrag ausprobieren, wählen Sie npx. Wenn DAO-Code dauerhaft als Terminal-Befehl verfügbar sein soll, verwenden Sie das offizielle Installationsskript. Wenn Sie Pull Requests, eigene Anpassungen oder lokale Debugging-Arbeiten planen, wechseln Sie zur Quellcode-Installation. Ein Wechsel zwischen den Varianten ist möglich, aber unnötige Mischinstallationen erschweren später die Fehlersuche.

Erster Prüfpunkt: System, Shell und CPU sauber erfassen

Bevor ein Skript Dateien kopiert, erfassen wir den Zustand des Mac. Das dauert nur wenige Befehle und verhindert, dass eine falsche Binärdatei oder ein falscher Pfad für die Ursache gehalten wird.

sw_vers
echo "$SHELL"
uname -m
printf '%s\n' "$PATH"
command -v node || true
command -v dao || true

sw_vers zeigt die macOS-Version. Mit echo "$SHELL" sehen Sie die verwendete Shell. uname -m ist für die Architekturentscheidung entscheidend:

• arm64 bedeutet Apple Silicon.
• x86_64 bedeutet Intel.

Apple beschreibt arm64 als Architektur für Apple-Silicon-Systeme. Die passende Erklärung finden Sie in der Apple-Dokumentation zum Bau universeller macOS-Binärdateien. Laden Sie auf einem Intel Mac nicht versehentlich eine ARM-Datei. Umgekehrt ist eine x64-Datei auf Apple Silicon nicht automatisch die beste Wahl, selbst wenn sie unter Übersetzung laufen kann.

Für die JavaScript- und Paketwerkzeuge nennt das DAO-Code-README Node.js 18 oder neuer als Voraussetzung. Installieren Sie Node.js ausschließlich über eine nachvollziehbare, unterstützte Quelle und kontrollieren Sie danach die tatsächlich aktive Version:

node --version
npm --version

Die verfügbaren Installationspakete stellt die offizielle Node.js-Downloadseite bereit. Entscheidend ist nicht nur, welche Version installiert wurde, sondern welche Version Ihre aktuelle Shell findet. Mehrere Node-Installationen, etwa aus unterschiedlichen Paketverwaltungen, führen häufig dazu, dass npm und node aus verschiedenen Verzeichnissen stammen.

Warum funktioniert der Befehl später trotz erfolgreicher Installation nicht? Meistens fehlt nicht DAO-Code, sondern der Installationsordner im PATH. Wenn command -v dao leer bleibt, öffnen Sie eine neue Terminal-Sitzung und prüfen den Pfad erneut. Ergänzen Sie keinen beliebigen Ordner auf Verdacht. Lesen Sie zuerst den Installationspfad aus dem aktuellen README oder aus der Ausgabe des Skripts. Genau dieser Schritt verhindert, dass eine funktionierende Binärdatei durch eine ältere Kopie überschattet wird.

Die erste Minute: Das offizielle Installationsskript verwenden

Das README und die Datei install.sh sind die maßgeblichen Quellen für die Installationsbefehle. Kopieren Sie keine Befehle aus Forenbeiträgen, wenn die Projektdateien inzwischen geändert wurden. Die aktuelle Datei können Sie zunächst speichern und lesen:

curl -fsSL https://raw.githubusercontent.com/tigicion/dao-code/master/install.sh \
  -o dao-code-install.sh

sed -n '1,240p' dao-code-install.sh

Die konkrete Länge des Skripts kann sich ändern. Die Ausgabe dient nur der Kontrolle. Achten Sie insbesondere auf:

• Download-Quelle und Release-Auswahl,
• Zielverzeichnis,
• Architekturprüfung,
• Änderungen an Shell-Konfigurationen,
• Dateien, die überschrieben oder angelegt werden.

Ein Remote-Skript direkt über eine Pipeline an eine Shell zu übergeben, ist nicht risikofrei. Darum speichern wir es zuerst lokal. Die offizielle install.sh bleibt die Referenz; die folgenden Schritte erklären den Sicherheitsablauf, ersetzen aber nicht die Prüfung des aktuellen Inhalts.

Wenn der Inhalt plausibel ist, setzen Sie das Ausführungsrecht und starten das Skript:

chmod 700 dao-code-install.sh
./dao-code-install.sh

macOS kann bei heruntergeladenen Dateien zusätzlich ein Quarantäneattribut setzen. Wenn das Skript nachweislich aus der offiziellen Projektquelle stammt, kann die Prüfung mit folgendem Befehl entfernt werden:

xattr -d com.apple.quarantine dao-code-install.sh 2>/dev/null || true
./dao-code-install.sh

Verwenden Sie xattr -d nicht als pauschale Lösung für unbekannte Dateien. Das Entfernen der Quarantäne reduziert eine Schutzschicht. Bei einer Fehlermeldung ist es besser, den Inhalt, die Signatur beziehungsweise die Release-Quelle zu prüfen, statt Sicherheitsmeldungen blind zu umgehen.

Nach der Installation öffnen Sie ein neues Terminal und prüfen den Befehl:

command -v dao
dao --version

Falls dao nicht gefunden wird, kontrollieren Sie zuerst PATH, Shell-Startdateien und den vom Skript genannten Zielordner. Installieren Sie nicht sofort eine zweite Variante mit npm oder npx. Zwei parallel gefundene Installationen erzeugen oft genau die Versionsverwechslung, die anschließend wie ein Programmfehler aussieht.

Erfahrung aus der Fehlersuche: Eine erfolgreiche Skriptausführung ist noch keine vollständige Abnahme. Erst wenn dao --version funktioniert, die API-Konfiguration angenommen wird und ein kleiner Auftrag den vorgesehenen Bestätigungsdialog auslöst, ist die Installation belastbar.

Beim ersten Start: DeepSeek API kontrolliert hinterlegen

Starten Sie DAO-Code erst dann, wenn der Befehl aus dem richtigen Installationspfad kommt:

dao

Beim ersten Start führt DAO-Code durch die Konfiguration. Dort wird der DeepSeek-API-Schlüssel hinterlegt. Verwenden Sie ausschließlich einen eigenen Schlüssel aus der offiziellen DeepSeek-API-Key-Verwaltung. Einen echten Schlüssel sollten Sie niemals in ein README, einen Screenshot, eine Shell-History oder ein öffentliches Repository schreiben.

Die API-Dokumentation ist die Referenz für Authentifizierung, Modellnamen und aktuelle Parameter. Prüfen Sie die Angaben in den offiziellen DeepSeek-API-Dokumenten, bevor Sie ein Modell manuell eintragen. Modellbezeichnungen können sich ändern. Die Schreibweise „DeepSeek V4“ aus der Projektbeschreibung darf deshalb nicht automatisch mit einem heute gültigen API-Modellnamen gleichgesetzt werden.

DAO-Code speichert die lokale Konfiguration im Benutzerkonfigurationsbereich des Tools. Bei der geprüften Projektstruktur liegt dieser Bereich im Benutzerverzeichnis unter ~/.dao-code/. Kontrollieren Sie die Dateien, ohne den Schlüssel auszugeben:

ls -la ~/.dao-code

Wenn die aktuelle README-Version einen abweichenden Pfad nennt, hat diese Angabe Vorrang. Konfigurationen aus einer früheren Installation können außerdem alte Modellnamen oder ungültige Schlüssel enthalten. Entfernen Sie nicht sofort alles. Sichern Sie die Datei zunächst außerhalb öffentlicher Synchronisationsordner und ersetzen Sie nur die veralteten Werte.

Wie wird die DeepSeek-API nach der Installation eingerichtet? Starten Sie dao, folgen Sie dem Einrichtungsdialog, fügen Sie den Schlüssel aus der offiziellen Verwaltung ein und bestätigen Sie nur die dort vorgesehenen Optionen. Danach beenden Sie den Agenten und starten ihn erneut. So prüfen Sie, ob der Schlüssel dauerhaft gespeichert wurde, statt nur in einer einmaligen Sitzung zu funktionieren.

Datenschutz ist besonders wichtig, wenn DAO-Code Quellcode lesen darf. Verwenden Sie für Tests ein isoliertes Repository ohne Zugangsdaten, Produktionsschlüssel oder private Zertifikate. Eine Übersicht zu den Datenschutzinformationen finden Sie auf der deutschen Datenschutzseite von ZekVPS. API-Schlüssel gehören nicht in ein Git-Repository und nicht in Umgebungsdateien, die gemeinsam mit dem Projekt archiviert werden.

Die Abnahme: Drei Aufgaben statt eines bloßen Startsignals

Die Installation gilt erst als erfolgreich, wenn der Agent kontrolliert arbeitet. Wir verwenden drei Aufgaben mit steigender Wirkung. Für alle drei Aufgaben wählen wir ein Testverzeichnis und kein Produktionsrepository.

1. Nur lesende Bestandsaufnahme

Wechseln Sie in ein kleines, unkritisches Projekt:

mkdir -p ~/dao-code-test
cd ~/dao-code-test
dao

Fordern Sie eine reine Verzeichnisübersicht oder eine Beschreibung der vorhandenen Dateien an. Es darf keine Datei geändert werden. Notieren Sie:

• die Ausgabe von dao --version,
• das verwendete Zielverzeichnis,
• die erkannte Berechtigung,
• die sichtbare Modell- oder API-Rückmeldung,
• ob eine Änderung vorgeschlagen oder tatsächlich ausgeführt wurde.

Diese Aufgabe prüft, ob der Agent Dateien lesen und den Arbeitsordner korrekt erkennen kann.

2. Projektdokumentation erzeugen

Lassen Sie anschließend eine kurze README- oder Projektbeschreibung vorschlagen. Bestätigen Sie die Änderung erst nach der Anzeige des Diffs. Prüfen Sie den Inhalt anschließend selbst:

git diff -- README.md

Wenn kein Git-Repository vorhanden ist, vergleichen Sie die Datei manuell oder arbeiten Sie in einer temporären Kopie. Der wichtige Punkt ist der sichtbare Unterschied zwischen „Agent hat Text vorgeschlagen“ und „Datei wurde mit Ihrer Zustimmung geändert“.

3. Einen kontrollierten Befehl testen

Erst im dritten Schritt erlauben Sie einen ungefährlichen Shell-Befehl, beispielsweise die Anzeige des aktuellen Verzeichnisses oder der Dateiliste. Bestätigen Sie nichts, was Dateien löscht, Pakete installiert oder Netzwerkzugriff ausführt, solange der Inhalt nicht vollständig geprüft wurde.

Die Installation ist nur dann abgenommen, wenn der Befehl dao aufgerufen werden kann, die API-Anmeldung akzeptiert wird, der Agent vor einer Aktion um Zustimmung bittet und die Ausgabe dem gewählten Arbeitsordner entspricht. Ein sichtbarer Fehlerdialog ist dabei kein Misserfolg: Er zeigt, dass die Kontrollgrenze greift. Ein unerwarteter Befehl ohne Bestätigung wäre dagegen ein Grund, die Konfiguration sofort zu stoppen und zu untersuchen.

Wie lässt sich eine erfolgreiche DAO-Code-Installation nachweisen? Erstellen Sie eine kurze Abnahmenotiz mit Version, Architektur, Installationsweg, Zielordner, API-Konfigurationsstatus und Ergebnis der drei Testaufgaben. Speichern Sie niemals den API-Schlüssel selbst. Diese Notiz macht eine spätere Wiederholung auf einem zweiten Mac oder einer entfernten Umgebung deutlich zuverlässiger.

Wenn lokale Nutzung endet: Mac oder entfernte Umgebung?

DAO-Code selbst ist plattformübergreifend. Ein Apple-Silicon-Mac ist also nicht zwingend nötig, nur um den Terminal-Agenten zu starten. Anders sieht es aus, sobald der Arbeitsablauf Xcode, iOS-Simulatoren, macOS-Builds oder Apple-spezifische Signierung einschließt. Dann benötigen Sie eine Mac-Umgebung. Docker ist dafür kein Ersatz, weil ein Container die Apple-Entwicklungswerkzeuge und deren Lizenz- beziehungsweise Systemintegration nicht automatisch bereitstellt.

Für gelegentliche API-Tests reicht ein vorhandener Mac. Für längere Entwicklungsaufgaben zählen zusätzlich Stabilität, Erreichbarkeit, ein sauberer Benutzerkontext und die Möglichkeit, die Umgebung nach einem Experiment zurückzusetzen. Prüfen Sie dabei auch, ob das Gerät dauerhaft eingeschaltet bleiben muss und ob sensible Quelltexte in einer entfernten Umgebung verarbeitet werden dürfen.

Wenn ein lokaler Mac nicht dauerhaft verfügbar sein soll, können Sie denselben Ablauf auf einem gemieteten Mac wiederholen: Architektur prüfen, install.sh lesen, installieren, API-Schlüssel einrichten und anschließend die drei Abnahmetests durchführen. Für Informationen zu einer verfügbaren Mac-Umgebung finden Sie einen passenden Einstieg bei Mac mini mieten in den USA. Der Vorteil liegt nicht in einer angeblich magischen DAO-Code-Beschleunigung, sondern in einem separaten, zurücksetzbaren Mac-Arbeitsplatz für Xcode- und macOS-Aufgaben.

Entscheidung nach Einsatzfall

• Wenn DAO-Code nur einmal getestet werden soll, wählen Sie npx; sonst verwenden Sie das offizielle Installationsskript.
• Wenn der Quellcode geändert oder debuggt werden soll, wählen Sie die Quellcode-Installation; sonst vermeiden Sie eine zusätzliche lokale Build-Kette.
• Wenn uname -m arm64 meldet, wählen Sie die Apple-Silicon-Datei; wenn x86_64 erscheint, wählen Sie die Intel-Datei.
• Wenn nur der Terminal-Agent benötigt wird, installieren Sie weder Docker noch Xcode; wenn iOS- oder macOS-Builds dazukommen, wechseln Sie in eine vollständige Mac-Entwicklungsumgebung.
• Wenn dao --version funktioniert, aber API-Aufträge scheitern, prüfen Sie Schlüssel, Modellname und Konfigurationspfad; installieren Sie DAO-Code nicht erneut.
• Wenn der lokale Mac nicht stabil oder nicht dauerhaft erreichbar ist, reproduzieren Sie die Abnahme auf einem separaten entfernten Mac; bei dauerhaft hoher Auslastung und vorhandener Hardware kann ein eigener Mac wirtschaftlicher sein.

Installationswege und ihre tatsächlichen Grenzen

Die native Installation ist für die meisten Erstnutzer die sauberste Entscheidung. npx bleibt die bessere Abkürzung, wenn nur ein einzelner Test ansteht. Eine Entwicklungsinstallation lohnt sich erst, wenn tatsächlich am Code gearbeitet wird.

Für den Abgleich nach Updates sollten Sie nicht allein auf eine Versionsmeldung vertrauen. Prüfen Sie die Release-Seite, das README, install.sh, die package.json und die DeepSeek-Dokumentation erneut. Besonders relevant sind neue Releases, Änderungen am Installationsskript, eine geänderte Node.js-Mindestversion und ein neuer API-Konfigurationsablauf. Die im September 2026 geprüften Versionsangaben gelten nicht automatisch für spätere Projektstände.

Eine lokale Installation ist für kurze Versuche meist die einfachste Lösung. Sie hat aber drei reale Grenzen: Der Mac muss erreichbar bleiben, API-Schlüssel und Quellcode liegen im lokalen Benutzerkontext, und iOS- beziehungsweise macOS-Builds benötigen zusätzlich die vollständige Apple-Toolchain. Ein gemieteter Mac kann diese Punkte durch eine getrennte, zurücksetzbare Umgebung lösen; er ist jedoch nicht automatisch die beste Wahl für dauerhaft hohe Auslastung oder Aufgaben mit speziellen physischen Schnittstellen. Wenn Sie die drei Abnahmetests samt Xcode-Anteil regelmäßig wiederholen müssen, ist eine entfernte Mac-Umgebung häufig praktischer als eine lokale Installation, die nur sporadisch verfügbar ist. ZekVPS bietet dafür einen Mac-Arbeitsplatz, auf dem Sie denselben DAO-Code-Ablauf kontrolliert nachvollziehen können.