Konfigurationsleitfaden

Konfigurationsdateien

Claude Code verwendet mehrere Konfigurationsdateien, um Ihre Entwicklungserfahrung anzupassen:

• Globale Konfiguration: ~/.claude/config.json
• Projekt-Konfiguration: ./claude.config.json oder ./CLAUDE.md
• Umgebungsvariablen: Für API-Schlüssel und andere sensible Informationen

Globale Konfiguration

Grundeinstellungen

{
  "apiKey": "your-api-key",
  "model": "claude-3-5-sonnet-20241022",
  "outputStyle": "concise",
  "planMode": "auto",
  "maxTokens": 8192
}

Details der Konfigurationsoptionen

Option	Typ	Standard	Beschreibung
apiKey	string	-	Anthropic API-Schlüssel
model	string	claude-3-5-sonnet-20241022	Zu verwendendes Claude-Modell
outputStyle	string	balanced	Ausgabestil: concise, balanced, verbose
planMode	string	manual	Planmodus: auto, manual, off
maxTokens	number	4096	Maximale Token-Anzahl
temperature	number	0.3	Kreativitätslevel (0-1)

Projekt-Konfiguration

CLAUDE.md Datei

Erstellen Sie eine CLAUDE.md Datei im Projektverzeichnis für projektspezifische Einstellungen:

# Projekt: Meine Webanwendung

## Projektbeschreibung
Dies ist eine moderne Webanwendung mit React + TypeScript.

## Coding-Standards
- ESLint + Prettier verwenden
- Airbnb Code-Stil befolgen
- Funktionale Komponenten + Hooks verwenden
- TypeScript bevorzugen

## Dateistruktur
- `src/components/` - React-Komponenten
- `src/hooks/` - Custom Hooks
- `src/utils/` - Hilfsfunktionen
- `src/types/` - TypeScript-Typdefinitionen

## Wichtige Hinweise
- Alle API-Aufrufe benötigen Fehlerbehandlung
- Komponenten müssen PropTypes oder TypeScript-Typen enthalten
- Neue Features benötigen entsprechende Unit-Tests

claude.config.json

Oder verwenden Sie JSON-Format für die Projekt-Konfiguration:

{
  "project": {
    "name": "Meine Webanwendung",
    "type": "react-typescript",
    "framework": "vite"
  },
  "codeStyle": {
    "indentSize": 2,
    "quotes": "single",
    "semicolons": true,
    "trailingComma": "es5"
  },
  "testing": {
    "framework": "jest",
    "coverageThreshold": 80
  },
  "hooks": {
    "beforeCommit": ["npm test", "npm run lint"]
  }
}

Umgebungsvariablen

Erforderliche Umgebungsvariablen

# Anthropic API-Schlüssel
export ANTHROPIC_API_KEY=your_api_key_here

# Optional: Modell spezifizieren
export CLAUDE_MODEL=claude-3-5-sonnet-20241022

# Optional: benutzerdefinierter Konfigurationsdateipfad
export CLAUDE_CONFIG_PATH=/path/to/config.json

.env Datei-Unterstützung

Erstellen Sie eine .env Datei im Projektverzeichnis:

ANTHROPIC_API_KEY=your_api_key_here
CLAUDE_OUTPUT_STYLE=concise
CLAUDE_PLAN_MODE=auto
CLAUDE_MAX_TOKENS=8192

Erweiterte Konfiguration

Benutzerdefinierte Agenten

{
  "agents": {
    "codeReviewer": {
      "prompt": "Als Code-Review-Experte konzentriere dich auf Codequalität, Performance und Sicherheit",
      "model": "claude-3-5-sonnet-20241022",
      "temperature": 0.1
    },
    "documentationWriter": {
      "prompt": "Spezialisiert auf das Schreiben klarer, umfassender technischer Dokumentation",
      "model": "claude-3-haiku-20240307",
      "temperature": 0.5
    }
  }
}

Ausgabestile

{
  "outputStyles": {
    "development": {
      "verbosity": "detailed",
      "includeReasoning": true,
      "showProgress": true
    },
    "production": {
      "verbosity": "minimal",
      "includeReasoning": false,
      "showProgress": false
    }
  }
}

Hooks-Konfiguration

{
  "hooks": {
    "beforeEdit": "npm run format",
    "afterEdit": "npm run lint",
    "beforeCommit": ["npm test", "npm run build"],
    "onError": "echo 'Fehler aufgetreten, bitte prüfen Sie die Logs'"
  }
}

Enterprise-Konfiguration

Bedrock-Integration

{
  "provider": "bedrock",
  "bedrock": {
    "region": "us-east-1",
    "modelId": "anthropic.claude-3-sonnet-20240229-v1:0",
    "credentials": {
      "accessKeyId": "your-access-key",
      "secretAccessKey": "your-secret-key"
    }
  }
}

Vertex AI-Integration

{
  "provider": "vertex",
  "vertex": {
    "projectId": "your-gcp-project",
    "location": "us-central1",
    "modelName": "claude-3-sonnet@20240229",
    "credentials": "/path/to/service-account.json"
  }
}

Fehlerbehebung

Konfigurationsvalidierung

Validieren Sie Ihre Konfiguration:

claude config validate

Aktuelle Konfiguration anzeigen

claude config show

Konfiguration zurücksetzen

claude config reset

Konfigurationsvorlagen

Web-Entwicklungsvorlage

{
  "project": { "type": "web", "framework": "react" },
  "codeStyle": { "prettier": true, "eslint": true },
  "testing": { "framework": "jest", "coverage": true },
  "deployment": { "platform": "vercel" }
}

Backend-Entwicklungsvorlage

{
  "project": { "type": "backend", "framework": "express" },
  "database": { "type": "postgresql", "orm": "prisma" },
  "testing": { "framework": "mocha", "integration": true },
  "deployment": { "platform": "heroku" }
}

Bewährte Praktiken

1. Konfiguration in Versionsverwaltung: Fügen Sie claude.config.json zur Versionsverwaltung hinzu
2. Umgebungstrennung: Verwenden Sie unterschiedliche Konfigurationen für verschiedene Umgebungen
3. Team-Standardisierung: Teammitglieder sollten dieselbe Projekt-Konfiguration verwenden
4. Regelmäßige Updates: Aktualisieren Sie die Konfiguration, während sich das Projekt entwickelt

Fahren Sie mit Kernmechaniken fort, um tief in die Funktionsweise von Claude Code einzutauchen.