安裝 Claude Code：Windows、macOS 與 Linux 的指令、無訂閱的 API 金鑰，以及不使用 PayPal 的付款方式

簡而言之：您只需在終端機中輸入一行指令即可安裝 Claude Code，不需要 Node.js，也不需要系統管理員權限。要輸入哪一行只取決於您使用的視窗：macOS、Linux 與 WSL 使用 curl -fsSL https://claude.ai/install.sh | bash，Windows PowerShell 使用 irm https://claude.ai/install.ps1 | iex，在命令提示字元（CMD）中使用下方的第三行。沒有 Claude 訂閱方案的使用者，之後可透過 API 金鑰將 Claude Code 連接至 Kunavo：ANTHROPIC_BASE_URL=https://api.kunavo.com（不含 /v1）、ANTHROPIC_AUTH_TOKEN 以及四個模型變數。/status 可顯示是否生效。付款按 token 從餘額中扣除，儲值起始金額為 $10，可使用簽帳金融卡或信用卡（包括 Visa Debit 與 Debit Mastercard）、Apple Pay、Google Pay、Link，或在奧地利使用 EPS。不可使用 PayPal 與 SEPA 直接扣款。

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

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

:: Windows-Eingabeaufforderung (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Anthropic pflegt die Claude-Code-Dokumentation vollständig auf Deutsch, deshalb verweist diese Anleitung auf die deutschen Seiten. Die Befehle oben sind am 2026年10月3日 mit 設定 Claude Code abgeglichen, die Variablen mit der Liste der 環境變數. Kunavos Preise und Zahlungswege sind auf dem Stand vom 2026年10月3日. Deutschland, Österreich und die Schweiz stehen in Anthropics 國家／地區清單 sowohl für Claude.ai als auch für die API (Stand 2026年10月3日). Eine englische Fassung gibt es unter 安裝 Claude Code.

流程概覽

1. 安裝：執行上方適用的指令列，然後開啟新的終端機視窗。
2. 檢查：claude --version 會輸出版本號碼。
3. 決定：使用 Claude 訂閱方案登入，或使用 API 金鑰（比較內容見下方）。
4. 使用 API 金鑰：儲值、建立金鑰、設定六個環境變數。
5. 確認：在工作階段中輸入 /status。

先決條件：目前適用的條件

Manche deutschsprachigen Anleitungen beschreiben einen älteren Stand von Claude Code. Die Tabelle stellt verbreitete Angaben neben das, was die 官方設定頁面 am 2026年10月3日 verlangt.

在 macOS、Linux 與 WSL 上安裝

在終端機中加入含有 install.sh 的指令列。官方文件將此方式列在「Native Installation (Recommended)」分頁。指令碼會將啟動程式放在 ~/.local/bin/claude，之後安裝會在背景中自行更新。在 WSL 中也使用相同指令列，但要在 WSL 終端機中執行。

在 Windows 上安裝 Claude Code

Unter Windows entscheidet das offene Fenster, welche Zeile funktioniert, und ein Blick auf die Eingabezeile genügt: PS C:\Users\Name> ist PowerShell, C:\Users\Name> ohne PS ist die Eingabeaufforderung (CMD). Administratorrechte brauchen Sie laut 設定頁面 für keine der beiden Varianten. Der Installer legt claude.exe unter %USERPROFILE%\.local\bin ab.

如果弄錯視窗，會看到英文訊息；在德文版 Windows 上有時也會看到德文訊息。將 CMD 指令列貼到 PowerShell 會以 The token '&&' is not a valid statement separator 結束；將 PowerShell 指令列貼到 CMD 則會以 'irm' is not recognized as an internal or external command 結束。兩者的意思相同：使用了錯誤的視窗，因此請改用另一行。

Lassen Sie im Startmenü den Eintrag „Windows PowerShell (x86)“ links liegen. Laut 疑難排解 startet er einen 32-Bit-Prozess, und der Installer bricht dann auch auf einem 64-Bit-PC mit Claude Code does not support 32-bit Windows ab. Gibt [Environment]::Is64BitOperatingSystem in diesem Fenster True aus, ist Ihr Windows in Ordnung, und Sie öffnen einfach „Windows PowerShell“ ohne den Zusatz.

Git for Windows müssen Sie nicht installieren. Ist es vorhanden, führt Claude Code Shell-Befehle in der Git Bash aus, sonst in PowerShell. Findet Claude Code eine installierte Git Bash nicht, tragen Sie den Pfad zur bash.exe als CLAUDE_CODE_GIT_BASH_PATH in den env-Block von ~/.claude/settings.json ein, bei einer Standardinstallation C:\Program Files\Git\bin\bash.exe.

選擇原生執行或 WSL，取決於您的專案位於何處：

使用 WSL 時，請在 WSL 終端機中安裝並啟動 claude，不要在 PowerShell 或 CMD 中執行。

替代方案：Homebrew、WinGet 與 npm

如果您偏好透過套件管理員維護軟體，也可以這麼做，但有一項注意事項：根據文件，Homebrew 與 WinGet 安裝不會自行更新，因此您需要定期執行 upgrade。Homebrew 提供兩個 Cask。claude-code 遵循穩定通道，通常會落後約一週，並略過具有重大回歸問題的版本；claude-code@latest 則會立即取得每個版本。

# Homebrew (macOS) – stabiler Kanal; claude-code@latest für den neuesten Stand
brew install --cask claude-code
brew upgrade claude-code              # aktualisiert sich nicht von selbst

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # aktualisiert sich nicht von selbst

透過 npm

npm 仍是官方說明的安裝方式。前提是 Node.js 22 或更新版本。npm 套件會載入與安裝程式相同的原生二進位檔，執行時完全不需要 Node.js。因此，即使使用較舊版本的 Node.js，安裝也不會中止；npm 只會顯示 EBADENGINE 警告。如果您尚未安裝 Node.js，原生安裝程式是較簡短的途徑。

node -v                                    # muss v22 oder neuer zeigen
npm install -g @anthropic-ai/claude-code   # niemals mit sudo

# später aktualisieren: mit @latest, nicht mit npm update -g
npm install -g @anthropic-ai/claude-code@latest

Drei Regeln aus der 設定頁面: 無 sudo npm install -g, weil das Rechteprobleme und Sicherheitsrisiken schafft. Aktualisieren mit @latest, denn npm update -g bleibt im ursprünglichen Versionsbereich hängen. Und optionale Abhängigkeiten nicht abschalten: Die Binärdatei kommt als plattformspezifische optionale Abhängigkeit, mit --omit=optional oder optional=false in der .npmrc fehlt sie, und claude meldet unter macOS und Linux Error: claude native binary not installed.

檢查安裝

請為此開啟新的終端機視窗。安裝前已開啟的視窗尚未取得更新後的 PATH，因此找不到 claude。

claude --version   # zeigt eine Versionsnummer wie 2.1.211 (Claude Code)
claude doctor      # Diagnose von Installation und Einstellungen, startet keine Sitzung

如果發生問題，claude doctor 就是診斷工具。它不會啟動工作階段，但會列出安裝狀態、設定檔中的錯誤，以及附有解決建議的警告。如此即可判斷問題出在安裝還是設定。

安裝遇到問題時

下載內容是 HTML 或回傳 403

Beginnt die Ausgabe mit syntax error near unexpected token '<' oder meldet curl einen 403, kam laut 疑難排解 (Stand 2026年10月3日) statt des Skripts eine Webseite oder ein Fehlerstatus zurück. Steht auf dieser Seite App unavailable in region, hält Anthropic die Verbindung für eine aus einem nicht unterstützten Land. Aus Deutschland, Österreich oder der Schweiz spricht das für einen VPN- oder Proxy-Ausgang im Ausland. Ein 403 ohne Text kann dieselbe Ursache haben oder von einer Firmen-Firewall kommen. Die Dokumentation rät, zuerst die Netzwerkverbindung zu prüfen, weil die anderen Installationswege dieselben Server ansprechen. Ein anderes Netz oder eine Freigabe durch die IT hilft hier mehr als ein anderer Installer.

找不到「claude」

在 macOS 和 Linux 上出現 command not found: claude，或在 Windows 上出現未辨識的 claude，表示安裝資料夾不在 PATH 中。通常開啟新視窗即可解決。如果在 macOS 或 Linux 上仍無法解決，請將 ~/.local/bin 加入 ~/.zshrc 或 ~/.bashrc。在 Windows 上，請依照疑難排解指示檢查並加入該資料夾：

# 1. Steht der Installationsordner schon im PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Keine Ausgabe? Ordner zum Benutzer-PATH hinzufügen, dann ein neues Fenster öffnen
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Im neuen Fenster
claude --version

PowerShell 封鎖 npm.ps1

這只影響 npm 版本。訊息 npm.ps1 cannot be loaded because running scripts is disabled on this system 表示執行原則封鎖了 npm 的啟動指令碼。您可以呼叫不受該原則限制的 npm.cmd 和 claude.cmd、改用原生安裝程式，或允許目前使用者帳戶執行本機指令碼：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

訂閱方案還是 API 金鑰？

Beim ersten Start will Claude Code wissen, wer bezahlt. Entweder melden Sie sich mit einem Claude-Konto an, oder Sie geben per Umgebungsvariable einen API-Key mit. Ist ein Key gesetzt, hat er laut Gateway 指南 Vorrang: Ein gespeicherter Login bleibt ungenutzt liegen und greift wieder, sobald Sie die Variable entfernen. Neu installieren müssen Sie für den Wechsel nichts.

Claude Code 價格指南會說明何時 Pro 或 Max 相較於金鑰更划算。

設定 API 金鑰（無需訂閱）

Dass Claude Code einen anderen Endpunkt anspricht, ist kein Trick. ANTHROPIC_BASE_URL steht in Anthropics 變數清單 und ist genau dafür da, Anfragen über einen Proxy oder ein Gateway zu leiten. Ein Plugin oder eine veränderte Claude-Code-Version brauchen Sie nicht.

1. 註冊 Kunavo，可使用電子郵件地址或 Google 帳戶。
2. 在 Billing 中至少儲值 $10（付款方式請參閱付款章節）。
3. 在 API-Keys 中建立金鑰。金鑰以 sk-kn- 開頭，且只會顯示一次，因此請立即複製。
4. 依照下方所示設定變數。

在 ~/.zshrc 或 ~/.bashrc 中設定後，這些值會套用至 macOS、Linux 和 WSL 中每個新開啟的終端機：

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # nur die Domain, ohne /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

在 PowerShell 中，$env: 指派只適用於目前開啟的視窗，適合先行測試：

# Gilt nur für dieses PowerShell-Fenster
$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

Auf Dauer gehören die Werte in den env-Block von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json). Diese Datei gilt laut Gateway 指南 (Stand 2026年10月3日) für alle Ihre Projekte. Gibt es sie schon, ergänzen Sie nur den env-Block:

{
  "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"
  }
}

VS Code 擴充功能會從 VS Code 使用者設定中的 claudeCode.environmentVariables 讀取變數（命令 Preferences: Open User Settings (JSON)）：

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.kunavo.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-kn-..." },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

每個變數的作用

Warum ein festes Startmodell? Laut 模型設定 (Stand 2026年10月3日) ist Opus 5.5 der Standard für API-Nutzer, und Aliase werden im Lauf der Zeit auf neue Versionen umgestellt. Kunavo bietet Opus 5.5 an; ein Start ganz ohne Modellvariablen läuft hier also auf Opus 5.5, das 每個 token 的費用是 Claude Sonnet 5 的兩倍. Mit festen Modellnamen wissen Sie, welches Modell antwortet und zu welchem Tarif. Der Opus-Pin hält den Alias opus auf Claude Opus 5.5 (claude-opus-5-5), auch wenn Anthropic ihn später auf ein neueres Opus umstellt. Opus 5.5 kostet bei Kunavo pro Token 低於 Claude Opus 5 ($2,80 / $14,00 gegenüber $3,50 / $17,50 pro 1 Mio. Input-/Output-Tokens) und setzt Claude Code ab Version 2.1.280 voraus; eine ältere Installation bringt claude update auf den aktuellen Stand. Der Sonnet-Pin ist Pflicht: Der Alias sonnet zeigt für API-Nutzer auf Sonnet 5.5, das Kunavo nicht anbietet, und ohne ANTHROPIC_DEFAULT_SONNET_MODEL enden /model sonnet, die Ausführungsphase von opusplan und Subagents mit model: sonnet mit 404. Claude Haiku 4.5 hält die Hintergrundaufgaben günstig, und mit /model wechseln Sie in der Sitzung jederzeit.

關於儲存位置有兩點。金鑰絕對不要放在專案的 .claude/settings.json 中，因為依照 Gateway 指南，這個檔案會被提交到版本庫，任何複製儲存庫的人都能取得。若 Shell 匯出和 env 區塊設定了同一個變數，設定檔會優先。也就是說，如果您在 Shell 中變更變數卻沒有作用，舊值很可能仍在 settings.json 中。

Die Modelle im Vergleich, Kunavo-Preise aus dem Katalog, Anthropics Listenpreise nach claude.com/de/pricing (Stand 2026年10月3日), jeweils pro 1 Mio. Tokens:

所有 Claude 模型與方案都列在 Claude API 價格指南和價格頁面中。

第一次啟動：使用 /status 檢查

Wechseln Sie in Ihren Projektordner und starten Sie claude. Mit gesetztem ANTHROPIC_AUTH_TOKEN geht es direkt in die Sitzung, 不顯示登入畫面. Erscheint er trotzdem, hat Claude Code keinen Key gefunden. Der häufigste Grund laut Gateway 指南: Der Key steht nur in der .claude/settings.json oder .claude/settings.local.json des Projekts. Solche env-Blöcke wertet Claude Code in einer interaktiven Sitzung erst nach dem Einrichtungsassistenten und der Frage aus, ob Sie dem Ordner vertrauen. Legen Sie den Key deshalb in die Shell (export) oder in ~/.claude/settings.json.

在工作階段中，/status 會在 Status 分頁顯示 Claude Code 從何處取得位址和憑證。以下兩行最重要：

即使不使用 Claude Code，也可以透過 Gateway 指南中的請求測試連線（此處將模型設為 claude-sonnet-5）。它只要求一個輸出 Token，因此費用極低。這些命令會讀取 Shell 變數；如果您的值只存在於 settings.json 中，請另外匯出它們以進行測試。

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": "."}]}'

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": "."}]}'

如果回傳的 JSON 以 {"id":"msg_ 開頭，或 PowerShell 回傳的物件含有以 msg_ 開頭的 id，表示位址和金鑰正確。出現 401 表示金鑰遭拒。

使用 API 金鑰後的變化

大部分功能維持不變：編輯程式碼、工具、子代理程式、MCP 伺服器、Hooks 和提示快取照常運作。以下四項差異需要注意：

• Remote Control 和語音聽寫會停用。 根據 Gateway 指南，兩者都需要 claude.ai 身分，且只要 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY 啟用就會被封鎖。自 2.1.196 版起，如果 ANTHROPIC_BASE_URL 指向 Anthropic 以外的主機，Remote Control 也會被封鎖。
• /fast 會顯示快速模式不可用。 只有 Bearer Token 時，Claude Code 會將其視為已停用，甚至不會送出可用性檢查。
• MCP 的工具搜尋已停用。 Laut MCP 文件 (Stand 2026年10月3日) schaltet Claude Code sie ab, sobald ANTHROPIC_BASE_URL auf einen Drittanbieter zeigt; mit ENABLE_TOOL_SEARCH lässt sie sich ausdrücklich einschalten.
• /context 會顯示估算值。 Kunavo bietet /v1/messages/count_tokens nicht an. Ohne diesen Endpunkt zählt Claude Code laut Gateway 相容性指南 (Stand 2026年10月3日) anhand der Zeichen.

更多整合資訊請參閱Claude Code 整合指南（英文）。

不使用 PayPal 和 SEPA 付款

Vorweg eine Abgrenzung: Kunavo verkauft keine Claude-Abos, sondern Guthaben für API-Zugang, von dem Claude Code jeden Token abbucht. Für Pro und Max bei Anthropic gilt: Im Web nur Kredit- oder Debitkarte, in den Apps rechnen App Store bzw. Google Play ab (計費常見問題). PayPal oder Venmo nimmt Anthropic laut dem 遭拒卡片說明文章 nicht an (beides Stand 2026年10月3日).

Kunavo lädt über den Stripe-Checkout auf. Die Preise stehen in US-Dollar; wer aus Deutschland oder Österreich zahlt, sieht den Betrag in Euro. In diesem Kurs steckt laut Stripe 的 Adaptive Pricing 文件 (Stand 2026年10月3日) eine Umrechnungsgebühr von 2–4 %, die der Käufer trägt. Wählen Sie im Checkout US-Dollar, entfällt sie; dann rechnet Ihre Bank zu ihrem eigenen Kurs um und kann eigene Gebühren verlangen. Der Checkout bietet an:

EPS ist laut Stripe ein österreichisches Verfahren, das alle österreichischen Banken unterstützen. Sie werden auf die Seite Ihrer Bank weitergeleitet und bestätigen dort; es funktioniert nur bei Zahlung in Euro. Wer aus der Schweiz zahlt, nimmt Karte, Apple Pay, Google Pay oder Link.

girocard： Eine Karte, die nur girocard ist (früher EC-Karte), wird im Kunavo-Checkout nicht angenommen, weil Stripe girocard nicht unter seinen 支援的卡片品牌 führt (Stand 2026年10月3日). Trägt Ihre Karte zusätzlich das Visa- oder Mastercard-Logo, läuft die Zahlung über dieses Netz, auch in Apple Pay und Google Pay.

不提供：PayPal、SEPA 直接扣款、人工銀行轉帳（預付款）、giropay 和 Sofort。Checkout 僅向美國買家提供 Klarna；即使在美國境外切換為美元，也仍看不到 Klarna。

1. 建立帳戶；Kunavo 註冊時不會要求信用卡。
2. 在 Billing 中選擇自 $10 起的儲值級距。較大的級距會提供紅利餘額：$100 ergeben $110, $1.000 ergeben $1.200, $5.000 ergeben $6.250。
3. 在 Stripe Checkout 中選擇付款方式。確認前會顯示歐元金額；使用 EPS 時，請在網路銀行中確認。
4. 在 API-Keys 中建立金鑰，並將其設為 ANTHROPIC_AUTH_TOKEN。

餘額需預先付款：無月費、不會過期，失敗的請求也不會收費。只有使用已儲存的卡片或 Link 才能自動儲值；使用 Apple Pay、Google Pay 和 EPS 時，請手動儲值。Kunavo 不會開立列有營業稅的發票；您可以在 Billing 中查看儲值紀錄。關於付款方式與遭拒卡片的更多資訊：不使用信用卡支付 Claude。

一次工作階段的費用：計算範例

使用 API 金鑰時，您支付的是 Token，而 Claude Code 每一步都會傳送先前的完整上下文。不過，這個上下文不會每次都按完整費用計算：未變更的開頭會由模型從快取讀取，並適用較低的快取讀取費率。下表以假設模式進行計算；既不是測量結果，也不是上限。假設：

• 每次請求 40.000 個輸入 Token，其中 36.000（90 %）從快取讀取，並有 4.000 個新 Token 寫入快取；
• 每次請求 1.000 個輸出 Token；
• 每個工作階段有 50 次這類請求，不計背景呼叫；
• 快取讀取在 Claude Sonnet 5 時按輸入費率的 10 % 計費，快取寫入則為 1,25 倍；表中的每個模型都以其自身的係數計算。

您實際支付的金額取決於上下文長度、快取命中情況和回應長度，也取決於您是否在兩項工作之間使用 /clear 重新開始。若要代入您自己的數字，請使用Claude Token 計算器（英文）；與 Pro 和 Max 的比較則可由Claude Code 價格指南計算。

錯誤訊息及其含義

此方式的限制

• 按 Token 計費，而非固定收費。每天使用 Claude Code 數小時的人，使用 Pro 或 Max 通常更划算。使用量不固定時，您只支付實際使用的部分，整個月未使用則不收費。
• 沒有 claude.ai 帳戶就無法使用 Remote Control 和語音聽寫；/fast 會被視為停用，MCP 的工具搜尋預設也會關閉。
• Kunavo 目前不提供 Sonnet 5.5；因此 /model sonnet、opusplan 和 Sonnet 子代理程式需要使用上方範例中的 Sonnet 固定設定。
• Apple Pay、Google Pay 和 EPS 只能手動儲值，自動儲值僅支援卡片或 Link。歐元金額包含 Stripe 的換匯費用。
• Kunavo 不會開立列有營業稅的發票。
• Anthropic 的 Claude Code 文件有德文版本，而 Kunavo 的整合指南僅提供英文版。

常見問題