Claude Code installieren【Windows・Mac】— API-Schlüssel ohne Abonnement konfigurieren und mit JCB sowie Apple Pay bezahlen

Die Installation von Claude Code besteht darin, eine Zeile des offiziellen nativen Installers auszuführen. Für Mac, Linux und WSL verwenden Sie install.sh, für Windows in PowerShell install.ps1 und in CMD install.cmd (npm funktioniert ebenfalls, erfordert dann aber Node.js 22 oder höher). Normalerweise melden Sie sich anschließend mit einem Tarif wie Pro oder Max an. Wenn Sie kein Abonnement abschließen, können Sie Claude Code ohne Anmeldung starten, indem Sie ANTHROPIC_BASE_URL=https://api.kunavo.com (ohne /v1) sowie ANTHROPIC_AUTH_TOKEN mit dem API-Schlüssel und vier Variablen zur Fixierung der Modelle setzen. Mit /status prüfen Sie, ob es läuft. Das API-Guthaben kann mit Karten wie JCB, Apple Pay, Google Pay und Link ab $10 im Voraus bezahlt werden; der Checkout zeigt die Beträge in Yen an.

# macOS・Linux・WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows コマンドプロンプト（CMD）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

インストール手順の一次情報は、日本語で読める Anthropic の公式ドキュメント（Einrichtung、Fehlerbehebung bei der Installation、3. Oktober 2026確認）です。このページはその内容をなぞるのではなく、日本語の解説記事で食い違っている点（Node.js のバージョン、Windows の管理者権限と Git）と、公式ドキュメントが扱っていないこと——ログインせずに API キーで動かす設定と、日本からの支払い——を中心にまとめています。料金と決済手段は 3. Oktober 2026時点の情報です。日本は Anthropic のListe der unterstützten Länderに、Claude.ai と API の両方で載っています（3. Oktober 2026確認）。

Zuerst entscheiden: mit einem Abonnement anmelden oder mit einem API-Schlüssel arbeiten

Die Installation ist in beiden Fällen gleich; der Unterschied liegt nach dem ersten Start. Beim Start fordert Claude Code eine Authentifizierung an. Wenn Sie unsicher sind, können Sie anhand dieser drei Punkte entscheiden.

• Sie haben bereits Pro, Max, Team oder Enterprise abonniert oder besitzen ein Console-Konto: Melden Sie sich einfach an. Die API-Schlüssel-Konfiguration dieser Seite ist nicht erforderlich. Der kostenlose Tarif enthält Claude Code nicht.
• Sie möchten keine monatliche Pauschale zahlen; die Nutzung schwankt stark von Monat zu Monat：API キーで動かし、使ったトークン分だけ払う形が合います。参考までに、Claude のサブスクは Pro が月 $20（年払いは $200 で月 $17 相当）、Max は月 $100 からで、いずれも税別です（Die Claude-Preisseite、3. Oktober 2026確認）。どちらが安くなるかの分岐点は Claude-Code-Preiseで試算しています。
• Sie möchten Remote Control oder Spracheingabe verwenden: Beides setzt ein claude.ai-Konto voraus und kann daher nicht mit einem API-Schlüssel verwendet werden. Wählen Sie die Anmeldung.

支払い手段も違います。Anthropic の Web サイトで契約するサブスクはクレジットカードかデビットカードのみで、iPhone・Android アプリから契約した場合は App Store・Google Play が決済します（Anthropic-Hilfe、英語版、3. Oktober 2026確認）。Kunavo の API 残高は、JCB を含むカード、Apple Pay、Google Pay、Link でチャージします（詳しくは後半の支払いの章）。

Prüfung vor der Installation

Die Anforderungen entsprechen der offiziellen Dokumentation (3. Oktober 2026 prüfen). Die rechte Spalte zeigt, wie Sie sie auf Ihrem Gerät überprüfen.

Installationsmethode

Die offizielle Dokumentation empfiehlt den nativen Installer. Der Hauptunterschied zu den anderen Methoden betrifft die Aktualisierung.

# Homebrew（既定では自動更新されない）
brew install --cask claude-code

# WinGet（Windows・既定では自動更新されない）
winget install Anthropic.ClaudeCode

Öffnen Sie nach jeder Methode zunächst das Terminal erneut und prüfen Sie dann. Fenster, die vor der Installation geöffnet waren, haben möglicherweise die neue PATH noch nicht geladen. claude doctor zeigt den Installations- und Konfigurationsstatus an, ohne eine Sitzung zu starten, und hilft bei der Fehlersuche.

claude --version   # 2.1.211 (Claude Code) のようなバージョン番号が出れば OK
claude doctor      # セッションを開かずに、インストールと設定を診断する

Hinweise zur Installation mit npm

日本語の解説記事では今も「Node.js 18 以上」という記載をよく見かけますが、公式ドキュメントの要件はNode.js 22 oder höherです（Offizielle Dokumentation、3. Oktober 2026確認）。古い Node.js でも npm は EBADENGINE の警告を出すだけでインストールを止めず、claude も起動しますが、警告が出たら Node.js を上げておくほうが安全です。nvm や Volta などでバージョンを切り替えている場合は、インストールするシェルで node -v を確かめてください。

node -v                                    # v22 以上であること
npm install -g @anthropic-ai/claude-code   # sudo は付けない

# 更新は @latest で（npm update -g は使わない）
npm install -g @anthropic-ai/claude-code@latest

In der offiziellen Dokumentation steht ausdrücklich, dass Sie sudo npm install -g nicht verwenden sollen. Da die Binärdatei von Claude Code als optionale Abhängigkeit installiert wird, startet Claude Code unter Mac und Linux nicht und meldet claude native binary not installed, wenn optionale Abhängigkeiten durch --omit=optional oder durch optional=false in .npmrc ausgeschlossen werden.

Wichtige Punkte bei der Installation unter Windows

まず、ネットでよく見る 2 つの手順は不要です。「PowerShell を管理者として実行」と「Git for Windows を先に入れる」は、どちらも公式ドキュメントの要件ではありません。Administratorrechte sind nicht erforderlich; Git for Windows ist optionalで、入っていなければ Claude Code は PowerShell でコマンドを実行します（Einrichtung unter Windows、3. Oktober 2026確認）。

Prüfen Sie vor dem Einfügen des Befehls nur diese zwei Punkte.

1. Ist das aktuell geöffnete Terminal PowerShell oder CMD? Wenn die Eingabeaufforderung PS C:\Users\ユーザー名> lautet, verwenden Sie die PowerShell-Zeile mit irm. Wenn PS fehlt und die Eingabeaufforderung C:\Users\ユーザー名> lautet, verwenden Sie die CMD-Zeile mit install.cmd. Bei einer Verwechslung meldet PowerShell, dass && nicht als Trennzeichen erkannt wird, während CMD meldet, dass irm nicht erkannt wird (bei japanischer Windows-Anzeige können die Meldungen auf Japanisch erscheinen).
2. Ist „Windows PowerShell (x86)“ geöffnet? Die im Startmenü angezeigte Variante mit (x86) ist ein 32-Bit-Prozess und endet daher auch auf einem 64-Bit-Computer mit Claude Code does not support 32-bit Windows.

Unter Windows gibt es drei Möglichkeiten zur Ausführung. Im Zweifel können Sie mit der nativen Methode beginnen.

Wenn Git for Windows installiert ist, Claude Code aber Git Bash nicht findet, tragen Sie in der Benutzereinstellungsdatei unter env den Pfad zu bash.exe in CLAUDE_CODE_GIT_BASH_PATH ein.

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Wenn claude trotz Installation nicht funktioniert

'claude' is not recognized (auf Mac und Linux command not found: claude) bedeutet, dass das Installationsverzeichnis nicht in PATH enthalten ist. Der native Installer liegt unter Windows in %USERPROFILE%\.local\bin\claude.exe und auf Mac und Linux in ~/.local/bin/claude. Wenn das erneute Öffnen des Terminals nicht hilft, prüfen und ergänzen Sie den Pfad gemäß der offiziellen Dokumentation aus PowerShell.

# 1. インストール先が PATH に入っているか確認する
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. 何も出なければユーザーの PATH に追加し、ターミナルを開き直す
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. 新しいターミナルで
claude --version

npm で入れた場合に npm.ps1 cannot be loaded because running scripts is disabled on this system （起動時なら claude.ps1）と出るのは、PowerShell の実行ポリシーが npm の .ps1 スクリプトを止めているためです（Offizielle Dokumentation、3. Oktober 2026確認）。現在のユーザーにだけローカルのスクリプト実行を許可する次のコマンドで解消します。ポリシーを変えたくなければ、npm.cmd・claude.cmd を使うか、PowerShell 用のネイティブインストーラーに切り替えてください。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Einrichtung für die Nutzung mit einem API-Schlüssel ohne Anmeldung

Kunavo ist kein Teil von Anthropic, sondern ein unabhängiges API-Gateway, das vorausbezahlten API-Zugriff auf Modelle wie Claude anbietet.Claude Code には送信先を差し替える ANTHROPIC_BASE_URL という変数が公式に用意されていて、公式ドキュメントにも「Claude Code mit einem LLM-Gateway verbinden」というページがあります。プラグインや改造版は使いません。この変数が変えるのは送信先だけで、どのモデルが答えるかは別の変数で決まります（Modelleinstellungen、3. Oktober 2026確認）。

Es sind die folgenden sechs Einstellungen erforderlich.

Auf Mac und Linux in die Shell-Konfigurationsdatei (~/.zshrc oder ~/.bashrc) eintragen und das Terminal erneut öffnen.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # ドメインだけ。/v1 は付けない
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
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

Zum Testen unter Windows führen Sie Folgendes in einem PowerShell-Fenster aus. Beim Schließen des Fensters geht die Einstellung verloren.

# このウィンドウの中だけで有効（閉じると消える）
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Wenn Sie die Variablen nicht jedes Mal eingeben möchten, tragen Sie sie im Benutzerkonfigurationsfile ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json) im Abschnitt env ein. Dies gilt für alle Projekte und funktioniert auf Mac und Windows gleich. Wenn die Datei bereits andere Einstellungen enthält, fügen Sie nur den Block env hinzu.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Zum Speicherort gibt es drei wichtige Hinweise.

• プロジェクトの .claude/settings.json にはDen Schlüssel nicht eintragenでください。リポジトリにコミットされ、クローンした人全員に渡ります（Offizielle Dokumentation）。
• Wenn dieselbe Variable in der Shell und in der Konfigurationsdatei vorhanden ist, wird der Wert aus der Konfigurationsdatei verwendet. Wenn sich das Verhalten auch nach erneutem export nicht ändert, prüfen Sie die Konfigurationsdatei.
• Bei Verwendung der VS-Code-Erweiterung tragen Sie dieselben Variablen in der VS-Code-Benutzereinstellung claudeCode.environmentVariables ein.

Warum ANTHROPIC_AUTH_TOKEN verwendet werden sollte

ANTHROPIC_AUTH_TOKEN wird im Header Authorization: Bearer gesendet und ist sofort aktiv. ANTHROPIC_API_KEY wird dagegen im Header x-api-key gesendet; im interaktiven Modus werden Sie beim ersten Mal einmalig gefragt, ob der Schlüssel verwendet werden darf. Wenn Sie ablehnen, wird der Schlüssel anschließend ohne Hinweis ignoriert und erst wieder verwendet, wenn Sie ihn unter /config mit Use custom API key aktivieren. Kunavo akzeptiert Schlüssel in beiden Headern, daher funktioniert auch ANTHROPIC_API_KEY; ANTHROPIC_AUTH_TOKEN ist jedoch zuverlässiger, da diese Stolperfalle entfällt. Die offizielle Dokumentation empfiehlt ebenfalls ANTHROPIC_AUTH_TOKEN, wenn kein Schlüsseltyp angegeben ist.

Warum die Modelle fixiert werden sollten (Stand 3. Oktober 2026)

Offizielle Dokumentation（3. Oktober 2026確認）によると、API キーで使う場合、既定モデルと opus エイリアスは Opus 5.5、sonnet エイリアスは Sonnet 5.5 を指します。エイリアスの行き先は新しいモデルが出るたびに変わりますが、Kunavo で同じ日から使えるとは限りません。実際、Kunavo は 3. Oktober 2026時点で Sonnet 5.5 を提供していないので、固定せずに /model sonnet を選ぶと 404 になります。opusplan の実行フェーズや、model: sonnet を指定したサブエージェントも同じです。そのため上の設定では ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 で sonnet エイリアスも固定しています。opus エイリアスも、行き先が次の Opus に変わっても困らないよう ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 で Claude Opus 5.5 に固定しています。Claude Opus 5.5 には Claude Code v2.1.280 以降が必要なので、古い場合は claude update で更新してください。

固定しておくと、費用の見通しも立てやすくなります。何も指定しないと既定モデルが Claude Opus 5.5 になり、Claude Sonnet 5 をメインにした場合より 1 トークンあたりの単価が上がります。Kunavo の単価（1M トークンあたり、入力 / 出力）は、Claude Haiku 4.5 が $0.70 / $3.50、Claude Sonnet 5 が $1.40 / $7.00（Anthropic-Preise: $2.00 / $10.00）、Claude Opus 5.5 が $2.80 / $14.00 です。ANTHROPIC_DEFAULT_HAIKU_MODEL を設定しないと、ANTHROPIC_AUTH_TOKEN で接続したセッションでは claude --resume 用の会話要約などのバックグラウンド処理もメインのモデルで動きます（Kompatibilitätsleitfaden für Gateways、3. Oktober 2026確認）。なお Anthropic のPreisseiteでは、メインに固定している Sonnet 5 は「レガシーモデル」の欄に移っています（3. Oktober 2026確認）。

Funktionsprüfung in drei Stufen

1. Vor dem Start nur URL und Schlüssel testen

Dies ist wie in der offiziellen Dokumentation eine Anfrage mit nur einem Ausgabetoken (ein sehr kleiner Betrag wird vom Guthaben abgezogen). Da die Shell-Variablen gelesen werden, führen Sie in diesem Terminal zunächst export aus, wenn der Schlüssel nur in der Konfigurationsdatei steht. Wenn JSON beginnend mit {"id":"msg_ und 200 zurückgegeben werden, sind URL und Schlüssel korrekt; bei 401 wurde der Schlüssel abgelehnt.

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

In PowerShell lautet der Befehl wie folgt; der Test ist erfolgreich, wenn das zurückgegebene id mit msg_ beginnt.

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

2. claude starten und sicherstellen, dass kein Anmeldebildschirm erscheint

Beim ersten Mal erscheinen der Assistent für die erste Ausführung und die Bestätigung des Ordnervertrauens, danach wird jedoch keine Browser-Anmeldung verlangt. Wenn eine Anmeldung verlangt wird, ist der Schlüssel nicht angekommen.

Eine häufige Ursache ist, dass der Schlüssel nur in den Projekteinstellungen .claude/settings.json oder .claude/settings.local.json steht. In interaktiven Sitzungen wird env der Projekteinstellungen erst nach Abschluss des Assistenten und der Ordnervertrauensprüfung geladen, daher wird der Schlüssel beim ersten Start als nicht vorhanden behandelt. Verschieben Sie ihn in export der Shell oder in ~/.claude/settings.json des Benutzers.

3. Die zwei Zeilen von /status prüfen

セッションの中で /status を実行し、Status タブを確認します（Offizielle Dokumentation、3. Oktober 2026確認）。

• Unter Anthropic base URL muss https://api.kunavo.com erscheinen. Diese Zeile wird nur angezeigt, wenn ein Gateway konfiguriert ist; fehlt sie vollständig, ist ANTHROPIC_BASE_URL nicht in der Sitzung angekommen.
• Unter Auth token muss ANTHROPIC_AUTH_TOKEN erscheinen. Wenn stattdessen Login method des claude.ai-Kontos angezeigt wird, läuft Claude mit der gespeicherten Anmeldung.

Was sich bei Verwendung eines API-Schlüssels ändert

• Remote Control und Spracheingabe sind nicht verfügbar. Beide setzen eine claude.ai-ID voraus und sind deaktiviert, solange Gateway-Anmeldedaten wie ANTHROPIC_AUTH_TOKEN aktiv sind. Ab v2.1.196 wird Remote Control bereits deaktiviert, wenn ANTHROPIC_BASE_URL lediglich auf einen Host außerhalb von Anthropic verweist.
• /fast wird als deaktiviert angezeigt. Wenn nur mit einem Bearer-Token authentifiziert wird, fragt Claude Code nicht ab, ob der Schnellmodus verfügbar ist, behandelt ihn als deaktiviert und zeigt Fast mode has been disabled by your organization an.
• Die Zahl in /context ist nur eine Schätzung.Kunavo は /v1/messages/count_tokens を提供していないため、Claude Code は文字数ベースの推定に切り替えます（Kompatibilitätsleitfaden für Gateways、3. Oktober 2026確認）。

Detaillierte Einstellungen für Kunavo finden Sie in der Integrationsdokumentation für Claude Code und in der Dokumentation zu ANTHROPIC_BASE_URL (beide auf Englisch).

API-Guthaben bezahlen: JCB, Apple Pay, Google Pay und Link

Hier werden zunächst häufige Fragen zur Zahlung aus Japan zusammengefasst.

Der Ablauf umfasst vier Schritte. Zuerst registrieren Sie sich bei Kunavo (mit E-Mail-Adresse oder Google-Konto; bei der Registrierung werden keine Kartendaten verlangt). Wählen Sie anschließend im Dashboard unter Billing den Aufladebetrag. Der Mindestbetrag beträgt $10; es gibt keine Monatsgebühr, und hohe Beträge erhalten einen Bonus ($100 で残高 $110、$1,000 で残高 $1,200、$5,000 で残高 $6,250). Wählen Sie im Stripe-Checkout eine der oben genannten Methoden und bezahlen Sie. Erstellen Sie zuletzt unter API Keys einen sk-kn--Schlüssel und tragen Sie ihn in ANTHROPIC_AUTH_TOKEN ein. Der Schlüssel wird nur einmal bei der Erstellung angezeigt; kopieren Sie ihn sofort.

Das Guthaben verfällt nicht, und fehlgeschlagene Anfragen werden nicht berechnet. Welche Zahlungsmethoden für ein Claude-Abonnement in Japan verfügbar sind (einschließlich App Store und Google Play) ist mit Quellen unter Zahlungsmethoden für Claude zusammengefasst.

Kostenschätzung (Beispielrechnung)

Claude Code mit API-Schlüssel wird nach Tokenverbrauch abgerechnet. Claude Code sendet bei jeder Anfrage den gesamten Gesprächskontext; der gleiche Anfangsteil wie bei der vorherigen Anfrage kann jedoch zum Preis für Cache-Lesevorgänge abgerechnet werden. Die folgende Tabelle basiert auf 40,000 Input-Token pro Anfrage, davon 36,000 = 90% Cache-Lesevorgänge und die übrigen 4,000 Cache-Schreibvorgänge, 1,000 Output-Token sowie 50 Anfragen pro Arbeitsschritt. Aufrufe von Claude Haiku 4.5 im Hintergrund sind nicht enthalten. Bei Kunavo betragen die Cache-Preise für Claude Sonnet 5 beim Lesen 10% des Input-Preises und beim Schreiben das 1.25-Fache (jedes Modell in der Tabelle wird mit seinem jeweiligen Verhältnis berechnet). Dies sind weder Messwerte noch eine Obergrenze.

Der tatsächliche Betrag hängt von Kontextlänge, Cache-Wirkung, Antwortlänge und davon ab, ob Sie pro Arbeitsschritt /clear ausführen. Die Preise aller Modelle finden Sie auf der Preisseite; eine Schätzung für Ihre Nutzung im Claude-Token-Kostenrechner (Englisch) und die API-Preise nach Modell unter Claude-API-Preise.

Häufige Fehler und Lösungen

Fälle, für die diese Methode nicht geeignet ist

• Eine qualifizierte Rechnung ist für die Spesenabrechnung zwingend erforderlich. Im Kunavo-Checkout werden weder Rechnungen noch qualifizierte Rechnungen mit Registrierungsnummer ausgestellt.
• Sie möchten im Konbini oder mit PayPay bezahlen. Beides wird ebenso wenig unterstützt wie Banküberweisung oder Mobilfunkabrechnung. Automatische Aufladungen sind nur mit einer gespeicherten Karte oder Link möglich.
• Sie möchten Remote Control oder Spracheingabe verwenden. Beides funktioniert nicht mit API-Schlüsseln; außerdem wird /fast als deaktiviert angezeigt. Melden Sie sich mit einem Abonnement an.
• Sie möchten Sonnet 5.5 verwenden. Kunavo bietet es zum Zeitpunkt 3. Oktober 2026 nicht an.
• Sie möchten die Einrichtung ausschließlich mit deutschsprachiger Dokumentation abschließen. Die offizielle Dokumentation von Claude Code ist auf Deutsch verfügbar, die Integrationsdokumentation von Kunavo jedoch nur auf Englisch.

Nächste Schritte

Sobald /status die Verbindung bestätigt, starten Sie im Verzeichnis des zu bearbeitenden Projekts claude und erstellen zunächst mit /init eine CLAUDE.md. Welche Inhalte in CLAUDE.md gehören, wie Sie Bestätigungsdialoge reduzieren und benutzerdefinierte Befehle erstellen, wird nacheinander unter Claude Code verwenden erklärt.

Häufig gestellte Fragen