Zum Inhalt springen
Collective Context

Claude Code — Deep Dive

Claude Code ist mehr als ein Chat-Interface im Terminal. Es ist ein vollständiger Coding-Agent mit Filesystem-Zugriff, Shell-Execution, git-Integration und einem offenen Ökosystem für Erweiterungen.

Installation

Abschnitt betitelt „Installation“
Empfohlen — mit auto-updates
curl -fsSL https://claude.ai/install.sh | bash
Erster Start
cd dein-projekt
claude
# → Browser-Login bei claude.ai → OAuth → fertig

CLAUDE.md: Das Projekt-Gedächtnis

Abschnitt betitelt „CLAUDE.md: Das Projekt-Gedächtnis“

CLAUDE.md wird automatisch in jede neue Session geladen — ohne Prompt, ohne Benutzeraktion. Es ist das einzige persistente Gedächtnis des Agents über Session-Grenzen hinweg.

# CLAUDE.md — Mein Projekt


## Projekt
Python-Backend für Domain-Harvesting. PostgreSQL 16, FastAPI, Celery.


## Regeln (nicht verhandelbar)
1. JAIL: Nur in /app/ — kein Zugriff auf /etc/, /home/, /root/
2. KEIN SUDO. Niemals.
3. VENV: Ausschließlich /app/bin/.venv/ — kein system-pip
4. DB: db_config.py liest os.environ[] — nie Passwörter hardcoden


## Bekannte Fehler / NIE WIEDER
- pytest IMMER mit /app/bin/.venv/bin/pytest — nicht system-pytest
- db.session.commit() IMMER in try/except (deadlock-Erfahrung 2026-02-15)
- Bei git merge: IMMER manuell reviewen — nie auto-accept


## Commit-Format
feat: / fix: / docs: / refactor: / chore: (Conventional Commits)

Best Practice: CLAUDE.md ≤100 Zeilen halten. Details in README.md auslagern, mit Anker-Links.

Standard-Richtung: AGENTS.md ist die Quelle, CLAUDE.md ist der Symlink:

Terminal-Fenster
mv CLAUDE.md AGENTS.md
ln -s AGENTS.md CLAUDE.md
echo "CLAUDE.md" >> .gitignore

Hooks: Determinismus durch Automatisierung

Abschnitt betitelt „Hooks: Determinismus durch Automatisierung“

Hooks sind Shell-Befehle die vor oder nach jeder Claude Code Aktion ausgeführt werden — konfigurierbar in ~/.claude/settings.json oder CLAUDE.md.

~/.claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          { "type": "command", "command": "cd $PROJECT_ROOT && ruff check --fix $CLAUDE_TOOL_INPUT_FILE_PATH" }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "echo '[HOOK] Bash: $CLAUDE_TOOL_INPUT_COMMAND'" }
        ]
      }
    ]
  }
}

Typische Hook-Anwendungen:

  • Auto-Lint nach jedem File-Edit (ruff, eslint, gofmt)
  • Test-Run nach Code-Änderungen
  • Audit-Log aller Shell-Befehle
  • Slack-Notification bei Task-Abschluss
  • .env-Check vor Commits (verhindert Credential-Leaks)

Sub-Agents: Parallele Task-Bearbeitung

Abschnitt betitelt „Sub-Agents: Parallele Task-Bearbeitung“

Claude Code kann mehrere Agenten parallel spawnen, die unabhängig an verschiedenen Teilen eines Tasks arbeiten:

Terminal-Fenster
claude "Implement the new auth module:
  - Sub-agent 1: Write unit tests for all edge cases
  - Sub-agent 2: Implement the JWT validation logic
  - Sub-agent 3: Update the API documentation
  Merge results when all three are done."

Intern: Ein Lead-Agent koordiniert, Unteragenten arbeiten parallel, Ergebnisse werden zusammengeführt. Ideal für:

  • Feature-Implementierung mit Tests (parallel)
  • Multi-File-Refactoring mit unabhängigen Modulen
  • Gleichzeitige Übersetzungen in mehrere Sprachen

MCP: Model Context Protocol

Abschnitt betitelt „MCP: Model Context Protocol“

MCP verbindet Claude Code mit externen Datenquellen und Services — ohne Code:

// .mcp.json  (Projektebene, git-versioniert — empfohlen)
// oder: ~/.claude.json  (User-Ebene, Feld "mcpServers")
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    },
    "jira": {
      "command": "npx",
      "args": ["-y", "@scope/mcp-jira"],
      "env": { "JIRA_TOKEN": "$JIRA_API_TOKEN" }
    }
  }
}

Nach Konfiguration kann Claude Code direkt:

  • PostgreSQL-Abfragen ausführen: "Zeig mir die 10 langsamsten Queries der letzten Stunde"
  • Jira-Tickets erstellen/lesen: "Erstelle Bug-Report für den Auth-Fehler aus dem Log"
  • Google Drive lesen: "Fasse das Design-Doc für Feature X zusammen"
  • Slack senden: "Informiere #backend über das Deployment"

Cross-Surface Workflows

Abschnitt betitelt „Cross-Surface Workflows“

Claude Code läuft auf mehreren Oberflächen, die denselben Engine teilen. Mit claude --teleport wechselst du eine laufende Session nahtlos zwischen den Oberflächen.

Voller Filesystem-Zugriff, Pipe-Composability, headless CI/CD-fähig.

Langen Task starten
claude "Refaktoriere das gesamte Auth-Modul auf JWT, schreibe Tests, erstelle PR"
Session ins Web übertragen
claude --teleport   # → öffnet laufende Session im Browser, auf jedem Gerät

CI/CD Integration

Abschnitt betitelt „CI/CD Integration“
.github/workflows/ai-review.yml
name: AI Code Review
on: [pull_request]


jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0


      - name: Install Claude Code
        run: curl -fsSL https://claude.ai/install.sh | bash


      - name: Security Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          git diff origin/main --name-only | \
          claude -p "Review for SQL injection, XSS, hardcoded secrets.
                     Exit code 1 if critical issues found, 0 otherwise.
                     Output findings as GitHub PR comment format."

Kosten-Realität

Abschnitt betitelt „Kosten-Realität“
OptionKostenToken-LimitIdeal für
Claude Max Basic~$100/MFlat RateSolo-Entwickler
Claude Max Pro~$200/MHöhere LimitsTeams
API (Console)Pay-per-TokenUnbegrenztCI/CD, Scripts
ZED Claude Code TabIm Max-AboFlat RateInteraktive Entwicklung

Wichtig: Ein Claude Max Abo deckt gleichzeitig Claude Code CLI, Claude Code Web, ZED Claude Code Tab und Claude Pro ab — keine mehrfachen Abos nötig.

XED /TUI — Eigene TUI-IDE

Abschnitt betitelt „XED /TUI — Eigene TUI-IDE“

Das Postbox Pattern macht Claude Code orchestrierbar — auch ohne GUI. xed-tui.py (XED /TUI) aus dem fb-data-Projekt ist ein Open-Source Session-Browser im mutt-Stil, der den Claude Code Terminal-Workflow zur vollständigen IDE erweitert:

  • 4-Panel-Layout — Projekte · Sessions · Reader · Notizen
  • [a] Agent — Session direkt fortsetzen mit automatischem CWD-Kontext
  • [o] Open — /resume <uuid> in Zwischenablage: in TUI surfen, in laufendem Claude Code einfügen
  • [r] Refresh — neue Sessions live nachladen ohne Neustart
  • Unified Rename — /rename in Claude Code und [t] in der TUI schreiben denselben nativen Record ins JSONL: Titel erscheint konsistent in Claude Code /resume, ZED History und der TUI — ohne Tricks, ohne Sync-Probleme
  • Notizen — pro Session eine memory/<uuid>.md, vorausgefüllt mit Transcript
  • Clipboard — Notizen direkt via wl-copy/xclip/xsel
Terminal-Fenster
# Starten
python scripts/bin/xed-tui.py


# Wichtigste Tasten
[a]  Agent starten (--resume, richtiges CWD)
[o]  /resume <uuid> → Clipboard  (in Claude Code einfügen)
[t]  Titel setzen  ←→  /rename in Claude Code
[r]  Refresh
[e]  Notiz im Editor
[?]  Hilfe

Das zeigt: Claude Code ist nicht nur ein Tool — es ist ein Baustein für eigene Entwicklungs-Infrastruktur.

Praxis-Patterns Solo-Agent, Dual-Agent, Review-Pipeline, CI/CD — konkrete Workflow-Beispiele aus der Praxis.
Tool-Vergleich 2026 Claude Code vs. Gemini CLI vs. Aider vs. Codex CLI — Stärken, Kosten, Einsatzszenarien.