Claude-Code-Referenz: KI-Programmierung in Ihrem Terminal

Autor: Claude Code Reference: AI Coding in Your Terminal

27. Januar 2026

Claude Code ist der terminalbasierte KI- Programmierassistent von Anthropic. Im Gegensatz zu IDE- -Plugins, die Code vorschlagen, liest Claude Code selbstständig Dateien, führt Befehle aus, führt Tests durch und implementiert Änderungen an mehreren Dateien mithilfe natürlicher Sprache. Dieser Leitfaden behandelt wesentliche Muster für produktionsreife, KI-gestützte Entwicklung.

Agentenbasiertes Programmieren verstehen

Claude Code funktioniert anders als herkömmliche Tools zur Code-Vervollständigung. Es handelt sich um einen autonomen Agenten, der Lösungen erforscht, plant und umsetzt, während Sie ihn umleiten oder sich zurückziehen. Der entscheidende Unterschied: Anstatt Code zu schreiben und Claude zu bitten, ihn zu überprüfen, beschreiben Sie, was Sie wollen, und Claude findet heraus, wie es umgesetzt werden kann.

Wichtige Einschränkung: Das Kontextfenster von Claude füllt sich schnell. Jede Nachricht, jedes gelesene Dokument und jede Befehlsausgabe verbraucht Tokens. LLM Die Leistung nimmt ab, wenn sich der Kontext füllt – Claude könnte frühere Anweisungen vergessen oder mehr Fehler machen. Das Kontextmanagement ist Ihre wichtigste Fähigkeit.

Kontextmanagement: Die Grundlage

CLAUDE.md: Ihre Projektkonfiguration

Die wichtigste Datei in jedem Claude-Code-Projekt. Claude liest diese Datei automatisch zu Beginn jeder Unterhaltung ein.

So erstellen Sie sie:

/init

Dadurch wird Ihre Codebasis analysiert und eine Starterdatei generiert. Verfeinern Sie diese im Laufe der Zeit.

Was sollte enthalten sein:

# Project: Finance Tracker API

## Tech Stack
- Node.js + TypeScript
- Express.js REST API
- PostgreSQL with Prisma ORM
- Jest for testing

## Bash Commands
npm run dev          # Start development server
npm run typecheck    # Run TypeScript checks
npm test             # Run test suite
npm run db:migrate   # Run database migrations

## Code Style
- Use ES modules (import/export), never CommonJS
- Destructure imports when possible
- Strict TypeScript mode enforced
- Database schema: /prisma/schema.prisma

## Workflow Rules
- Run typecheck after making changes
- Write tests for new features
- Never commit directly to main
- Branch naming: feature/*, bugfix/*, hotfix/*

## Testing Approach
- Run single tests for speed during development
- Full test suite before PR
- Integration tests require local database

Kontext effektiv bereitstellen

Bewährte Vorgehensweisen aus der offiziellen Dokumentation:

Verweise auf Dateien mit @ anstatt zu beschreiben, wo sich der Code befindet

@src/auth/login.ts Update the password validation to require 12+ characters

Bilder direkt einfügen per Drag-and-Drop oder Kopieren-Einfügen
- Unter macOS: Umschalt + Befehl + Steuerung + 4 für einen Screenshot, dann einfügen
Gib URLs an für Dokumentation und API Referenzen
```
Build a Stripe checkout flow using 
```

Daten direkt an Claude weiterleiten

cat error.log | claude "What's causing these database timeouts?"

Lassen Sie Claude das Benötigte mithilfe von Bash-Befehlen, MCP Tools oder Dateizugriffe

Enge Rückkopplungsschleifen: Der Schlüssel zum Erfolg

Die besten Ergebnisse erzielt man mit engen Rückkopplungsschleifen. Korrigieren Sie Claude, sobald Sie bemerken, dass er vom Thema abweicht.

Gesprächssteuerung

Esc              → Stop Claude mid-action (context preserved)
Esc + Esc        → Rewind conversation and restore previous state
/clear           → Reset context between unrelated tasks
/compact         → Summarize history while keeping learned knowledge

Wann man /clear verwenden sollte: Wenn du Claude in einer Sitzung mehr als zweimal wegen desselben Problems korrigiert hast, ist der Kontext mit fehlgeschlagenen Ansätzen überladen. Eine saubere Sitzung mit einer besseren Eingabeaufforderung ist fast immer besser als eine lange Sitzung mit angesammelten Korrekturen.

Gespräche eingrenzen: Arbeite pro Chat an einem Projekt oder einer Funktion. Wenn du fertig bist, /clear fang für die nächste Aufgabe von vorne an.

Wesentliche Arbeitsabläufe

1. Planen-dann-ausführen (Recherche → Planung → Umsetzung)

Dies ist der von Anthropic empfohlene Arbeitsablauf für komplexe Änderungen.

Schritt für Schritt:

Recherche: „Recherchiere, wie man die OAuth2-Authentifizierung hinzufügt. Schreibe noch keinen Code.“
Planen: Die Recherchen von Claude durchsehen. „Einen detaillierten Implementierungsplan erstellen.“
Überprüfung: Überprüfe, ob der Plan sinnvoll ist. Verfeinere ihn bei Bedarf. Erstelle optional ein GitHub-Issue mit dem Plan.
Implementierung: „Setzen Sie diese Lösung um. Überprüfen Sie während der Umsetzung die Plausibilität.“
Commit: „Führe einen Commit der Änderungen durch und erstelle einen Pull-Request.“

Die Schritte 1 und 2 sind entscheidend – ohne sie neigt Claude dazu, direkt mit der Programmierung einer Lösung zu beginnen.

2. Testgetriebene Entwicklung

Claude arbeitet am besten, wenn es ein klares Ziel gibt, auf das es iterativ hinarbeiten kann.

Ablauf:

Geben Sie Claude Testfälle oder erwartete Ergebnisse vor
Bitten Sie Claude, die Funktion zu implementieren
Claude führt Tests durch, erkennt Fehler und iteriert
Claude führt einen Commit durch, wenn die Tests erfolgreich sind

Warum es funktioniert: Tests bieten eine objektive Validierung. Claude nimmt Änderungen vor, wertet die Ergebnisse aus und verbessert das Ergebnis schrittweise, bis es erfolgreich ist.

3. Umsetzung des visuellen Designs

Ähnlich wie TDD , jedoch mit visuellen Zielvorgaben.

Einrichtung:

Stelle Claude eine Möglichkeit zur Verfügung, Browser-Screenshots zu erstellen (Playwright MCP Server)
Stelle ein visuelles Mock-up bereit (Screenshot, Figma-Export oder Bilddatei)
Bitte Claude, dies im Code zu implementieren
Claude macht Screenshots und iteriert so lange, bis die Ausgabe mit dem Mock übereinstimmt
Committen, wenn man zufrieden ist

Wie bei Menschen verbessern sich auch Claudes Ergebnisse mit jeder Iteration in der Regel deutlich.

Leistungsmodi für komplexe Aufgaben

Planungsmodus (Zweimal „Umschalt“ + „Tab“)

Recherchiert vor der Ausführung weitere Dateien
Erstellt detaillierte Implementierungspläne
Verwendung für: Refactorings über mehrere Dateien, Funktionserweiterungen, Architekturänderungen
Höhere Token-Kosten

Denkmodus (sag „Ultra-Denkmodus“)

Erweitertes Denkbudget
Tiefgreifendere Analyse komplexer Probleme
Verwendung für: Debugging, Algorithmusoptimierung, knifflige Randfälle
Höhere Token-Kosten

Kombinieren Sie beide Modi für wirklich komplexe Aufgaben, aber beachten Sie dabei den Token-Kompromiss.

Benutzerdefinierte Befehle: Automatisieren Sie sich wiederholende Aufgaben

Erstellen Sie wiederverwendbare Slash-Befehle in .claude/commands/.

Struktur:

.claude/
  commands/
    audit.md         → becomes /audit
    test-gen.md      → becomes /test-gen
    security-fix.md  → becomes /security-fix

Beispiel (audit.md):

Audit all dependencies in package.json for:
- Security vulnerabilities (critical and high only)
- Unused packages
- Outdated versions with breaking changes

Generate a report with specific recommendations.

Use these arguments if provided: $arguments

Verwendung:

/audit
/audit --only-production-deps

Starten Sie den Claude-Code neu, nachdem Sie Befehle hinzugefügt haben.

Hooks: Automatisierte Qualitätskontrollen

Hooks fangen Tool-Aufrufe vor und nach der Ausführung ab, erkennen Fehler und geben automatisch Feedback.

Konfiguration

Hinzufügen zu .claude/settings.local.json:

{
  "hooks": {
    "pre-tool-use": ({
      "matcher": "read|grep",
      "command": "node ./hooks/block_secrets.js"
    }),
    "post-tool-use": ({
      "matcher": "edit",
      "command": "node ./hooks/typecheck.js"
    })
  }
}

Implementierung des Hooks


const { execSync } = require('child_process');

const stdin = process.stdin;
let data = '';

stdin.on('data', chunk => data += chunk);
stdin.on('end', () => {
  const toolCall = JSON.parse(data);
  
  
  try {
    execSync('npx tsc --no-emit', { stdio: 'pipe' });
    process.exit(0); 
  } catch (error) {
    
    console.error(error.stdout.toString());
    process.exit(0); 
  }
});

Exit-Codes:

0 → Vorgang zulassen und fortsetzen
2 → Vorgang blockieren (nur Pre-Hooks)

stderr-Ausgabe → Wird bei Blockierung als Feedback an Claude gesendet

Wichtige Hook-Muster

1. TypeScript-Typprüfer

Ausführen tsc --no-emit nach Änderungen
Erkennt Typfehler sofort
Claude erkennt Fehler und korrigiert Aufrufstellen automatisch

2. Dateizugriffskontrolle

Verhindert das Lesen sensibler Dateien (.env, API Schlüssel)
Verhindert versehentliche Offenlegung im Kontext

3. Vermeidung von Code-Duplikaten

Starten einer sekundären Claude-Instanz zur Überprüfung von Änderungen
Prüft auf doppelte Funktionen/Abfragen
Bei Duplikaten wird der Vorgang blockiert; Claude verwendet stattdessen vorhandenen Code

MCP Server: Erweiterung der Funktionen von Claude

Model Context Protocol-Server ermöglichen Claude den Zugriff auf externe Tools und Systeme.

Installation


claude mcp add playwright npx -y @modelcontextprotocol/server-playwright


claude mcp add brave-search npx @modelcontextprotocol/server-brave-search

Berechtigungen automatisch genehmigen

Hinzufügen zu settings.local.json:

{
  "allowTools": (
    "MCP__playwright",
    "MCP__brave-search"
  )
}

Beispiel-Anwendungsfälle

Browsertests:

Claude generiert UI -Komponente
Öffnet den Browser über Playwright
Erstellt Screenshots
Analysiert die visuelle Qualität
Optimiert die Implementierung automatisch
Wiederholt den Vorgang, bis die Standards erfüllt sind

Dokumentationsrecherche:

Search for best practices for JWT authentication and implement in our API

Claude durchsucht das Web, findet aktuelle Best Practices und setzt diese um.

GitHub-Integration: CI/CD-Automatisierung

/install GitHub app

Generiert automatisch zwei GitHub-Aktionen:

@Claude wird in Issues/PRs erwähnt → Claude arbeitet an der Aufgabe
Automatische PR Überprüfungen → Claude überprüft den Code in neuen PRs

Anpassung

Bearbeiten .github/workflows/ Dateien auf:

Fügen Sie benutzerdefinierte Anweisungen für Claudes Kontext hinzu
Integrieren Sie MCP Server (z. B. Playwright für automatisierte Tests)
Explizite Berechtigungsbereiche definieren

Berechtigungsanforderung: Es müssen alle Tools aufgelistet werden, die Claude verwenden darf. MCP Server-Tools benötigen individuelle Berechtigungen.

Beispiel-Workflow:

Entwickler erwähnt @Claude in einem GitHub-Issue
GitHub Action startet Claude Code
Claude liest das Issue und implementiert die Lösung
Führt Tests über MCP den Playwright-Server durch
Erstellt PR mit der Implementierung
Veröffentlicht Verifizierungsbericht

Best Practices für die Produktion

1. Halten Sie den Kontext übersichtlich

Wenn Sie Claude in einer Sitzung mehr als zweimal wegen desselben Problems korrigiert haben, ist der Kontext mit fehlgeschlagenen Ansätzen überladen.

Lösungen:

Verwenden Sie /clear , um zwischen den Aufgaben einen Neustart durchzuführen
Verwenden Sie /compact , wenn Claude zwar gelernt hat, die Unterhaltung aber unübersichtlich ist
Beschränken Sie jede Unterhaltung auf ein Feature oder ein Problem

2. Geben Sie klare Ziele vor

Claude erzielt die besten Ergebnisse, wenn es ein klares Ziel gibt, an dem es sich orientieren kann – ein visuelles Mockup, einen Testfall oder eine andere Art von Ausgabe.

Beste Ziele:

Testfälle mit erwarteten Ergebnissen
Visuelle Mockups für die Benutzeroberfläche
Beispiel API Antworten
Fehlerprotokolle zur Fehlersuche

3. Verweisen, nicht beschreiben

Verwende immer @filename , anstatt zu beschreiben, wo sich der Code befindet. Claude liest die Datei, bevor er antwortet.

4. Verwende URLs für die Dokumentation

Füge Dokumentations-URLs direkt ein. Claude ruft den Inhalt ab und verwendet ihn:

Build authentication using

Verwende /permissions , um häufig verwendete Domains auf die Whitelist zu setzen.

5. Vor der Umsetzung planen

Bei komplexen Änderungen solltest du Claude immer bitten, zunächst zu recherchieren und zu planen. Die Schritte 1 und 2 sind entscheidend – ohne sie neigt Claude dazu, direkt mit der Programmierung einer Lösung zu beginnen.

6. Iterieren Sie mit Feedback

Korrigieren Sie Claude, sobald Sie bemerken, dass er vom Kurs abweicht. Die besten Ergebnisse entstehen durch enge Feedbackschleifen.

Verwende Esc , um sofort anzuhalten und die Richtung zu ändern.

Kurzanleitung

Wichtige Befehle

Befehl	Zweck
`/init`	CLAUDE.md aus dem Quellcode generieren
`@filename`	Bestimmte Datei in den Kontext einbinden
`/clear`	Kontext zurücksetzen (zwischen Aufgaben verwenden)
`/compact`	Verlauf zusammenfassen, Wissen beibehalten
`Esc`	Claude während einer Aktion anhalten
`Esc + Esc`	Zum vorherigen Zustand zurückspringen
`Shift+Tab x2`	Planungsmodus aktivieren (Breite)
`"Ultra think"`	Denkmodus aktivieren (Tiefe)
`/permissions`	Verwalten URL Zulassungsliste

Kontext-Hierarchie

@mentions (most specific)
  ↓
CLAUDE.md files (Project → Local → Machine)
  ↓
Conversation history
  ↓
General knowledge (least specific)

Wann welcher Modus verwendet werden sollte

Modus	Verwendung für	Token-Kosten
Normal	Einfache Bearbeitungen an einzelnen Dateien	Standard
Plan	Refactoring in mehreren Dateien, Funktionen	Hoch
Überlegen	Komplexe Logik, Debugging	Hoch
Kombiniert	Komplexe Mehrdateien + Logik	Sehr hoch

Wann sollte Claude-Code verwendet werden?

Verwenden Sie Claude Code für:

Refactoring mehrerer Dateien
Architekturuntersuchung und -planung
Automatisierte Testgenerierung
Komplexe Fehlersuche, die eine gründliche Analyse erfordert
Implementierung von Funktionen mit mehreren Komponenten
Überprüfung von „Infrastructure as Code“

Verwenden Sie Alternativen für:

Schnelle einzeilige Änderungen → IDE Plugins (Cursor, Copilot)
Neue Konzepte erlernen → Dokumentation
Explorative technische Diskussionen → claude.ai

Mentales Modell für den Erfolg

Claude-Code ist kein „eine bessere Autovervollständigung.“ Es ist die Infrastruktur für eine grundlegend andere Arbeitsweise.

Sie treffen weiterhin architektonische Entscheidungen. Sie sind weiterhin für die Codebasis verantwortlich. Aber Sie arbeiten auf einer höheren Abstraktionsebene – und delegieren Implementierungsdetails an ein autonomes System, das die Tool-Koordination, das Kontextmanagement und die mehrstufige Ausführung übernimmt.

Entwickler, die Claude Code beherrschen:

Wissen, wann sie es einsetzen sollten (und wann nicht)
Konfigurieren ihn speziell für ihre Arbeitsabläufe
Verwalten das Kontextbudget aktiv
Verstehen die Modusauswahl (Breite vs. Tiefe)
Nutzen Hooks für automatisierte Qualitätskontrollen
Stellen klare Ziele bereit (Tests, visuelle Darstellungen, Beispiele)
Iterieren mit engen Feedbackschleifen

Die besten Ergebnisse entstehen durch enge Feedbackschleifen. Korrigieren Sie frühzeitig. Geben Sie klare Ziele vor. Halten Sie den Kontext übersichtlich.

Beherrschen Sie diese Prinzipien, und Claude Code wird zum Kraftmultiplikator, der die Leistungsfähigkeit eines einzelnen Entwicklers revolutioniert.

Weitere Ressourcen

Offizielle Dokumentation:

Community-Ressourcen:

Bis zum nächsten Mal.

Kontakt

Treffen wir uns auf der Plattform, die Ihrem gewünschten Ergebnis am besten dient. Meine digitale Identität umfasst alle Plattform-Kontakte. Bevorzugst du E-Mail? Probiere contact@julianpaul.me.

Möchtest du auf dem Laufenden bleiben? RSS ↗ und/oder abonnieren Sie E-Mail-Updates. ↓

Vernetzen Sie sich mit mir: LinkedIn | Instagram |
GitHub |
𝕏 |
Lebenslauf

Original-Quelle: https://julianpaul.me/blog/claude-code-reference-ai-coding-in-your-terminal

Startseite | Shopping-Ideen | Syreality-Blog | A-Z Krafttier-Lexikon | A-Z Index der Bücher