Claude Code Konfiguration

Problem: Frische Claude Code-Sessions liefern generische Antworten, weil sie nichts über dein Projekt wissen.

Schnellgewinn: Leg eine CLAUDE.md in dein Projektstamm, und die nächste Session liest sie, bevor du ein Wort getippt hast.

Ergebnis: Antworten hören auf, wie ein Standard-Tutorial zu klingen, und fangen an, zu deinem tatsächlichen Stack zu passen.

Drei Dateien erledigen den Großteil der Arbeit. CLAUDE.md gibt Claude Kontext. MCP-Server geben ihm Tools. Slash-Befehle geben ihm Workflows. Einmal einrichten, überall wiederverwenden.

Konfigurationsdateien erstellen

Zwei Befehle starten dich:

touch CLAUDE.md                    # Projektstamm - erforderlich
mkdir -p .claude/commands          # Benutzerdefinierte Workflows - optional

Das ist das gesamte Gerüst. Jetzt füll es aus.

CLAUDE.md (Erforderlich)

Leg das in den Projektstamm. Claude liest es bei jedem Session-Start:

# [Project Name] - Development Context

## What This Project Does

[2-sentence description of your app's purpose]

## Tech Stack & Version

- Frontend: React 18.2.0 with TypeScript 5.0
- Backend: Node.js with Express or Next.js App Router
- Database: PostgreSQL 15 with Prisma ORM
- Styling: Tailwind CSS 3.4

## File Structure

src/
├── app/ # Next.js pages (App Router)
├── components/ # Reusable UI components
├── lib/ # Utilities and configurations
└── types/ # TypeScript definitions

## Current Sprint Goals
- [ ] User authentication system
- [ ] Dashboard with user data
- [ ] API endpoints for CRUD operations

## Never Touch Without Permission
- package.json dependencies (ask first)
- Database migrations (explain changes)
- Production environment variables

Erfolgscheck: Claude erwähnt deinen Stack und deine Sprint-Ziele in seiner nächsten Antwort, ohne gefragt zu werden.

MCP-Server (Leistungsstarke Features)

MCP (Model Context Protocol) Server schrauben echte Tools an Claude. Lege sie in deinen globalen Einstellungen unter ~/.claude/settings.json ab:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "env": {
        "ACCESS_DIRECTORIES": "/Users/yourname/projects"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Was dir das bringt:

• Direktes Lesen und Schreiben von Dateien
• GitHub Repository-Suche
• Zugriff auf Projektdokumentation
• Mustererkennung in deinem Code

Erfolgscheck: Claude kann jetzt Dateien öffnen und GitHub treffen, ohne dass du etwas einfügen musst.

Slash-Befehle (Wiederverwendbare Workflows)

Jede Markdown-Datei unter .claude/commands/ wird zu einem Slash-Befehl. Benenne die Datei, und der Befehl ist kostenlos.

Debug-Workflow (.claude/commands/debug.md):

# Debug Workflow

When debugging:

1. Reproduce the error in isolation
2. Check browser console and network tab
3. Add console.logs to trace execution
4. Test with minimal data
5. Check recent changes in git log
6. Ask before suggesting major architecture changes

Test-Generierung (.claude/commands/test.md):

# Test Generation Guidelines

For new functions:

1. Write unit tests with Jest/Vitest
2. Test happy path and edge cases
3. Mock external dependencies
4. Use descriptive test names
5. Aim for 80% coverage on critical paths

Verwendung: Tippe /debug oder /test in einer beliebigen Session und Claude führt den Workflow aus.

Erfolgscheck: Claude folgt jedes Mal denselben dokumentierten Schritten.

Häufige Konfigurationsfehler

Wenn CLAUDE.md zu groß wird, aufteilen. Die Stammdatei kurz halten und auf den Rest verweisen:

# Main CLAUDE.md (keep short)

See also:

- .claude/database-schema.md (detailed schema)
- .claude/api-patterns.md (endpoint conventions)

Das settings.json-Scope-System

Über CLAUDE.md hinaus verwendet Claude Code settings.json-Dateien für Berechtigungen, Env-Variablen, Standard-Modelle und Tool-Verhalten. Vier Scopes stapeln sich, und der engere gewinnt:

Priorität, von oben nach unten: Managed > Kommandozeilenargumente > Local > Project > User. Managed-Einstellungen gewinnen immer, damit Unternehmensrichtlinien durchgesetzt bleiben.

Füge $schema oben in deine settings.json ein und VS Code, Cursor oder jeder JSON-Schema-Editor wird autocomplete und Validierung beim Tippen bieten:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
    "deny": ["Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)"]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1"
  }
}

Claude Code speichert auch jeden Einstellungsedit mit Zeitstempel und behält die fünf neuesten Backups, damit ein schlechtes Speichern dir nichts kostet.

Wichtige Einstellungskategorien

Jede Kategorie hat ihren eigenen dedizierten Leitfaden. Kurze Version:

• Berechtigungen. Steuere, welche Tools Claude verwendet, welche Dateien es liest, welche Befehle es ausführt. Regeln gehen unter allow, deny und ask.
• Sandbox. Bash-Befehle vom Dateisystem und Netzwerk abschotten, auf OS-Ebene durchgesetzt. Mit /sandbox oder sandbox.enabled einschalten.
• Attribution. Den Co-Authored-By-Trailer in Commits und PRs behalten oder entfernen. Commits und PRs werden separat konfiguriert.
• Plugins. Skills, Agents, Hooks und MCP-Server aus Marktplätzen laden. Gesteuert durch enabledPlugins und extraKnownMarketplaces.
• Modell. Einen Standard über den model-Schlüssel festlegen, anstatt jedes Mal --model zu übergeben.
• Statusleiste. Kontextverbrauch, Git-Branch, Modellname oder Kosten in eine persistente Leiste einbauen.
• Tastenbelegungen. Tasten mit /keybindings neu belegen, das in ~/.claude/keybindings.json schreibt.

Essentielle Umgebungsvariablen

Env-Variablen geben dir die feinste Kontrolle über Claude Code. Setze sie in deinem Shell-Profil, übergib sie direkt oder steck sie in den env-Schlüssel in settings.json. Die wissenswerten:

Drei Wege, sie anzuwenden. Direkt für eine einmalige Session:

ANTHROPIC_MODEL=claude-sonnet-4-20250514 claude

Persistent, durch Hinzufügen zu ~/.bashrc oder ~/.zshrc:

export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=80
export MAX_THINKING_TOKENS=10000

Oder in settings.json einbacken, damit sie bei jedem Ausführen gelten:

{
  "env": {
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "80",
    "MAX_THINKING_TOKENS": "10000"
  }
}

Es gibt rund 70 Env-Variablen. Die Einstellungsreferenz hat die vollständige Liste, und der Terminal-Setup-Leitfaden behandelt Zeilenumbrüche und Benachrichtigungen.

Globale vs. Projektkonfiguration

Globale Einstellungen (~/.claude/settings.json):

• MCP-Server-Konfigurationen
• Persönliche Präferenzen und Modell-Standardwerte
• Universelle Codierungsstandards

Projekteinstellungen (Projektstamm):

• CLAUDE.md. Projektkontext und Regeln.
• .claude/commands/. Benutzerdefinierte Slash-Befehle.
• .claude/settings.json. Teamgeteilte Berechtigungen, Hooks und MCP-Server.
• .claude/settings.local.json. Deine persönlichen Übersteuerungen für dieses Projekt (gitignored).

Priorität nochmal kurz: Managed > Local > Project > User. Führe /init aus und Claude schreibt eine Starter-CLAUDE.md für dich.

Arbeitest du in einem Monorepo oder teilst Standards über Repos hinweg? Das --add-dir-Flag lässt Claude CLAUDE.md-Dateien aus zusätzlichen Verzeichnissen laden.

Nächste Schritte

Claude Code ist jetzt konfiguriert. Von hier aus:

• Baue dein erstes Projekt auf dem konfigurierten Setup
• Lerne Terminal-Kontrolltechniken kennen
• Vertiefe dich in Context-Management-Strategien
• Füge weitere MCP-Server aus der beliebten Liste hinzu
• Schau in den Fehlerbehebungsleitfaden, wenn etwas hakt

Pro-Tipp: Halte CLAUDE.md frisch. Stack ändert sich, Prioritäten verschieben sich, Sprint-Ziele rotieren. Aktualisiere die Datei, wenn das passiert. Claude ist nur so scharf wie der Kontext, den du ihm gibst.