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

Claude Code 只需一個官方命令即可安裝：在 macOS、Linux 和 WSL 上使用 curl -fsSL https://claude.ai/install.sh | bash，在 Windows PowerShell 中使用 irm https://claude.ai/install.ps1 | iex（在命令提示字元 CMD 中，使用下方的 install.cmd 命令列）。接著選擇付款方式。您可以使用 Pro、Max、Team、Enterprise 或 Console 帳戶登入（免費的 Claude.ai 訂閱不包含 Claude Code），也可以在沒有訂閱方案時使用 API 金鑰：設定 ANTHROPIC_BASE_URL（僅網域，不含 /v1）、ANTHROPIC_AUTH_TOKEN 和四個模型變數，並使用 /status 確認金鑰已啟用。Kunavo 餘額可使用 iDEAL（荷蘭）或 Bancontact（比利時）儲值，起始金額為 $10，沒有月費。

Commando’s en variabelen gecontroleerd op 2026年10月3日 in de Claude Code 官方安裝文件 en de 環境變數文件; prijzen en betaalmethoden gecontroleerd op 2026年10月3日. Nederland en België staan allebei op de Anthropic 支援的國家／地區清單 (gecontroleerd op 2026年10月3日), zowel voor Claude.ai als voor de API. Deze handleiding bestaat ook in het Engels: 安裝 Claude Code.

安裝前

在 macOS 與 Linux 上安裝 Claude Code

開啟 Terminal，貼上這一行：

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

這是建議的原生安裝方式：一個會在背景自動更新的獨立程式。claude 指令會安裝到 ~/.local/bin。已開啟的終端機尚未取得新的 PATH，因此測試前請先開啟新的視窗。在 WSL 中，請在 WSL 終端機使用完全相同的指令。

在 Windows 上安裝 Claude Code

在 Windows 上有兩條指令，您需要哪一條只取決於目前開啟的視窗。若提示字元以 PS C:\Users\Naam> 開頭，您位於 PowerShell；若只有 C:\Users\Naam> 而沒有 PS，則是命令提示字元（CMD）。您不需要以 系統管理員身分 開啟視窗：根據官方文件，這並非必要。

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

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

最常見的錯誤是將指令貼到錯誤的視窗中。在 PowerShell 中使用 CMD 指令會顯示 The token '&&' is not a valid statement separator；在 CMD 中使用 PowerShell 指令會顯示 'irm' is not recognized as an internal or external command。在荷蘭文版 Windows 上，第二則訊息可能會以荷蘭文顯示，原因相同。此外，在 PowerShell 中使用含有 | bash 的 macOS 指令，會顯示找不到 bash 的錯誤訊息。以上三種情況都請使用與您視窗相符的指令。

Git for Windows is optioneel. Staat het erop, dan voert Claude Code commando’s uit via de meegeleverde Git Bash; zonder Git gebruikt het PowerShell. Is Git wel geïnstalleerd maar wordt Git Bash niet gevonden, zet dan CLAUDE_CODE_GIT_BASH_PATH in het env-blok van ~/.claude/settings.json op het pad naar bash.exe; het voorbeeldpad in de documentatie is C:\Program Files\Git\bin\bash.exe.

因此，WSL 並非某些較舊指南所聲稱的必要條件，而是選項。若選擇 WSL，請在 WSL 終端機中執行 macOS/Linux 指令，並且也在該處啟動 claude，不要從 PowerShell 或 CMD 啟動。

透過 Homebrew、WinGet 或 npm

也可以使用這些方式，但有一項重要差異：根據官方文件，Homebrew 和 WinGet 安裝不會自動更新。您需要自行更新：

# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code              # bijwerken gebeurt niet vanzelf

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # bijwerken gebeurt niet vanzelf

npm 套件要求 Node.js 22 或更新版本，而不是較舊指南仍寫的 Node.js 18。使用較舊的 Node.js 時，npm 只會顯示 EBADENGINE 警告，安裝仍會繼續：套件會安裝相同的原生程式，而該程式執行時不需要 Node.js。絕對不要使用 sudo npm install -g：這會造成權限問題並帶來安全風險。請使用 @latest 更新，而不是使用 npm update -g。

node -v                                           # moet v22 of hoger zijn
npm install -g @anthropic-ai/claude-code          # nooit met sudo

# later bijwerken: met @latest, niet met npm update -g
npm install -g @anthropic-ai/claude-code@latest

確認安裝

claude --version   # toont het versienummer, gevolgd door (Claude Code)
claude doctor      # alleen-lezen diagnose van installatie en instellingen, start geen sessie

claude doctor 不會啟動工作階段，而是顯示安裝狀態及設定檔狀態。如此即可快速判斷問題出在安裝還是設定。

Krijg je command not found: claude, of meldt Windows dat claude niet wordt herkend, dan staat de installatiemap niet in je PATH. Open eerst een nieuw terminalvenster. Helpt dat niet, zet dan op macOS en Linux ~/.local/bin in je PATH via ~/.zshrc of ~/.bashrc. Op Windows is de map %USERPROFILE%\.local\bin; volgens de 官方疑難排解 controleer en voeg je die zo toe in PowerShell:

# 1. Staat de installatiemap al in je PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Geen uitvoer? Voeg de map toe aan je gebruikers-PATH en open een nieuw venster
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. In het nieuwe venster: twee paden betekent twee installaties naast elkaar
where.exe claude

若您透過 npm 安裝，且 PowerShell 顯示 npm.ps1 cannot be loaded because running scripts is disabled on this system，表示 PowerShell 的執行原則封鎖了 npm 的啟動指令碼。請使用原生安裝程式、啟動 npm.cmd 和 claude.cmd，或允許目前使用者執行本機指令碼：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

首次啟動：訂閱或 API 金鑰

首次啟動時，您可以選擇 Claude Code 的付款方式。兩條路徑互斥：若已設定 API 金鑰，已儲存的登入資訊會維持未使用狀態；移除該變數後，Claude Code 會改用登入資訊，不需要重新安裝。

路徑 A：使用訂閱登入

在專案資料夾中啟動 claude，然後透過瀏覽器登入。一項容易踩到的陷阱是：若已設定 ANTHROPIC_API_KEY，Claude Code 會詢問一次是否使用該金鑰。若您拒絕，之後它會忽略該金鑰而不再詢問，看起來就像沒有讀取變數。請透過 /config → Use custom API key 重新啟用。

路徑 B：不需訂閱，使用 API 金鑰

ANTHROPIC_BASE_URL 是 Claude Code 內建的變數。根據官方文件，它會覆寫 API 端點，以便透過 proxy 或 gateway 傳送請求。因此，讓 Claude Code 指向使用 Anthropic Messages API 的端點是受支援的設定方式，不需要外掛程式或自訂版本。步驟如下：

1. 建立 Kunavo 帳戶。
2. 透過 Billing 儲值，最低為 $10（iDEAL 和 Bancontact 將在後文說明）。
3. 在 /app/keys 建立以 sk-kn- 開頭的金鑰。金鑰只會顯示一次，因此請立即保存。
4. 設定變數。在 macOS 和 Linux 上，於 ~/.zshrc 或 ~/.bashrc 中設定：

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # alleen het domein, zonder /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

在 Windows 上，若要先於單一 PowerShell 視窗中測試：

# Geldt alleen voor dit PowerShell-venster
$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

若要永久使用，使用者設定中的 env 區塊是最佳位置：~/.claude/settings.json（Windows 上為 %USERPROFILE%\.claude\settings.json）。這些值會套用到 Claude Code 執行的所有位置，包括背景代理程式。Shell 中的變數只適用於該終端機視窗：從 Dock 或開始功能表開啟的編輯器看不到這些變數。若檔案中已有其他設定，請只新增 env 區塊：

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

Zet de sleutel 絕不 in de .claude/settings.json van een project: volgens de 官方 gateway 文件 (gecontroleerd op 2026年10月3日) wordt dat bestand gecommit en gedeeld met iedereen die de repository kloont. Let ook op de volgorde: zetten zowel je shell als een instellingenbestand dezelfde variabele, dan wint het instellingenbestand. Heeft een gewijzigde shellvariabele geen effect, kijk dan eerst in settings.json.

每一行都有自己的陷阱：

• ANTHROPIC_BASE_URL 僅是網域。 Claude Code 會自行在後面加上 /v1/messages；若結尾已包含 /v1，請求會傳送到 /v1/v1/messages，並得到 404。
• 使用 ANTHROPIC_AUTH_TOKEN，不要使用 ANTHROPIC_API_KEY。 根據文件，ANTHROPIC_AUTH_TOKEN 會作為帶有 Bearer 前綴的 Authorization 標頭傳送，並立即生效。ANTHROPIC_API_KEY 會放在 x-api-key 標頭中，在互動模式下必須先核准一次（請參閱路徑 A）。
• 在 ANTHROPIC_MODEL 中精確寫入模型名稱。 Kunavo 只辨識完全相符的名稱，不會轉換後面帶有日期的舊名稱。
• 同時固定 ANTHROPIC_DEFAULT_OPUS_MODEL 和 ANTHROPIC_DEFAULT_SONNET_MODEL。 Volgens de 模型設定文件 (gecontroleerd op 2026年10月3日) wijzen de standaardinstelling en de alias opus voor API-gebruikers naar Opus 5.5 en de alias sonnet naar Sonnet 5.5, en schuiven die aliassen mee met nieuwe versies. Vastzetten doe je met de volledige modelnaam of met variabelen als ANTHROPIC_DEFAULT_OPUS_MODEL. Kunavo biedt Sonnet 5.5 nu niet aan, en een nieuw Opus-model staat er niet altijd meteen; een model dat er niet is, geeft een 404. Zonder ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 mislukken daardoor /model sonnet, de uitvoerfase van opusplan en subagents die op model: sonnet staan. De alias opus zet je vast op Opus 5.5 (claude-opus-5-5); daarvoor heb je Claude Code v2.1.280 of nieuwer nodig; een oudere versie werk je bij met claude update.
• ANTHROPIC_DEFAULT_HAIKU_MODEL 也適用於背景工作。 根據文件，此變數會決定 haiku 別名及背景功能所使用的模型，例如工作階段標題。使用 Claude Haiku 4.5 可讓這些工作維持低成本。

若使用 VS Code 擴充功能，請在 claudeCode.environmentVariables 中設定變數，也就是在 VS Code 本身的使用者設定中（指令 Preferences: Open User Settings (JSON)）。擴充功能會在啟動前先在此檢查登入資訊；~/.claude/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" }
  ]
}

Prijzen per miljoen tokens, uit de Kunavo-catalogus; de lijstprijs van Anthropic komt van claude.com/pricing (gecontroleerd op 2026年10月3日):

在工作階段內可使用 /model claude-opus-5-5 切換，或直接使用 claude --model claude-opus-5-5 啟動。Claude Code 每月大約需要多少費用，以及何時訂閱較划算，請參閱 Claude Code pricing（英文）；您可以使用 Claude token 計算機計算自己的用量。所有模型與價格均列於價格頁面。

使用 /status 確認

啟動 claude。設定 ANTHROPIC_AUTH_TOKEN 後，您將不會看到登入畫面：該變數會立即生效。若仍看到登入畫面，表示 Claude Code 沒有讀取金鑰。請將金鑰放在 Claude Code 於首次啟動精靈之前會讀取的位置：Shell 中的 export，或 env 區塊中的 ~/.claude/settings.json。互動工作階段中的專案 .claude/settings.json 或 .claude/settings.local.json 內的 env 區塊，必須等首次啟動精靈完成並回答是否信任該資料夾後才會生效。

Typ in de sessie /status en kijk op het tabblad Status naar twee regels (bron: de 官方 gateway 文件, gecontroleerd op 2026年10月3日):

• Anthropic base URL 必須顯示 https://api.kunavo.com。只有在設定 gateway 位址時才會出現這一行；若缺少，表示 ANTHROPIC_BASE_URL 沒有套用至工作階段。
• Auth token 必須提及 ANTHROPIC_AUTH_TOKEN。若改為看到含有 claude.ai 帳戶的 Login method，表示變數未被讀取，且工作階段使用的是您的訂閱。

若您先前使用訂閱登入，Claude Code 啟動時可能會警告有兩個登入來源處於啟用狀態（訊息結尾為 auth may not work as expected）。此時請求會透過金鑰傳送；使用 /logout 可清除舊的登入資訊。

想在開啟 Claude Code 前測試位址與金鑰嗎？請依文件建議，傳送只有一個輸出 token 的請求；這會消耗極少量的餘額。這些指令會從 Shell 讀取變數，因此即使變數已寫入 settings.json，也請在 Shell 中設定。

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

以 {"id":"msg_ 開頭的 JSON 回應表示位址與金鑰有效；在 PowerShell 中，您會看到以 msg_ 開頭的 id。401 表示金鑰遭拒。

API 金鑰模式下的其他差異

• 沒有 Remote Control，也沒有語音聽寫。 兩者都需要 claude.ai 帳戶，且只要 ANTHROPIC_AUTH_TOKEN 啟用就無法使用；此外，只要 ANTHROPIC_BASE_URL 指向 Anthropic 以外的位址，Remote Control 也會停用。
• /fast 會顯示快速模式已關閉。 只有 bearer token 時，Claude Code 會將快速模式視為停用，且不會傳送檢查請求。
• MCP 工具搜尋預設為關閉，只要 ANTHROPIC_BASE_URL 指向 Anthropic 以外的位址。
• /context 中的數字為估算值： Kunavo biedt /v1/messages/count_tokens nu niet aan. Volgens de gateway 官方相容性文件 (gecontroleerd op 2026年10月3日) valt Claude Code zonder dat endpoint terug op een schatting op basis van tekens, dus /context toont benaderde aantallen.

程式碼、工具、子代理程式、MCP 伺服器、hooks 與提示快取均照常運作。更多詳細資訊請參閱Claude Code 整合文件（英文）及 Claude Code without a subscription（英文）。

使用 iDEAL 或 Bancontact 付款

Een Claude-abonnement betaal je via de website alleen met een creditcard of debitcard (Claude 關於付費訂閱的說明文章, gecontroleerd op 2026年10月3日); de prijzen op claude.com/pricing zijn exclusief belasting.

Het Kunavo-tegoed waardeer je op via Stripe Checkout. De prijzen staan in Amerikaanse dollars; voor kopers in Nederland en België toont Stripe het bedrag in euro’s. Volgens de Stripe 關於 Adaptive Pricing 的文件 (gecontroleerd op 2026年10月3日) zit in die wisselkoers een omrekenopslag van 2–4% die de koper betaalt; wie in dollars betaalt (met een kaart, Apple Pay, Google Pay of Link), betaalt die opslag niet. iDEAL en Bancontact werken alleen in euro’s. Op de betaalpagina worden aangeboden:

• iDEAL, voor Nederland. De methode heet inmiddels iDEAL | Wero (Stripe vroeg om die naam in het eerste kwartaal van 2026 over te nemen), dus ook die naam kun je op de betaalpagina zien. Je wordt doorgestuurd naar de omgeving van je eigen bank en bevestigt daar (Stripe 關於 iDEAL 的說明, gecontroleerd op 2026年10月3日).
• Bancontact, voor België, met je Bancontact-kaart of de app (Stripe 關於 Bancontact 的說明, gecontroleerd op 2026年10月3日).
• 卡片（Visa、Mastercard）、Apple Pay、Google Pay 與 Link。

不提供：PayPal、SEPA 直接扣款、Klarna（僅提供給美國買家）、Tikkie、Riverty（前身為 AfterPay）及一般銀行轉帳。

1. 建立 Kunavo 帳戶。
2. 在 Billing 選擇金額，最低為 $10。一次儲值越多，獲得的額外餘額越多：bij $100 krijg je $110, bij $1.000 krijg je $1.200, bij $5.000 krijg je $6.250。
3. 在 Stripe 付款頁面選擇 iDEAL 或 Bancontact，並在您的銀行環境中完成付款（iDEAL），或使用 Bancontact 應用程式或卡片完成付款。確認前，付款頁面會顯示以歐元計價的金額。
4. 在 /app/keys 建立金鑰，並填入 ANTHROPIC_AUTH_TOKEN。

餘額採預付制：沒有月費、餘額不會過期，失敗的請求也不會收費。自動儲值只能使用已儲存的卡片或 Link；因此使用 iDEAL 和 Bancontact 時，每次都必須手動儲值。Kunavo 不開立增值稅發票；您的儲值記錄位於 Billing。這些付款方式只會儲值您的 Kunavo API 餘額：不能用來支付 Claude Pro 或 Max 訂閱。更多以歐元付款的資訊：使用 iDEAL 支付 Claude。

常見錯誤

安裝後

首次在專案中啟動時，請輸入 /init：Claude Code 會讀取儲存庫，並建立一份 CLAUDE.md，其中包含它找到的測試指令與慣例。請檢查該檔案並保持簡短，因為每個工作階段都會載入它。在個別工作之間，/clear 會開始新的對話；若工作變得很長，/compact 會摘要歷史記錄，讓您繼續工作。

您需要知道的事項

• 這是按 token 計費的 API，不是 Claude Pro 或 Max 訂閱。每天長時間使用 Claude Code 的人，訂閱通常更划算；按 token 付費適合用量不固定的情況，而一整個月不使用就不會產生費用。比較資訊請參閱 Claude Code pricing（英文）。
• 使用 API 金鑰時，Remote Control 與語音聽寫不可用。
• 透過 Kunavo 使用的是共享容量，沒有保留配額，也沒有合約保證；若您需要這些保障，請直接與 Anthropic 簽訂合約。
• iDEAL 和 Bancontact 僅可用於手動儲值；自動儲值只能使用卡片或 Link。
• 以歐元計價的金額包含 Stripe 的換匯加成。Kunavo 不開立增值稅發票。

常見問題