Claude Code Masterkurs – KI-gestuetztes Programmieren lernen mit Anthropics Coding-Agent

Authentifizierung & Model-Auswahl

Level 1 | 15 Minuten

API-Keys verwalten und das richtige Modell für deine Aufgaben auswählen

Lernziele

API-Key Management

Dein API Key ist der sensibelste Teil deiner Claude Code Konfiguration — er gibt Zugriff auf dein Anthropic-Konto und kann bei Missbrauch erhebliche Kosten verursachen. Professionelles Key-Management ist daher kein optionaler Schritt sondern eine Notwendigkeit. Die Grundregel: Behandle deinen API Key wie ein Passwort. Er gehört in Umgebungsvariablen, nicht in Dateien. Er gehört in Secrets Manager, nicht in Chat-Nachrichten. Er gehört in geschützte CI/CD-Variablen, nicht in YAML-Dateien. Jede Stelle an der dein Key im Klartext steht, ist ein potentielles Sicherheitsrisiko. Key-Rotation: Erstelle regelmäßig (mindestens monatlich) einen neuen Key auf console.anthropic.com und deaktiviere den alten. Das begrenzt den Schaden falls ein Key kompromittiert wird. In Teams: Nutze separate Keys pro Entwickler damit einzelne Keys gesperrt werden können ohne alle zu beeinträchtigen. Für verschiedene Umgebungen verschiedene Keys: Einen für lokale Entwicklung, einen für CI/CD, einen für Production-Automation. So kannst du die Kosten pro Umgebung tracken und bei Problemen gezielt einzelne Keys sperren. Überwachung: Prüfe regelmäßig auf console.anthropic.com die Nutzung deiner Keys. Ungewöhnliche Spitzen können auf kompromittierte Keys oder fehlkonfigurierte Pipelines hinweisen. Setze Spending Limits auf deinem Account um unkontrollierte Kosten zu verhindern. Für Teams und Unternehmen: Nutze ein zentrales Secrets-Management-System wie HashiCorp Vault, AWS Secrets Manager oder die Built-in-Secrets der CI/CD-Plattform. Persönliche Keys sollten NICHT geteilt werden — jeder Entwickler braucht seinen eigenen. Was tun wenn der Key kompromittiert ist? Sofort auf console.anthropic.com den Key deaktivieren. Neuen Key erstellen. Alle Stellen aktualisieren die den alten Key verwenden. Prüfen ob unautorisierte Nutzung stattgefunden hat. Ein häufiger Fehler: Den Key in eine .env Datei schreiben die nicht in der .gitignore steht. Ein einziger git push reicht um den Key öffentlich zu machen.

# 1. Via Claude CLI (Empfohlen)
claude config set api-key sk-ant-your-key-here

# 2. Environment Variable
export ANTHROPIC_API_KEY="sk-ant-your-key-here"

# 3. .env File im Projekt
echo 'ANTHROPIC_API_KEY=sk-ant-your-key-here' > .env

# 4. Shell Profile (persistent)
echo 'export ANTHROPIC_API_KEY="sk-ant-your-key-here"' >> ~/.zshrc
⚠️ Sicherheit NIEMALS API-Keys in Git committen! - Füge .env zu .gitignore hinzu - Nutze Secrets Management in Production - Rotiere Keys regelmäßig

Claude Modelle verstehen

Claude Code kann verschiedene KI-Modelle nutzen — und die richtige Wahl hat direkten Einfluss auf Qualität, Geschwindigkeit und Kosten deiner Arbeit. Es gibt drei Modellfamilien die du kennen solltest: Haiku, Sonnet und Opus. Claude Haiku: Das schnellste und günstigste Modell. Es antwortet nahezu sofort und kostet einen Bruchteil der anderen Modelle. Ideal für einfache Aufgaben: Dateien suchen, Code formatieren, einfache Refactorings, Dokumentation generieren, kurze Fragen beantworten. Haiku ist wie ein schneller Junior-Entwickler — zuverlässig bei klaren Aufgaben, überfordert bei komplexen Problemen. Claude Sonnet: Die beste Balance aus Qualität und Kosten. Sonnet ist das Standard-Modell für den Alltag — intelligent genug für die meisten Aufgaben, schnell genug für flüssiges Arbeiten, und preislich vertretbar. Feature-Implementierung, Code-Reviews, Test-Generierung, Refactoring, Bug-Fixing — Sonnet deckt 80% aller Aufgaben ab. Claude Opus: Das leistungsstärkste Modell mit der höchsten Reasoning-Fähigkeit. Opus ist das teuerste Modell aber auch das beste für wirklich schwierige Aufgaben: Komplexe Architektur-Entscheidungen, tiefe Security-Analysen, schwer reproduzierbare Bugs, Multi-System-Design, Algorithmen-Entwicklung. Opus ist wie ein Senior-Architekt — teuer, aber bei den richtigen Aufgaben sein Geld wert. Modellwahl in der Praxis: Du kannst das Modell bei jedem Start wählen ('claude --model opus') oder innerhalb einer Session wechseln. Die Faustregel: Starte mit Sonnet. Wenn die Ergebnisse nicht gut genug sind, wechsle zu Opus. Wenn die Aufgabe trivial ist, nutze Haiku. Token-Limits beachten: Jedes Modell hat ein maximales Context Window (wie viel Text es gleichzeitig verarbeiten kann). Seit März 2026 bieten Opus 4.6 und Sonnet 4.6 ein 1M Token Context Window (vorher 200K) — das reicht für ganze Codebases in einem Kontext. Haiku hat weiterhin 200K. Die Output-Limits variieren: Haiku bis 8K Tokens, Sonnet bis 16K und Opus bis 32K Tokens. Die Kosten im Überblick: Haiku kostet ~0.25 USD pro Million Input Tokens. Sonnet ~3 USD. Opus ~15 USD. Das klingt abstrakt — in der Praxis bedeutet es: Eine typische Session mit Sonnet kostet 0.05-0.30 USD. Mit Opus das 5-fache. Deshalb ist die richtige Modellwahl der größte Kostenhebel.

| Modell | Intelligenz | Speed | Kosten | Best For |
|--------|-------------|-------|--------|----------|
| Opus 4.6 | ⭐⭐⭐⭐⭐ | ⭐⭐ | 💰💰💰 | Komplexe Tasks, Architecture Design |
| Sonnet 4.6 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 💰💰 | Daily Development, Balanced |
| Haiku 4.5 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 💰 | Simple Tasks, Quick Fixes |

Opus 4.6 - Maximum Intelligence

# Opus explizit verwenden
claude --model opus "Refaktoriere das gesamte Auth-System zu Clean Architecture"

Sonnet 4.6 - Best Balance (DEFAULT)

# Sonnet (Standard, kein Flag nötig)
claude "Erstelle eine neue React Component für User Profile"

Haiku 4.5 - Maximum Speed

# Haiku für schnelle Tasks
claude --model haiku "Füge TypeScript Type zu dieser Funktion hinzu"

Kosten-Optimierung

Beispiel: Feature Development (10K input, 2K output tokens)

Opus:   $15 * 0.01 + $75 * 0.002 = $0.30
Sonnet: $3  * 0.01 + $15 * 0.002 = $0.06
Haiku:  $0.25 * 0.01 + $1.25 * 0.002 = $0.005

💡 Sonnet ist 5x günstiger als Opus
💡 Haiku ist 12x günstiger als Sonnet
💰 Cost-Saving Strategy 1. Nutze Haiku für Simple Tasks (80% der Fälle) 2. Nutze Sonnet für Features & Reviews (15% der Fälle) 3. Nutze Opus für Complex Architecture (5% der Fälle) → Spart bis zu 90% Kosten!

Model Selection Guide

# Quick Fixes & Simple Edits → Haiku
claude --model haiku "Fix typo in README"
claude --model haiku "Add console.log for debugging"
claude --model haiku "Format this code with prettier"

# Feature Development & Reviews → Sonnet (Default)
claude "Implement user authentication"
claude "Review this PR for security issues"
claude "Write tests for UserService"

# Complex Architecture & Research → Opus
claude --model opus "Design microservices architecture for e-commerce"
claude --model opus "Analyze performance bottlenecks across system"
claude --model opus "Refactor monolith to domain-driven design"

Default Model konfigurieren

# Set default model
claude config set default-model sonnet

# Check current config
claude config list

# Per-project override in CLAUDE.md
---
model: opus
---

Usage Tracking

# Zeige Usage Statistics
claude usage

# Output:
# This month:
# - Opus:   1.2M tokens ($24.00)
# - Sonnet: 10M tokens ($60.00)
# - Haiku:  50M tokens ($25.00)
# Total: $109.00

# Zeige detaillierte Logs
claude logs --cost
🎓 Best Practice Starte immer mit Sonnet. Wechsle zu Opus nur wenn: - Die Task zu komplex ist - Sonnet mehrfach fehlschlägt - Du Maximum Quality benötigst Nutze Haiku für: - Alle repetitiven Tasks - Quick Iterations - Prototyping