KI-Buch-Archive

Projekte · codex-harness · Hilfe

Letzte Prüfung: 2026-07-31 · companion-0.1.1

Schnelle Hilfe bei typischen Drift-Problemen

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

Immer zuerst: codex --version notieren, dann in der Session / bzw. /status und codex --help. UI-Labels und Flags können abweichen – Buch-Konzept bleibt gültig, Syntax der aktuellen Doku folgen.

H-01 Produkt-Drift (UI)

Approval-Dialog sieht anders aus

Sofort: freigeben / ablehnen / Session-Allow als Idee bleibt. Den Dialog lesen; bei Unsicherheit ablehnen und in den Docs nachsehen – nicht Full Access oder approval_policy = "never" aus Gewohnheit.

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

Buch: Kap. 1 (Project Trust), Kap. 2 (Sandbox/Approvals) · Extern: learn.chatgpt.com/codex (Approvals & security)

H-02 Produkt-Drift (UI)

Slash-Command heißt anders oder fehlt unter /

Sofort: / und /status in deiner Version sind 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 · Extern: Docs + / / codex --help

H-03 Produkt-Drift / Setup

AGENTS.md oder config.toml greifen nicht

Sofort: Pfade und Trust prüfen (Repo-AGENTS.md, AGENTS.override.md, User unter ~/.codex bzw. CODEX_HOME, Project Trust vor Projekt-.codex/). In der Session /status – oft liegt die Datei im falschen Scope oder das Projekt ist nicht trusted.

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

Buch: Kap. 2, Kap. 4 · Extern: Docs (AGENTS.md, Configuration)

H-04 Setup (kein Codex-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 Codex.

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-Namen in den Hook-Configs mit der aktuellen Doku abgleichen, Session neu starten. Project Trust und geladene Config-Quellen ansehen.

Buch-Konzept bleibt gültig. Hooks erzwingen Schritte; Sandbox/Approvals 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, Sandbox/Approvals 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)

TOML-Feld oder Flag aus dem Buch wird abgelehnt

Sofort: Version notieren, Feldnamen in der aktuellen Doku suchen, Konzept (z. B. enge Sandbox vor Full Access / approval_policy) behalten und Syntax anpassen. Nicht das ganze Buch verwerfen.

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

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

H-08 Produkt-Drift (CI)

CI- / codex exec-Beispiel weicht ab

Sofort: Offizielle non-interactive-Doku und aktuelle Flag-Namen prüfen. Prinzip bleibt: begrenzte Rechte, Review, Merge bleibt menschlich.

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

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

Mehr nicht gelöst?

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