Windows、macOS、LinuxにClaude Codeをインストールする方法 — サブスクリプション不要のAPIキーとBLIK決済

Claude Codeは、公式コマンド1つでインストールできます（macOSとLinux、PowerShell、CMD向けのコマンドを以下に示します）。Anthropicはネイティブインストーラーを推奨しています。代替手段としてnpmも利用できますが、Node.js 22以降が必要です。Pro/Maxのサブスクリプションもログインも不要で、ANTHROPIC_BASE_URL=https://api.kunavo.com（/v1は付けません）、APIキーを指定したANTHROPIC_AUTH_TOKEN、モデルを固定する4つの変数を設定するだけで利用できます。その場合、BLIKを使ってポーランド・ズウォティでチャージした残高から、使用したトークンの分だけ支払います。チャージは10 USDから可能です。最後に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 3 października 2026 w Claude Code の公式インストールドキュメント i w 環境変数のドキュメント. Polskiej wersji tej dokumentacji nie ma. Ceny i metody płatności sprawdziliśmy 3 października 2026. Polska jest na Anthropic がサポートする国の一覧 (sprawdzone 3 października 2026), zarówno dla Claude.ai, jak i dla API.

ログインと API キーのどちらを使うか

インストール後、Claude Code は認証する必要があります。方法は 2 つあり、このガイドでは 2 つ目を詳しく説明します。

始める前に

方法 1：ネイティブインストーラー（推奨）

公式ドキュメントでは、この方法に「Native Install (Recommended)」タブがあります。コマンドはページの冒頭にあります。macOS、Linux、WSL では install.sh を含む行を使います。Windows PowerShell では irm … | iex を、CMD では install.cmd を含む行を使います。ネイティブインストールはバックグラウンドで自動的に更新されます。Claude Code は Homebrew や WinGet でもインストールできますが、ドキュメントによると、これらのインストールはデフォルトでは自動更新されないため、パッケージマネージャーで手動更新する必要があります。

# 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 3 października 2026) 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 には 2 種類のインストールコマンドがあり、選択はターミナルによってのみ決まります。行頭が PS C:\Users\TwojaNazwa> なら PowerShell です。PS なしで C:\Users\TwojaNazwa> だけが表示されるなら、コマンドプロンプト（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)」の 2 つがあります。後者は 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 エンドポイントを上書きして、プロキシまたはゲートウェイ（gateway）経由でリクエストを送るために使用します。そのため、Claude Code を Anthropic Messages API 互換サービスに接続することは、Anthropic が想定している設定です。プラグインや改変版プログラムは必要ありません。macOS と Linux では、シェルの設定ファイル（~/.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 の 1 つのウィンドウで設定を確認できます。

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

これら 6 行はいずれも間違えやすい箇所です。

• 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 3 października 2026) 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 3 października 2026) 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 の料金は入力トークン 100 万個あたり 0,70 USD、出力トークン 100 万個あたり 3,50 USD です。メインモデルの Claude Sonnet 5 は 1,40 USD / 7,00 USD （Anthropic の料金：2,00 USD / 10,00 USD）、Claude Opus 5.5 は 2,80 USD / 14,00 USD です（入力 / 出力、トークン 100 万個あたり）。

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

ゲートウェイ接続のドキュメント（3 października 2026確認済み）によると、ANTHROPIC_AUTH_TOKEN を設定すると、claude コマンドはすぐにログイン画面なしでセッションを開きます。この変数はすぐに有効になり、ANTHROPIC_API_KEY のように承認する必要はありません。代わりにログイン画面が表示される場合、Claude Code はキーを読み取れていません。

Claude Code が初期設定前にキーを読み取れる場所、つまりシェルで export コマンドによって設定するか、ユーザーの ~/.claude/settings.json ファイルの env ブロックに記述する必要があります。インタラクティブモードでは、プロジェクトの .claude/settings.json または .claude/settings.local.json にある env ブロックは、初回起動ウィザードとフォルダーの信頼に関する質問の後で初めて有効になります。プロジェクト設定にのみキーがある場合、初回起動時にはログイン画面が表示されます。

セッションで /status と入力し、次の 2 行を確認します。

• Anthropic base URL は、ゲートウェイアドレスが設定されている場合にのみ表示されます。https://api.kunavo.com と表示されるはずです。この行がない場合、ANTHROPIC_BASE_URL はセッションに届いていません。
• Auth token に ANTHROPIC_AUTH_TOKEN という名前が表示されていれば、保存済みの claude.ai ログインではなく API キーが機能しています。claude.ai アカウントの Login method が表示される場合、変数は機能していません。

Claude Code を起動する前に、公式ドキュメントの方法でアドレスとキーを確認することもできます。これは出力トークン 1 個を要求するリクエストを送信し、残高から象徴的な金額を差し引く方法です。コマンドは現在のシェルの変数を読み取るため、キーが設定ファイルにある場合でも、まずこのターミナルで 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 トークンだけの場合、Claude Code は fast mode を無効として扱い、利用可能かどうかのリクエストを送信しません。
• MCP ツールの検索はデフォルトで無効です。 これは ANTHROPIC_BASE_URL が Anthropic 以外のホストを指している場合に発生します。
• /context の数値は推定値です。 Kunavo nie udostępnia endpointu /v1/messages/count_tokens. Według ゲートウェイ互換性のドキュメント (sprawdzone 3 października 2026) 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 の請求に関する FAQ, sprawdzone 3 października 2026). 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 3 października 2026) 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 Adaptive Pricing に関する Stripe のドキュメント (sprawdzone 3 października 2026) 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 は VAT 請求書を発行せず、チャージ履歴は「請求（Billing）」タブで確認できます。これは Claude Pro や Max の料金ではなく、Kunavo API 残高へのチャージであることに注意してください。

料金はいくらですか（計算例）

Claude Code ではトークンに対して料金を支払います。各リクエストで Claude Code は会話コンテキスト全体を再送しますが、コンテキストの繰り返される冒頭部分は、キャッシュ読み取り料金で精算される場合があります。以下はトークンを使った計算例です。測定値でもコスト上限でもありません。すべての前提を示します。

• 各リクエストには入力トークンが 40 000 個あり、そのうち 36 000 個（90%）はキャッシュ読み取りとして、残りの 4000 個はキャッシュ書き込みとして精算されます。
• 各リクエストは出力トークンを 1000 個返します。
• 1 回の作業セッションにはこのようなリクエストが 50 件あり、バックグラウンドでの Claude Haiku 4.5 呼び出しはありません。
• Kunavo では、キャッシュ読み取りは入力料金の 10%、キャッシュ書き込みは入力料金の 1,25×です。これは Claude Sonnet 5 に対する比率であり、一覧にある各モデルはそれぞれ固有の比率で計算されます。

実際のコストは、コンテキストの長さ、キャッシュヒット数、応答の長さ、タスク間で /clear コマンドを使って会話を消去するかどうかによって異なります。すべてのモデルの料金は 料金表で確認できます。自分の使用量はClaude トークンコスト計算ツール（英語）で見積もれます。サブスクリプションと API のどちらが得かについては、Claude Code の料金はいくらかというガイドで説明しています。

よくあるエラー

制限事項

• KunavoはVAT請求書を発行していません。
• BLIKは手動チャージでのみ利用できます。自動チャージには、保存済みのカードまたはLinkが必要です。
• これはトークン単位で課金されるAPIであり、Claude ProまたはMaxのサブスクリプションではありません。APIキーではRemote Controlと音声ディクテーションは利用できず、/fastモードは無効になり、MCPツール検索もデフォルトで無効です。
• Kunavoは現在（3 października 2026時点）Sonnet 5.5を提供していないため、上記の設定ではエイリアスsonnetをclaude-sonnet-5に固定しています。モデルを固定しないと、デフォルトのエイリアスが404を返す場合があります。Claude Opus 5.5はエイリアスopusに固定されており、Claude Code 2.1.280以降が必要です。
• Claude Codeの公式ドキュメントとKunavo統合ドキュメントは英語のみです。

よくある質問