Erste Schritte mit SupaCloud

Am Ende dieses Tutorials hast du ein Konto auf einer SupaCloud-Instanz, eine Organisation und einen Workspace, Modell-Zugang, damit Agenten denken können, Git-Zugang, damit sie klonen und pushen können, und ein Projekt, das an ein Repository gebunden ist — genau das, was Dein erster Agent-Run als gegeben voraussetzt. Es dauert etwa fünfzehn Minuten.

Voraussetzungen

• Die URL einer SupaCloud-Instanz — eine gehostete oder eine, die du self-gehostet hast.
• Eine E-Mail-Adresse, deren Postfach du lesen kannst. Die Anmeldung setzt auf den Magic-Link, also schickt SupaCloud dir als Erstes einen Link.
• Einen API-Schlüssel für einen KI-Provider oder ein Provider-Konto, das du autorisieren kannst (Anthropic, OpenAI, Google, GitHub Copilot, OpenRouter, …).
• Ein Git-Repository, das du lesen und beschreiben darfst.

Zwei Dinge, die neue Nutzer überraschen — vorweg

Eine Selbstregistrierung wird nicht automatisch freigeschaltet. Nur eine Adresse, die in der Instanz-Konfiguration SUPACLOUD_INITIAL_ADMIN_EMAILS steht, ist direkt bei der Anlage freigeschaltet; jedes andere neue Konto landet auf Account wartet auf Freischaltung, bis ein Instanz-Admin es unter Owner → Benutzer freischaltet. Registriere dich auf deiner eigenen self-gehosteten Instanz mit genau der Adresse aus dieser Variable, dann entfällt das Warten.

Die Erste-Schritte-Checkliste sieht nur der Eigentümer. Sie liest den Autonomie-Zustand des Workspace, und den darf nur ein Eigentümer lesen. Ein Mitglied, das per Einladung zu einem bestehenden Workspace gestoßen ist, sieht sie also nie — und braucht sie auch nicht, weil dessen Eigentümer die Abschnitte 3 bis 6 unten längst erledigt hat. Wenn das auf dich zutrifft, spring direkt zu Dein erster Agent-Run.

1. Anmelden oder Konto anlegen

Die Anmeldeseite führt mit einem Magic-Link, nicht mit einem Passwort: du weist dich mit einer E-Mail-Adresse aus und SupaCloud schickt dir einen Einmal-Anmeldelink. Das Passwort ist die leise Option darunter, nicht der Hauptweg.

1. Öffne die URL deiner Instanz. Du landest auf /login.

2. Tippe deine E-Mail-Adresse ein und drücke Mit E-Mail fortfahren. Jetzt passiert eines von zwei Dingen: Ist die Domain deiner Adresse dem Single Sign-on einer Organisation zugeordnet, wirst du zu deren Identity-Provider geleitet. Andernfalls schickt SupaCloud dir einen Anmeldelink, der in 30 Minuten abläuft, und zeigt dir die Passwort-Karte — dort kannst du Stattdessen mit Passwort anmelden wählen.

3. Noch kein Konto? Drücke Noch kein Konto? Registrieren und gib deinen Namen, deine E-Mail-Adresse und — optional — ein Passwort mit mindestens 12 Zeichen an. Das Passwort ist wirklich optional: der Magic-Link allein ist eine vollständige Anmeldemethode. (Ist die Registrierung auf deiner Instanz geschlossen, fehlt dieser Button und ein Admin lädt dich stattdessen ein.)

4. Nach der Registrierung landest du auf Bestätige deine E-Mail. Öffne den Bestätigungslink, den SupaCloud dir geschickt hat — er läuft in 24 Stunden ab —, um das Konto zu aktivieren. Nichts angekommen? Nutze Bestätigungslink erneut senden oder E-Mail-Adresse ändern, falls du dich vertippt hast.

5. Hast du für dieses Konto schon eine Authenticator-App aktiviert, folgt nach dem Passwort die Abfrage des sechsstelligen Codes. Dein zweiter Faktor gehört zu deinem SupaCloud-Konto — er greift also unabhängig davon, über welchen Weg du dich angemeldet hast.

Was je Instanz unterschiedlich ist — such keinen Button, den es nicht gibt

Drei Anmelde-Optionen sind opt-in und standardmäßig aus. Ob du sie siehst, hängt also an der Konfiguration deiner Instanz:

• Social-Login — Mit Google anmelden bzw. Mit GitHub anmelden erscheinen unter dem E-Mail-Feld nur, wenn der Betreiber den jeweiligen Provider konfiguriert hat. Siehe Mit Google oder GitHub anmelden.
• Captcha — eine kleine Sicherheitsprüfung, die dein Browser still löst; sie erscheint beim Registrieren, beim Anfordern eines Magic-Links und beim Zurücksetzen des Passworts (sowie beim Anmelden nach mehreren Fehlversuchen). Sie braucht eine https-Verbindung.
• Enterprise-SSO — ein Button Mit OIDC anmelden mit dem Abzeichen ENTERPRISE.

Die ersten beiden aktiviert der Betreiber wie unter Social-Login und Captcha aktivieren beschrieben.

2. Organisation und Workspace kennenlernen

Zwei Begriffe tragen in SupaCloud die Mandantenlogik — und keinen von beiden legst du selbst an. Deine erste Anmeldung erzeugt beide in einer einzigen Transaktion: eine persönliche Organisation (Name Personal) und einen Workspace (Name Workspace), mit dir als Eigentümer von beidem.

Die Organisation ist der oberste Mandant — sie besitzt Abrechnung und Sitze, Single Sign-on und Einladungen. Du gehörst zu genau einer, weshalb es nirgends in der UI einen Organisationswechsler gibt: der Server leitet deine aktive Organisation aus deinem aktiven Workspace ab. Der Workspace ist der Container für alles Übrige — Projekte, Tasks, Runs, Workflows, Zeitpläne, Secrets und Connectors leben alle im Workspace, und die Mitgliedschaft gilt pro Nutzer.

Benenne den Workspace unter Einstellungen → Arbeitsbereich jederzeit in etwas Sprechenderes um; nichts in diesem Tutorial hängt an seinem Namen. Das ganze Modell — und die Regel „ein Begriff, eine Bedeutung“ dahinter — steht in Workspaces und Organisationen.

3. Die Erste-Schritte-Checkliste öffnen

Bei einem brandneuen Workspace begrüßt das Dashboard seinen Eigentümer mit einem Erste Schritte-Dialog über abgedunkeltem Hintergrund. Er geht denselben Weg wie dieses Tutorial, und es lohnt sich, ihm in der App zu folgen statt aus dem Gedächtnis zu arbeiten — denn er prüft deinen tatsächlichen Zustand: vier Pflichtschritte, ein Zähler n/4 und darunter abgesetzt zwei optionale Erweiterungen.

Drei Verhaltensweisen solltest du kennen, bevor du losklickst:

• Der Button Einrichten eines Schritts verlinkt direkt auf genau die Oberfläche, die dieser Schritt braucht. Kommst du in den Tab zurück, prüft die Checkliste erneut und setzt den Schritt selbst auf Erledigt — du musst nie neu laden, und ein OAuth-Vorgang, der in einem anderen Tab fertig wurde, wird bei der Rückkehr erkannt.
• Die Reihenfolge ist Absicht und lautet credentials-first: Modell-Zugang, dann Git-Zugang, dann das Projekt, dann der Run. Jeder Schritt ist harte Voraussetzung des nächsten — wer vorgreift, verschiebt den Fehler nur nach hinten.
• Überspringen verbirgt den Dialog nur für diese Browser-Sitzung. Die dauerhafte Erinnerung ist das Banner Onboarding-Modus unter Einstellungen → Arbeitsbereich, wo du das Setup auch später abschließen kannst.

Die beiden optionalen Erweiterungen — MCP-Zugang und ein eigener Skill — geben Agenten zusätzliche Tools und wiederverwendbare Anweisungen. Keine davon blockiert einen ersten Run; lass sie für später.

4. Einen Modell-Harness verbinden

Das ist der erste Schritt der Checkliste, weil es der Schritt ist, den ein Agent nicht umgehen kann. Ein Harness-Credential ist das, was den Agent denken lässt; ohne ihn hat ein Start kein Modell und schlägt fehl, bevor irgendetwas Nützliches passiert.

1. Drücke Einrichten bei Harness verbinden. Du landest unter Einstellungen → API-Schlüssel.

2. Wähle, wie du SupaCloud Modell-Zugang gibst:

   • API-Schlüssel einfügen — Provider wählen, optional eine Bezeichnung setzen, Wert einfügen.
   • Konto verknüpfen — Provider wählen und Verknüpfen drücken, um statt Copy-and-paste einen OAuth-Vorgang zu starten. GitHub Copilot nutzt einen Device-Code: SupaCloud zeigt einen kurzen Benutzercode und eine github.com-URL, du autorisierst dort, und SupaCloud schließt die Verbindung ab, indem es im Hintergrund pollt.

3. Wähle einen Scope: Persönlich für einen Schlüssel, den nur du nutzt, Workspace, um ihn mit allen im Workspace zu teilen, Organisation für einen organisationsweiten Schlüssel (nur Eigentümer und Admins).

4. Speichern, dann zurück in den Dashboard-Tab. Der Schritt springt auf Erledigt, sobald ein API-Schlüssel oder ein verknüpftes Konto existiert.

Es gibt keinen Zuordnungsschritt

Du ordnest kein Credential einem Agent zu. Die passende Anmeldung wird beim Start automatisch aufgelöst — Claude ist der empfohlene Einstieg. Und ein Modell, für dessen Provider kein Credential vorliegt, erscheint in jeder Modellauswahl ausgegraut: die UI sagt dir also vorher, was erreichbar ist, statt erst zur Laufzeit zu scheitern. Scopes, Vorrang und Sperren behandelt Secrets in der Benutzeroberfläche verwalten.

5. Git-Zugang hinterlegen

Der zweite Schritt der Checkliste ist die andere Hälfte der Abhängigkeitskette. Ein Agent arbeitet in einem Wegwerf-Container: er klont dein Repository hinein, committet und pusht einen Branch zurück. Ohne Git-Credential scheitert das Klonen beim allerersten Kommando.

1. Drücke Einrichten bei Git-Zugangsdaten hinterlegen. Du landest unter Einstellungen → Git-Zugangsdaten.

2. Wähle den Auth-Typ — SSH Key oder Access Token — und füge Schlüssel oder Token ein.

3. Optional kannst du das Credential auf einen Provider einschränken (GitHub, GitLab, Forgejo, Bitbucket). Lässt du es uneingeschränkt, wird es für jeden Provider angeboten.

4. Wähle einen Scope (Persönlich, Workspace oder Organisation) und speichere.

Lesezugriff genügt nicht

Gib dem Token oder Schlüssel Schreibrechte auf das Repository, nicht nur Leserechte. Ein Agent, der klonen aber nicht pushen kann, macht die ganze Arbeit und hat dann nichts, wohin er sie liefern kann — ein Fehlerbild, das nach einem kaputten Agent aussieht und tatsächlich am Credential-Scope liegt. Existieren auf deiner Instanz sowohl ein organisationsweiter als auch dein eigener Schlüssel, gewinnt der spezifischste Scope; siehe Secrets in der Benutzeroberfläche verwalten.

6. Dein erstes Projekt anlegen

Ein Projekt ist das, worauf ein Agent gerichtet wird: ein Name plus ein Repository, im aktiven Workspace.

1. Drücke Einrichten bei Projekt anlegen. Du landest im Formular Neues Projekt.

2. Fülle aus:

   • Name — so erscheint das Projekt in jeder Liste, und genau dieses Wort tippst du im Befehl run des Web-Terminals.
   • Git Repo URL — Pflichtfeld. Eine SSH-URL funktioniert, zum Beispiel ssh://git@git.example.com:2222/org/repo.git.
   • Git Provider — Forgejo, Bitbucket, GitHub oder GitLab.
   • Git Credential — die Auswahl listet nur Credentials, die zum gerade gewählten Provider passen. Genau deshalb kam Abschnitt 5 zuerst: ohne passendes Credential bietet die Auswahl nur Kein Credential und einen Link zurück in die Einstellungen.

3. Drücke Projekt erstellen. Du landest auf der Seite des neuen Projekts.

Ein Projekt darf git-only starten

Ein Issue-Tracker ist zum Anlegen eines Projekts nicht nötig. Die Issues der Forge selbst, Linear oder Notion verdrahtest du später in der Konfiguration des Projekts und startest Arbeit dann direkt aus einem Issue — siehe Einen Task aus einem Issue starten.

7. Setup abschließen — und was das freischaltet

Der vierte Schritt der Checkliste ist das nächste Tutorial, erledige ihn also dort. Sobald alle vier auf Erledigt stehen, erscheint im Fuß des Dialogs der Button Setup abschließen. Ihn zu drücken ist nicht kosmetisch: er schaltet den Onboarding-Modus des Workspace ab — und der Onboarding-Modus ist eine echte Sicherheitshaltung.

Solange er aktiv ist, ist das Autonomie-Level des Workspace auf 25 begrenzt und der autonome Backlog-Versand pausiert, ganz unabhängig davon, was der Regler anzeigt. Das Freischalten hebt die Grenze auf den vollen Bereich und lässt die Auslieferungs-Engine selbstständig zu dispatchen beginnen. Nur der Eigentümer des Workspace kann den Button drücken, das Freischalten ist einseitig, und wenn du zunächst begrenzt bleiben willst, lässt du ihn stehen und schaltest später über das Banner Onboarding-Modus unter Einstellungen → Arbeitsbereich frei.

Wenn du dir bei autonomem Dispatch noch unsicher bist, lies vorher Das Autonomie-Level einstellen — die Grenze existiert, damit ein brandneuer Workspace keine Arbeit unbeaufsichtigt dispatcht, bevor du einen einzigen Run gesehen hast.

Was du jetzt hast

• Ein freigeschaltetes Konto, in das du dich per Magic-Link oder Passwort anmelden kannst.
• Eine persönliche Organisation und einen Workspace, beide in deinem Besitz.
• Ein Harness-Credential, damit Agenten denken können.
• Ein Git-Credential mit Schreibrechten, damit Agenten klonen und pushen können.
• Ein Projekt, das an ein Repository gebunden ist.

Als Nächstes: dein erster Agent-Run

Das sind alle Voraussetzungen, die Dein erster Agent-Run annimmt. Mach dort weiter: dort startest du einen Agent gegen das Projekt, das du gerade angelegt hast, verfolgst ihn live und liest ab, was der Run gekostet hat.

Hat sich etwas auf dieser Seite anders verhalten als beschrieben — keine Bestätigungs-E-Mail, ein hängender Bildschirm Account wartet auf Freischaltung, ein Projekt, das sich nicht speichern lässt —, siehe Fehlerbehebung.