Claude Code verstehen: Was passiert hinter dem Chat?
Für: PO/PM, die wissen wollen, wie Claude Code "unter der Haube" funktioniert
Vorwissen: Dokument "KI-Tools verstehen" gelesen (Chat vs. Agent)
Lesezeit: 15 Minuten
1. Was du siehst vs. was passiert
Das Verwirrende
Wenn du Claude Code öffnest, siehst du... einen Chat. Wie ChatGPT. Wie Gemini. Wie Claude im Browser.
Aber: Hinter diesem Chat passiert viel mehr.
Die zwei Ebenen
┌─────────────────────────────────────────────────────────────────────────┐
│ │
│ WAS DU SIEHST │
│ ══════════════ │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 💬 Ein Chat-Fenster │ │
│ │ │ │
│ │ Du: "Analysiere die Excel-Datei im Input-Ordner" │ │
│ │ │ │
│ │ Claude: "Ich habe die Datei gelesen. Hier ist die Analyse: │ │
│ │ [...]" │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ WAS PASSIERT │
│ ════════════ │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 🗂️ Dateisystem 🔧 Tools 🌐 Externe Systeme │ │
│ │ │ │
│ │ /projekt/ Dateien lesen Notion │ │
│ │ ├── input/ Dateien schreiben Confluence │ │
│ │ ├── output/ Terminal nutzen GitHub │ │
│ │ ├── docs/ Suchen Figma │ │
│ │ └── CLAUDE.md Berechnen ... │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Die Analogie: Schreibtisch mit Assistenz
Chat (ChatGPT, Gemini):
Du sitzt am Schreibtisch. Ein Assistent steht an der Tür.
Du liest ihm Dokumente vor. Er antwortet mündlich.
Er darf den Raum nicht betreten.
Claude Code:
Du sitzt am Schreibtisch. Ein Assistent sitzt neben dir.
Er sieht deinen Bildschirm. Er kann Ordner öffnen.
Er kann Dokumente lesen UND schreiben.
Er hat Zugang zu anderen Räumen (Notion, GitHub).
2. Wie Claude Code "denkt": Der Kontext-Aufbau
Was ist "Kontext"?
Kontext = Alles, was Claude weiß, wenn du eine Frage stellst.
Bei normalem Chat: - Nur das aktuelle Gespräch - Was du in diese Session geschrieben hast - Endet, wenn du das Fenster schließt
Bei Claude Code: - Das aktuelle Gespräch - PLUS: Dateien, die Claude lesen darf - PLUS: Wissen über das Projekt - PLUS: Informationen aus externen Tools
Der Kontext-Aufbau Schritt für Schritt
SCHRITT 1: Du öffnest ein Projekt in Claude Code
══════════════════════════════════════════════════
Claude: "Okay, ich schaue mich um..."
┌────────────────────────────────┐
│ 📄 CLAUDE.md │
│ │
│ "Das hier ist ein Workshop- │
│ Projekt für Kunde-ABC..." │
│ │
└────────────────────────────────┘
│
▼
Claude versteht: Worum geht es hier?
SCHRITT 2: Claude liest die Projektstruktur
══════════════════════════════════════════════════
Claude: "Was gibt es hier für Ordner und Dateien?"
📁 projekt/
├── CLAUDE.md ✓ (gelesen)
├── docs/
│ ├── context/
│ │ └── kunde-abc-analyse.md ← "Das könnte wichtig sein"
│ └── prompts/
│ └── README.md ← "Hier sind Arbeitsanweisungen"
├── input/
│ └── raw/ ← "Hier kommt Material rein"
└── output/ ← "Hier soll ich Ergebnisse ablegen"
│
▼
Claude versteht: Wie ist das Projekt organisiert?
SCHRITT 3: Claude liest relevante Dateien
══════════════════════════════════════════════════
Wenn du fragst: "Analysiere die Kunde-ABC-Website"
Claude: "Moment, ich schaue in /docs/context/..."
┌────────────────────────────────┐
│ 📄 kunde-abc-analyse.md │
│ │
│ "Vorhandene JSON-LD Blöcke: │
│ Organization, BreadcrumbList,│
│ Product..." │
│ │
└────────────────────────────────┘
│
▼
Claude versteht: Was wurde schon analysiert?
SCHRITT 4: Dein Auftrag wird eingeordnet
══════════════════════════════════════════════════
Jetzt erst beantwortet Claude deine Frage –
mit dem GESAMTEN Kontext:
┌─────────────────────────────────────────────────────────────┐
│ │
│ KONTEXT (was Claude "weiß"): │
│ │
│ • Projektbeschreibung aus CLAUDE.md │
│ • Struktur des Projekts │
│ • Vorherige Analyse aus /docs/context/ │
│ • Dein aktueller Auftrag │
│ │
│ ↓ │
│ │
│ ANTWORT (informiert durch alles oben) │
│ │
└─────────────────────────────────────────────────────────────┘
Das Kontext-Fenster: Begrenzt, aber clever
Claude kann nicht "alles" gleichzeitig lesen. Es gibt ein Kontext-Fenster – wie ein Schreibtisch mit begrenzter Fläche.
┌─────────────────────────────────────────────────────────────┐
│ KONTEXT-FENSTER (vereinfacht) │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │CLAUDE.md │ │ Dein │ │ Relevante│ │ Vorherige│ │
│ │ │ │ Auftrag │ │ Dateien │ │ Antworten│ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ ════════════════════════════════════════════════════════ │
│ Begrenzte Kapazität – Claude wählt, was wichtig ist │
│ │
└─────────────────────────────────────────────────────────────┘
Deshalb ist Struktur wichtig:
- CLAUDE.md = Immer dabei (wichtigste Infos)
- /docs/context/ = Wird bei Bedarf geladen
- Klare Ordnerstruktur = Claude findet schneller
3. Die Werkzeugkiste: Was Claude Code alles kann
Übersicht
┌─────────────────────────────────────────────────────────────────────────┐
│ │
│ CLAUDE CODE WERKZEUGKISTE │
│ │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ 📂 DATEISYSTEM │
│ ─────────────── │
│ • Dateien lesen (alle Formate) │
│ • Dateien schreiben/erstellen │
│ • Ordner durchsuchen │
│ • Dateien verschieben/umbenennen │
│ │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ 💻 TERMINAL (Kommandozeile) │
│ ──────────────────────────── │
│ • Programme ausführen │
│ • Dateien konvertieren (PDF → Text, etc.) │
│ • Berechnungen durchführen │
│ • Automatisierungen starten │
│ │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ 🔌 MCP (Model Context Protocol) │
│ ──────────────────────────────── │
│ Verbindung zu externen Tools: │
│ │
│ • Notion – Seiten lesen/schreiben │
│ • Confluence – Dokumentation abrufen │
│ • GitHub – Code-Repositories │
│ • Figma – Design-Dateien │
│ • Slack – Nachrichten (je nach Setup) │
│ • ... und weitere │
│ │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ 🧠 LLMs (Sprachmodelle) │
│ ──────────────────────── │
│ Claude Code nutzt verschiedene Modelle: │
│ │
│ • Claude Sonnet – Standard, schnell, günstig │
│ • Claude Opus – Komplexe Aufgaben, tiefes Denken │
│ • (Konfigurierbar je nach Bedarf) │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Die Werkzeuge im Detail
Dateisystem: Der direkte Zugriff
OHNE Claude Code (Chat): MIT Claude Code:
════════════════════════ ════════════════
Du: "Hier ist meine Excel..." Du: "Lies die Excel in /input/"
[Copy-Paste Inhalt]
Claude: [öffnet Datei direkt]
Claude: [sieht nur Text] [sieht Struktur]
[keine Formeln] [sieht Formeln]
[keine Formatierung] [sieht Formatierung]
Terminal: Die Maschine dahinter
Das Terminal ist wie eine Werkbank, auf der Claude Dinge tun kann:
| Aktion | Was passiert |
|---|---|
| PDF zu Text | Claude ruft ein Programm auf, das PDFs liest |
| Excel berechnen | Claude führt Berechnungen mit echten Tools aus |
| Dateien sortieren | Claude verschiebt Dateien nach Regeln |
| Report erstellen | Claude nutzt Templates und füllt sie |
Du siehst: Nur das Ergebnis im Chat.
Im Hintergrund: Echte Programme laufen.
MCP: Die Brücke zu anderen Tools
┌─────────────┐ MCP ┌─────────────┐
│ │ ◄──────────────────► │ │
│ Claude Code │ │ Notion │
│ │ │ │
└─────────────┘ └─────────────┘
│
│ MCP ┌─────────────┐
└───────────────────────►│ │
│ Confluence │
│ │
└─────────────┘
MCP = Standardisierte Verbindung
Stell dir vor, Claude Code spricht viele Sprachen: - "Notion-Sprache" → Kann Notion-Seiten lesen - "GitHub-Sprache" → Kann Repositories durchsuchen - "Confluence-Sprache" → Kann Dokumentation abrufen
Wichtig: MCP muss eingerichtet sein. Nicht alle Verbindungen sind automatisch da.
LLMs: Das Gehirn wählen
Claude Code kann verschiedene "Gehirne" nutzen:
| Modell | Stärke | Wann nutzen |
|---|---|---|
| Claude Sonnet | Schnell, effizient | Alltägliche Aufgaben |
| Claude Opus | Tiefgründig, präzise | Komplexe Analysen |
Analogie: - Sonnet = Erfahrener Mitarbeiter für Standardaufgaben - Opus = Senior-Experte für knifflige Fälle
4. Ein Auftrag von A bis Z: Was wirklich passiert
Beispiel: "Erstelle einen Report aus den Input-Dokumenten"
PHASE 1: VERSTEHEN
══════════════════
Du tippst: "Erstelle einen Report aus den Dokumenten in /input/raw/"
Claude denkt:
┌─────────────────────────────────────────────────────────────┐
│ "Okay, ich soll: │
│ 1. Dokumente in /input/raw/ finden │
│ 2. Einen Report erstellen │
│ 3. Aber in welchem Format? Wohin speichern?" │
│ │
│ Ich schaue in CLAUDE.md nach Hinweisen... │
│ │
│ Ah: 'Reports werden als Markdown in /output/reports/ │
│ gespeichert'" │
└─────────────────────────────────────────────────────────────┘
PHASE 2: ERKUNDEN
═════════════════
Claude führt aus (im Hintergrund):
> ls /input/raw/
workshop-notizen.pdf
kundenfeedback.xlsx
interview-transkript.docx
Claude denkt:
┌─────────────────────────────────────────────────────────────┐
│ "Ich habe 3 Dateien: │
│ - 1x PDF │
│ - 1x Excel │
│ - 1x Word │
│ │
│ Ich muss alle lesen und zusammenfassen." │
└─────────────────────────────────────────────────────────────┘
PHASE 3: VERARBEITEN
════════════════════
Claude führt aus (im Hintergrund):
> [PDF zu Text konvertieren]
> [Excel-Inhalte extrahieren]
> [Word-Dokument lesen]
Claude denkt:
┌─────────────────────────────────────────────────────────────┐
│ "Jetzt habe ich alle Inhalte. Ich strukturiere: │
│ │
│ 1. Workshop-Erkenntnisse (aus PDF) │
│ 2. Kundenfeedback-Zusammenfassung (aus Excel) │
│ 3. Interview-Highlights (aus Word)" │
└─────────────────────────────────────────────────────────────┘
PHASE 4: PRODUZIEREN
════════════════════
Claude erstellt:
📄 /output/reports/zusammenfassung-2026-01.md
# Report: Input-Dokumente Januar 2026
## Workshop-Erkenntnisse
[...]
## Kundenfeedback
[...]
## Interview-Highlights
[...]
PHASE 5: ANTWORTEN
══════════════════
Claude schreibt dir:
"Ich habe die 3 Dokumente analysiert und einen Report
erstellt: /output/reports/zusammenfassung-2026-01.md
Zusammenfassung:
- Workshop: 5 Kernthemen identifiziert
- Feedback: 12 positive, 3 kritische Punkte
- Interview: 4 Handlungsempfehlungen"
Was du davon siehst
┌─────────────────────────────────────────────────────────────┐
│ │
│ DU SIEHST: │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Du: Erstelle einen Report aus /input/raw/ │ │
│ │ │ │
│ │ Claude: Ich habe die 3 Dokumente analysiert... │ │
│ │ → Report: /output/reports/zusammenfassung.. │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ DU SIEHST NICHT (aber es passiert): │
│ │
│ • Ordner durchsuchen │
│ • PDF konvertieren │
│ • Excel parsen │
│ • Word lesen │
│ • Datei erstellen │
│ • Datei speichern │
│ │
└─────────────────────────────────────────────────────────────┘
5. Grenzen und Missverständnisse
Was Claude Code NICHT kann
| Erwartung | Realität |
|---|---|
| "Claude erinnert sich an letzte Woche" | Jede Session startet neu. Kontext kommt aus Dateien, nicht aus Erinnerung. |
| "Claude weiß alles über mein Projekt" | Claude weiß nur, was in den Dateien steht, die es lesen kann. |
| "Claude kann auf alles zugreifen" | Nur auf konfigurierte Ordner und MCP-Verbindungen. |
| "Claude macht keine Fehler" | Claude kann sich irren. Ergebnisse sollten geprüft werden. |
| "Claude ersetzt mein Urteil" | Claude führt aus. Du entscheidest, WAS ausgeführt wird. |
Häufige Missverständnisse
"Claude hat doch ein Gedächtnis?"
Nein – aber es sieht so aus.
WIE ES AUSSIEHT: WAS WIRKLICH PASSIERT:
════════════════ ══════════════════════
Session 1: Session 1:
Du: "Das Projekt heißt Kunde-ABC" Claude liest CLAUDE.md
Claude: "Verstanden" → "Projekt: Kunde-ABC"
[Session Ende] [Session Ende - alles vergessen]
Session 2: Session 2:
Du: "Was war nochmal das Projekt?" Claude liest CLAUDE.md erneut
Claude: "Kunde-ABC" → "Projekt: Kunde-ABC"
Es WIRKT wie Erinnerung. Es IST Dateizugriff.
"Mehr Kontext = bessere Antworten?"
Nicht automatisch.
ZU WENIG KONTEXT: ZU VIEL KONTEXT:
═════════════════ ═════════════════
Claude weiß nicht genug Claude "ertrinkt" in Infos
→ Rät oder fragt nach → Verliert Fokus
→ Übersieht Wichtiges
GOLDENE MITTE:
═══════════════
Relevanter, strukturierter Kontext
→ CLAUDE.md: Das Wichtigste
→ /docs/: Details bei Bedarf
"Claude Code ist wie ChatGPT, nur besser?"
Nein – es ist ein anderes Werkzeug.
| ChatGPT | Claude Code |
|---|---|
| Gespräch | Arbeitsumgebung |
| Text rein → Text raus | Dateien rein → Dateien raus |
| Jede Session isoliert | Projekt-Kontext persistent |
| Für Fragen & Ideen | Für Aufgaben & Produktion |
Beide haben ihre Berechtigung. Sie ersetzen sich nicht.
6. Zusammenfassung: Das mentale Modell
Claude Code in einem Bild
┌─────────────────────────────────────────────────────────────────────────┐
│ │
│ CLAUDE CODE │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ CHAT-OBERFLÄCHE │ │
│ │ (was du siehst) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ CLAUDE │ │
│ │ (das "Gehirn") │ │
│ │ │ │
│ │ Versteht Sprache → Plant Aktionen → Führt aus → Antwortet │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ │ │ │ │ │ │
│ │ DATEISYSTEM │ │ TERMINAL │ │ MCP │ │
│ │ │ │ │ │ │ │
│ │ Lesen │ │ Programme │ │ Notion │ │
│ │ Schreiben │ │ ausführen │ │ Confluence │ │
│ │ Suchen │ │ │ │ GitHub │ │
│ │ │ │ │ │ ... │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │ │ │
│ └────────────────────┼────────────────────┘ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ DEIN PROJEKT │ │
│ │ │ │
│ │ 📄 CLAUDE.md 📁 /docs 📁 /input 📁 /output │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Die drei Kern-Erkenntnisse
1. Claude Code = Chat + Dateizugriff + Tools
Es sieht aus wie Chat, aber dahinter arbeitet eine ganze Werkstatt.
2. Kontext kommt aus Dateien, nicht aus Erinnerung
Was in deinem Projekt steht, weiß Claude. Was nicht drinsteht, weiß es nicht.
3. Du gibst Aufträge, Claude führt aus
Claude ist ein fähiger Assistent – aber du bleibst der Chef.
Nächster Schritt
Du verstehst jetzt, was Claude Code ist und wie es funktioniert.
Weiter geht's mit: "Einstieg: KI-gestützte Projektarbeit mit Claude Code" (Onboarding-Guide)
Dort lernst du, wie du konkret mit Claude Code arbeitest – Ordnerstruktur, Commands, Skills und mehr.
Claude Code verstehen v1.0 – Januar 2026