Das komplette
Claude Code
Handbuch.

Was ist Claude Code?

Claude Code ist die offizielle Kommandozeilen-Version von Claude, entwickelt von Anthropic. Du startest Claude direkt im Terminal, gibst ihm ein Projekt-Verzeichnis, und er liest, schreibt, testet und deployed Code — alles mit direktem Dateisystem-Zugriff. Kein Copy-Paste mehr zwischen Browser und Editor.

Was Claude Code von anderen AI-Tools unterscheidet

Installation & erster Login

Drei Schritte: Node.js installieren, Claude Code via npm global installieren, einloggen. Zehn Minuten.

2.1 — Homebrew & Node.js

# Homebrew installieren (falls nicht vorhanden)
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Node.js installieren — mindestens Version 18
$ brew install node
$ node --version
v22.11.0

2.2 — Claude Code installieren

$ npm install -g @anthropic-ai/claude-code
$ claude --version

2.3 — Erster Start & Login via Browser

# In ein Projekt-Verzeichnis wechseln
$ cd ~/Documents

# Claude starten
$ claude

# Browser öffnet sich → bei Anthropic einloggen → fertig

2.4 — Die Verzeichnisstruktur von Claude Code

Nach der Installation wird automatisch folgende Struktur unter ~/.claude/ angelegt:

~/.claude/
├── CLAUDE.md              # Deine globalen Regeln
├── settings.json          # Globale Config (Modell, Hooks, Sprache)
├── settings.local.json    # Projekt-Berechtigungen (Allowlist)
├── plugins/               # Installierte Plugins
├── skills/                # Skills (eigene + via GSD)
├── agents/                # Sub-Agents (kommen mit GSD)
├── hooks/                 # Hook-Scripts
├── commands/              # Custom Slash-Commands
├── projects/              # Memory pro Projekt-Verzeichnis
├── get-shit-done/         # GSD-Workflow-Engine
├── scripts/               # Eigene Shell-Scripts (pre-deploy usw.)
└── keybindings.json       # Keyboard-Shortcuts

Basis-Config: Modell, Sprache, Voice

Mirkan nutzt Claude Opus als Standardmodell, Deutsch als Sprache, und hat Voice-Input aktiviert. Alles über ~/.claude/settings.json.

{
  "model": "opus",
  "language": "German",
  "voiceEnabled": true,
  "statusLine": {
    "type": "command",
    "command": "node ~/.claude/hooks/gsd-statusline.js"
  }
}

Modell wechseln

In jeder Session per /model Befehl. Opus ist am stärksten (Default), Sonnet ist ausgewogen, Haiku ist schnell und günstig.

Fast-Mode — Opus 4.6 mit schnellerem Output

Statusline — die Info-Zeile unten

Die gsd-statusline.js zeigt dir in Echtzeit: aktuelle Phase, Token-Budget, Modell, Projekt. Installiert sich mit GSD automatisch.

Die 3 Plugins — mit Praxis-Beispielen

Diese drei Plugins laufen bei Mirkan, alle aus dem Marketplace claude-plugins-official. Jedes Plugin hat seinen ganz eigenen Anwendungsfall.

Installation — so gehst du vor

$ claude
> /plugin

# Navigation:
#   1. "Browse Marketplaces"
#   2. "claude-plugins-official" auswählen
#   3. Plugin auswählen → "Install"
#   4. Für alle drei wiederholen

# Prüfen ob installiert:
$ cat ~/.claude/plugins/installed_plugins.json

Plugin-Verwaltung im Alltag

MCP-Server: Magic & Pencil

MCP (Model Context Protocol) ist Anthropics Standard, mit dem Claude mit externen Tools spricht. Bei Mirkan laufen zwei: magic (21st.dev für UI-Komponenten & Logos) und pencil (für .pen Design-Dateien in VS Code).

# Erst API-Key holen: https://21st.dev/magic/console
# Kostenlos, Free-Tier reicht

$ claude mcp add magic -s user \
    --env API_KEY="DEIN_API_KEY" \
    -- npx -y @21st-dev/magic@latest

$ claude mcp list

# Voraussetzung: VS Code + Pencil-Extension installiert
# VS Code Marketplace → "Pencil" von High Agency

$ claude mcp add pencil -s user -- \
    ~/.vscode/extensions/highagency.pencildev-*/out/mcp-server-darwin-arm64 \
    --app visual_studio_code

Überblick MCP-Server bei Mirkan

Die globale CLAUDE.md

Das Herzstück. Eine Markdown-Datei unter ~/.claude/CLAUDE.md, die bei JEDER Session automatisch geladen wird. Bei Mirkan ca. 300 Zeilen mit 25+ Sektionen. Alles was Claude global wissen muss.

Mirkans CLAUDE.md — alle Sektionen im Überblick

So bekommt dein Kollege die Datei

# Mirkan schickt dir seine CLAUDE.md — leg sie ab unter:
$ cp ~/Downloads/CLAUDE.md ~/.claude/CLAUDE.md

# Oder neu erstellen und Sektionen einfügen:
$ code ~/.claude/CLAUDE.md

# Zum Testen:
$ claude
> Zeig mir die wichtigsten globalen Regeln, die du aus CLAUDE.md kennst.

Projekt-CLAUDE.md — zusätzlich pro Projekt

In jedem Projekt-Root eine eigene CLAUDE.md. Globale + projektspezifische werden automatisch kombiniert.

GSD — Get Shit Done

Mirkans wichtigste Erweiterung. Über 65 Slash-Commands für strukturierte Projekt-Arbeit: Milestones, Phasen, Pläne, Execution, Review, Ship. Bringt auch automatisch 24 Agents und 9 Hooks mit.

GSD installieren

# GSD Installer — legt alle Skills, Agents, Hooks an
$ npx -y @get-shit-done/installer

# Verzeichnis-Struktur nach Installation:
$ ls ~/.claude/get-shit-done/
bin  contexts  references  templates  VERSION  workflows

Die GSD-Commands nach Kategorie

Skills — Mirkans Werkzeugkasten

Skills sind spezialisierte Mini-Programme für konkrete Aufgaben. Neben den GSD-Skills hat Mirkan 18 weitere. Jeder mit Anwendungsbeispiel.

Die 24 GSD-Agents

Agents sind spezialisierte Sub-Claudes, die für spezifische Aufgaben aufgerufen werden. Anders als Skills (= Anweisungen) sind Agents eigenständige Prozesse mit eigenem Tool-Set. Kommen alle mit GSD.

Hooks — automatische Wächter

Hooks sind Scripts, die bei bestimmten Events automatisch laufen. Bei Mirkan sind 9 aktiv — alle kommen mit GSD. Plus ein eigener pre-deploy-Hook.

Wie Hooks konfiguriert werden

Alle Hooks sind in ~/.claude/settings.json definiert. Mit GSD-Install werden sie automatisch eingetragen.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{
          "type": "command",
          "command": "if echo \"$CLAUDE_TOOL_INPUT\" | grep -q 'deploy'; then pre-deploy || exit 1; fi"
        }]
      },
      {
        "matcher": "Write|Edit",
        "hooks": [{
          "type": "command",
          "command": "node ~/.claude/hooks/gsd-workflow-guard.js",
          "timeout": 5
        }]
      }
    ],
    "SessionStart": [
      {
        "hooks": [{
          "type": "command",
          "command": "bash ~/.claude/hooks/gsd-session-state.sh"
        }]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Bash|Edit|Write|MultiEdit|Agent|Task",
        "hooks": [{
          "type": "command",
          "command": "node ~/.claude/hooks/gsd-context-monitor.js",
          "timeout": 10
        }]
      }
    ]
  }
}

Der pre-deploy Hook — was er prüft

Das pre-deploy-Script triggert automatisch, sobald Claude einen Bash-Befehl mit dem Wort "deploy" ausführen will. Es blockt den Deploy wenn einer der Checks fehlschlägt.

• Security: console.log/error in Production? Hardcoded Secrets? innerHTML mit User-Input?
• Performance: Alle Bilder WebP? Alle mit width/height? Hero-Image loading="eager"?
• SEO: Title/Description pro Seite? Sitemap + Robots vorhanden? Schema.org JSON-LD?
• Barrierefreiheit: alt-Texte vorhanden? lang="de" gesetzt? Kontraste ok?
• Rechtliches: Impressum vorhanden? Datenschutz verlinkt? DSGVO-Checkbox bei Formularen?
• .htaccess: HTTPS-Forcing, GZIP, Caching, Verzeichnis-Listing aus?

Eigene Hooks bauen

Memory-System — Claude vergisst nichts

Pro Projekt-Verzeichnis legt Claude ein Memory-Verzeichnis an. Dort speichert er persistente Infos über dich, Feedback, Projekt-Status und externe Referenzen. Sessionübergreifend.

Memory-Struktur bei Mirkan

$ ls ~/.claude/projects/-Users-mirkanpolat/memory/
MEMORY.md                         # Index aller Memory-Dateien
user_profile.md                   # Wer Mirkan ist
feedback_security_audit.md        # "Security vor jedem Deploy"
feedback_scripts_reminder.md      # "An vorhandene Scripts erinnern"
feedback_less_overhead.md         # "Bei Polish direkt arbeiten"
project_homepage_status.md        # Status Immobilien-Portfolio
reference_framer.md               # Framer MCP Zugriff

Die 4 Memory-Typen

Memory steuern

Built-in Commands

Commands die Claude Code direkt mitbringt — unabhängig von GSD oder Plugins.

Keyboard-Shortcuts

• Shift+Tab — wechselt Berechtigungsmodus (Ask / Accept / Auto)
• Esc — bricht laufende Aktion ab
• Ctrl+C 2x — beendet Session sauber
• Cmd+L — fokussiert Prompt-Input
• ↑/↓ — navigiert Prompt-Historie

Permission-Allowlist

Damit Claude nicht bei jedem harmlosen Befehl nachfragt, pflegst du eine Allowlist in ~/.claude/settings.local.json. Mirkans Liste ist mittlerweile ziemlich lang — hier die wichtigsten Einträge.

{
  "permissions": {
    "allow": [
      // Shell-Basics
      "Bash(open:*)",
      "Bash(ls:*)",
      "Bash(cd:*)",
      "Bash(mkdir:*)",
      "Bash(chmod:*)",
      "Bash(sed:*)",
      "Bash(source:*)",
      "Bash(export:*)",

      // Node / NPM
      "Bash(node:*)",
      "Bash(npm install:*)",
      "Bash(npm run:*)",
      "Bash(npm view:*)",
      "Bash(npx tsc:*)",

      // Python
      "Bash(python3:*)",

      // Bild-Tools (für WebP-Konvertierung)
      "Bash(sips:*)",
      "Bash(which cwebp:*)",

      // FTP / Deploy
      "Bash(which lftp:*)",
      "Bash(brew install:*)",

      // Git
      "Bash(git init:*)",
      "Bash(git add:*)",
      "Bash(git commit:*)",
      "Bash(git stash:*)",
      "Bash(git merge:*)",

      // Web
      "WebSearch",
      "WebFetch(domain:raw.githubusercontent.com)",
      "WebFetch(domain:ui.shadcn.com)",
      "WebFetch(domain:ui-ux-pro-max-skill.nextlevelbuilder.io)",

      // MCP
      "mcp__context7__resolve-library-id",
      "mcp__pencil",

      // GSD Skills (oft genutzt)
      "Skill(gsd:progress)",
      "Skill(gsd:execute-phase)",
      "Skill(gsd:discuss-phase)",
      "Skill(gsd:plan-phase)",
      "Skill(gsd:autonomous)"
    ]
  }
}

Smart verwalten

Tool-Kombinationen

Die besten Ergebnisse entstehen durch kluge Kombination. Hier die Workflows aus Mirkans CLAUDE.md — copy & paste als Prompts.

Webseite bauen — der Standard-Flow

Konkurrenz analysieren

Vor Deployment — automatischer Check

Framework-Arbeit — kein veralteter Code

Komplexes Projekt — GSD + parallele Agenten

Neuen Skill bauen

Drei echte Real-World Szenarien

So nutzt Mirkan das ganze Setup in der Praxis. Copy-paste-ready.

Szenario 1 — Neue Kunden-Webseite (Bäckerei)

# 1. Projekt anlegen
$ mkdir ~/Projekte/baeckerei-mueller && cd $_
$ claude

# 2. GSD-Projekt starten
> /gsd-new-project
  Bäckerei Müller München, 5 Seiten, Launch in 3 Wochen,
  warmes Farbschema, lokaler Fokus

# 3. Design-Phase
> /gsd-ui-phase
> Nutze ui-ux-pro-max für Palette. Such via magic
  passende Bäckerei-Hero-Templates. frontend-design aktivieren.

# 4. Plan & Execute
> /gsd-plan-phase
> /gsd-execute-phase

# 5. Quality Gates
> /gsd-code-review
> /gsd-secure-phase
> /gsd-ui-review

# 6. Browser-Tests
> Teste mit webapp-testing alle Formulare & Breakpoints

# 7. Deploy (triggert pre-deploy Hook automatisch!)
> Deploye via lftp nach Webgo

# 8. Dokumentation für Kunden
> Mach mit pdf ein Kunden-Handout "So änderst du Texte & Bilder"

Szenario 2 — Bug-Fix in bestehendem Projekt

$ cd ~/Projekte/altes-kundenprojekt
$ claude

# Direkter Fix ohne GSD-Overhead (bei Polish/Fixes)
> Das Kontaktformular sendet doppelt.
  Check send-mail.php und fix das.

# Claude:
#   - Liest send-mail.php
#   - Findet Race-Condition
#   - Fixt mit Token-basierter Idempotenz
#   - Testet mit webapp-testing
#   - Commit automatisch

> Deploy dann den Fix nach Webgo

# pre-deploy Hook triggert automatisch

Szenario 3 — Framework-Migration (Astro v4 → v5)

$ cd ~/Projekte/blog-kunde
$ claude

> Ich migriere von Astro v4 auf v5.
  - Hol dir via context7 die aktuelle Astro v5 Migration-Doku
  - Pass mir astro.config.mjs an (Breaking Changes)
  - Update alle Content Collections auf neue API
  - Check ob View Transitions anders funktionieren
  - Zeig mir alle Änderungen als Diff vor dem Commit

# Claude zieht aktuelle Doku, macht Änderungen,
# gsd-workflow-guard Hook prüft dass Plan existiert,
# gsd-validate-commit checkt Commit-Message

Finale Checkliste für den Kollegen

• Node.js 18+ via Homebrew installiert
• Claude Code CLI global via npm installiert
• Pro-Account auf claude.ai eingerichtet & eingeloggt
• 3 Plugins: frontend-design, context7, playwright (alle aus claude-plugins-official)
• 2 MCP-Server: magic (eigener 21st.dev API-Key!), pencil (optional)
• Globale CLAUDE.md unter ~/.claude/CLAUDE.md (von Mirkan bekommen)
• Basis-Config: model=opus, language=German in settings.json
• GSD-Workflow via npx @get-shit-done/installer installiert
• User-Skills: ui-ux-pro-max & co. in ~/.claude/skills/
• 9 Hooks aktiv (kommen mit GSD) + pre-deploy Script separat
• Memory-Verzeichnis existiert unter ~/.claude/projects/
• Allowlist in settings.local.json (wächst mit der Zeit)