macOS: Claude CLI einrichten und produktiv werden

Schritt-für-Schritt Anleitung: Von Homebrew Installation bis zum ersten Repository mit Claude CLI

Claude CLI auf macOS: Der schnellste Weg zur KI-gestützten Entwicklung

Diese Anleitung zeigt dir, wie du auf deinem MacBook in wenigen Minuten Claude CLI einrichtest und dein erstes Repository klonst.

Warum Claude CLI?

Claude CLI ist dein KI-Pair-Programming Partner direkt im Terminal. Statt zwischen Browser und Code zu wechseln, arbeitest du direkt in deiner gewohnten Entwicklungsumgebung.

Schritt 1: Terminal öffnen

Methode 1: Spotlight

  • Drücke ⌘ + Leertaste
  • Tippe “Terminal”
  • Enter drücken

Methode 2: Finder

  • Öffne Finder
  • Gehe zu Programme → Dienstprogramme
  • Doppelklick auf Terminal

Schritt 2: Homebrew installieren

Homebrew ist der Package Manager für macOS. Einmal installiert, macht er alles andere kinderleicht.

# Homebrew Installation (kopiere die ganze Zeile)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Nach der Installation musst du Homebrew zum PATH hinzufügen:

# Für Apple Silicon Macs (M1/M2/M3)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# Für Intel Macs
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"

Teste ob es funktioniert:

brew --version
# Sollte sowas zeigen wie: Homebrew 4.3.0

Schritt 3: Git installieren (falls noch nicht vorhanden)

# Git installieren
brew install git

# Git konfigurieren (mit deinen Daten)
git config --global user.name "Dein Name"
git config --global user.email "deine.email@example.com"

Schritt 4: Claude CLI installieren

# Node.js installieren (wird für Claude CLI benötigt)
brew install node

# Claude CLI global installieren
npm install -g @anthropic-ai/claude-cli

# Alternative: Mit Homebrew direkt
brew install claude

Schritt 5: Claude CLI einrichten

# Claude CLI starten
claude login

Du wirst zu einer Webseite weitergeleitet:

  1. Logge dich mit deinem Claude Account ein
  2. Bestätige die Verbindung
  3. Terminal zeigt “Successfully authenticated!”

Schritt 6: Dein erster Prompt - Repository klonen

Jetzt kommt der magische Moment! Kopiere diesen Prompt und passe die URL an:

claude "Ich habe ein Repository unter https://github.com/username/projektname und möchte das lokal klonen und damit arbeiten. Bitte hilf mir bei der Einrichtung. Erkläre mir auch die Ordnerstruktur und was die wichtigsten Dateien machen."

Claude wird dir dann helfen:

  • Das Repository zu klonen
  • Die Struktur zu verstehen
  • Dependencies zu installieren
  • Das Projekt zu starten

Erste Prompts im Repository

Prompt 1: Projekt verstehen

# Im geklonten Repository-Ordner:
claude "Analysiere dieses Projekt und erkläre mir:
1. Was macht diese Anwendung?
2. Welche Technologien werden verwendet?
3. Wie ist die Architektur aufgebaut?
4. Was sind die wichtigsten Dateien die ich kennen sollte?"

Prompt 2: README erstellen/verbessern

claude "Erstelle eine professionelle README.md für dieses Projekt mit:
- Projektbeschreibung
- Installation
- Verwendung
- Beispielen
- Contribution Guidelines"

Prompt 3: Code Review

claude "Review den Code in src/ und gib mir Feedback zu:
- Code Qualität
- Potentielle Bugs
- Performance Verbesserungen
- Best Practices die fehlen"

Prompt 4: Tests schreiben

claude "Schreibe Unit Tests für die Funktionen in src/utils.js. 
Verwende das Test-Framework das bereits im Projekt konfiguriert ist."

Prompt 5: Dokumentation generieren

claude "Gehe durch alle JavaScript/TypeScript Dateien und:
1. Füge JSDoc Kommentare hinzu
2. Erstelle eine API Dokumentation
3. Generiere Beispiele für jede exportierte Funktion"

Dokumente mit Claude verarbeiten

PDFs analysieren

# PDF in Markdown konvertieren und analysieren
claude "Lies die Datei dokument.pdf und:
1. Fasse den Inhalt zusammen
2. Extrahiere die Kernaussagen
3. Erstelle Action Items basierend auf dem Inhalt"

Excel/CSV Daten verarbeiten

claude "Analysiere data.csv und:
1. Zeige mir eine Zusammenfassung der Daten
2. Finde Anomalien oder interessante Muster
3. Erstelle ein Python Script zur Visualisierung"

Mehrere Dokumente vergleichen

claude "Vergleiche die Dateien alt-version.md und neu-version.md.
Zeige mir:
- Was wurde hinzugefügt?
- Was wurde entfernt?
- Was wurde geändert?
Erstelle eine Zusammenfassung der wichtigsten Änderungen."

Dokumente in Code umwandeln

claude "Lies requirements.pdf und:
1. Erstelle User Stories daraus
2. Generiere eine Projektstruktur
3. Schreibe erste Implementierungen der beschriebenen Features"

Pro-Tipps für effektives Arbeiten

Alias für häufige Befehle

Füge diese zu deiner ~/.zshrc hinzu:

# Claude Shortcuts
alias cc="claude"
alias ccreview="claude 'Review diesen Code und gib konstruktives Feedback'"
alias ccfix="claude 'Finde und behebe Bugs in diesem Code'"
alias ccdoc="claude 'Dokumentiere diesen Code ausführlich'"

Context-Datei für Projekte

Erstelle eine .claude-context.md im Projekt-Root:

# Projekt Kontext

## Über dieses Projekt
SkillLock QM-System für KMUs

## Technologie Stack
- Frontend: React + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL

## Coding Standards
- Functional Components only
- TypeScript strict mode
- Prettier + ESLint

## Wichtige Befehle
- `npm run dev` - Entwicklungsserver
- `npm test` - Tests ausführen
- `npm run build` - Production Build

Dann kannst du referenzieren:

claude "Beachte .claude-context.md und implementiere ein neues Feature: [Beschreibung]"

Troubleshooting

Problem: “command not found: claude”

# PATH neu laden
source ~/.zshrc

# Oder neu installieren
npm install -g @anthropic-ai/claude-cli

Problem: “Permission denied”

# Mit sudo installieren (nur wenn nötig)
sudo npm install -g @anthropic-ai/claude-cli

Problem: Homebrew läuft nicht

# Homebrew Doctor ausführen
brew doctor

# Folge den Anweisungen die angezeigt werden

Nächste Schritte

  1. VS Code Integration: Installiere die Claude VS Code Extension
  2. Git Workflow: Lerne Git mit Claude zu nutzen
  3. Automatisierung: Erstelle Shell Scripts mit Claude’s Hilfe
  4. CI/CD: Lass Claude GitHub Actions für dich schreiben

Der Power-User Workflow

# Morgens: Projekt Status
cd mein-projekt
claude "Was sollte ich heute als erstes in diesem Projekt angehen? Check die offenen Issues und TODOs."

# Feature entwickeln
claude "Ich möchte Feature X implementieren. Guide mich Schritt für Schritt."

# Vor dem Commit
claude "Review meine Änderungen und schlage eine gute Commit Message vor."

# Dokumentation
claude "Update die Dokumentation basierend auf meinen heutigen Änderungen."

Glückwunsch! 🎉 Du hast Claude CLI auf deinem Mac eingerichtet und bist bereit für KI-gestütztes Entwickeln.

Tipp: Claude wird mit jeder Interaktion besser darin, deinen Stil und deine Präferenzen zu verstehen. Je spezifischer deine Prompts, desto besser die Ergebnisse.

Nächster Artikel: Warum Linux Mint statt Windows →