KI-Buch-Archive

Projekte · claude-code-harness · Hilfe

Letzte Prüfung: 2026-07-29 · companion-0.1.2

Schnelle Hilfe bei typischen Drift-Problemen

Symptom → 2–3 Sätze Lösung → Buchkapitel und offizielle Doku. Kein Ersatz für claude doctor und die Docs – sondern der schnelle Einstieg.

Immer zuerst: claude --version notieren, dann claude doctor. UI-Labels und Flags können abweichen – Buch-Konzept bleibt gültig, Syntax der aktuellen Doku folgen.

H-01 Produkt-Drift (UI)

Permission-Dialog sieht anders aus

Sofort: allow / deny / ask als Idee bleibt. Den Dialog lesen, Scope prüfen (Project vs. User). Bei Unsicherheit ablehnen und in den Docs nachsehen – nicht „Allow always“ aus Gewohnheit.

Buch-Konzept bleibt gültig. Permissions sind Policy, nicht Memory.

Buch: Kap. 1 (Trust), Kap. 2 (Permissions) · Extern: code.claude.com/docs · claude doctor

H-02 Produkt-Drift (UI)

Slash-Command heißt anders oder fehlt in /help

Sofort: /help in deiner Version ist maßgeblich. Die Phase (Plan, Compact, …) zählt – nicht der exakte String im Buch-Screenshot.

Buch-Konzept bleibt gültig. Harness-Steuerung vs. „Modell umstimmen“.

Buch: Kap. 3, Kap. 7.9 · Extern: Docs + /help

H-03 Produkt-Drift / Setup

claude doctor meldet Warnung oder unklaren Settings-Pfad

Sofort: Doctor vor „härterem Prompt“ nutzen. Prüfen, welche Project-/User-Quellen geladen werden – oft ist die Datei im falschen Scope oder nie geladen.

Buch-Konzept bleibt gültig. Hierarchie und Scopes sind die Landkarte.

Buch: Kap. 1, Kap. 4, Kap. 7.6 · Extern: Docs · claude doctor

H-04 Setup (kein Claude-Bug)

ZIP entpackt, aber pytest / Import scheitert

Sofort: Im Ordner beispiele/todo-cli venv anlegen, pip install -e ".[dev]", dann pytest -q. Ohne Install greifen weder CLI noch Tests – unabhängig von Claude Code.

Buch-Konzept bleibt gültig. Verify gehört vor „fertig“.

Buch: Kap. 1 · Material: Vorlagen & Beispiele

H-05 Produkt-Drift / Config

Hooks feuern nicht

Sofort: Script-Pfad und Exec-Bit prüfen, Event-Name in settings.json mit der aktuellen Doku abgleichen, Session neu starten. Doctor und geladene Settings-Quellen ansehen.

Buch-Konzept bleibt gültig. Hooks erzwingen Schritte; Permissions sind die Tür.

Buch: Kap. 5 · Extern: Docs (Hooks)

H-06 Produkt-Drift / MCP

MCP-Server „verbunden“, Tool greift nicht

Sofort: Server-Status und Tool-Namen prüfen, Permissions für MCP-Tools, Env/Token außerhalb des Chats. Verbindung ≠ erlaubte Ausführung.

Buch-Konzept bleibt gültig. MCP erweitert Tools; Policy begrenzt sie.

Buch: Kap. 5 · Extern: Docs (MCP)

H-07 Produkt-Drift (Syntax)

JSON-Feld oder Flag aus dem Buch wird abgelehnt

Sofort: Version notieren, Feldnamen in der aktuellen Doku suchen, Konzept (z. B. Deny vor Allow always) behalten und Syntax anpassen. Nicht das ganze Buch verwerfen.

Buch-Konzept bleibt gültig. Siehe Lesevertrag und Kap. 7.9.

Buch: Kap. 0, Kap. 7.9 · Stand: Drift-Liste

H-08 Produkt-Drift (CI)

CI-Action-Input oder Workflow-Beispiel weicht ab

Sofort: Offizielle Action-/CLI-Doku und aktuelle Input-Namen prüfen. Prinzip bleibt: begrenzte Rechte, Review-Prompt, Merge bleibt menschlich.

Buch-Konzept bleibt gültig. Policy in CI ist enger als lokal.

Buch: Kap. 6 · Material: beispiele/configs/github-actions-claude.yml

Mehr nicht gelöst?

Troubleshooting-Raster im Buch (Kap. 7), dann Feedback mit claude --version und kurzer Symptom-Beschreibung.