如何在 Windows、macOS 與 Linux 上安裝 Claude Code——無需訂閱的 API 金鑰與 BLIK 付款

Claude Code 可使用一個官方指令安裝（下方提供 macOS、Linux、PowerShell 及 CMD 版本）。Anthropic 建議使用原生安裝程式，而 npm 是需要 Node.js 22 或更新版本的替代方案。不使用 Pro/Max 訂閱且不登入時，只需設定 ANTHROPIC_BASE_URL=https://api.kunavo.com（不要加上 /v1）、含 API 金鑰的 ANTHROPIC_AUTH_TOKEN，以及四個固定模型的變數。之後只需從以波蘭茲羅提儲值、起始金額為 10 USD 的餘額中支付實際使用的 token。最後，在 Claude Code 中輸入 /status，確認金鑰是否正常運作。

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

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

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

Polecenia i zmienne sprawdziliśmy 2026年10月3日 w Claude Code 官方安裝文件 i w 環境變數文件. Polskiej wersji tej dokumentacji nie ma. Ceny i metody płatności sprawdziliśmy 2026年10月3日. Polska jest na Anthropic 支援國家清單 (sprawdzone 2026年10月3日), zarówno dla Claude.ai, jak i dla API.

登入還是 API 金鑰？

安裝 Claude Code 後，必須進行驗證。有兩種方式，本指南詳細說明第二種：

開始之前

方法 1：原生安裝程式（建議）

官方文件中，此方法的分頁標題為「Native Install (Recommended)」。您可以在頁面開頭找到指令。在 macOS、Linux 和 WSL 上，使用含 install.sh 的指令列。在 Windows PowerShell 中使用 irm … | iex，在 CMD 命令提示字元中使用含 install.cmd 的指令列。原生安裝會在背景中自動更新。也可以透過 Homebrew 或 WinGet 安裝 Claude Code，但根據文件，這些安裝預設不會自動更新，因此需要在套件管理員中手動更新：

# Homebrew – kanał stable; domyślnie nie aktualizuje się sam
brew install --cask claude-code

# WinGet (Windows) – domyślnie nie aktualizuje się sam
winget install Anthropic.ClaudeCode

安裝後，開啟新的終端機視窗，因為先前開啟的視窗看不到更新後的 PATH 變數。接著檢查：

claude --version   # wypisuje numer wersji, np. 2.1.280 (Claude Code)
claude doctor      # diagnostyka instalacji i ustawień, bez otwierania sesji

claude doctor 不會開啟工作階段，只會列出安裝狀態和設定檔的診斷資訊。這有助於最快區分安裝問題和設定問題。

下載失敗時

Jeśli terminal pokazuje syntax error near unexpected token '<' albo curl: (22) The requested URL returned error: 403, to według 官方安裝問題頁面 (sprawdzone 2026年10月3日) adres instalatora zwrócił stronę HTML lub kod błędu zamiast skryptu. Strona z napisem App unavailable in region oznacza według dokumentacji, że Claude Code nie jest dostępny w Twoim kraju. Polska jest jednak na liście obsługiwanych krajów, więc jeśli widzisz ten napis w Polsce, sprawdź, czy połączenie nie wychodzi przez VPN albo proxy. Samo 403 bez treści może też pochodzić z firmowego proxy lub zapory, która blokuje pobieranie. Dokumentacja radzi wtedy najpierw sprawdzić połączenie sieciowe, bo inne metody instalacji łączą się z tymi samymi serwerami. Spróbuj z innej sieci albo poproś administratora o odblokowanie tych adresów.

方法 2：npm（Node.js 22 或更新版本）

npm nadal jest jedną z metod opisanych w oficjalnej dokumentacji. Pakiet wymaga Node.js 22 lub nowszego. Część polskich poradników wciąż podaje Node.js 18, co jest już nieaktualne. Na starszym Node.js npm wypisze ostrzeżenie EBADENGINE, ale nie przerwie instalacji, a claude będzie działać, bo pakiet pobiera natywny program, który nie korzysta z Node.js w czasie działania. Jeśli nie masz Node.js, zainstaluj wersję 22 lub nowszą ze nodejs.org 網站.

node -v                                    # potrzebna wersja v22 lub nowsza
npm install -g @anthropic-ai/claude-code   # bez sudo

# aktualizacja: @latest, a nie npm update -g
npm install -g @anthropic-ai/claude-code@latest

• 絕對不要使用 sudo npm install -g。文件警告，這會導致權限問題，並造成安全風險。
• 請透過 @latest 更新。更新時請使用 npm install -g @anthropic-ai/claude-code@latest，而不是 npm update -g。
• 不要略過選用相依套件。正確的程式會以選用相依套件的形式安裝，也就是適用於您平台的 @anthropic-ai/claude-code-* 套件。若使用 --omit=optional 旗標，或在 .npmrc 中設定 optional=false，macOS 或 Linux 上的安裝會以 claude native binary not installed 訊息結束。

Windows 上的 Claude Code：PowerShell、CMD、WSL 與 PATH

Windows 有兩個不同的安裝命令，選擇哪一個只取決於終端機。如果命令列以 PS C:\Users\TwojaNazwa> 開頭，表示您正在使用 PowerShell。如果只看到 C:\Users\TwojaNazwa> 而沒有 PS，則是命令提示字元（CMD）。根據文件，不需要以系統管理員身分啟動終端機，儘管部分指南如此建議。

最常見的錯誤，是將命令貼到錯誤的終端機中。將 CMD 命令列貼到 PowerShell 會顯示 The token '&&' is not a valid statement separator。將 PowerShell 命令列貼到 CMD 會顯示 'irm' is not recognized as an internal or external command。在波蘭文 Windows 中，相同訊息為：「irm」不被辨識為內部或外部命令、可執行程式或批次檔。另一方面，將 macOS 的 curl … | bash 命令列貼到 PowerShell，會以 A parameter cannot be found that matches parameter name 'fsSL' 或 'bash' is not recognized as the name of a cmdlet 錯誤結束。在上述任何情況下，只要使用適用於您終端機的命令列即可。

開始功能表中有兩個項目：「Windows PowerShell」與「Windows PowerShell (x86)」。後者以 32 位元程序執行，因此即使在 64 位元電腦上也會顯示 Claude Code does not support 32-bit Windows 錯誤。請開啟沒有 (x86) 後綴的項目。

Git for Windows jest opcjonalny, ale zalecany. Gdy jest zainstalowany, Claude Code wykonuje polecenia przez dołączony do niego Git Bash, a bez niego przez PowerShell. Jeśli Git jest zainstalowany, ale Claude Code nie znajduje Git Bash, ustaw w bloku env pliku ~/.claude/settings.json zmienną CLAUDE_CODE_GIT_BASH_PATH ze ścieżką do bash.exe. Przykładowa ścieżka z dokumentacji to C:\Program Files\Git\bin\bash.exe.

如果選擇 WSL，請在 WSL 終端機中執行 macOS 和 Linux 的命令列，並在該處啟動 claude，不要在 PowerShell 或 CMD 中啟動。

執行原則錯誤（PowerShell 中的 npm）

在使用 npm 安裝或啟動時出現 npm.ps1 cannot be loaded because running scripts is disabled on this system 訊息，表示 PowerShell 的執行原則封鎖了 npm 產生的啟動指令碼 .ps1。根據文件，您可以允許目前使用者執行本機指令碼（如下方命令），使用 npm.cmd 和 claude.cmd，或改用 PowerShell 的原生安裝程式。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

安裝後無法辨識「claude」命令

command not found: claude 或 'claude' is not recognized 表示安裝目錄不在 PATH 中。原生安裝程式會在 macOS 和 Linux 將程式放在 ~/.local/bin/claude，在 Windows 則放在 %USERPROFILE%\.local\bin\claude.exe。請先開啟新的終端機。如果在 Windows 上仍然無法運作，請按照文件說明，在 PowerShell 中檢查並加入路徑：

# 1. Sprawdź, czy katalog instalacji jest już w PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Brak wyniku? Dopisz go do PATH użytkownika, zamknij i otwórz terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. W nowym terminalu
claude --version

使用 API 金鑰而非登入（無訂閱）

ANTHROPIC_BASE_URL 是 Claude Code 的內建變數。根據官方文件，它會覆寫 API 端點，將請求導向 Proxy 或閘道（gateway）。因此，將 Claude Code 連接至相容於 Anthropic Messages API 的服務，是 Anthropic 預設支援的設定方式。您不需要外掛程式或修改版程式。在 macOS 和 Linux 上，請將變數加入 Shell 設定檔（~/.zshrc 或 ~/.bashrc）：

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # sama domena, bez /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 視窗中檢查設定：

# Działa tylko w tym oknie PowerShella – po zamknięciu znika
$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

若要永久設定，最好將變數填入使用者設定檔 ~/.claude/settings.json（Windows 上為 %USERPROFILE%\.claude\settings.json）中的 env 區塊。根據文件，這個檔案會套用至您的所有專案。如果檔案中已有其他設定，只需加入 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"
  }
}

這六行中的每一行都很容易出錯：

• 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 標頭，在互動模式中必須先核准一次。如果當時拒絕，金鑰會被靜默忽略。您可以在 /config → Use custom API key 中重新啟用。
• ANTHROPIC_MODEL 會選擇主要模型。此處為 Claude Sonnet 5（claude-sonnet-5）。名稱必須與 Kunavo 模型清單中的名稱完全一致。Kunavo 無法辨識名稱末尾帶有日期的舊名稱。
• ANTHROPIC_DEFAULT_OPUS_MODEL 和 ANTHROPIC_DEFAULT_SONNET_MODEL 會將別名 opus 和 sonnet 固定至指定模型。 Według 官方模型設定文件 (sprawdzone 2026年10月3日) dla użytkowników API model domyślny i alias opus wskazują Opus 5.5, a alias sonnet wskazuje Sonnet 5.5. Aliasy z czasem się zmieniają, a wersję przypina się pełną nazwą modelu albo zmiennymi takimi jak te dwie. Zapytanie o model, którego nie ma w Kunavo, zwraca 404. Alias opus przypinamy do Claude Opus 5.5 (claude-opus-5-5), bo kolejny Opus wydany przez Anthropic nie musi być od razu dostępny w Kunavo. Opus 5.5 wymaga Claude Code w wersji 2.1.280 lub nowszej, starszą wersję zaktualizujesz poleceniem claude update. Sonnet 5.5 nie jest obecnie (stan na 2026年10月3日) dostępny w Kunavo, więc bez przypięcia aliasu sonnet do claude-sonnet-5 błąd 404 zwracają /model sonnet, faza wykonania w trybie opusplan i subagenci ustawieni na model: sonnet.
• ANTHROPIC_DEFAULT_HAIKU_MODEL 也會處理背景工作。根據文件，此變數會為別名 haiku 和背景執行的功能選擇模型。在 Kunavo 中，Claude Haiku 4.5 的輸入每百萬 token 費用為 0,70 USD，輸出每百萬 token 費用為 3,50 USD。主要模型 Claude Sonnet 5 的費用為 1,40 USD / 7,00 USD （Anthropic 牌價：2,00 美元 / 10,00 美元），而 Claude Opus 5.5 的費用為 2,80 USD / 14,00 USD（輸入／輸出，每百萬 token）。

Klucza 不 wpisuj do projektowego .claude/settings.json. Według 閘道連接文件 ten plik trafia do repozytorium, a więc do każdego, kto je sklonuje. Pamiętaj też o kolejności pierwszeństwa. Gdy ta sama zmienna jest ustawiona i w powłoce, i w bloku env pliku ustawień, w większości sesji obowiązuje wartość z pliku ustawień. Osobna zasada dotyczy klucza model w pliku ustawień: zmienna ANTHROPIC_MODEL ma przed nim pierwszeństwo, a model działa tylko wtedy, gdy zmiennej nie ma. Jeśli zmiana w powłoce nie działa, najpierw sprawdź plik ustawień. W rozszerzeniu Claude Code dla VS Code zmienne ustawia się w claudeCode.environmentVariables, w ustawieniach użytkownika samego VS Code.

首次啟動與 /status

根據閘道連接文件（已於 2026年10月3日 檢查），在設定 ANTHROPIC_AUTH_TOKEN 後，claude 命令會立即開啟不含登入畫面的工作階段。此變數會立即生效，不需要像 ANTHROPIC_API_KEY 那樣核准。如果您看到的是登入畫面，表示 Claude Code 沒有讀取到金鑰。

金鑰必須位於 Claude Code 在首次設定前會讀取的位置，也就是在 Shell 中透過 export 命令設定，或位於使用者檔案 ~/.claude/settings.json 的 env 區塊中。在互動模式下，專案 .claude/settings.json 或 .claude/settings.local.json 中的 env 區塊，必須完成首次啟動精靈並回答是否信任資料夾後才會生效。如果金鑰只放在專案設定中，首次啟動時仍會看到登入畫面。

在工作階段中輸入 /status，並檢查以下兩行：

• 只有在設定了閘道位址時才會出現 Anthropic base URL。它應顯示 https://api.kunavo.com。如果沒有這一行，表示 ANTHROPIC_BASE_URL 沒有傳遞至工作階段。
• Auth token 顯示名稱為 ANTHROPIC_AUTH_TOKEN，表示使用的是 API 金鑰，而非已儲存的 claude.ai 登入資訊。如果看到含有 claude.ai 帳戶的 Login method，表示變數未生效。

您也可以在啟動 Claude Code 前，使用官方文件中的方法檢查位址與金鑰。方法是傳送要求 1 個輸出 token 的請求，從餘額中扣除象徵性金額。命令會讀取目前 Shell 中的變數，因此即使金鑰位於設定檔中，也請先在此終端機中使用 export 命令設定變數。以 {"id":"msg_ 開頭的 JSON 回應表示位址與金鑰可正常運作。401 代碼表示金鑰遭到拒絕。

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

在 PowerShell 中，相同的檢查如下。如果一切正常，回應中會看到以 msg_ 開頭的 id 欄位：

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

使用 API 金鑰時有哪些不同

• Remote Control 與語音聽寫無法使用。根據文件，這些功能需要 claude.ai 身分驗證，且在 ANTHROPIC_AUTH_TOKEN 啟用時無法運作。自 2.1.196 版起，當 ANTHROPIC_BASE_URL 指向不同於 api.anthropic.com 的主機時，Remote Control 也會停用。
• /fast 會顯示快速模式已停用。根據文件，只有 bearer token 時，Claude Code 會將快速模式視為停用，且不會傳送可用性請求。
• MCP 工具搜尋預設為停用。當 ANTHROPIC_BASE_URL 指向 Anthropic 以外的主機時，就會發生這種情況。
• /context 中的數字為估算值。 Kunavo nie udostępnia endpointu /v1/messages/count_tokens. Według 閘道相容性文件 (sprawdzone 2026年10月3日) Claude Code liczy wtedy tokeny lokalnie na podstawie liczby znaków.

完整的整合說明請參閱Claude Code 整合文件（英文），本指南的英文版本請參閱文章 Install Claude Code。

BLIK 付款：為餘額儲值與取得 API 金鑰

Subskrypcje Claude kupowane przez stronę Anthropic można opłacić wyłącznie kartą kredytową lub debetową (Claude 計費常見問題, sprawdzone 2026年10月3日). BLIK-iem nie zapłacisz za Pro ani za Max. W Kunavo BLIK doładowuje przedpłacone saldo API, z którego Claude Code płaci za tokeny po ustawieniu klucza tak jak wyżej. Wszystkie kroki płatności opisuje poradnik 如何使用 BLIK 支付 Claude 費用, a w skrócie wygląda to tak:

1. 透過電子郵件或 Google 帳戶建立 Kunavo 帳戶。註冊時不需要提供信用卡。
2. 在Billing（帳務）分頁中選擇儲值金額。最低金額為 10 USD，且沒有月費。儲值較高金額可獲得獎勵：100 USD → 110 USD na saldzie, 1000 USD → 1200 USD na saldzie, 5000 USD → 6250 USD na saldzie。
3. Na stronie płatności Stripe kwota jest pokazana w złotych. Wybierz BLIK, wygeneruj w aplikacji bankowej sześciocyfrowy kod, wpisz go i potwierdź płatność w aplikacji. Według Stripe 文件 (sprawdzone 2026年10月3日) kod BLIK jest ważny 2 minuty, a po rozpoczęciu płatności masz 60 sekund na jej zatwierdzenie.
4. 在API 金鑰分頁中建立以 sk-kn- 開頭的金鑰。金鑰只會顯示一次，因此請立即儲存，並填入 ANTHROPIC_AUTH_TOKEN。

Na stronie płatności w złotych oprócz BLIK-a są też karty (Visa, Mastercard), Apple Pay i Google Pay na obsługiwanych urządzeniach oraz Link. Nie ma natomiast Przelewy24, PayU, PayPal ani zwykłego przelewu bankowego. Ceny są ustalone w dolarach, a Stripe przelicza je na złote. Według Stripe 的 Adaptive Pricing 文件 (sprawdzone 2026年10月3日) kurs zawiera opłatę za przewalutowanie w wysokości 2–4%, którą ponosi kupujący. Płacąc kartą w dolarach, unikniesz tej opłaty, choć wtedy obowiązują kurs i opłaty Twojego banku, a BLIK działa tylko w złotych. Dokładną kwotę w złotych zobaczysz na stronie płatności przed potwierdzeniem.

BLIK 僅適用於手動儲值。自動儲值需要已儲存的信用卡或 Link。餘額不會過期，失敗的請求不會收費。Kunavo 不開立增值稅發票，您可以在 Billing（帳務）分頁中查看儲值紀錄。請注意，這是 Kunavo API 餘額儲值，不是 Claude Pro 或 Max 的訂閱費用。

費用是多少（計算範例）

在 Claude Code 中，您需要支付 token 費用。每次請求時，Claude Code 都會重新傳送完整的對話內容，但重複的上下文開頭可能會按照快取讀取費率計費。以下是以 token 計算的費用範例。這不是實測結果，也不是費用上限。所有假設如下：

• 每次請求有 40 000 個輸入 token，其中 36 000（90%）按快取讀取計費，其餘 4000 按快取寫入計費；
• 每次請求會回傳 1000 個輸出 token；
• 單一工作階段共有 50 次此類請求，不包含背景中的 Claude Haiku 4.5 呼叫；
• 在 Kunavo 中，快取讀取費用為輸入費率的 10%，快取寫入費用為輸入費率的 1,25 倍。這些比例適用於 Claude Sonnet 5，清單中的每個模型則依其自身比例計算。

實際費用取決於上下文長度、快取命中次數、回應長度，以及您是否在工作之間使用 /clear 命令清除對話。所有模型的費率請參閱價格表。您可以使用Claude token 費用計算器（英文）估算自己的用量。指南Claude Code 的費用說明何時訂閱方案較划算，以及何時使用 API 較划算。

最常見的錯誤

限制

• Kunavo 不開立增值稅發票。
• BLIK 僅適用於手動儲值。自動儲值需要已儲存的信用卡或 Link。
• 這是按 token 計費的 API，而不是 Claude Pro 或 Max 訂閱。使用 API 金鑰時，Remote Control 與語音聽寫無法使用，/fast 模式已停用，MCP 工具搜尋也預設為停用。
• Kunavo 目前（截至 2026年10月3日）不提供 Sonnet 5.5，因此上方設定會將別名 sonnet 固定至 claude-sonnet-5。未固定模型時，預設別名可能回傳 404。Claude Opus 5.5 固定至別名 opus，需要 Claude Code 2.1.280 或更新版本。
• Claude Code 官方文件與Kunavo 整合文件僅提供英文版本。

常見問題