Workban Guard in Claude Code und Codex einrichten

Schritt 1

Workban-CLI anmelden

Workban Guard prüft deinen Zugang über dein Workban-Konto. Ist die workban-CLI noch nicht eingerichtet, installiere sie wie unter Einrichten beschrieben. Den persönlichen Token erstellst du in Workban unter Einstellungen → Tokens, und zwar in dem Workspace, für den Workban Guard freigeschaltet ist. Dann anmelden und prüfen:

workban auth login --api-url https://workban.de/api/v1 --token wb_p_…
workban auth status --api-url https://workban.de/api/v1

Workban Guard nutzt genau diesen Token. Verlässt du den Workspace oder widerrufst du den Token, endet der Zugang zu den Downloads. Installierte Kopien laufen weiter.

Schritt 2

Claude Code

Trag den Marketplace in deine ~/.claude/settings.json ein. Steht dort schon etwas, ergänze nur den Schlüssel extraKnownMarketplaces:

{
  "extraKnownMarketplaces": {
    "workban-guard": {
      "source": {
        "source": "url",
        "url": "https://guard.workban.de/marketplace.json",
        "headersHelper": "PATH=\"$PATH:$HOME/.local/bin:/usr/local/bin:/opt/homebrew/bin\" workban auth header --api-url https://workban.de/api/v1"
      },
      "autoUpdate": true
    }
  }
}

Starte Claude Code danach einmal, ein kurzer Start reicht: Erst dabei übernimmt es den Marketplace aus den Einstellungen. Dann installieren:

claude plugin install wbg@workban-guard

Starte Claude Code neu oder tippe /reload-plugins. Prüfen: /wbg:status zeigt den Stand. Bittest du Claude, git reset --hard auszuführen, fragt Workban Guard nach.

Den Header baut Claude Code bei jedem Abruf mit workban auth header, also mit dem Token, den die CLI ohnehin speichert. Der PATH-Zusatz findet die CLI auch, wenn Claude Code ohne Login-Shell startet (Desktop-App, IDE). Mit autoUpdate holt es neue Versionen von selbst.

Schritt 3

Codex CLI

Codex bindet Marketplaces aus einem Ordner oder einem Git-Repository ein. Lade den Marketplace-Ordner mit deinem Workban-Token herunter und füge ihn hinzu:

mkdir -p ~/.local/share/workban-guard && cd ~/.local/share/workban-guard
curl -fsSL -H "$(workban auth header --http --api-url https://workban.de/api/v1)" \
  -o wbg.zip https://guard.workban.de/download/wbg-marketplace.zip
unzip -oq wbg.zip && rm wbg.zip
codex plugin marketplace add ~/.local/share/workban-guard/workban-guard
codex plugin add wbg@workban-guard

Öffne Codex, rufe /hooks auf und vertraue den Hooks von Workban Guard. Erst dann laufen sie. Prüfen: $wbg-status.

Schritt 4

Für ein Projekt im Team

Damit alle im Projekt Workban Guard bekommen, committe eine .claude/settings.json mit Marketplace und Plugin. Sie enthält kein Geheimnis, jede Person nutzt ihr eigenes Workban-Konto:

{
  "extraKnownMarketplaces": {
    "workban-guard": {
      "source": {
        "source": "url",
        "url": "https://guard.workban.de/marketplace.json",
        "headersHelper": "PATH=\"$PATH:$HOME/.local/bin:/usr/local/bin:/opt/homebrew/bin\" workban auth header --api-url https://workban.de/api/v1"
      },
      "autoUpdate": true
    }
  },
  "enabledPlugins": {
    "wbg@workban-guard": true
  }
}

Jede Person meldet ihre workban-CLI an (Schritt 1), vertraut dem Projektordner beim ersten Start von Claude Code und installiert einmal:

claude plugin install wbg@workban-guard --scope project

Projektregeln stehen in .workban-guard.json. Darf Code aus dem Projekt nur an Claude gehen, dann so:

{
  "review": {
    "engines": [
      "claude"
    ]
  }
}

Schritt 5

Aktualisieren

Claude Code holt neue Versionen dank autoUpdate selbst. Sofort geht es so:

claude plugin marketplace update workban-guard
claude plugin update wbg@workban-guard

Für Codex lädst du den Ordner neu und fügst das Plugin noch einmal hinzu. Hat sich die Hook-Datei geändert, fragt Codex unter /hooks erneut nach deinem Vertrauen.

cd ~/.local/share/workban-guard
curl -fsSL -H "$(workban auth header --http --api-url https://workban.de/api/v1)" \
  -o wbg.zip https://guard.workban.de/download/wbg-marketplace.zip
unzip -oq wbg.zip && rm wbg.zip
codex plugin add wbg@workban-guard

Schritt 6

Entfernen

Pausieren reicht oft: /wbg:pause schaltet Workban Guard für höchstens 8 Stunden aus. Ganz entfernen:

claude plugin uninstall wbg@workban-guard

codex plugin remove wbg@workban-guard
codex plugin marketplace remove workban-guard

Schritt 7

Wenn etwas nicht klappt

401 beim Abruf

Die workban-CLI ist nicht angemeldet, oder der Token wurde widerrufen. workban auth status zeigt den Stand.

403 beim Abruf

Für den Workspace deines Tokens ist Workban Guard nicht freigeschaltet. Nimm einen Token aus dem freigeschalteten Workspace. Oder frag die Freischaltung als Owner oder Admin in Workban unter Einstellungen → Workban Guard an.

workban: command not found

Claude Code findet die CLI nicht. Liegt sie nicht in ~/.local/bin, /usr/local/bin oder /opt/homebrew/bin, ergänze ihren Ordner im headersHelper.

„isn't installed here“

Das Plugin steht in den Projekt-Einstellungen, ist bei dir aber noch nicht installiert: claude plugin install wbg@workban-guard --scope project.

„not found in marketplace“

Claude Code hat den Marketplace noch nicht übernommen. Starte Claude Code einmal und installiere dann erneut.

Codex prüft nichts

Die Hooks sind unter /hooks noch nicht vertraut.

node: command not found

Die Hooks starten node. Node.js 22.23.4, 24.22.1 oder 26.12.1 (oder neuer) muss im PATH liegen; ältere Versionen haben bekannte Sicherheitslücken.