Agent Studio herunterladen und installieren
Wähle eine Einrichtung für Windows oder Linux, prüfe den Download und schließe die ersten Schritte in Studio ab.
Bei jedem Website-Build wird die Verfügbarkeit geprüft. Download-Schaltflächen erscheinen nur, wenn beide Setupdateien und SHA256SUMS veröffentlicht sind.
Erste Version steht noch aus
Noch ist keine geprüfte Installerversion verfügbar. Download-Links bleiben ausgeblendet, bis beide Setupdateien und SHA256SUMS veröffentlicht sind und die Website erneut veröffentlicht wurde.
Veröffentlichungen ansehenDateien der Version verifizieren
Lade Setupdatei und SHA256SUMS von derselben neuesten Version. Vergleiche den Hash vor dem Start. Der Linux-Einzeiler erledigt diese Prüfung automatisch.
Vergleiche unter Windows den ausgegebenen Hash mit der Zeile für agent-studio-setup.exe in SHA256SUMS. Starte die Datei nur bei Übereinstimmung.
Die Windows-exe ist derzeit nicht signiert. SmartScreen kann „Der Computer wurde durch Windows geschützt“ anzeigen. Prüfe zuerst Quelle und SHA-256-Wert. Wähle „Weitere Informationen“ → „Trotzdem ausführen“ nur, wenn du dieser Version vertraust.
Linux: grep ' agent-studio-setup$' SHA256SUMS | sha256sum -c -Windows PowerShell: (Get-FileHash .\agent-studio-setup.exe -Algorithm SHA256).HashRechner prüfen
Die Standardinstallation startet Studio, Task Server, Engine und einen Linux-Runner als Docker-Stack auf einem Rechner. Für den Installer selbst brauchst du weder .NET noch Node.js auf dem Host.
- Windows x64: Docker Desktop mit aktivem WSL-2-Backend und eingeschalteter Hardware-Virtualisierung.
- Linux x64: laufende Docker Engine mit Compose v2. Prüfe vorher docker compose version und docker info.
- Für one-box oder einen Runner-Host brauchst du mindestens 20 GiB freien Speicher. Die Vorprüfung prüft den gewählten Weg und nennt bei Fehlern eine Abhilfe.
Wo Studio und Agenten laufen
Die Installation auf einem Rechner ist der kürzeste Weg zur Browseroberfläche. Ein separater Linux-Agentenhost verbindet sich mit einem bestehenden Task Server und braucht eigenen Zugriff auf Repository und Anbieter.
Nur Windows
Starte die Windows-Setupdatei mit Docker Desktop und WSL 2. Der Standardweg startet Studio und einen Linux-Runner auf diesem Rechner.
Nur Linux
Starte die geprüfte Linux-Setupdatei auf einem Host mit Docker Engine. Der Standardweg startet denselben Stack auf einem Rechner.
Windows-Studio + Linux-Agentenhost
Nutze einen entfernten Task Server, verbinde Windows-Studio mit Server-URL und geschützter Tokendatei und füge den Linux-Runner mit seinem Join-Token hinzu. Netzwerk und Zuständigkeit erklärt die Mehrrechner-Anleitung.
Was die Einrichtung abfragt und warum
Vor Änderungen an Diensten zeigt die Setupdatei Installationsweg, Voraussetzungen, Speicherort, festgelegte Version, menschliche Identität, Projekt-Repository, ersten Runner und Budgets. Für eine entfernte Verbindung braucht sie außerdem Server-URL und geschützte Tokendatei.
- Wähle one-box für einen Rechner, join-host für einen Linux-Runner oder attach-studio für einen Windows-Client. Die Vorprüfung prüft nur die Voraussetzungen dieses Wegs.
- Lege die kanonische Git-Repository-Adresse fest, damit der Runner das richtige Projekt abrufen kann. Richte auf dem Host einen passenden Git-Zugang ein, etwa ein begrenztes Token oder einen Deploy Key. Studio erstellt diese Zugangsdaten nicht.
- Setze endliche Budgets für Coding und Review. Die Anmeldung bei der Anbieter-CLI erfolgt auf dem Ausführungshost außerhalb des Installers, bevor eine echte Aufgabe laufen kann.
- Das erste Eigentümerkonto erstellst du in Studio mit dem einmaligen Installationscode, solange die Ersteinrichtung offen ist. Übergib Geheimnisse nicht als Befehlsargumente oder in Antwortdateien.
Die ersten Schritte in Studio abschließen
Eine erreichbare Browserseite ist der Anfang, aber noch kein Beleg für einen arbeitsfähigen Agenten. Öffne die vom Installer ausgegebene lokale Adresse (gewöhnlich http://127.0.0.1:4011) und prüfe Folgendes.
- Erstelle mit dem einmaligen Eigentümercode das erste Konto und melde dich an.
- Trage die kanonische Git-Adresse des Projekts ein. Prüfe, ob der zugewiesene Host sie mit Token oder Deploy Key abrufen kann.
- Installiere die gewählte Coding-Agent-CLI auf dem Runner-Host und melde dich an. Prüfe den Anbieterzugang außerhalb von Studio.
- Prüfe unter Workspace Settings → Execution Hosts die Installations-Checkpoints, Host-Verbindung und Fähigkeiten. Starte dann eine kleine Aufgabe und lies ihr dokumentiertes Ergebnis.
Fehlermeldung der Vorprüfung nutzen
Notiere die erste fehlgeschlagene Prüfung und die genannte Abhilfe. Starte danach dieselbe Installerversion erneut; eine unterbrochene Installation wird mit derselben Identität fortgesetzt.
- Windows: Fehlt Docker oder WSL 2, starte Docker Desktop mit WSL-2-Backend und prüfe docker info erneut. Für den Docker-Weg sind keine Administratorrechte nötig.
- Linux: Fehlen Compose oder der Daemon, installiere oder starte Docker Engine und Compose v2. Prüfe die Rechte des ausführenden Benutzers.
- Entfernte Einrichtung: Ein ungültiges Join-Token scheitert vor der Vorprüfung. Eine abweichende Server-URL, unerreichbarer Server oder nicht vertrauenswürdiges HTTPS-Zertifikat muss zuerst korrigiert werden.
- Fehlt eine Release-Datei, vergleiche die angeforderte Version mit einer veröffentlichten Version. Eine falsch geschriebene Version wird von Setup nicht festgelegt.
- Tokendateien dürfen nur für den Eigentümer lesbar sein. Verschiebe sie bei nicht durchsetzbaren Linux-Rechten von Windows-Pfaden unter /mnt/c und setze Modus 0600.