Zum Inhalt springen
Ömer Tiryaki (Startseite)
← Alle Notizen

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.

  1. Abo: Claude Pro oder Max (auch Team und Enterprise). Du zahlst einen festen Monatsbetrag mit Nutzungsgrenzen.
  2. 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 update

Tipp: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.

  1. Im Projektordner claude eingeben und der Anmeldung im Browser folgen.
  2. Mit /status prüfen, welches Konto und welches Modell aktiv sind.
  3. Mit /logout abmelden, mit /login neu anmelden.
cd mein-projekt
claude

Achtung: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ü öffnen

Tipp: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.

  1. Im Projekt /init eingeben und die erzeugte CLAUDE.md lesen.
  2. Harte Regeln ergänzen, zum Beispiel was nie ins Repo darf oder wie Tests laufen.
  3. 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 Commits

Tipp: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.

  1. Plan zuerst: Im Plan-Modus beschreibe ich das Ziel und lese den Plan, bevor eine Datei geändert wird.
  2. Kleine Schritte: lieber mehrere kurze Aufgaben als eine riesige. Das hält den Kontext sauber und den Diff lesbar.
  3. Diff prüfen: Ich lese jede Änderung, bevor ich sie übernehme.
  4. Tests vor dem Commit, dann ein kleiner Commit mit klarer Nachricht.
  5. 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:

  1. 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.
  2. Claude verrennt sich in einer großen Aufgabe: mit Esc unterbrechen, die Aufgabe im Plan-Modus in Teilschritte zerlegen und einzeln umsetzen.
  3. Eine Änderung war falsch: mit /rewind oder zweimal Esc zu einem früheren Stand zurückspringen.
  4. Ständige Rückfragen: sichere, wiederkehrende Befehle wie Tests als allow-Regel eintragen oder für reine Dateiarbeit in den Modus acceptEdits wechseln.
  5. 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:

  1. claude --version zeigt eine Versionsnummer, /status zeigt das richtige Konto.
  2. Eine kurze CLAUDE.md mit Befehlen und harten Regeln liegt im Projekt.
  3. .claude/settings.json erlaubt die üblichen Befehle und sperrt .env und Secrets.
  4. Ein Formatierungs-Hook läuft nach jeder Änderung.
  5. Wiederkehrende Abläufe sind als Skill angelegt.
  6. Du kennst Plan-Modus, Esc, /compact und /clear.

Weitere Notizen

Datenschutz

Keine Tracking-Cookies

Hier wird nichts über dich gesammelt.

Das merkt sich dein Browser

Nichts davon dient der Analyse.

Zur Datenschutzerklärung