CLAUDE CODE - ANTHROPIC CLI TOOL
================================

Stand: 2026-01-24

WAS IST CLAUDE CODE?
--------------------
Claude Code ist das offizielle CLI-Tool von Anthropic, das Claude
direkt im Terminal verfuegbar macht. Es ist ein agentic coding tool,
das Code lesen, schreiben, analysieren und ausfuehren kann.

Kernkonzept: "Du gibst Aufgaben, Claude fuehrt sie aus."

INSTALLATION
------------
  # Via npm (empfohlen)
  npm install -g @anthropic-ai/claude-code

  # Version pruefen
  claude --version

  # Updates installieren
  claude update

AUTHENTIFIZIERUNG
-----------------
  # Interaktiv (Browser-basiert)
  claude setup-token

  # Via API-Key (Umgebungsvariable)
  set ANTHROPIC_API_KEY=sk-ant-...

SUBSCRIPTION & PLANS
--------------------
Claude Code nutzt denselben Account wie claude.ai:

  Free Tier
    - Begrenzte Nutzung
    - Zugang zu Sonnet/Haiku

  Claude Pro ($20/Monat)
    - Mehr Nutzung
    - Zugang zu Opus
    - Prioritaet bei hoher Last

  Claude Max ($100/Monat)
    - Unbegrenzte Nutzung (Fair Use)
    - Alle Modelle (Opus, Sonnet, Haiku)
    - Hoechste Prioritaet
    - Gilt auch fuer Claude Code CLI!

WICHTIG: Ihr bestehendes Abo (Pro/Max) gilt automatisch auch
in der Konsole! Nach `claude setup-token` sind Sie mit demselben
Account eingeloggt und haben dieselben Vorteile.

  # Pruefen ob eingeloggt
  claude --version

  # Mit Max-Abo: Opus ohne extra Kosten
  claude --model opus

GRUNDLEGENDE NUTZUNG
--------------------
  # Interaktive Session starten
  claude

  # Im aktuellen Verzeichnis
  claude .

  # Mit Prompt starten
  claude "Erklaere diesen Code"

  # Letzte Session fortsetzen
  claude -c
  claude --continue

  # Bestimmte Session fortsetzen
  claude -r
  claude --resume session-id

MODELLE
-------
Claude Code unterstuetzt verschiedene Claude-Modelle:

  --model sonnet    Claude Sonnet 4.5 (Standard)
                    - Gute Balance aus Speed und Quality
                    - Empfohlen fuer taegliche Nutzung

  --model opus      Claude Opus 4.5 (Staerkstes)
                    - Beste Reasoning-Faehigkeiten
                    - Komplexe Aufgaben, tiefe Analyse
                    - Hoehere Kosten/Latenz

  --model haiku     Claude Haiku (Schnellstes)
                    - Schnelle, einfache Aufgaben
                    - Niedrigste Kosten
                    - Weniger komplex

Beispiel:
  claude --model opus "Analysiere die Architektur dieses Projekts"

NON-INTERACTIVE MODUS
---------------------
Fuer Scripts und Automatisierung:

  # Print-Modus (Ausgabe und Exit)
  claude -p "Dein Prompt"
  claude --print "Dein Prompt"

  # JSON-Ausgabe
  claude -p --output-format json "Prompt"

  # Streaming JSON
  claude -p --output-format stream-json "Prompt"

  # Budget-Limit setzen
  claude -p --max-budget-usd 5.00 "Prompt"

PERMISSION-MODI
---------------
Steuert wie Claude um Erlaubnis fragt:

  --permission-mode default
    Standard - fragt vor Aktionen

  --permission-mode acceptEdits
    Datei-Edits automatisch akzeptieren

  --permission-mode bypassPermissions
    Alle Permissions umgehen (VORSICHT!)

  --permission-mode plan
    Nur Planung, keine Ausfuehrung

  --permission-mode delegate
    An Sub-Agenten delegieren

TOOL-KONTROLLE
--------------
Welche Tools Claude nutzen darf:

  # Bestimmte Tools erlauben
  --allowed-tools "Bash(git:*) Edit Read"

  # Bestimmte Tools verbieten
  --disallowed-tools "Bash Write"

  # Nur bestimmte Tools aktivieren
  --tools "Bash,Edit,Read"

  # Alle Tools deaktivieren
  --tools ""

Verfuegbare Standard-Tools:
  - Bash        Shell-Kommandos
  - Edit        Dateien bearbeiten
  - Read        Dateien lesen
  - Write       Dateien erstellen
  - Glob        Dateien suchen
  - Grep        In Dateien suchen
  - Task        Sub-Agenten starten
  - WebFetch    Web-Inhalte abrufen
  - WebSearch   Web-Suche

MCP (MODEL CONTEXT PROTOCOL)
----------------------------
Claude Code unterstuetzt MCP-Server:

  # MCP-Server verwalten
  claude mcp

  # MCP-Config laden
  claude --mcp-config config.json

  # Nur bestimmte MCP-Server nutzen
  claude --strict-mcp-config --mcp-config my-servers.json

MCP-Config Beispiel (mcp_config.json):
  {
    "mcpServers": {
      "filesystem": {
        "command": "npx",
        "args": ["-y", "@anthropic-ai/mcp-filesystem"]
      },
      "github": {
        "command": "npx",
        "args": ["-y", "@anthropic-ai/mcp-github"]
      }
    }
  }

CUSTOM AGENTS
-------------
Eigene Agenten definieren:

  claude --agents '{"reviewer": {"description": "Reviews code", "prompt": "You are a code reviewer"}}'

  # Agent nutzen
  claude --agent reviewer "Review this PR"

SYSTEM PROMPTS
--------------
  # System-Prompt setzen
  claude --system-prompt "Du bist ein Python-Experte"

  # Zum Standard-Prompt hinzufuegen
  claude --append-system-prompt "Antworte auf Deutsch"

IDE-INTEGRATION
---------------
  # Mit IDE verbinden (wenn verfuegbar)
  claude --ide

  # Chrome-Extension
  claude --chrome
  claude --no-chrome

SESSION-MANAGEMENT
------------------
  # Session mit bestimmter ID
  claude --session-id "meine-session-uuid"

  # Session forken (Kopie erstellen)
  claude -c --fork-session

  # Session nicht speichern
  claude -p --no-session-persistence "Prompt"

PLUGINS
-------
  # Plugins verwalten
  claude plugin

  # Plugin-Verzeichnis laden
  claude --plugin-dir /pfad/zu/plugins

DEBUGGING
---------
  # Debug-Modus aktivieren
  claude -d
  claude --debug

  # Bestimmte Debug-Kategorien
  claude --debug "api,hooks"
  claude --debug "!statsig,!file"

  # Verbose-Ausgabe
  claude --verbose

KOMMANDOS
---------
  claude doctor       Auto-Updater Status pruefen
  claude update       Updates pruefen/installieren
  claude install      Native Build installieren
  claude mcp          MCP-Server verwalten
  claude plugin       Plugins verwalten
  claude setup-token  Auth-Token einrichten

VERGLEICH: CLAUDE CODE vs GEMINI CLI
------------------------------------
  Feature              Claude Code         Gemini CLI
  ---------------------------------------------------------
  Hersteller           Anthropic           Google
  Modelle              Claude Familie      Gemini Familie
  GUI                  Nein (Terminal)     Nein (Terminal)
  MCP Support          Ja                  Ja
  Permission-Modi      Ja (5 Modi)         --yolo
  Custom Agents        Ja                  Nein
  Session Resume       Ja (-c, -r)         Ja (-r)
  API-Key Auth         Ja                  Ja
  Browser Auth         Ja                  Ja

BACH-INTEGRATION
----------------
Claude Code ist das primaere Tool fuer BACH-Entwicklung.

  # BACH-Verzeichnis oeffnen
  cd "%ONEDRIVE_AI_ROOT%\BACH"
  claude

  # Mit Opus fuer komplexe Aufgaben
  claude --model opus

  # Session fortsetzen
  claude -c

Potenzielle Erweiterungen:
  - claude_start.py analog zu gemini_start.py
  - Integration in partners/ System
  - MCP-Server fuer BACH-Tools

TROUBLESHOOTING
---------------
  "Not authenticated"
    claude setup-token

  "Model not available"
    - Subscription pruefen
    - API-Key pruefen

  "Rate limit exceeded"
    - Warten oder Plan upgraden

  Updates fehlgeschlagen
    claude doctor

NUETZLICHE LINKS
----------------
  Anthropic:     https:/anthropic.com
  Claude:        https:/claude.ai
  API Docs:      https:/docs.anthropic.com
  npm Package:   https:/www.npmjs.com/package/@anthropic-ai/claude-code

SIEHE AUCH
----------
  docs/help/claude-code.txt       Kurzreferenz
  wiki/gemini.txt       Gemini CLI/Antigravity
  wiki/ollama.txt       Lokale LLMs
  wiki/mcp.txt          Model Context Protocol
