Claude Code CLI einrichten: Schnellstart in 5 Minuten
Über 29.000 Entwickler bei ServiceNow nutzen Claude Code mittlerweile täglich, und Allianz hat es Anfang 2026 unternehmensweit ausgerollt. Die Adoptionskurve des Tools zeigt ein klares Muster: Sobald Entwickler agentisches Programmieren in ihrem eigenen Terminal ausprobiert haben, kehren sie nicht mehr zum Kopieren und Einfügen aus Chat-Fenstern zurück. Dieser Schnellstart bringt Sie in etwa fünf Minuten von null zu einer funktionierenden Claude Code-Sitzung – mit einer echten Konfiguration, die Sie danach weiter verwenden können.
Kurzfassung: Installieren Sie Claude Code über npm install -g @anthropic-ai/claude-code, authentifizieren Sie sich über Ihren Browser, erstellen Sie eine CLAUDE.md-Datei mit Ihrem Projektkontext und konfigurieren Sie Berechtigungen in .claude/settings.json. Fügen Sie einen Prettier-Hook hinzu, der Dateien nach jeder Bearbeitung automatisch formatiert. Die gesamte Einrichtung dauert unter fünf Minuten, und die Konfiguration bleibt über Sitzungen hinweg bestehen.
Wichtigste Erkenntnisse
- Einzelentwickler: CLAUDE.md und ein Formatierungs-Hook decken 80 % Ihrer Anforderungen ab. Beginnen Sie mit Standardberechtigungen und genehmigen Sie Tools vorab, während Sie Vertrauen aufbauen.
- Teamleiter: Committen Sie
.claude/settings.jsonin Ihr Repository, damit das gesamte Team dieselben Berechtigungs-Allowlists und Hooks teilt. - Sicherheitsingenieure: Das dreistufige Berechtigungsmodell (Standard, vorab genehmigt, überspringen) entspricht direkt den Vertrauensstufen. Der Standardmodus erfordert eine explizite Genehmigung für jeden Schreibvorgang und jeden Befehl.
Voraussetzungen
Sie benötigen drei Dinge, bevor Sie Claude Code installieren:
Node.js 18 oder höher. Claude Code wird als npm-Paket ausgeliefert. Prüfen Sie Ihre Version:
node --version
# v18.0.0 or higher
Falls Sie Node.js installieren oder aktualisieren müssen, verwenden Sie nvm oder laden Sie es direkt von nodejs.org herunter.
Ein Anthropic-Konto mit API-Zugang. Erstellen Sie einen API-Schlüssel unter console.anthropic.com in den Einstellungen > API Keys. Claude Code wird über Ihr API-Guthaben oder Ihren Max-Abonnementplan abgerechnet. Halten Sie den Schlüssel für den Authentifizierungsschritt bereit.
Ein Terminal. Claude Code läuft in jedem Terminal-Emulator: Terminal.app, iTerm2, Windows Terminal, Alacritty oder dem integrierten Terminal in VS Code. Ich empfehle ein Terminal mit mindestens 120 Spalten Breite, da Claude Code Datei-Diffs und Tool-Ausgaben anzeigt, die von horizontalem Platz profitieren.
Installation
Installieren Sie Claude Code global über npm:
npm install -g @anthropic-ai/claude-code
Überprüfen Sie, ob die Installation erfolgreich war:
claude --version
Sie sollten eine Versionsnummer in der Standardausgabe sehen. Falls Sie den Fehler „command not found” erhalten, stellen Sie sicher, dass Ihr globales npm-bin-Verzeichnis in Ihrem PATH enthalten ist. Führen Sie npm config get prefix aus und fügen Sie das Unterverzeichnis /bin dieser Ausgabe zu Ihrem PATH hinzu.
Beim ersten Start öffnet Claude Code Ihren Browser zur Anthropic-Konsole für die OAuth-Authentifizierung. Sie melden sich an, autorisieren den Zugriff, und das Token wird lokal in ~/.claude/ gespeichert. Alternativ können Sie die Umgebungsvariable ANTHROPIC_API_KEY vor dem Start setzen. In beiden Fällen bleiben die Anmeldedaten auf Ihrem Rechner und werden ausschließlich zur Authentifizierung von API-Anfragen verwendet.
Erste Sitzung
Navigieren Sie zu einem beliebigen Projektverzeichnis und führen Sie aus:
cd ~/Projects/my-app
claude
Claude Code startet eine interaktive REPL-Sitzung. Beim ersten Start in einem neuen Projekt geschehen mehrere Dinge automatisch:
- Scannt die Verzeichnisstruktur, um das Projektlayout zu verstehen
- Liest Konfigurationsdateien wie
package.json,pyproject.tomloderCargo.toml, um den Tech-Stack zu identifizieren - Sucht nach einer CLAUDE.md-Datei im Projektstammverzeichnis für projektspezifische Anweisungen
Probieren Sie einen einfachen Prompt, um zu bestätigen, dass alles funktioniert:
> Explain the structure of this project
Claude liest Ihre Dateien, synthetisiert die Architektur und antwortet im Terminal. Sie sehen Tool-Aufrufe in Echtzeit (jede gelesene Datei, jeden ausgeführten Befehl) zusammen mit einer Berechtigungsanfrage vor jedem Schreibvorgang.
CLAUDE.md einrichten
CLAUDE.md ist die wichtigste einzelne Datei für effektive Claude Code-Nutzung. Sie befindet sich im Projektstammverzeichnis und enthält Anweisungen, die Claude zu Beginn jeder Sitzung liest. Betrachten Sie sie als README für Ihren KI-Mitarbeiter.
Erstellen Sie die Datei:
touch CLAUDE.md
Hier ist eine praktische Startvorlage:
# My App
## Project Context
Express.js API with React frontend. PostgreSQL database.
## Stack
- Backend: Node.js 20, Express 4, TypeScript
- Frontend: React 18, Vite
- Database: PostgreSQL 16, Prisma ORM
- Testing: Vitest for unit tests, Playwright for e2e
## Code Standards
- Use async/await, never raw Promises
- All API endpoints need input validation with Zod
- Tests required for new endpoints before merging
## Commands
- `npm run dev` starts the dev server on port 3000
- `npm test` runs the test suite
- `npx prisma migrate dev` runs database migrations
Nach meiner Erfahrung sind die wertvollsten Abschnitte diejenigen, die wiederholte Fehler verhindern. Wenn Claude immer wieder CommonJS verwendet, obwohl Ihr Projekt ESM nutzt, fügen Sie das in die CLAUDE.md ein. Wenn es einen bestimmten Testbefehl oder einen Datenbank-Setup-Schritt gibt, dokumentieren Sie ihn. Claude liest CLAUDE.md bei jeder Sitzung, sodass alles, was Sie dort eintragen, zu einer dauerhaften Anweisung wird.
Sie können auch eine CLAUDE.md in Ihrem Home-Verzeichnis (~/.claude/CLAUDE.md) für globale Anweisungen anlegen, die für alle Projekte gelten, und in Unterverzeichnissen für Kontext, der nur für bestimmte Teile eines Monorepos gilt.
Berechtigungsgrundlagen
Claude Code arbeitet in drei Berechtigungsstufen, die bestimmen, wie viel Autonomie der Agent hat:
Standardmodus fragt vor jedem Schreibvorgang, jeder Befehlsausführung oder jeder destruktiven Aktion um Erlaubnis. Sie sehen genau, was Claude vorhat, und genehmigen oder lehnen jeden Schritt ab. Ich empfehle, hier zu beginnen.
Vorab genehmigte Berechtigungen ermöglichen es Ihnen, bestimmte Tools und Muster auf eine Allowlist zu setzen, sodass Claude nicht jedes Mal nachfragt. Sie konfigurieren diese in der .claude/settings.json Ihres Projekts:
{
"permissions": {
"allow": [
"Read",
"Glob",
"Grep",
"Bash(npm test)",
"Bash(npx prisma migrate dev)"
]
}
}
Dieses Beispiel erlaubt Claude, Dateien zu lesen, die Codebasis zu durchsuchen und Ihre Test- sowie Migrationsbefehle ohne Nachfrage auszuführen. Bei Schreibvorgängen oder anderen Bash-Befehlen wird weiterhin um Erlaubnis gefragt.
Berechtigungen gefährlich überspringen (--dangerously-skip-permissions) deaktiviert alle Bestätigungsaufforderungen. Dieses Flag ist ausschließlich für CI/CD-Pipelines und automatisierte Workflows gedacht, bei denen kein Mensch zum Genehmigen anwesend ist. Verwenden Sie es niemals in interaktiven Sitzungen mit einer Codebasis, die Ihnen wichtig ist.
Das Berechtigungssystem ist der Grund, warum Claude Code sicher auf echten Projekten eingesetzt werden kann. Beginnen Sie mit dem Standardmodus, beobachten Sie, welche Genehmigungen sich wiederholen, und genehmigen Sie selektiv genau diese Operationen vorab.
Ihr erster Hook
Hooks sind Shell-Befehle, die an bestimmten Punkten im Claude Code-Lebenszyklus ausgeführt werden. Sie bieten deterministische Garantien auf Basis des probabilistischen Verhaltens des LLM. Hier ist ein praktischer erster Hook: automatisches Formatieren von Dateien, nachdem Claude sie bearbeitet hat.
Erstellen oder bearbeiten Sie .claude/settings.json in Ihrem Projekt:
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "npx prettier --write \"$FILE_PATH\" 2>/dev/null || true"
}
]
}
]
}
}
Dieser Hook wird nach jedem Edit- oder Write-Tool-Aufruf ausgelöst. Claude Code setzt $FILE_PATH auf die geänderte Datei. Prettier formatiert sie direkt, und || true stellt sicher, dass der Hook Claude nicht blockiert, falls Prettier nicht installiert ist oder der Dateityp nicht unterstützt wird.
Weitere praktische Starter-Hooks, die ich empfehle:
- PreToolUse für Bash: Blockieren Sie gefährliche Befehle wie
rm -rf /odergit push --force - SessionStart: Injizieren Sie das aktuelle Datum, den aktiven Git-Branch oder Umgebungsvariablen in den Kontext (die Standardausgabe von SessionStart-Hooks fließt in den Kontext von Claude)
- Stop: Führen Sie Ihre Testsuite automatisch aus, wenn Claude eine Aufgabe abschließt
Hooks verwandeln Claude Code von einem Konversationswerkzeug in eine kontrollierte Entwicklungsumgebung. Bereits ein oder zwei gut gewählte Hooks eliminieren ganze Fehlerkategorien.
Nächste Schritte
Dieser Schnellstart behandelt die Grundlagen: Installation, Ihre erste Sitzung, Projektkonfiguration, Berechtigungen und einen Starter-Hook. Für die vollständige Referenz aller 5 Kernsysteme (CLAUDE.md-Hierarchie, das vollständige Berechtigungsmodell, Hooks-Architektur, benutzerdefinierte Slash-Befehle und Multi-Agent-Workflows) lesen Sie Der vollständige Leitfaden zu Claude Code.
Der Leitfaden behandelt Kontextfenster-Verwaltung, Subagent-Delegation, automatische Skill-Aktivierung und die Muster, die nach Monaten täglicher Claude Code-Nutzung entstehen. Wenn Sie diesen Schnellstart nützlich fanden, ist der vollständige Leitfaden der natürliche nächste Schritt.
FAQ
Was kostet Claude Code?
Claude Code unterstützt zwei Abrechnungsmodelle. Das API-Pay-as-you-go-Modell berechnet pro Token zu den Standard-Anthropic-API-Preisen. Eine typische 30-60-minütige Sitzung kostet 0,50–3,00 $ je nach Größe der Codebasis und Generierungsvolumen. Alternativ bietet Anthropics Max-Plan (100 $/Monat für Einzelpersonen, 200 $/Monat für Teams) Claude Code-Nutzung mit höheren Rate-Limits. Sie können die API-Nutzung unter console.anthropic.com überwachen.
Kann ich Claude Code mit VS Code verwenden?
Ja. Claude Code funktioniert in jedem Terminal, einschließlich des integrierten Terminals von VS Code. Öffnen Sie das Terminal-Panel in VS Code, navigieren Sie zu Ihrem Projektverzeichnis und führen Sie claude genauso aus wie in einem eigenständigen Terminal. Claude Code liest und bearbeitet Dateien auf der Festplatte, sodass Änderungen sofort in Ihren VS Code-Editor-Tabs erscheinen. Eine separate VS Code-Erweiterung ist nicht erforderlich. Einige Entwickler verwenden einen dedizierten Terminal-Split für Claude Code neben ihrem Editor, was gut funktioniert, um Änderungen in Echtzeit zu überprüfen.
Ist Claude Code sicher für Produktions-Codebasen?
Der Standardberechtigungsmodus von Claude Code verlangt eine explizite Genehmigung vor jedem Schreibvorgang und jeder Befehlsausführung. Ohne Ihre Bestätigung ändert sich nichts auf der Festplatte. Das Berechtigungssystem, kombiniert mit Hooks, die gefährliche Operationen wie Force-Pushes oder destruktive Shell-Befehle blockieren können, macht es praxistauglich für Produktionsarbeit. Ich verwende Claude Code täglich in Projekten, die echte Nutzer bedienen. Der Schlüssel liegt darin, im Standardmodus zu beginnen, zu verstehen, was jeder Tool-Aufruf tut, bevor Sie ihn genehmigen, und schrittweise nur die Operationen vorab zu genehmigen, denen Sie vertrauen. Versionskontrolle ist Ihr letztes Sicherheitsnetz: Committen Sie vor jeder größeren Claude Code-Sitzung, damit Sie jederzeit zurücksetzen können.