grok-bot
05bbd70056
Parallele Print-Ausgabe (just pdf-print / qa-print) mit Grayscale-Assets, Print-Metadaten und QA; headsep 0,12″ für KDP-sicheren Kolumnentitel.
Der Claude-Code-Harness
Titel: Der Claude-Code-Harness – CLAUDE.md, Permissions, MCP und Workflows in der Praxis
Praxisbuch (Deutsch) über Claude Code: Anthropics agentisches Coding-Tool in Terminal, IDE, Desktop und Web. Deep Cut an einem Produkt – und parallel portable Harness-Patterns (Memory vs. Policy, Agent-Schleife, Phasen, Erweiterbarkeit), die du in anderen Coding-Agents wiedererkennst. Stand der Fakten: Mitte/Ende 2026.
Stil: klar, unaufgeregt, praxisnah – analog zum Schwesterbuch Die KI hinter dem Vorhang. Kein Marketing, keine leeren Versprechen. Konzepte → Beispiele → nachbaubare Configs. Pattern-Transfer und Agenten-Landschaft: Anhang 8.11.
Für wen
| Stufe | Kapitel | Fokus |
|---|---|---|
| Tag-1-Einstieg (ohne Claude-Code-Vorkenntnisse) | 01 | Installation, erste Sitzung, Sicherheit – Terminal-Basics empfohlen |
| Einsteiger | 02, 03 | Explore–Plan–Code–Verify–Commit, CLAUDE.md, settings, Alltag |
| Fortgeschrittene | 04, 05 | Hierarchie, MCP, Skills, Hooks, Sessions |
| Experten & Teams | 06, 07 | Enterprise, CI, Compliance-Tiefe (Audit/Datenschutz/AI Act); Kontext/Session-BP, Troubleshooting |
| Nachschlagewerk | 08, Anhang A | Cheatsheets, Vorlagen-Index, stabile Kernvorlagen |
Einstieg für alle: 00-einleitung.md (warum Buch vs. Doku, Agent-Schleife, Vorkenntnisse, zwei Lesepfade). Kapitel 1–3 reichen für den produktiven Alltag; 4–6 bei konkretem Schmerz.
Lesepfad (empfohlen)
Zielgruppe: Claude-Code-Neulinge mit Dev-Basics (Terminal/cd, Dateien lesen; für Übungen Python-venv abtippen). Kein Informatik-Abschluss nötig – aber kein reines Non-Coder-Buch.
- Einleitung – Warum Buch vs. Doku, Modell vs. Harness, Agent-Schleife oder zuerst Kap. 1, Konzept nachholen (beide Pfade in der Einleitung)
- Tag-1-Einstieg – installieren, todo-cli-Setup, erste Aufgaben, Sicherheits-Basics
- Grundlagen – CLAUDE.md und Permissions (Minimum: eine Project-Config)
- Alltag – Explore–Plan–Code–Verify–Commit; hier darfst du wochenlang bleiben
- Fortgeschritten – Scopes, Rules, Local, Managed (bei Bedarf)
- MCP / Skills / Hooks – Erweiterbarkeit ohne Chaos (bei Bedarf)
- Teams & CI – Policy, GitHub Actions, Kosten, Audit/Compliance
- Best Practices – Kontext, Session-Steuerung, Persistenz, Troubleshooting
- Anhang – Cheatsheets, Vorlagen-Index und Roadmap
- Anhang A – Stabile Kernvorlagen (Hybrid: Minima im Buch, Voll-ZIPs online)
Du darfst springen. Die Kapitel sind so geschrieben, dass Querverweise greifen, ohne dass du alles linear gelesen haben musst.
Verzeichnisstruktur
ki-claude/
├── README.md
├── AGENTS.md # Prinzipien für Agents (Autoren-Harness)
├── CLAUDE.md # operativer Kompass (Build, Layout, Do/Don’t)
├── .grok/ # Grok: rules, skills, slash-commands
├── .claude/ # Claude Code: settings, rules, skills, hooks
├── 00-einleitung.md
├── 01-laien-einstieg.md
├── 02-grundlagen-und-konfiguration.md
├── 03-alltag-und-workflows.md
├── 04-fortgeschrittene-konfiguration.md
├── 05-mcp-skills-hooks.md
├── 06-teams-enterprise-ci.md
├── 07-best-practices-troubleshooting.md
├── 08-anhang-cheatsheets.md
├── 09-anhang-a-stabile-kernvorlagen.md # stabile Kerne im PDF
├── vorlagen/ # kopierfertige CLAUDE.md / settings (für Leser; ZIPs)
├── beispiele/ # Mini-Projekte und vollständige Configs (für Leser)
└── .gitignore
Vorlagen und Beispiele
Hybrid: Stabile Minima und Rituale im PDF → Anhang A. Vollständige, versionierte Dateien online.
Begleit-Service: https://books.maatini.space/projects/claude-code-harness/ — Stand & Drift, Errata, Material (ZIPs mit MANIFEST/SHA256 für beispiele/ und vorlagen/), Schnelle Hilfe, Feedback.
| Pfad | Inhalt |
|---|---|
09-anhang-a-stabile-kernvorlagen.md |
Stabile Kernvorlagen (A.1–A.7) im Buch |
vorlagen/CLAUDE.md.minimal.md |
Minimale Projekt-CLAUDE.md (Vollfassung ZIP/Repo) |
vorlagen/CLAUDE.md.team.md |
Team-taugliche CLAUDE.md |
vorlagen/settings.permissions.json |
Allow/Deny-Grundgerüst |
vorlagen/settings.hooks-format.json |
Format-on-edit Hook |
vorlagen/settings.hooks-guard.json |
PreToolUse-Guard (destruktives rm) |
vorlagen/hooks/ |
Format- und Guard-Scripts |
vorlagen/skills/verify/SKILL.md |
Verify-Skill |
vorlagen/PLAN.md.skeleton.md |
Feature-Plan für Session-Handoff |
vorlagen/agents/security-reviewer.md |
Custom Subagent (Security-Review) |
vorlagen/.mcp.json.beispiel.json |
MCP-Server-Beispiel |
beispiele/ |
Index der Mitmach-Beispiele |
beispiele/todo-cli/ |
Mini-Python-CLI inkl. CLAUDE.md, Settings, Rules, Skill, Hooks |
beispiele/configs/ |
Generische Project-Settings + GitHub-Actions-Gerüst |
Konventionen im Text
- Jetzt selbst machen: Übungen, die du im Terminal nachvollziehst (PDF: teal-Callout mit Icon)
- Kern in einem Satz / Kern: Kapitel- oder Abschnittsthese (PDF: navy-Callout)
- Achtung: echte Risiken – Trust, Secrets, Prod, CI-Rechte (PDF: burgundy-Callout; sparsam)
- Was du jetzt kannst / Nächste Schritte: Abschluss jedes größeren Abschnitts
- Wie & Warum: Tabellen und Configs sind eingerahmt – Mechanik und Begründung, nicht nur Stichworte (kein Callout)
- Code und Shell: fenced Blocks mit Sprach-Tag
- Platzhalter:
YOUR_TOKEN,your-project– nie echte Secrets
Quellen und Aktualität
Primärquelle: offizielle Claude-Code-Dokumentation unter code.claude.com/docs.
Installationswege, Settings-Scopes, Hooks und Memory-Verhalten können sich mit Releases ändern (Produkt-Drift). Bei Abweichungen gilt die aktuelle Doku; dieses Buch nennt den Stand Mitte/Ende 2026 und erklärt die stabilen Konzepte dahinter. Im Buch: Lesevertrag in Kapitel 0; Vorgehen bei Abweichung in Kapitel 7.9.
PDF bauen
Pipeline analog zu ../ki-hinterm-vorhang und ../ki-copilot: just + pandoc + lualatex + KOMA-Template.
Voraussetzungen: pandoc, just, TeX Live (LuaLaTeX, KOMA-Script scrbook), Fonts Charter + DejaVu.
just pdf # eBook A4 → dist/claude-code-harness.pdf
just pdf-print # KDP 6×9 Grayscale → dist/claude-code-harness-print.pdf
just qa # eBook-Checks
just qa-print # Print-Checks (6×9, Grayscale)
just all # pdf + qa
just all-print # pdf-print + qa-print
just clean
Weitere Targets: just pdf-draft, just pdf-plain, just assemble, just print-assets.
KDP-Upload (KI-Meldung Text vs. Bilder, nicht im Leser-PDF): pdf/front/kdp-ki-disclosure.md. Print-Interior-Hinweise: pdf/print/QA-NOTES.md.
00–09-*.md → scripts/assemble_book.py → build/book.md
↓ pandoc + template
dist/*.pdf
Weiterarbeiten am Projekt (Autoren-Harness)
| Datei / Ordner | Rolle |
|---|---|
AGENTS.md |
Prinzipien, Dateirollen, Qualitätsregeln |
CLAUDE.md |
Build/QA, Layout, Agent notes |
.grok/ |
Grok Build: rules, skills (pdf-bauen, lektorat, kapitel-review), commands |
.claude/ |
Claude Code: settings.json, path-scoped rules, skill, block-rm hook |
Autoren-Harness (Root) steuert Agents, die am Buch arbeiten. vorlagen/ und beispiele/ sind Content für Leser des Buchs – inklusive dem vollständigen Demo-Harness unter beispiele/todo-cli/.claude/.
Typischer Mitautor-Workflow: Kapitel editieren → bei Bedarf just pdf && just qa → Lektorat/Review über Skills bzw. Grok-Commands (/pdf, /lektorat, /review, /status).