Erste Schritte mit Arc OS

Arc OS — AI-Orchestrierungssystem für Entwicklungsteams. Dieser Leitfaden erklärt, was Arc OS ist, warum es existiert und wie Sie es effektiv einsetzen.

Was ist Arc OS?

Arc OS ist eine Plattform, mit der Sie ein persönliches AI-Entwicklungsteam auf Basis von Claude aufbauen und verwalten.

Die Kernidee: Statt jedes Mal einen neuen AI-Chat zu öffnen, wenn Sie Hilfe brauchen, haben Sie persistente AI-Worker, die:

• Ihre Codebasis, Architektur und Historie kennen
• Nie den Kontext zwischen Sessions verlieren
• Jeweils auf eine bestimmte Rolle spezialisiert sind
• Dieselbe Projekt-Wissensbasis teilen

Sie bauen Ihr Team einmal auf. Danach arbeiten Sie damit — über CLI, IDE oder Web.

Die Grundidee: Ein LLM, geteilter Kontext, spezialisierte Rollen

Die meisten Entwickler nutzen AI als Wegwerf-Chat — Code einfügen, Antwort erhalten, vergessen.

Arc OS ist anders:

Ein LLM (Claude) — alle Worker laufen auf Claude. Wir haben Claude wegen des langen Kontextfensters, der Befolgung von Anweisungen und der Code-Qualität gewählt. Sie bringen Ihr eigenes Claude-Abonnement mit.

Kein Kontextverlust — jeder Worker hat Zugriff auf:

• Ihr Projekt-Wiki (Architekturentscheidungen, Konventionen, Notizen)
• Ihre Skills (eigene Anweisungen für bestimmte Aufgaben)
• Ihren Issue-Tracker (woran gearbeitet wird, was erledigt ist)
• Die Session-Historie (was zuvor besprochen wurde)

Spezialisierte Rollen — jeder Worker hat eine eigene Persönlichkeit, eigene Berechtigungen und einen eigenen Zweck:

Sie können außerdem eigene Worker für Ihre spezifischen Bedürfnisse erstellen.

Was ist ein Projekt?

Ein Projekt in Arc OS entspricht einer Codebasis oder einem Produkt, an dem Sie arbeiten.

Jedes Projekt hat:

• Sein eigenes Set an Workern (Developer, Consultant usw.)
• Sein eigenes Wiki (Architektur-Doku, Entscheidungen, Konventionen)
• Seine eigenen Skills (eigene Anweisungen, die in Worker injiziert werden)
• Seinen eigenen Issue-Tracker (Aufgaben, Bugs, Features)
• Seine eigene Session-Historie

Sie können mehrere Projekte haben — eines pro Produkt, Kunde oder Repository.

Der primäre Arbeitsweg: CLI Bridge

Die CLI Bridge ist die Hauptschnittstelle von Arc OS. Sie verbindet Ihr lokales Terminal oder Ihre IDE direkt mit Ihren AI-Workern.

# Start a Developer session on project "my-app"
arc my-app developer

# Start a Consultant (read-only) session
arc my-app consultant

# Continue the previous session (restores context)
arc my-app developer continue

Wenn Sie arc <project> <worker> ausführen, macht der Worker Folgendes:

1. Lädt Ihr Projekt-Wiki, Ihre Skills und das aktive Issue
2. Öffnet eine interaktive Claude-Session in Ihrem Terminal
3. Hat vollen Zugriff auf Ihr lokales Dateisystem (Developer) oder nur Lesezugriff (Consultant)
4. Speichert den Session-Kontext für das nächste Mal

Warum CLI-First?

• Funktioniert in jedem Terminal (macOS, Linux, Windows)
• Integriert sich über das Terminal-Panel in VS Code, Cursor, JetBrains
• Kein Kontextwechsel — Sie bleiben in Ihrem Editor
• Git-bewusst: Der Worker sieht Ihren aktuellen Branch, gestagte Änderungen, letzte Commits

Wichtige arc-CLI-Befehle

arc <project> <worker>               # Start a session
arc <project> <worker> continue      # Resume previous session
arc sessions <project>               # Browse past sessions
arc issues                           # List open issues
arc issue create --title "..."       # Create new issue
arc issue log <id> "progress note"   # Log progress
arc skill <name>                     # Load a skill into context
arc wiki                             # Browse project wiki
arc roadmap                          # View project roadmap
arc retro <project>                  # Reconstruct issues from history

So legen Sie los

Schritt 1 — arc CLI installieren

Laden Sie die Binärdatei für Ihr Betriebssystem aus dem Arc OS Dashboard herunter (Settings → CLI).

# macOS / Linux
chmod +x arc-linux-x64
sudo mv arc-linux-x64 /usr/local/bin/arc
arc --version

Schritt 2 — Ihr erstes Projekt erstellen

Im CRM-Dashboard:

1. Klicken Sie auf New Project
2. Geben Sie einen Namen ein und verbinden Sie Ihr GitHub-Repository
3. Das System erstellt Ihr Worker-Team automatisch

Schritt 3 — Skills hinzufügen (optional, aber empfohlen)

Skills sind eigene Anweisungssets, die Worker schlauer im Umgang mit Ihrem Projekt machen:

• Code-Style-Konventionen
• Architekturmuster, die Sie verwenden
• Bibliotheken und Frameworks in Ihrem Stack
• Dinge, die der Worker immer / nie tun soll

Gehen Sie zu Skill Registry → Generate — das System liest Ihre Codebasis und schlägt automatisch Skills vor.

Schritt 4 — Ihre erste Session starten

arc my-project developer

Der Developer-Worker stellt sich vor, lädt Ihren Projektkontext und wartet auf Ihre erste Aufgabe.

Schritt 5 — Telegram verbinden (optional)

Wenn Sie Workern vom Smartphone aus oder unterwegs schnelle Nachrichten senden möchten, verbinden Sie Telegram über Settings → Telegram Bot.

Telegram ist optional — die gesamte Kernfunktionalität funktioniert über die CLI.

Wie Worker Wissen teilen

Alle Worker desselben Projekts teilen:

Wiki — Markdown-Dokumente, die Sie oder Worker über das Projekt schreiben. Architekturentscheidungen, API-Konventionen, „Dinge, die man wissen sollte", Onboarding-Notizen. Worker lesen das Wiki automatisch beim Session-Start.

Skills — wiederverwendbare Anweisungssets. Ein Skill „TypeScript strict mode" oder „immer zuerst Tests schreiben" wird in jede relevante Worker-Session injiziert.

Issues — wenn ein Worker an Issue #42 arbeitet, kennt er diesen Kontext. Andere Worker können sehen, woran gearbeitet wird.

Session-Historie — Worker können über arc sessions oder continue auf das verweisen, was in früheren Sessions besprochen wurde.

Standard Cloud — Always-On Workspace

Standard Cloud ist ab sofort verfügbar. Mit einem Standard-Cloud-Abonnement erhalten Sie einen dedizierten Docker-Container auf Arc-OS-Servern (Hetzner).

Was Ihnen das bringt

Persistente Projektdateien auf dem VPS Ihr /workspace-Verzeichnis liegt auf dem Server — nicht auf Ihrem Laptop. Die Dateien sind da, wenn Sie zurückkommen, auch nachdem Sie Ihren Rechner zugeklappt haben.

/workspace/my-project/   ← your code, always available
/home/arcuser/.claude/   ← Claude auth, persisted
/home/arcuser/.ssh/      ← GitHub SSH key, persisted

GitHub-Sync via SSH Der Container hat einen dedizierten SSH-Key, der mit Ihrem GitHub-Konto verbunden ist. Sie führen git clone einmal aus — danach git pull / push von überall, ohne sich erneut zu authentifizieren.

# Inside your container workspace
cd /workspace
git clone [email protected]:you/project.git   # once
git pull                                    # any time, from any device

Zugriff von jedem Gerät Öffnen Sie das Arc OS CRM vom Smartphone, Tablet oder einem anderen Rechner — Ihr Workspace und Ihre Dateien sind genau dort, wo Sie sie zurückgelassen haben. Kein „Das Projekt liegt auf meinem anderen Rechner"-Problem.

Dort weitermachen, wo Sie aufgehört haben

# In Telegram, next morning:
/continue

# Worker responds:
# Yesterday: finished auth middleware, tests remaining
# Continuing...

Der Worker nimmt den Kontext der vorherigen Session auf und arbeitet weiter — während Sie Kaffee trinken.

Was enthalten ist

Aktivierung

1. Gehen Sie zu Billing → Standard Cloud
2. Abonnieren Sie (aktuelle Preise finden Sie im Dashboard)
3. Klicken Sie auf Create Cloud Workspace — der Container ist in unter 60 Sekunden bereit
4. Verbinden Sie Claude Code (Ihr Claude-Pro-Abonnement)
5. Verbinden Sie den GitHub-SSH-Key
6. Klonen Sie Ihr Projekt nach /workspace

Ihr Claude-Pro/Max-Abonnement ist separat — Sie bringen Ihr eigenes mit. Arc OS berechnet keine Gebühren für die Claude-Nutzung.

Was Arc OS NICHT ist

• Kein autonomer Agent — Worker laufen nicht ohne Sie im Hintergrund. Jede Session startet, wenn Sie sie öffnen.
• Kein Kundensupport-Bot — Worker sprechen mit Ihnen (dem Entwickler), nicht mit Ihren Endnutzern.
• Kein Workflow-Automatisierungstool — Arc OS verbindet sich nicht eigenständig mit externen APIs. Worker helfen Ihnen, Code zu schreiben, der das tut.
• Kein Ersatz für Claude.ai — Arc OS baut auf Claude auf und ergänzt Projektkontext und Teamstruktur.

Häufige erste Fragen

F: Brauche ich Telegram? Nein. Telegram ist optional. Die CLI Bridge ist die primäre Schnittstelle.

F: Teilen Worker untereinander Kontext? Ja — über das gemeinsame Wiki, die Skills und den Issue-Tracker. Sie teilen keinen Live-Session-Zustand, lesen aber dieselbe Wissensbasis.

F: Kann ich Worker anpassen? Ja. Im Worker Studio (im CRM) können Sie den System-Prompt, die Skills und das Verhalten jedes Workers bearbeiten.

F: Wie funktioniert die Abrechnung? Sie nutzen Ihr eigenes Claude-Pro- oder Max-Abonnement. Arc OS erhebt keine zusätzlichen Gebühren für die Claude-Nutzung — Sie zahlen direkt an Anthropic. Arc OS berechnet eine Plattformgebühr für Dashboard und Tooling.

F: Was, wenn ich einen Worker-Typ möchte, der nicht aufgelistet ist? Erstellen Sie einen eigenen Worker im Worker Studio. Definieren Sie Rolle und Berechtigungen und injizieren Sie beliebige Skills.

Ihre Daten & Privatsphäre

Arc OS ist so konzipiert, dass Ihre Daten unter Ihrer Kontrolle bleiben.

Daten exportieren (DSGVO Art. 20)

Sie können jederzeit einen vollständigen JSON-Export all Ihrer Kontodaten herunterladen:

1. Gehen Sie zu Settings → Security → Download my data
2. Eine JSON-Datei wird generiert und sofort heruntergeladen

Der Export umfasst Ihre Kontoinformationen, Projekte, Chat-Verlauf, Issues, Wiki-Seiten, Skills und Aktivitätsprotokolle. Begrenzt auf 3 Exporte pro 24 Stunden.

Konto löschen (DSGVO Art. 17)

Sie können Ihr Konto jederzeit dauerhaft löschen:

1. Gehen Sie zu Settings → Security → Delete account
2. Bestätigen Sie die Löschung

Damit werden alle Ihre Daten in allen Tabellen sofort und dauerhaft gelöscht — Projekte, Chat-Verlauf, Skills, Vault-Einträge, Aktivitätsprotokolle und Ihr Kontodatensatz. Diese Aktion ist unwiderruflich.

Was wir nicht tun

• Wir verwenden Ihren Code, Ihre Prompts oder AI-Antworten nicht für Modelltraining
• Wir betten keine Werbe-Tracker oder Analytics-SDKs ein
• Wir setzen keine HTTP-Cookies — der gesamte Session-Zustand liegt in localStorage
• Wir geben Ihre Daten nicht an Dritte weiter, über das hinaus, was für den Betrieb des Dienstes nötig ist (Cloudflare CDN, Anthropic AI-Inferenz, OAuth-Anbieter)

Die vollständige Richtlinie finden Sie in der Datenschutzerklärung.