Wie du mit Claude Code 100-mal produktiver wirst. Vollständiger Systemleitfaden für Wissensarbeiter.

Iwo Szapar
Mitgründer von AI Maturity Index (im Januar 2026 von ISG, Nasdaq: III übernommen). Habe über 3.000 Unternehmen dabei geholfen, ihre Arbeitsweise zu transformieren. Vorgestellt in der Financial Times und Forbes – und ich führe mein gesamtes Geschäft mit genau dem System, das du gleich lernst.
Referenzen:
Was mich unterscheidet:
Dieser Leitfaden ist in 6 aufeinander aufbauenden Phasen aufgebaut, plus einer neuen Harness-Engineering-Ebene für zuverlässige KI-Arbeit.
Phasen 1-2: Grundlagen (15 Min.)
Verstehe, was Claude Code ist, und bring es zum Laufen
Phasen 3-4: Die zentrale Power (30 Min.)
Progressive Disclosure, Hooks, Agenten, Skills und kumulatives Lernen
Phase 5: Fortgeschritten (20 Min.)
MCP-Integrationen, um deine Business-Tools anzubinden
Phase 6: Umsetzung (10 Min.)
Dein Weg nach vorn mit fertigen Vorlagen
Profi-Tipp: Klicke auf die Abschnittstitel zum Auf- und Zuklappen. Spare Zeit, indem du dich auf das konzentrierst, was du am dringendsten brauchst.
Willst du die Magie sehen, bevor du die Theorie liest? Wähle dein Setup und mach das jetzt sofort.
Claude Code installieren (2 Min.)
curl -fsSL https://claude.ai/install.sh | bashTerminal öffnen, authentifizieren, starten
claude login
claudeSag das (wörtlich kopieren und einfügen):
"Research the top 3 competitors in my space and
summarize their pricing models. Run them in parallel
with subagents."Sieh zu, wie Claude automatisch mehrere Agenten startet
Du hast gerade einen Multi-Agenten-Workflow ausgeführt. Drei KI-Worker haben parallel recherchiert, während du dich zurücklehnen konntest. Das ist die Grundidee – lies jetzt weiter, um zu erfahren, wie du ein komplettes System darum herum baust.
Nutzt du Claude Code schon? Spring direkt zu Phase 4: Agenten, Skills, Hooks & Harnesses für die fortgeschrittenen Orchestrierungsmuster.
Einführung in 30 Sekunden
Claude Code ist ein KI-Coding-Agent von Anthropic, der über dein Terminal, deine IDE, die Desktop-App und den Browser hinweg arbeitet. Sitzungen starten weiterhin bei null, aber dein Repository kann dauerhaften Kontext über Dateien wie CLAUDE.md, .claude/rules/, Skills, Agenten und Projektdokumentation mitführen.
"Claude Code ist das am meisten unterschätzte KI-Tool für nicht-technische Leute."
Die Benennung ist verwirrend, weil die Desktop-App jetzt mehrere Tabs enthält. Trenne die Produktoberfläche vom Workflow, den du willst.
Chat-Tab · Browser oder App
Claude Chat
Am besten für: schnelles Denken, nicht für wiederverwendbare Systeme
Cowork-Tab · Desktop-App
Claude Cowork
Am besten für: Berater, Analysten, Operators
Code-Tab, CLI, IDE, Web
Claude Code (dieser Leitfaden)
Am besten für: Power-User, die ein wiederverwendbares Betriebssystem bauen
Du liest gerade den Leitfaden dazu ↗Unsicher? Nimm Chat für einmaliges Denken, Cowork für Hintergrundarbeit mit wenig Einrichtung und Claude Code, wenn du Projektspeicher, eigene Workflows, Hooks, MCP und wiederholbare Systeme willst.
Jeder Wissensarbeiter, der:
Berater
Kundenberichte, Angebote, Frameworks
Product Manager
PRDs, Roadmaps, User Stories
Marketer
Content-Kalender, Kampagnen
Gründer
Strategie, Investor-Updates, Operations
Sales & Revenue
Pipeline, Outreach, CRM-Automatisierung
Researcher & Analysten
Datensynthese, Wettbewerbsanalyse
Nicht ideal für:
Einmalige Fragen ohne Folgeaufgaben, einfaches Brainstorming oder Aufgaben, die sich nie wiederholen. Dafür reicht der normale Claude-Chat völlig.
"Ich bin kein Programmierer. Ich schreibe keinen Code. Deshalb ist es unglaublich, dass so etwas verfügbar ist und tatsächlich passieren kann."
— Dominic, Cloud-Berater • Hat mit Claude Code eine Abo-Plattform gebaut, ganz ohne Programmierhintergrund
Bevor wir loslegen
Dieses Tutorial vermittelt jedes Konzept Schritt für Schritt. Aber wenn du sehen willst, wie ein komplettes System in der Praxis aussieht, hier ist ein 3-minütiger Clip aus einer Live-Session.
Ein Befehl. Die KI liest deine E-Mails, WhatsApp-Nachrichten, Aufgaben und dein CRM – und sagt dir dann, worauf du dich heute konzentrieren solltest. Alles, was du hier siehst, lernst du in den folgenden Phasen zu bauen.
Traditionelle KI (ChatGPT, Claude Chat): Jedes Gespräch beginnt bei null. Du erklärst dein Projekt mehr als 10-mal pro Woche neu.
Claude-Code-Lösung: Das Repository als dauerhafter Speicher. Die Datei CLAUDE.md wird zu jedem Sitzungsstart geladen. Dev-Docs (plan.md, context.md, tasks.md) für mehrwöchige Projekte.
Traditionelle KI-Sitzung:
Session 1:
You: "I'm building a SaaS product..."
[Explain project for 10 minutes]
Session 2 (next day):
You: "Remember my SaaS product?"
AI: "What product? Please explain."
[Re-explain AGAIN]Claude-Code-Sitzung:
Session 1:
Claude reads CLAUDE.md
"I see you're building a SaaS
product. What would you like?"
Session 2 (next day):
Claude reads CLAUDE.md
"Back to the SaaS project.
What's next?"Kernaussage: Dauerhafter Speicher eliminiert den Overhead des Kontextwechsels
Echter Effekt: Richard (Unternehmensberater, Australien) hat eine Woche damit verbracht, Claude Code allein einzurichten. Nach einer einzigen 2-stündigen Session mit den Second-Brain-Vorlagen: "Du hast in diesem Call das gelöst, was ich noch falsch gemacht habe – ich habe es gepromptet, als wäre es ein Chatbot. Mit Befehlen und Agenten kannst du es deinen täglichen Workflow für dich managen lassen. Das ist riesig. Definitiv das Geld wert, um mir drei bis vier Monate zu sparen, in denen ich mich sonst durchgehangelt hätte."
Traditionelle KI: Kann nur an EINER Sache gleichzeitig arbeiten. 10 Dateien analysieren? Auf jede einzeln warten.
Claude-Code-Lösung: Subagenten führen mehrere Aufgaben parallel innerhalb der Sitzung aus. Für unabhängige, langlaufende Arbeit nutzt du Hintergrundsitzungen aus Claude Code im Web, Desktop, Slack oder der Agent View.
SEQUENTIAL (ChatGPT Way):
[Agent 1: Research] → [Agent 2: Content] → [Agent 3: Analysis]
15 min 20 min 10 min
Total: 45 minutes
PARALLEL (Claude Code Way):
[Agent 1: Research] ─┐
[Agent 2: Content] ─┼─ All running simultaneously
[Agent 3: Analysis] ─┘
Total: MAX(15, 20, 10) = 20 minutes
Speedup: 45 min → 20 min = 2.25x fasterEchter Effekt: Ein Berater analysierte 5 Wettbewerber (Asana, Monday, ClickUp, Notion, Airtable). ChatGPT brauchte 45 Min. und schaffte nur 3. Claude Code mit Subagenten brauchte 20 Min. und erledigte alle 5 gleichzeitig.
Kernaussage: Hintergrund-Agenten ermöglichen echte parallele Verarbeitung
Echter Effekt: Damian (KI-Berater, Schweiz) baute in 2 Tagen einen kompletten Social-Media-Content-Flow – etwas, das ein kommerzielles SaaS-Tool für Hunderte pro Monat verkauft. Sein Workflow: Ideen erfassen → LinkedIn-Stimm-DNA extrahieren → Karussell-PDFs erzeugen → Posts planen. "Ein Freund hat mir gerade von dieser neuen, super coolen Lösung erzählt, die er gekauft hat. Es war genau das, was ich in zwei Tagen mit dem Second Brain gebaut hatte. Reine Magie."
Traditionelle KI: Doks kopieren → einfügen → warten. Code kopieren → einfügen → warten. Mehr als 30 Minuten pro Sitzung verloren.
Claude-Code-Lösung: MCP (Model Context Protocol) verbindet sich direkt mit Gmail, Kalender, CRM und Analytics. Schluss mit dem Kopieren und Einfügen zwischen Apps.
Manueller Prozess:
Zeit: 35 Minuten
MCP-Prozess:
Zeit: 3 Minuten
Echter Effekt: Ein Sales-Ops-Manager ging von 2 Stunden/Woche manueller CRM-Pflege auf null. Alles automatisiert über MCP.
Traditionelle KI: Die KI kommt nicht an deine echten Business-Tools heran. Überall manueller Datentransfer.
Claude-Code-Lösung: Skills aktivieren sich automatisch anhand von Schlüsselwörtern. Hooks führen Skripte automatisch aus. Einmal bauen, für immer wiederverwenden.
Traditional AI:
You: "Generate weekly sales report"
AI: "Please provide data..."
You: [Copy sales from HubSpot]
You: [Copy traffic from Analytics]
You: [Copy revenue from Stripe]
AI: [Generates report]
You: [Format manually]
You: [Send to team]
Time: 45 minutes
Claude Code with Skills:
You: "Generate weekly sales report"
Skill auto-loads:
├─ MCP: Fetch HubSpot deals
├─ MCP: Fetch GA4 traffic
├─ MCP: Fetch Stripe revenue
└─ Generate formatted report
└─ Save to reports/weekly-2025-01-11.md
Time: 2 minutesEchter Effekt: Eine Marketingleiterin automatisierte 5 Wochenberichte. Von 3,5 Stunden/Woche auf 10 Minuten/Woche. Das ist 21-mal schneller.
Das ist nicht theoretisch. Das sind echte Admin-Seiten, die genau jetzt im Produktivbetrieb laufen.
| SaaS-Kategorie | Typische Monatskosten | Jetzt in Second Brain integriert |
|---|---|---|
| CRM (HubSpot/Pipedrive) | $45-100/mo | Sales-Pipeline + Prospect-Tracking |
| E-Mail-Marketing (Mailchimp) | $30-60/mo | Automatisierte Sequenzen + Newsletter |
| Content-Planung (Buffer) | $15-30/mo | Content-Kalender + Queue-Management |
| Aufgabenmanagement (Asana/Linear) | $10-25/mo | Aufgaben-Tracking + Sitzungs-Workflow |
| Analytics-Dashboard | $20-50/mo | Business Intelligence + Reporting |
| Kunden-Lieferportal | Individuell | Repository-Generator + Onboarding |
$120-265/Mon. vorher
$20/Mon. nachher (Claude Pro)
Das ist kein Vergleich zwischen Claude und HubSpot. HubSpot ist besser darin, ein CRM zu sein. Aber für einen Solopreneur oder ein kleines Team deckt Claude Code + strukturierter Kontext 80 % dessen ab, wofür du diese Tools tatsächlich nutzt – zu 10 % der Kosten.
Checkliste Phase 1
Willst du die Abkürzung?
Spar dir 2-3 Wochen Trial and Error. Alles weiter unten ist im Second Brain bereits fertig gebaut.
Pakete ansehenClaude-Abo oder API-Abrechnung
Die meisten sollten mit einem Claude-Pro- oder Max-Plan für planbare Monatskosten starten. API-Abrechnung gibt es ebenfalls für programmatische oder Team-Workflows.
Wähle, wie du Claude Code nutzt
Wähle die Oberfläche, die zu deinem Komfortlevel und deinem Betriebssystem passt
Claude Code im Web
Research Preview. Verbinde GitHub unter claude.ai/code. Läuft in einer von Anthropic verwalteten Cloud-VM.
Code-Tab der Desktop-App
Native App für macOS und Windows. GUI für Claude Code mit Seitenleiste, Terminal, Datei-Editor, Diffs, Vorschauen und PR-Monitoring.
Terminal-CLI (am leistungsstärksten)
Volle Kontrolle über lokale Dateien, Shell, MCP, Hooks, Skripte, CI und Automatisierung.
IDE-Erweiterung
VS Code, Cursor und IDEs der JetBrains-Familie. Claude Code läuft direkt in deinem Editor, neben deinen Dateien.
GitHub-Konto (optional, aber empfohlen)
Stell es dir vor wie "Google Drive für das Gehirn deiner KI" – es sichert dein Repository und synchronisiert es über Geräte hinweg.
Checkliste Phase 2
Versuch nicht, das ganze System auf einmal zu bauen. Der größte Fehler ist, gleich am ersten Tag alles automatisieren zu wollen. Das klappt nie.
Wähle einen Anwendungsfall pro Tag. Mehr nicht.
Tag 1
"Hilf mir, dieses Unternehmen zu recherchieren."
Tag 2
"Schreib mir einen LinkedIn-Post über X."
Tag 3
"Prüfe diese Landingpage."
Tag 4
"Erstelle einen Skill für meinen Wochenbericht."
Stück für Stück füllt sich dein Repo. Deine Skills, Agenten, Rules und deine CLAUDE.md werden klüger. Nach ein paar Wochen blickst du zurück und merkst, dass du ein ganzes System gebaut hast – ein kleines Teil nach dem anderen.
Deine 4-Wochen-Einführungs-Roadmap
Subagenten (null Einrichtung nötig)
Bitte Claude Code, für 2-3 unabhängige Recherche-Aufgaben Subagenten zu nutzen. Achte darauf, wie dein Hauptgespräch sauber bleibt, während die Spezialisten parallel arbeiten.
Dein erster Skill
Wähle deinen am häufigsten wiederkehrenden Workflow (Content-Erstellung, Code-Review, Datenanalyse). Erstelle .claude/skills/my-workflow/SKILL.md mit einer klaren Beschreibung und Schritt-für-Schritt-Anweisungen. Teste, indem du natürlich danach fragst oder /my-workflow aufrufst, und iteriere dann.
Skills + Subagenten kombiniert
Füge in deinem Skill Schritte hinzu, die Subagenten für Recherche nutzen. Verkette zwei Skills. Richte deine CLAUDE.md mit Projektkontext und Präferenzen ein.
Harness + MCP + Fortgeschrittenes (optional)
Füge Plan-, Test-, Review- und Freigabe-Gates um deine wichtigsten Workflows hinzu. Verbinde dann Business-Tools über MCP. Die meisten sollten den Harness bauen, bevor sie mehr Autonomie geben.
Hinweis: CLAUDE.md ist optional, aber für dauerhaften Kontext dringend empfohlen. Sie erspart dir, dein Projekt in jeder Sitzung neu zu erklären.
Eine spezielle Markdown-Datei, die Claude Code zu Beginn jeder Sitzung lädt. Stell sie dir als das Handbuch deines Projekts vor – aber für die KI, nicht für Menschen.
Ohne CLAUDE.md:
Mit CLAUDE.md:
# CLAUDE.md
## Project Overview
[One sentence: What you're building]
**Mission**: [Your project's goal]
**Target Users**: [Who uses this]
## Repository Structure
- `company-brain/`: Business knowledge
- `agents/`: AI agent templates
- `data/`: Datasets and analysis
## Key Guidelines
- [Important fact #1 Claude should always know]
- [Important fact #2]
- [Important fact #3]
## Output Standards
- [How you want deliverables formatted]
- [Your writing style preferences]
## Guardrails
- [Things Claude should NEVER do]
- [Data privacy rules]Sieh es in der Praxis
Vergiss die Theorie für einen Moment. Hier ist ein echtes Second-Brain-Repository mit über 30 Agenten, Skills, Befehlen und Wissensdateien – die Struktur, die alles in diesem Tutorial zum Laufen bringt.
"Ich habe alles in CLAUDE.md gepackt – 500 Zeilen. Claude fing an, die Hälfte zu ignorieren. Dann habe ich von Progressive Disclosure gelernt und alles hat klick gemacht."
— Andrew, Product Director
Der Fehler Nr. 1, den alle machen
Die Leute stopfen alles in CLAUDE.md – Business-Kontext, API-Doks, Style-Guides, Gotchas, Vorlagen. Ab 500+ Zeilen fängt Claude an, Anweisungen zu ignorieren. Studien zeigen, dass das Befolgen von Anweisungen ab etwa 300 Zeilen und etwa 50 Regeln nachlässt. Mehr Anweisungen führen paradoxerweise zu schlechterem Befolgen von Anweisungen.
Die Lösung ist Progressive Disclosure: Halte CLAUDE.md kurz (unter 200 Zeilen) mit Verweistabellen, die detaillierte Doks bei Bedarf laden. Denk an ein Inhaltsverzeichnis, nicht an eine Enzyklopädie.
Monolithisch (bricht bei Skalierung):
CLAUDE.md (972 lines)
├─ Business context (50 lines)
├─ API documentation (200 lines)
├─ Database schema (150 lines)
├─ Style guide (100 lines)
├─ Email templates (120 lines)
├─ Gotchas list (80 lines)
├─ MCP configs (150 lines)
└─ ... Claude ignores half of itGeschichtet (skaliert unbegrenzt):
CLAUDE.md (200 lines)
├─ Business context (always loaded)
├─ Tech stack (always loaded)
├─ Pointer table → docs/
├─ Critical gotchas (3-5 rules)
└─ Self-improvement protocol
.claude/docs/ (loaded on demand)
├─ api-guide.md
├─ database-ops.md
├─ email-system.md
└─ gotchas.mdEbene 1: CLAUDE.md (immer geladen – unter 200 Zeilen)
Nur universell anwendbarer Kontext gehört hierher. Business-Kontext, Tech-Stack, kritische Gotchas und eine Verweistabelle zu allem anderen.
## Architecture & Patterns
| Area | Read This File |
|-------------------|----------------------------|
| Writing API code | .claude/docs/api-guide.md |
| Database work | .claude/docs/database.md |
| Email system | docs/EMAIL_SYSTEM.md |
| Known gotchas | .claude/docs/gotchas.md |
| Troubleshooting | docs/TROUBLESHOOTING.md |
Read the relevant file BEFORE making changes
in that area.Wenn Claude am E-Mail-System arbeiten muss, liest es CLAUDE.md, sieht den Verweis und lädt docs/EMAIL_SYSTEM.md bei Bedarf. Die übrigen Doks bleiben außerhalb des Kontexts.
Ebene 2: .claude/docs/ (bei Bedarf geladen)
Detaillierte Dokumentation, die Claude nur liest, wenn es in einem bestimmten Bereich arbeitet. Jede Datei beginnt mit einem "Wann lesen"-Trigger.
# API Development Guide
> When to read: Before writing or modifying
> any API endpoint
## Pattern: Legacy Request/Response
All endpoints MUST use VercelRequest/
VercelResponse pattern. Web API pattern
causes 30-second timeouts.
## Required: .js Extensions
All imports in API files MUST include .js
extension. Missing extensions cause silent
build failures in production.
## Template
export default async function handler(
req: VercelRequest,
res: VercelResponse
) { ... }Ebene 3: knowledge/ (agentenspezifischer Kontext)
Tiefes Referenzmaterial, das nur bestimmte Agenten oder Skills brauchen. Wird nie in allgemeine Sitzungen geladen.
.claude/knowledge/
├─ content-creator/ # Voice DNA, templates
│ ├─ brand-voice.md
│ └─ content-types.md
├─ sales/ # CRM context, scripts
│ ├─ objection-handling.md
│ └─ email-sequences.md
└─ data-analysis/ # Schema, query patterns
└─ common-queries.mdWarum das funktioniert:
Kontext-Effizienz
Eine schlanke CLAUDE.md mit Verweisen nutzt weit weniger Tokens als eine riesige Datei. Lässt Platz für die eigentliche Arbeit.
Besseres Befolgen von Anweisungen
50 Regeln in einer fokussierten Datei schlagen 200 Regeln in einer aufgeblähten Datei. Jedes Mal.
Skaliert unbegrenzt
Füge neue Doks hinzu, ohne CLAUDE.md anzufassen. Ergänze einfach eine Zeile in der Verweistabelle.
Verschiebe jeden Abschnitt, der länger als 20 Zeilen ist, aus CLAUDE.md in eine eigene Datei.
Ordne jeden Arbeitsbereich der Datei zu, die Claude vor dem Start lesen soll.
Beginne jede Doks-Datei mit einem einzeiligen Trigger: "Wann lesen: bevor du an [X] arbeitest"
Diese Architektur zu bauen dauert 4-6 Stunden
Verweistabellen schreiben, Doks mit "Wann lesen"-Triggern organisieren, testen, dass Claude die richtige Datei zur richtigen Zeit lädt. Das Second Brain kommt mit über 10 vorkonfigurierten Doks, Trigger-Tabellen und der vollständigen, startbereiten Progressive-Disclosure-Architektur.
Spar dir die EinrichtungCheckliste Phase 3
"Das ist der echte Vorteil von Claude Code. Parallele Programmierung. Du feuerst 3 Recherche-Agenten ab und alle kommen mit Ergebnissen zurück, während du am Hauptstrang weiterarbeitest."
— Wytze, Community-Mitglied
Subagenten sind spezialisierte KI-Worker mit isoliertem Kontext. Wie ein Recherche-Analyst UND ein Texter, die gleichzeitig in deinem Team arbeiten.
Wann Subagenten nutzen:
Wann NICHT nutzen:
Echtes Beispiel: Wettbewerbsanalyse
Aufgabe: 5 Wettbewerber analysieren (Asana, Monday, ClickUp, Notion, Airtable)
Sequenziell (ChatGPT): 45 Minuten
Einen analysieren → nächster → nächster... 3 schlecht erledigt, 2 aus Erschöpfung übersprungen
Parallel (Claude Code): 8 Minuten
5 Subagenten laufen gleichzeitig. Alle 5 fertig, hohe Qualität, einheitliches Format
USER PROMPT:
"Analyze these 5 competitors: Asana, Monday, ClickUp,
Notion, Airtable. For each, analyze pricing, features,
target market."
CLAUDE CODE SPAWNS 5 SUBAGENTS:
┌─────────────────────────────────────────────┐
│ Main Claude │
│ ├─ Subagent 1: Analyze Asana │
│ ├─ Subagent 2: Analyze Monday │
│ ├─ Subagent 3: Analyze ClickUp │
│ ├─ Subagent 4: Analyze Notion │
│ └─ Subagent 5: Analyze Airtable │
│ │
│ [All run in parallel] │
│ │
│ After 8 min: Aggregate results → │
│ Generate comparison table │
└─────────────────────────────────────────────┘Realitätscheck zu den Kosten
Subagenten verbrauchen ihre eigenen Kontextfenster. Eine parallele Aufgabe mit 3 Agenten nutzt rund 3-mal so viele Tokens wie die sequenzielle Erledigung. Agenten-Teams (5+ Agenten) können 7-mal oder mehr erreichen. Das ist wichtig, wenn du per API abrechnest.
| Strategie | Wie | Ersparnis |
|---|---|---|
| Kleinere Modelle für Worker | Nutze Haiku für einfache Aufgaben, Opus für Entscheidungen | 60-80% |
| Agenten-Scope begrenzen | Tools und Dateizugriff pro Agent einschränken | 30-50% |
| Explore-Agenten zum Suchen nutzen | Nur Lesen, schnell, minimaler Token-Verbrauch | ~70% |
| In CLAUDE.md cachen | Ergebnisse speichern, damit Agenten nicht erneut recherchieren | Erheblich |
| max_turns setzen | Außer Kontrolle geratene Agenten-Schleifen verhindern | Harte Obergrenze |
Mit einem Claude-Pro/Max-Abo (20-200 $/Mon.) laufen Subagenten innerhalb deiner Plan-Limits – keine zusätzlichen Kosten pro Token. API-Key-Nutzer sollten ihren Verbrauch genauer im Blick behalten.
Sieh es in der Praxis
Du hast gerade über Agenten-Konfigurationen gelesen. Hier wird eine live geöffnet – ein Content-Creator-Agent mit Tool-Zugriff, einem Entscheidungsbaum, Stimm-Einstellungen und Verweisen auf Wissensdateien. Es ist eine Textdatei, kein Code.
"Ich habe besseren Content bemerkt, wenn ich einen zentralen Agenten habe und dazu eine Reihe von Skills, die er selbst aufrufen kann. Statt jedes Mal den genauen Workflow im Kopf zu haben, sage ich einfach 'schreib einen LinkedIn-Post' und er zieht den richtigen Skill."
— Shaun, Spezialist für Marketing & Growth
Agent = Modell + Harness
Die meisten aktualisieren immer wieder das Modell. Power-User aktualisieren den Harness um das Modell herum. Ein Harness ist das Betriebssystem für KI-Arbeit: Er definiert den Plan, gibt dem Agenten sichere Tools, prüft die Ausgabe, bittet um Review, hält Lektionen fest und lässt die Arbeit erst dann ausliefern.
Das Modell ist nur eine Eingabe. Der Harness ist alles andere: Prompts, CLAUDE.md, Rules, Tools, MCP-Server, Dateisystem, Git, Sandboxes, Hooks, Subagenten, Kontextrichtlinien, Logs, Grader, Wiederherstellungspfade und Release-Gates. Claude Code, Cursor, Codex, Aider, Cline und Managed Agents sind allesamt Harnesses um Modelle herum.
Die Ratsche: jeder Fehler wird zu einer dauerhaften Korrektur
Harness Engineering beginnt, wenn du aufhörst, standardmäßig dem Modell die Schuld zu geben. Wenn der Agent einen Fehler wiederholt, besteht die Aufgabe darin, den Harness so zu ändern, dass genau dieser Fehler beim nächsten Mal schwerer oder unmöglich wird.
| Beobachteter Fehler | Harness-Korrektur | Wo es lebt |
|---|---|---|
| Hat eine Projektkonvention ignoriert | Füge eine kurze, erarbeitete Regel hinzu | CLAUDE.md oder .claude/rules/ |
| Hat einen destruktiven Befehl ausgeführt | Blockiere ihn vor der Ausführung | PreToolUse-Hook |
| Hat sich in einer langen Aufgabe verloren | Trenne die Rollen Planer, Ausführer und Reviewer | Skill + Subagenten |
| War mit kaputter Ausgabe fertig | Führe objektive Prüfungen aus und speise Fehler zurück | Verifizierungs-Hook oder Grader |
| Hat denselben schwachen Entwurf wiederholt | Füge Beispiele, Rubrik und Review-Fragen hinzu | Referenzdateien des Skills |
Füge Einschränkungen nur hinzu, wenn sie auf einen echten Fehler zurückgehen. Entferne sie, wenn sie überholt sind. Ein guter Harness ist ein lebendes Artefakt, kein Prompt-Friedhof.
1. Plan-Gate
Bevor Claude handelt, muss es das Ziel, die Annahmen, die Dateien oder Quellen, die es anfasst, und die Bedeutung von "fertig" neu formulieren.
2. Arbeitsgrenze
Der Agent erhält nur die Tools und den Scope, die er braucht. Nur Lesen für Recherche. Freigabe vor dem Senden, Löschen, Veröffentlichen oder Ändern von Datensätzen.
3. Verifizierungs-Gate
Die Ausgabe wird gegen objektive Kriterien geprüft: Quellen zitiert, Zahlen abgeglichen, Checkliste vollständig, Pflichtfelder vorhanden.
4. Review-Gate
Ein separater Durchgang sucht nach dem, was die Automatisierung übersieht: falsche Diagnose, Überentwicklung, unpassender Ton, versteckte Annahmen.
5. Kumulations-Gate
Jeder Fehler wird zu einer Regel, einer Vorlage, einem Beispiel oder einem Checklistenpunkt. Das System wird besser, weil der Harness lernt.
6. Ship-Gate
Nichts verlässt das System, bevor die Artefakte für Plan, Verifizierung, Review und Freigabe existieren. Claude kann vorschlagen; der Harness entscheidet.
Die tragenden Teile eines Harness
Zustand
Dateisystem, Git, Aufgabendateien, Speicherdateien und Ausgabeordner. Hier überlebt die Arbeit über das aktuelle Kontextfenster hinaus.
Tools
Bash, Code-Ausführung, Browser-Automatisierung, MCP-Server und APIs. Halte die Tools fokussiert; sich überschneidende Tools verwirren das Modell und blähen den Kontext auf.
Kontextrichtlinie
Was geladen, komprimiert, ausgelagert oder später abgerufen wird. Das entscheidet, was die Kontextgrenze des Modells überquert.
Durchsetzung
Hooks, Berechtigungen, Sandboxes, Testbefehle und Freigabe-Gates. Sie verwandeln Präferenzen in Einschränkungen.
Bewertung
Rubriken, Grader, Review-Agenten und Abnahmekriterien. Bewerte das Ergebnis, nicht den seltsamen Weg, den der Agent genommen hat.
Beobachtbarkeit
Logs, Traces, Token-Verbrauch, Kosten, Latenz und Fehler-Cluster. Eine Bewertung ohne Ticket ist nur Dashboard-Kunst.
Kontextmanagement ist Harness-Design
Das Modell kann nicht über Tokens nachdenken, die es nie erhält. Wenn das Kontextfenster voll wird, muss der Harness entscheiden, was bleibt, was komprimiert wird, was auf die Platte wandert und was später abgerufen wird. Diese Entscheidung ist oft wichtiger als die Wahl des Modells.
Abschneiden
Verwirf Ausgabe mit geringem Wert oder altes Transkript, wenn Kontinuität keine Rolle spielt.
Komprimieren
Fasse die Sitzung zusammen und fahre mit dem komprimierten Zustand fort.
Auslagern
Speichere lange Logs, Tool-Ergebnisse und Entwürfe in Dateien; behalte nur die nützliche Vorschau im Kontext.
Offenlegen
Lade detaillierte Doks, Skills und Tools nur, wenn die Aufgabe sie tatsächlich braucht.
Praktische Regel: halte den immer geladenen Kontext kurz, blättere mit offset/limit durch große Dateien, suche, bevor du ganze Dateien liest, und speichere lange Tool-Ausgaben auf der Platte, statt sie zurück ins Gespräch zu kopieren.
Ergebnis-Rubriken: definiere, wie "fertig" aussieht
Die Managed Agents API von Anthropic macht dieses Muster explizit: definiere ein Ergebnis, hänge eine Rubrik an, lass einen separaten Grader das Artefakt bewerten und speise dann die Lücken zur nächsten Iteration an den Agenten zurück. Du kannst dieselbe Idee in Claude Code manuell nutzen.
Outcome:
Create a competitor pricing report for the 5 named companies.
Rubric:
- Includes all 5 companies
- Every price claim has a source URL
- Pricing tiers are normalized into one table
- Unknown prices are marked "not published" instead of invented
- Final section recommends what we should change
Iteration rule:
If any rubric item fails, revise once before showing me the final.Der entscheidende Schritt ist die Trennung: eine Schleife erstellt das Artefakt, eine andere bewertet es gegen die Rubrik. Das reduziert Selbstbeweihräucherung und deckt Lücken schneller auf.
Die Harness-Vorlage für Wissensarbeiter
1. Track
Capture the request in a task, client folder, or project log.
2. Plan
Ask Claude: "Before doing the work, give me the plan,
assumptions, sources/tools needed, and acceptance criteria."
3. Work
Let Claude execute inside clear boundaries:
read-only research, draft-only writing, no external sends.
4. Verify
Run a checklist that matches the work type:
sources, calculations, brand voice, missing fields, risks.
5. Review
Ask a second pass: "Find what is wrong, overbuilt,
unsupported, or not how we do things here."
6. Learn
Capture one reusable rule or template improvement.
7. Ship
Only publish, send, update CRM, or hand off after approval.Copy-Paste-Prompt: verwandle jeden Workflow in einen Harness
I want to turn this repeated workflow into a reliable AI harness:
[describe the workflow]
Create:
1. The planning questions Claude must answer before starting
2. The tool and permission boundaries
3. The verification checklist
4. The review questions a second pass should ask
5. The human approval points
6. The learning rule to update after each run
Keep it practical for a non-technical knowledge worker.Wöchentliches Harness-Audit: schneide den unsichtbaren Overhead weg
Wenn sich Claude langsamer, dümmer anfühlt oder durch deine Limits frisst, prüfe den Harness, bevor du dem Modell die Schuld gibst. Die meiste Verschwendung versteckt sich im immer geladenen Kontext.
| Prüfpunkt | Worauf achten | Korrektur |
|---|---|---|
CLAUDE.md -Größe | Regeln, die nicht mehr relevant sind oder in engere Doks gehören | Halte den Wurzelkontext kurz; verschiebe Spezifika in Rules, Doks oder Skills |
| Hooks | UserPromptSubmit- oder SessionStart-Hooks, die jedes Mal Kontext einspeisen | Deaktiviere alles ohne konkrete Aufgabe |
| MCP-Server | Tool-Schemata, die für selten genutzte Tools geladen werden | Lass nur tägliche Tools dauerhaft aktiv; aktiviere andere pro Sitzung |
| Skills | Breite Beschreibungen, die das Laden irrelevanter Skills auslösen | Schärfe die Beschreibungen oder deaktiviere ungenutzte Skills |
| Gesprächslänge | Lange Sitzungen, die veralteten Verlauf erneut lesen | Komprimiere, fasse zusammen oder starte mit einer Übergabenotiz neu |
| Workflow | Verifizierungs-Gate | Menschliches Gate |
|---|---|---|
| Beratungsbericht | Aussagen an Kundendaten gebunden, Empfehlungen auf den Scope abgebildet, keine vertraulichen Namen durchgesickert | Der Partner prüft die Qualität der Erkenntnisse vor dem Versand |
| Sales-Outreach | CRM-Verlauf geprüft, Personalisierungsquelle zitiert, kein erfundenes Trigger-Event | Du gibst frei, bevor per E-Mail, LinkedIn oder WhatsApp gesendet wird |
| Finanzanalyse | Summen stimmen überein, Annahmen aufgelistet, Auffälligkeiten markiert, Quelldateien benannt | Du gibst die Interpretation vor dem Teilen frei |
| Content-Veröffentlichung | Stimm-Check, verbotene Phrasen entfernt, Fakten mit Quelle, CTA vorhanden | Du gibst die finale Version vor Queue oder Veröffentlichung frei |
Was kein Harness zuverlässig abfängt
Die Regel: automatisiere das Tippen, Recherchieren, Prüfen und Formatieren. Lass Verantwortung, finales Urteil und externe Zusagen beim Menschen.
"Ich bin VERLIEBT in dieses neue System. Ich habe an einem einzigen Tag etwa 10 Tage Arbeit geschafft."
— Shaun, Spezialist für Marketing & Growth • Baute in seiner ersten Woche eine Audio-zu-Social-Post-Automatisierung
Dafür haben 5.475 Leute "BRAIN" kommentiert
Die meisten nutzen Claude als einzelnen Assistenten. Frage stellen, Antwort bekommen. Aber mit Claude Code kannst du ein ganzes Team von Spezialisten bauen, die die Arbeit untereinander weiterreichen – während du prüfst.
Wichtige Unterscheidung: Subagenten vs. Hintergrund-Agenten
Subagenten sind Spezialisten innerhalb einer Claude-Code-Sitzung. Sie haben ihren eigenen Kontext und ihre eigenen Tool-Berechtigungen und berichten dann an die Hauptsitzung zurück. Hintergrund-Agenten sind separate Cloud-Sitzungen, die du über Claude Code im Web, Desktop, Slack oder die Agent View verwaltest.
Nutze Subagenten, wenn:
Ein Haupt-Workflow mehrere fokussierte Analysen, Reviews oder Entwürfe parallel braucht.
Nutze Hintergrund-Agenten, wenn:
Du unabhängige, langlaufende Sitzungen auf verschiedenen Repos, Branches, PRs oder geplanten Jobs willst.
Stufe 1: Solo-Agent
Eine Claude-Sitzung erledigt alles. Wie die Arbeit mit einem einzigen, sehr fähigen Generalisten. Hier hören die meisten auf.
Stufe 2: delegierender Lead (Subagenten)
Deine Haupt-Claude-Sitzung agiert als Lead. Sie schickt Spezialisten los, um fokussierte Arbeit zu erledigen – Recherche, Entwürfe, Analyse – und zwar parallel. Jeder Spezialist berichtet an den Lead zurück, der die Ergebnisse zusammenführt. Das ist produktionsreif und das, was die meisten Power-User bauen.
Stufe 3: Hintergrundsitzungen + Agent View
Mehrere Claude-Code-Sitzungen, die unabhängig laufen. Nutze claude agents oder die Web-/Desktop-Oberflächen, um Arbeit loszuschicken, zu überwachen und fortzusetzen. Research-Preview-Terrain – mächtig, aber noch in Entwicklung.
Echtes Beispiel: Sales-Outreach-Pipeline
Das passiert tatsächlich, wenn ich sage "entwirf Outreach für diesen Prospect":
Lead Agent orchestrates the pipeline:
│
├─ Research Agent
│ → Pulls LinkedIn profile + company intel
│ → Returns: role, company size, recent posts
│
├─ CRM Agent
│ → Checks prospect history, stage, past notes
│ → Returns: last contact, deal stage, context
│
├─ Draft Agent
│ → Writes personalized email using research
│ → Uses voice guidelines from knowledge files
│
├─ Quality Agent
│ → Scores draft against brand voice rubric
│ → Flags generic phrases, suggests improvements
│
└─ Lead Agent
→ Reviews final draft
→ I approve → sends via email MCP
5 agents. 3 minutes.
What used to take 45 minutes of tab-switching
between LinkedIn, CRM, email, and style guides.Auf Stufe 2 läuft die gesamte Kommunikation über die Lead-Sitzung. Du kannst Claude trotzdem bitten, unabhängige Spezialisten-Durchgänge auszuführen, ihre Erkenntnisse zu vergleichen und die Meinungsverschiedenheiten zusammenzuführen. Für separate, langlaufende Arbeitsstränge nutzt du Hintergrundsitzungen und die Agent View.
"Our conversion rate dropped 15% last week.
Use three specialist subagents to investigate:
- One analyzes traffic sources
- One reviews checkout funnel
- One checks pricing page changes
Then compare their findings and challenge contradictions."
What happens:
Traffic Agent: "Paid traffic quality dropped"
Checkout Agent: "But checkout completion is
stable. The issue is upstream."
Pricing Agent: "New pricing page went live
Tuesday. Bounce rate up 40%."
Traffic Agent: "That explains the drop—
the traffic was fine, the page wasn't."
→ Root cause found in minutes, not hours.Die Debattenstruktur verhindert Ankerverzerrung. Sequenzielle Untersuchung neigt dazu, eine Theorie zu finden und aufzuhören. Mehrere unabhängige Ermittler, die einander herausfordern, bringen die wahre Antwort ans Licht.
Über 30 spezialisierte Agenten zu bauen mit den richtigen Personas, Tool-Berechtigungen, Wissensdateien und der Koordinationslogik brauchte Monate an Iteration. Jeder Agent muss wissen, worauf er zugreifen kann, in welchem Format er ausgeben soll und wann er an den nächsten Agenten übergibt. Das Second Brain kommt mit der vollständigen Agenten-Bibliothek – vorkonfiguriert für Content-Erstellung, Sales-Outreach, Kundenmanagement, Datenanalyse und den Tagesbetrieb.
Claude Code arbeitet neben anderen Tools
Die effektivsten Setups sind nicht "nur Claude Code". Power-User kombinieren Tools strategisch: ChatGPT für kreatives Brainstorming, Claude Code für strukturierte Ausführung, Gemini für Review. Claude Code wird zur Orchestrierungsebene, die alles zusammenhält – nicht zum einzigen Tool in deinem Stack.
1. Brainstorm with ChatGPT (creative, divergent thinking)
2. Hand the brief to Claude Code (precise execution)
3. Review output with Gemini (catching edge cases)
4. Final polish back in Claude Code
Why: Each model has different strengths.
Claude Code orchestrates the whole thing
through skills and sub-agents.Checkliste Phase 4
So sieht ein komplettes System aus
Über 30 Agenten, über 50 Skills, über 6 Hooks, Harness-Gates, kumulatives Lernen, Progressive Disclosure, Agenten-Koordination – alles konfiguriert und im Zusammenspiel. Dieses System brauchte Monate an Iteration. Das Second Brain liefert eine angepasste Version in Stunden.
Sieh, was enthalten istMCP (Model Context Protocol) ist ein standardisierter Weg, Claude Code mit externen Tools zu verbinden. Stell es dir als USB-C für KI vor – ein Protokoll verbindet mit allem.
┌─────────────────────────────────────────────┐
│ Claude Code │
│ └─ MCP Client (built-in) │
└─────────┬───────────────────────────────────┘
│
├─ MCP Server: Gmail
│ └─ Functions: send_email, search, read
│
├─ MCP Server: HubSpot
│ └─ Functions: create_contact, update_deal
│
├─ MCP Server: PostgreSQL
│ └─ Functions: query, insert, update
│
└─ MCP Server: Google Calendar
└─ Functions: create_event, list_eventsBusiness-Tools
Dev-Tools
Analytics
Echtes Beispiel: Sales-Operations
Aufgabe: 200 Webinar-Teilnehmer in HubSpot markieren
Ohne MCP: 35 Minuten
Mit MCP: 3 Minuten
Kernaussage: Die MCP-Einrichtung kann die größte Zeitbarriere sein
Andrew (Product Director, Niederlande) baute ein automatisiertes System zum Tracking der Jobsuche – LinkedIn-Scraper → Datenbank → Follow-up-Planer. MCP-Einrichtung in Eigenregie: 6-8 Stunden OAuth-Debugging. Mit den Second-Brain-Vorlagen: 20 Minuten.
Sieh es in der Praxis
Abstrakte Diagramme sind schön. Hier ist, was ein MCP tatsächlich tut: ein einziger Befehl zieht je 20 Posts von Reddit, X und LinkedIn – 60 Datenpunkte, analysiert in unter 2 Minuten. Kein Kopieren und Einfügen zwischen Tabs.
MCP-OAuth-Debugging dauert im Schnitt 6-8 Stunden
Das Done-With-You-Paket enthält eine Live-Konfigurationssession, in der wir deine Tools für Gmail, Calendar, CRM und Datenbank zusammenführen – plus Vorlagen, die du für künftige Tool-Verbindungen wiederverwenden kannst.
Done-With-You ansehenCheckliste Phase 5
Woche 1: Damian (KI-Berater, Schweiz)
System zur Automatisierung von Social-Media-Content. Ideen erfassen → LinkedIn-Stimm-DNA extrahieren → Karussell-PDFs erzeugen → Posts planen. "Ein Freund hat mir gerade von dieser neuen, super coolen Lösung erzählt, die er gekauft hat. Es war genau das, was ich in zwei Tagen mit dem Second Brain gebaut hatte."
Woche 2: Andrew (Product Director, Niederlande)
Automatisiertes System zum Tracking der Jobsuche. LinkedIn-Scraper, Bewerbungsdatenbank, Follow-up-Planer. Ersetzte ein kommerzielles SaaS-Tool, für das er monatlich zahlte – gebaut in zwei Tagen mit dem Second Brain.
Woche 3: Dominic (Cloud-Berater)
Automatisierte wöchentliche Status-Berichte für Kunden. Salesforce-MCP-Integration, die Deal-Daten zieht, Microsoft Graph für den Kalender-/E-Mail-Kontext. Sparte 3 Stunden/Woche an Verwaltungsarbeit.
Woche 4: Richard (Unternehmensberater, Australien)
Nachdem er sich eine Woche allein abgemüht hatte: "Du hast in diesem Call das gelöst, was ich noch falsch gemacht habe – ich habe es gepromptet, als wäre es ein Chatbot. Mit Befehlen und Agenten kannst du es deinen täglichen Workflow für dich managen lassen. Definitiv das Geld wert, um mir drei bis vier Monate zu sparen, in denen ich mich sonst durchgehangelt hätte."
Du hast gesehen, wie ein komplettes System aussieht: Progressive-Disclosure-Architektur, durchsetzbare Hooks, kumulatives Lernen, das Skills-vs-Agenten-Framework, MCP-Integrationen. Das von Grund auf zu bauen dauert 3-4 Wochen Trial and Error– Dateistrukturen debuggen, Hooks schreiben, Skill-Trigger testen, MCP-OAuth-Flows konfigurieren, Speicher-Schemata entwerfen...
Oder du sparst dir das alles und bekommst eine angepasste Version in Stunden.
"Das war eine der besten Investitionen für mich und mein Geschäft. Es hat mir die Welt der leicht konfigurierbaren agentischen Arbeit eröffnet. Die üblichen KI-Tools wirken jetzt nur noch wie ein Kinderspiel."
— Damian, KI-Berater • Done-With-You-Kunde, der in 2 Tagen ein komplettes System zur Content-Automatisierung gebaut hat
Das Gesamtbild
E-Mail-Triage, Kundenantworten, Finanzanalyse, LinkedIn-Content und eine Landingpage – alles aus demselben Terminal in einer einzigen Sitzung angestoßen. Das ist, was das komplette System liefert.
$197
DIY-Paket
Komplettes Second-Brain-Repository mit Agenten, Befehlen und Skills. Die Einrichtung übernimmst du selbst.
Zeitrahmen: 1-2 Wochen Einrichtung
$597
Kickstart-Paket
Alles aus DIY + ein KI-Agent konfiguriert dein System anhand der Fragebogen-Antworten.
Zeitrahmen: einsatzbereit in Minuten, nicht Wochen
$2,497
Done-With-You
Alles aus Kickstart + ein 2-stündiger Onboarding-Call mit Iwo. Vollständige Infrastruktur-Bereitstellung.
Zeitrahmen: produktiv in 2 Stunden
Aufzeichnung der Coworking-Session
60-minütige Live-Session mit über 10 Demos – Tagesplanung, Content-Erstellung, MCP-Recherche, WhatsApp-Agenten und mehr.
AI-Chief-of-Staff-Vorlage
Kostenlose Agenten-Vorlage mit vollständiger Konfiguration, Struktur für die Wissensbasis und Anpassungsleitfaden für deine Rolle.
Offizielle Dokumentation
Das sind die maßgeblichen Quellen. Dieses Tutorial ergänzt das praktische "Wie" und "Wann", das die offizielle Dokumentation nicht abdeckt.
Drei Pakete verfügbar – von DIY-Vorlagen bis zur Done-With-You-Umsetzung.
Pakete ansehen30 Tage Geld-zurück-Garantie • Spar im ersten Monat über 10 Stunden oder volle Rückerstattung