Claude Code Terminal AI Helfer: Von Installation bis Konfiguration

Gerade vor dem Frühlingsfest habe ich etwas Ruhe im Job. Da alle gerade verschiedene AI-Tools ausprobieren, habe ich die Gelegenheit genutzt, um meinen Code zu reviewen und gleichzeitig Claude Code auszuprobieren. Diese Anleitung zeigt euch Schritt für Schritt, wie ihr diesen starken Terminal-AI-Assistenten nutzen könnt.

🚀 Was ist Claude Code?

Claude Code ist ein von Anthropic entwickelter Kommandozeilen-AI-Programmierassistent. Er kann direkt im Terminal Code analysieren, debuggen, refaktorisieren und vieles mehr. Im Vergleich zur Web-Version ist die Terminal-Version besonders effizient und passt perfekt in den Entwickler-Alltag.

Offizielle Website: https://code.claude.com/docs/en/overview

📦 Installationsanleitung

Option 1: Offizielles One-Click Script (empfohlen)

curl -fsSL https://claude.ai/install.sh | bash

Option 2: Installation über Node.js

Wenn das Netzwerk eingeschränkt ist oder ihr Node.js bevorzugt:

# mit npm
npm install -g @anthropic-ai/claude-code

# oder mit pnpm
pnpm add -g @anthropic-ai/claude-code

⚠️ Achtung: Node-Version sollte kompatibel sein, am besten die aktuelle LTS-Version verwenden.

Installation prüfen

claude --version

Wenn eine Versionsnummer angezeigt wird, ist alles korrekt installiert!

🌍 Netzwerk konfigurieren (sehr wichtig!)

Viele stoßen hier auf Probleme. Ich erkläre Schritt für Schritt die Lösungen.

Problem

Beim Ausführen von claude im Projektverzeichnis kann folgende Fehlermeldung erscheinen:

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
Please check your internet connection and network settings.
Note: Claude Code might not be available in your country.
Check supported countries at https://anthropic.com/supported-countries

Lösungen

1. Proxy-Software konfigurieren

Wenn ihr z. B. ClashX nutzt:

✅ Wählt unterstützte Regionen: USA, Großbritannien, Singapur
✅ Systemweiten Proxy aktivieren
✅ „Erweiterter Proxy-Modus“ aktivieren

📸 Hier könnte man einen Screenshot der ClashX-Konfiguration einfügen.

2. Netzwerk prüfen

# API-Verbindung testen
ping api.anthropic.com

# Details zur Verbindung
curl -v https://api.anthropic.com

Wenn im Curl-Output ein Hinweis wie CF-RAY: -HKG erscheint, ist der Knotenpunkt nicht unterstützt (HKG = Hongkong).

3. Unterstützte Regionen

Code	Stadt	Land	Unterstützt
LAX	Los Angeles	🇺🇸 USA	✅ Ja
SJC	San Jose	🇺🇸 USA	✅ Ja
LHR	London	🇬🇧 UK	✅ Ja
SIN	Singapur	🇸🇬 SG	✅ Ja
HKG	Hongkong	🇭🇰 HK	❌ Nein
NRT	Tokio	🇯🇵 Japan	✅ Ja

4. Andere Netzwerkchecks

echo $HTTP_PROXY
echo $HTTPS_PROXY

# ggf. Umgebungsvariablen löschen
unset HTTP_PROXY
unset HTTPS_PROXY

🔑 Authentifizierung konfigurieren

Nach der Netzwerkprüfung:

claude auth login

Dann wählt:

Direktes Abo
3rd-Party API

Für Nutzer in China: Zhipu AI

Ohne Abonnement kann die Zhipu AI API genutzt werden:

API Key von Bigmodel Docs holen
JSON Konfiguration erstellen/ändern (MacOS/Linux: ~/.claude/settings.json)

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "dein_zhipu_api_key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}

Onboarding abschließen (~/.claude.json):

{
  "hasCompletedOnboarding": true
}

Konfiguration prüfen

claude

Wenn die Willkommensseite erscheint, war alles erfolgreich!

💡 Häufige Fragen

Q: Warum funktioniert die Webversion, aber die Terminal-Version nicht? A: Terminal-Version greift direkt auf Anthropic API zu, strengere Regionskontrolle. Webversion kann andere Zugriffswege nutzen.
Q: Wie prüfe ich, ob der Proxy funktioniert? A: Mit curl -v https://api.anthropic.com die CF-RAY Header prüfen.
Q: Ist die Zhipu API stabil? A: Ja, aktuell schnelle Antwortzeiten und gutes Preis-Leistungs-Verhältnis für China.

🎯 Loslegen

cd dein-projekt
claude

Jetzt könnt ihr:

📝 Code analysieren lassen
🐛 Bugs debuggen
🔧 Code refaktorisieren
💡 Programmierfragen beantworten lassen

Fazit

Claude Code ist ein mächtiges Tool, aber für Nutzer in China ist die Netzwerk-Konfiguration die erste Hürde. Diese Anleitung sollte euch helfen, problemlos loszulegen!