Claude Code installieren – ein Befehl und zwei Hürden danach

Die Installation von Claude Code selbst besteht aus einem einzigen Befehl; die tatsächlichen Hürden kommen danach. Artikel zur Installation enden meist bei „Installation abgeschlossen“, doch bis zur Ausführung in Korea gibt es zwei weitere Hürden — globale Installationsberechtigungen und Anmeldung und Zahlung. Dieser Artikel behandelt alle drei Schritte in der richtigen Reihenfolge und erklärt jeweils die Lösung, wenn etwas blockiert.

Schritt 1 — Installation (ein Befehl)

Einzige Voraussetzung ist Node.js 18 oder höher. Unter macOS, Windows (WSL) und Linux wird derselbe Befehl verwendet.

# Node.js 18 이상이 필요합니다. 먼저 확인하세요.
node --version

# 설치
npm install -g @anthropic-ai/claude-code

# 확인 — 버전이 출력되면 설치 자체는 끝난 것입니다
claude --version

claude --versionWenn diese Version ausgegeben wird, ist die Installation abgeschlossen. Wenn es hier nicht weitergeht, trifft einer der beiden folgenden Abschnitte zu.

Schritt 2 — Berechtigungs- und Pfadfehler

Dies sind die beiden häufigsten Fehler während der Installation.

Es wird nicht empfohlen, EACCES mit sudo zu ergänzen. Die Installation funktioniert zunächst, aber bei jedem Update tritt dasselbe Problem erneut auf; außerdem gehört das globale Verzeichnis dann root, was die Situation weiter verkompliziert. Sauberer ist es, den Pfad ins Home-Verzeichnis zu verschieben.

# npm 전역 설치에서 EACCES가 나면 sudo를 붙이지 말고
# 전역 경로를 홈 디렉터리로 옮기는 편이 안전합니다.
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

# 셸 설정에 추가한 뒤 새 터미널을 엽니다
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc

Unter Windows sollten Sie innerhalb von WSL installieren. Auch die Projektdateien müssen im WSL-Dateisystem liegen, damit Dateiwächter und Pfadverarbeitung korrekt funktionieren.

Schritt 3 — Anmeldung und Zahlung (die tatsächliche Hürde in Korea)

Nach Abschluss der Installation fordert claude beim Start eine Anmeldung. Hier bleiben Nutzer in Korea am häufigsten stecken; die Ursache hat nichts mit der Installation zu tun.

• Karte mit gesperrten internationalen Zahlungen — Die Abonnementzahlung schlägt fehl. Wenn Sie internationale Zahlungen in der App oder auf der Website des Kartenanbieters aktivieren, ist das Problem meistens gelöst.
• KakaoPay und Toss — Diese werden für Zahlungen im Web auf claude.ai nicht unterstützt (sie sind nur als Zahlungsmethoden für Store-Abonnements in mobilen Apps verfügbar). Wer eine koreanische Sofortzahlungsoption erwartet, scheitert an diesem Schritt.
• Wenn Sie keine für internationale Zahlungen geeignete Karte haben — können Sie den Web-Abonnementweg nicht nutzen. Bei der unten beschriebenen Schlüssel-Authentifizierung laden Sie Kunavo-Guthaben auf; wenn der Zahlungsbildschirm in koreanischen Won angezeigt wird, werden KakaoPay, Naver Pay, PAYCO, Samsung Pay und inländische Karten (auch Karten ohne freigeschaltete Auslandszahlungen) als Zahlungsmethoden angeboten, sodass Sie ohne Karte für internationale Zahlungen aufladen können (TOSS wird nicht unterstützt).

Welche Zahlungsmethoden funktionieren und welche nicht, ist unter Zahlungsmethoden für Claude zusammengefasst.

Wenn die Abonnementzahlung blockiert ist — mit der bestehenden Installation per Schlüssel ausführen

Claude Code unterstützt neben der Anmeldung per Abonnement auch die Authentifizierung per API-Schlüssel. Wenn die beiden folgenden Umgebungsvariablen gesetzt sind, startet es ohne Anmeldebildschirm; wenn Sie die Variablen löschen, kehrt es zum ursprünglichen Verhalten zurück. Eine Neuinstallation ist nicht erforderlich.

# 구독 결제가 막혔을 때 설치한 클로드 코드를 그대로 쓰는 방법.
# 이 두 줄이 있으면 로그인 대신 키로 인증하고, 지우면 원래대로 돌아갑니다.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# 클로드 코드의 기본 모델과 opus·sonnet 별칭은 Anthropic의 최신 모델을 따라가므로,
# Kunavo가 제공하는 모델로 고정해 404를 막습니다. sonnet 별칭은 Kunavo가 제공하지
# 않는 Sonnet 5.5를 요청하므로, 고정하지 않으면 /model sonnet, opusplan의 실행 단계,
# sonnet 서브에이전트가 404로 실패합니다. opus는 Opus 5.5로 고정하며,
# 클로드 코드 v2.1.280 이상이 필요합니다(이전 버전은 claude update).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

claude

Bei diesem Weg zahlen Sie statt einer Monatsgebühr nur für die tatsächlich verwendeten Tokens; in Monaten ohne Arbeit fallen keine Kosten an. Die Ausstellung eines Schlüssels ist unter Claude-API-Schlüssel ausstellen beschrieben; welcher Weg — Abonnement oder verbrauchsabhängige Abrechnung — günstiger ist, erfahren Sie unter Claude-Code-Preise.

Erster Start nach der Installation — 3-Minuten-Prüfung

Sobald die Ausführung funktioniert, starten Sie im Projektverzeichnis claude und führen Sie einmal /init aus. Dabei wird das Repository gelesen und CLAUDE.md erstellt; anschließend wird die Datei automatisch in jeder Sitzung gelesen. Die weitere Nutzung — Regeln verfassen, Berechtigungen konfigurieren und benutzerdefinierte Befehle — wird unter Claude Code verwenden erklärt.

Fehler, die nach dem Start auftreten (401, 429, 529), haben völlig andere Ursachen als Probleme bei der Installation. Die Unterscheidung ist unter Claude-Code-Fehler im Überblick separat erklärt.

Häufig gestellte Fragen