Anleitunggeprüft
Claude Code einrichten
Von der Installation bis zum Arbeiten mit CLAUDE.md, Skills und Hooks. So nutze ich Claude Code jeden Tag.
Was Claude Code ist
Claude Code ist ein KI-Assistent für das Terminal. Er liest dein Projekt, ändert Dateien und führt Befehle aus, aber nur so weit, wie du es erlaubst. Der Unterschied zu einem Chatfenster: Claude sieht den echten Code und kann Tests selbst laufen lassen. Diese Anleitung führt dich von der Installation bis zu einer Einrichtung, mit der du jeden Tag arbeiten kannst.
Voraussetzungen
Du brauchst ein Terminal (Bash, Zsh, PowerShell oder CMD) und ein aktuelles System: macOS 13 oder neuer, Windows 10 ab 1809, Ubuntu 20.04 oder Debian 10. Dazu ein Konto mit Zugang zu Claude Code. Der kostenlose Claude-Plan reicht nicht.
- Abo: Claude Pro oder Max (auch Team und Enterprise). Du zahlst einen festen Monatsbetrag mit Nutzungsgrenzen.
- Oder ein Konto in der Claude Console mit API-Abrechnung. Hier zahlst du nach Verbrauch.
Installation
Empfohlen ist der native Installer. Er braucht kein Node.js und hält Claude Code im Hintergrund automatisch aktuell. Die Installation über npm geht weiterhin, setzt aber Node.js 22 oder neuer voraus und wird nicht mit sudo ausgeführt. Danach prüfst du mit claude --version, ob alles geklappt hat.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Alternative über npm (Node.js 22+)
npm install -g @anthropic-ai/claude-code@latest
# Prüfen und manuell aktualisieren
claude --version
claude doctor
claude updateTipp:Meldet das Terminal nach der Installation „command not found“, öffne ein neues Terminalfenster. Hilft das nicht, zeigt claude doctor, was fehlt.
Anmelden und erster Start
Starte Claude Code immer im Ordner des Projekts, an dem du arbeiten willst. Claude sieht dann genau diesen Ordner und lädt die passenden Einstellungen. Beim ersten Start öffnet sich der Browser zur Anmeldung. Mit einem Abo meldest du dich mit deinem Claude-Konto an, mit der Console über dein Console-Konto.
- Im Projektordner claude eingeben und der Anmeldung im Browser folgen.
- Mit /status prüfen, welches Konto und welches Modell aktiv sind.
- Mit /logout abmelden, mit /login neu anmelden.
cd mein-projekt
claudeAchtung:Ist die Umgebungsvariable ANTHROPIC_API_KEY gesetzt und bestätigst du sie, nutzt Claude Code diesen Schlüssel statt deines Abos. Dann wird nach Verbrauch abgerechnet. Mit /status siehst du, was gerade aktiv ist.
Grundbedienung
Du schreibst Aufgaben in normaler Sprache. Befehle mit Schrägstrich steuern die Sitzung selbst. Mit @ und einem Dateinamen verweist du gezielt auf eine Datei, so muss Claude nicht erst suchen. Esc unterbricht Claude mitten in der Arbeit, das bisher Erledigte bleibt erhalten. Umschalt + Tab wechselt den Modus: Manual (fragt bei jeder Änderung), acceptEdits (übernimmt Dateiänderungen ohne Rückfrage) und Plan (liest und plant, ändert aber nichts).
/help Hilfe und alle Befehle
/init erste CLAUDE.md anlegen
/clear neues Gespräch mit leerem Kontext
/compact Gespräch zusammenfassen, Kontext freigeben
/context zeigen, wie voll der Kontext ist
/model Modell wechseln
/permissions Berechtigungsregeln verwalten
/rewind zu einem früheren Stand zurückspringen
/usage Verbrauch und Limits anzeigen
@src/app.ts Datei gezielt erwähnen
Esc Claude unterbrechen
Esc Esc (bei leerer Eingabe) Rewind-Menü öffnenTipp:Gib einen Plan erst frei, wenn er stimmt. Soll etwas anders laufen, schreib es einfach dazu, Claude passt den Plan an.
Berechtigungen
Lesen darf Claude im Projektordner ohne Rückfrage. Für Shell-Befehle und Dateiänderungen fragt es standardmäßig nach. Damit du nicht bei jedem npm-Befehl bestätigen musst, legst du Regeln fest: allow erlaubt ohne Nachfrage, deny verbietet. Gemeinsame Regeln stehen in .claude/settings.json und landen im Repo, persönliche in .claude/settings.local.json, Regeln für alle Projekte in ~/.claude/settings.json.
{
"permissions": {
"allow": ["Bash(npm run *)", "Bash(git commit *)"],
"deny": ["Bash(git push *)", "Read(./.env)", "Read(./secrets/**)"]
}
}Achtung:Eine deny-Regel prüft nur den Befehlstext. git -C . push würde Bash(git push *) zum Beispiel nicht treffen. Sie ist also keine Sicherheitsgrenze. Den Modus bypassPermissions, der alle Rückfragen abschaltet, nutzt du nur in einer isolierten Umgebung wie einem Container.
CLAUDE.md: Regeln für dein Projekt
Claude liest bei jedem Start die Datei CLAUDE.md. Dort steht, was das Projekt ist, welche Befehle es gibt und welche Regeln gelten. Mit /init legt Claude eine erste Fassung an, die du dann schärfst. Halte die Datei kurz, unter 200 Zeilen. Je knapper und konkreter, desto zuverlässiger hält Claude sich daran.
- Im Projekt /init eingeben und die erzeugte CLAUDE.md lesen.
- Harte Regeln ergänzen, zum Beispiel was nie ins Repo darf oder wie Tests laufen.
- Persönliche Vorlieben gehören in ~/.claude/CLAUDE.md, die gilt für alle Projekte. Private Notizen nur für dieses Projekt kommen in CLAUDE.local.md, die du in .gitignore einträgst.
# Projekt
Next.js mit TypeScript strict. Details in @README.md
## Befehle
- npm run dev: Entwicklungsserver
- npm run test: Tests, vor jedem Commit
## Regeln
- Keine Secrets im Code, nur über Umgebungsvariablen
- Kleine Commits nach Conventional CommitsTipp:CLAUDE.md ist Kontext, keine Sperre. Was auf keinen Fall passieren darf, sicherst du zusätzlich mit einer deny-Regel oder einem Hook ab.
Skills
Ein Skill ist ein Ordner mit einer SKILL.md, die eine wiederkehrende Aufgabe beschreibt, etwa ein Release oder eine Übersetzung. Claude lädt ihn selbst, wenn die Beschreibung zu deiner Anfrage passt, oder du rufst ihn mit /name direkt auf. Der Vorteil: Die Anleitung liegt einmal im Projekt und wird nur geladen, wenn sie gebraucht wird. Projekt-Skills liegen in .claude/skills/, persönliche in ~/.claude/skills/.
# .claude/skills/release/SKILL.md
---
name: release
description: Bereitet ein Release vor. Nutzen, wenn ich nach einem Release oder einer neuen Version frage.
disable-model-invocation: true
---
1. npm run test ausführen und bei Fehlern abbrechen.
2. Changelog aus den Commits seit dem letzten Tag schreiben.
3. Versionsnummer nach SemVer vorschlagen und auf mein OK warten.Tipp:Die description entscheidet, wann Claude den Skill lädt. Schreib hinein, was er tut und wann er passt. Mit disable-model-invocation: true startest nur noch du ihn, sinnvoll bei allem mit Folgen wie Deploys oder Releases.
Hooks
Hooks sind Shell-Befehle, die Claude Code bei festen Ereignissen ausführt. Anders als eine Regel in der CLAUDE.md laufen sie immer, egal was Claude entscheidet. Wichtige Ereignisse sind PreToolUse (vor einem Werkzeug, kann es blockieren), PostToolUse (danach), Stop (wenn Claude fertig ist) und SessionStart. Hooks stehen im Block "hooks" einer settings.json, mit /hooks siehst du alle aktiven.
// .claude/settings.json
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\""
}
]
}
]
}
}Tipp:Das Beispiel braucht das Werkzeug jq, das den Dateipfad aus den Daten liest, die Claude Code an den Hook übergibt. Ein PreToolUse-Hook, der mit Exit-Code 2 endet, blockiert die Aktion und gibt Claude den Grund zurück.
Subagents
Ein Subagent ist ein spezialisierter Helfer mit eigenem Kontextfenster. Claude gibt ihm eine Teilaufgabe, etwa ein Code-Review oder eine breite Suche, und bekommt nur die Zusammenfassung zurück. So bleibt dein Hauptgespräch schlank. Du kannst die Werkzeuge eines Subagents einschränken, zum Beispiel auf reines Lesen. Projekt-Subagents liegen in .claude/agents/, persönliche in ~/.claude/agents/.
# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Prüft Änderungen auf Fehler, Lesbarkeit und Sicherheit. Nach jeder größeren Änderung nutzen.
tools: Read, Glob, Grep
model: sonnet
---
Du prüfst Code. Nenne konkrete Probleme mit Datei und Zeile
und schlage eine Lösung vor. Ändere selbst nichts.Tipp:Pflicht sind nur name und description. Der Text unter dem Frontmatter ist die Anweisung, mit der der Subagent arbeitet. Ohne tools erbt er alle Werkzeuge der Hauptsitzung.
MCP: externe Werkzeuge anbinden
Über das Model Context Protocol (MCP) verbindest du Claude Code mit weiteren Werkzeugen und Datenquellen, etwa einer Datenbank, einem Ticketsystem oder deinem eigenen Dienst. Mit /mcp siehst du, welche Server verbunden sind. Wie du einen Server einrichtest und worauf du bei der Sicherheit achten solltest, beschreibe ich ausführlich in der Anleitung „MCP-Server anbinden“.
So arbeite ich damit
Größere Aufgaben lasse ich zuerst planen (Umschalt + Tab für den Plan-Modus), dann umsetzen. Jede Änderung prüfe ich im Diff, Tests laufen vor jedem Commit. Claude ist mein Sparringspartner, das Verstehen bleibt meine Aufgabe.
- Plan zuerst: Im Plan-Modus beschreibe ich das Ziel und lese den Plan, bevor eine Datei geändert wird.
- Kleine Schritte: lieber mehrere kurze Aufgaben als eine riesige. Das hält den Kontext sauber und den Diff lesbar.
- Diff prüfen: Ich lese jede Änderung, bevor ich sie übernehme.
- Tests vor dem Commit, dann ein kleiner Commit mit klarer Nachricht.
- Neue Aufgabe, neuer Kontext: Wenn ein Thema abgeschlossen ist, starte ich mit /clear neu.
Häufige Fehler und Lösungen
Die meisten Probleme haben mit zu viel Kontext, zu großen Aufgaben oder fehlenden Regeln zu tun. Diese Fälle begegnen dir am häufigsten:
- Antworten werden ungenau oder Claude vergisst Absprachen: Der Kontext ist voll. Mit /context nachsehen, dann /compact (gern mit Hinweis, worauf die Zusammenfassung achten soll) oder bei neuem Thema /clear.
- Claude verrennt sich in einer großen Aufgabe: mit Esc unterbrechen, die Aufgabe im Plan-Modus in Teilschritte zerlegen und einzeln umsetzen.
- Eine Änderung war falsch: mit /rewind oder zweimal Esc zu einem früheren Stand zurückspringen.
- Ständige Rückfragen: sichere, wiederkehrende Befehle wie Tests als allow-Regel eintragen oder für reine Dateiarbeit in den Modus acceptEdits wechseln.
- Claude ignoriert eine Regel: Die CLAUDE.md ist zu lang oder zu vage. Kürzen, konkret formulieren und Wichtiges mit Hook oder deny-Regel absichern.
Checkliste
Wenn diese Punkte erledigt sind, ist Claude Code für den Alltag eingerichtet:
- claude --version zeigt eine Versionsnummer, /status zeigt das richtige Konto.
- Eine kurze CLAUDE.md mit Befehlen und harten Regeln liegt im Projekt.
- .claude/settings.json erlaubt die üblichen Befehle und sperrt .env und Secrets.
- Ein Formatierungs-Hook läuft nach jeder Änderung.
- Wiederkehrende Abläufe sind als Skill angelegt.
- Du kennst Plan-Modus, Esc, /compact und /clear.
Weitere Notizen
- Anleitungn8n mit KIWorkflows in n8n bauen, die mit KI Mails einordnen, Daten aus Dokumenten lesen und Antworten vorschlagen. Mit Installation, Fehlerbehandlung, Datenschutz und Betrieb.
- AnleitungMCP-Server anbindenWie du Claude über das Model Context Protocol mit eigenen Daten und Werkzeugen verbindest, sicher und Schritt für Schritt.
- NotizConditional Access einführen, ohne sich auszusperrenConditional Access ist mächtig, und genau das macht es riskant. Eine einzige Richtlinie mit „Alle Benutzer, alle Ressourcen, Zugriff blockieren“ sperrt die ganze Organisation aus, die Admins eingeschlossen. Die meisten Probleme entstehen nicht durch exotische Einstellungen, sondern weil eine Richtlinie direkt scharf geschaltet wird, ohne sie vorher zu testen.