# Was HB Code ist

> Eine Desktop-App, die Sessions mit OpenAI Codex und Claude Code in Ihren Projekten ausführt. Jeder Befehl, jede Datei und jeder Diff öffnet sich mit einem Klick. Die iPhone- und Android-Apps steuern dieselbe Session über ein Relay. Dieses Handbuch erklärt, wie die App gebaut ist.

Handbuch / Hier starten · Gegen den Quellcode geprüft am 2026-10-05 · https://www.hbcode.ai/de/docs

## Was anders ist

HB Code ist eine Mac- und Windows-App, die Coding-Agenten in einem lokalen Projektordner ausführt: OpenAI Codex mit Ihrem ChatGPT-Abo und Claude Code mit Ihrem Claude-Konto. Dieses Handbuch erklärt die Teile, die Sie auf dem Bildschirm nicht sehen: welcher Prozess was besitzt, wie eine Nachricht zu einem Agent-Turn wird und bestätigt wird, wie die Timeline aus Verlaufsseiten und einem Live-Overlay entsteht, was das Relay tut und was es verweigert, und wie die mitgelieferten Tools Ihr Chrome, Gemini und Ihre Telefone erreichen.

Jede Session führt einen Agenten aus, Codex oder Claude Code. Sie wählen ihn, wenn Sie die Session anlegen, auf dem Desktop oder auf einem Telefon, und er bleibt für die ganze Lebensdauer der Session. Der Desktop merkt sich die letzte Wahl für die nächste neue Session und beginnt mit Codex. Beide Agenten nutzen eine Chat-Schicht, daher gelten die Kapitel unten für beide, sofern sie nichts anderes sagen. Die Liste zeigt, was die beiden Agenten teilen. Die Tabelle zeigt, worin sie sich unterscheiden.

- Der Desktop startet den Agentenprozess und besitzt ihn.
- Jede Nachricht läuft durch die dauerhafte Outbox und hat eine operationId.
- Eine Nachricht, die Sie während eines Runs senden, kommt in den laufenden Turn. Sie können sie auch für später in die Warteschlange der Session legen.
- Ein Tool-Katalog im Namensraum hbcode. Vier Tools sind immer darin.
- Eine Skala mit vier Zugriffsstufen.
- Settings → Agents zeigt Konten, Limits und Nutzung.

| Thema | Codex | Claude |
| --- | --- | --- |
| Prozess | Ein langlebiger app-server-Kindprozess. Ein Kindprozess bedient viele Sessions. | Ein Node-Prozess pro Run, der Agent-Host, mit dem Claude Agent SDK. Er endet mit seinem Run. |
| Nachweis der Zustellung | Codex gibt die operationId als clientId der Benutzernachricht zurück. | Das gespeicherte Transkript enthält die Nachrichten-UUID der Operation. |
| Eine Nachricht während eines Runs | turn/steer fügt die Nachricht dem laufenden Turn hinzu. | Der Agent-Host schreibt die Nachricht in die offene Query. Claude liest sie nach seinem aktuellen Schritt. |
| Tools | Der Thread behält die Liste von seinem Start. Codex führt diese Tools ohne Nachfrage aus. | Jeder Run bekommt eine neue Liste. Claude fragt je nach Zugriffsstufe, außer bei der Session-Suche und bei Session-Nachrichten. |
| Namen der Stufen | Read only, Full auto, Full access, Never ask. | Plan mode, Accept edits, Auto mode, Bypass permissions. |
| Konten | ChatGPT-Anmeldungen, gespeichert als Codex-Auth-Profile. | Die Claude-Anmeldung des Computers und hinzugefügte Kontoordner. |

- [Codex und Claude nebeneinander](https://www.hbcode.ai/de/docs/agents.md): Prozess-Lebensdauern, die Dispatch-Schicht, Zugriffsstufen, Fähigkeiten und Limits für beide Agenten.

Die Zeichnung unten folgt einer Nachricht einer Codex-Session von einem Telefon bis zum Agent. Eine Claude-Session nimmt denselben Weg bis zur Outbox und beweist die Zustellung aus ihrem gespeicherten Transkript.

**Eine Nachricht bleibt auf dem Telefon bis zur Quittung des Desktops und in der Outbox bis zum Echo von Codex**

Eine vom Telefon gesendete Nachricht läuft über das Relay zum Desktop. Er speichert sie als Outbox-Eintrag und schickt diesem Telefon eine Quittung, erst dann verwirft das Telefon seine eigene Kopie. Der Desktop startet einen Codex-Turn mit der Operations-ID als Client-Nachrichten-ID und entfernt den Outbox-Eintrag, wenn Codex diese ID als Echo zurückgibt. Das Relay reicht Nachrichten nur durch: Es hält keine Warteschlange und kein Replay-Protokoll. Timeline-Updates erreichen danach die Telefone mit einem Interesse-Lease, und die Zeile auf dem Telefon trägt dieselbe Operations-ID. Ist die Antwort auf turn/start unklar oder startet der Desktop vor dem Echo neu, sucht der Desktop die Operations-ID im Verlauf der Session.

- **Quittung** (queueId · operationId): Kommt zurück, sobald die Nachricht in der Outbox des Desktops gespeichert ist, und nur an das Telefon, das gefragt hat. Das Telefon wartet bis zu 20 s darauf und behält seine eigene Kopie, bis sie eintrifft.
- **Codex-Echo** (userMessage.clientId): Der Drain-Task sendet die operationId als clientUserMessageId. Bringt die Live-Benachrichtigung item/completed sie zurück, verbucht der Desktop die Nachricht als gesendet und entfernt den Outbox-Eintrag.
- **Kein Desktop verbunden** (-32011 · -32010): Das Relay antwortet dem Telefon selbst: -32011, solange sich der Desktop neu verbindet, -32010, sobald er offline ist. Nichts wird zwischengespeichert, und das Telefon behält seine Kopie.

## Die drei Regeln des Entwurfs

- Der Desktop ist die Autorität. Er besitzt die Projektdateien, die Agent-Prozesse, die dauerhafte Outbox und den RPC-Router, mit dem die Telefone sprechen.
- Das Relay ist absichtlich dumm. Es leitet Umschläge zwischen authentifizierten Geräten weiter und hält keine Projektinhalte, keine dauerhafte Warteschlange und kein Replay-Protokoll.
- Jede Timeline-Zeile ist ein typisiertes Objekt mit stabiler Identität, sodass dieselbe Unterhaltung auf dem Desktop und auf einem Telefon identisch gerendert wird, ohne dass Textvergleiche oder Zeitstempel entscheiden, was existiert.

## Kapitel nach Thema

- [Einrichtung: Anmeldungen, Regionen, Fernzugriff](https://www.hbcode.ai/de/docs/setup.md): Die Anmeldungen bei HB Code, ChatGPT und Claude, eine Region pro Konto, der Fernzugriff-Schalter und die Vorschau vor Pro.
- [Prozessgrenzen](https://www.hbcode.ai/de/docs/architecture.md): Die vier Anwendungsgrenzen, die zwei Agent-Prozessgrenzen und eine mobile Anfrage bis zur Ausführung verfolgt.
- [Die Claude-Agent-SDK-Integration](https://www.hbcode.ai/de/docs/claude-agent-sdk.md): Der Agent-Host, wie Claudes gespeicherte Zeilen zu Timeline-Zeilen werden, Freigaben, Subagents und Konten.
- [Nachrichtenzustellung](https://www.hbcode.ai/de/docs/message-delivery.md): Outbox-Verwahrung, Turn-Zulassung, der Zustellungsnachweis des Agenten und was passiert, wenn eine Antwort verloren geht.
- [Timeline](https://www.hbcode.ai/de/docs/timeline.md): Verlaufsseiten, das revisionierte Live-Overlay, Settlement-Epochen und der Splice-Vertrag der Paginierung.
- [Speichereigentum](https://www.hbcode.ai/de/docs/storage.md): appdata.db, das Codex-Profilverzeichnis, Claudes eigener Ordner, PostgreSQL und die Exact-Source-Regeln für Transkripte.
- [Relay-Wire-Protokoll](https://www.hbcode.ai/de/docs/relay-protocol.md): Nachrichtenhüllen, Registrierung, Zuordnung ausstehender Anfragen und die zwei Idempotenz-Schichten.
- [Browser Bridge](https://www.hbcode.ai/de/docs/tools/browser-bridge.md): Native Messaging, Chrome-DevTools-Eingaben, Inkognito-Recherchefenster und Upload-Prüfung.
- [Bauen, testen und beitragen](https://www.hbcode.ai/de/docs/contributing.md): Der Sidecar-Build, die Prüfungen pro Grenze, und wie Sie eine Operation durch den Code verfolgen.