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.
Gegen den Quellcode geprüft am 5. Oktober 2026
Auf dieser Seite
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 operation | Das gespeicherte Transkript enthält die Nachrichten-UUID der Operation. |
| Eine Nachricht während eines Runs | turn/ | 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 | Chat | Die Claude-Anmeldung des Computers und hinzugefügte Kontoordner. |
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.
- QuittungqueueId · 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-EchouserMessage.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.