Claude Codeのインストール：Windows、macOS、Linuxのコマンド、サブスクリプションなしのAPIキー、iDEALでの支払い

Claude Codeは公式コマンド1つでインストールできます。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、および4つのモデル変数を設定し、/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をインストールする

ターミナルを開き、次の行を貼り付けます。

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

これは推奨されるネイティブインストールです。バックグラウンドで自動更新される単独のプログラムが1つインストールされます。claudeコマンドは~/.local/binに配置されます。すでに開いているターミナルには新しいPATHが反映されないため、テストする前に新しいウィンドウを開いてください。WSLではWSLターミナルでまったく同じ行を使用します。

WindowsにClaude Codeをインストールする

Windowsでは2つの行があり、必要なものは開いているウィンドウだけで決まります。プロンプトがPS C:\Users\Naam>で始まる場合はPowerShellです。PSなしでC:\Users\Naam>だけが表示される場合は、コマンドプロンプト（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では、同じ原因で2つ目のメッセージがオランダ語で表示される場合があります。また、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経由

これらも可能ですが、重要な違いが1つあります。公式ドキュメントによると、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の支払い方法を選択します。2つの方法は同時には使用されません。APIキーが設定されている場合、保存済みのログインは使用されません。変数を削除すると、再インストールせずにClaude Codeはログインに戻ります。

方法A：サブスクリプションでログイン

claudeをプロジェクトフォルダーで起動し、ブラウザからログインします。注意点が1つあります。ANTHROPIC_API_KEYがすでに設定されている場合、Claude Codeはそのキーを使用するかどうかを一度だけ確認します。拒否すると、その後は再度確認せずにキーを無視するため、変数が読み込まれていないように見えます。/config → Use custom API keyから再び有効にできます。

方法B：サブスクリプションなしでAPIキーを使用

ANTHROPIC_BASE_URLはClaude Codeに組み込まれた変数です。公式ドキュメントによると、APIエンドポイントを上書きし、プロキシまたはゲートウェイ経由でリクエストを送信します。したがって、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で、まず1つの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が実行されるすべての場所で有効です。シェルの変数はそのターミナルウィンドウでのみ有効です。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 公式ゲートウェイドキュメント (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はAuthorizationヘッダーにBearerを付けて送信され、すぐに有効になります。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トークンコスト計算ツールで計算できます。すべてのモデルと料金は料金ページに掲載されています。

/statusで確認する

claudeを起動します。ANTHROPIC_AUTH_TOKENが設定されている場合、ログイン画面は表示されません。変数はすぐに有効になります。それでもログイン画面が表示される場合、Claude Codeはキーを読み取っていません。その場合は、初回起動ウィザードより前にClaude Codeが読み取る場所、つまりシェルのexportまたは~/.claude/settings.jsonのenvブロックに設定してください。プロジェクトの.claude/settings.jsonまたは.claude/settings.local.jsonにあるenvブロックは、インタラクティブセッションでは初回起動ウィザードとフォルダーの信頼確認が終わった後にのみ有効になります。

Typ in de sessie /status en kijk op het tabblad Status naar twee regels (bron: de 公式ゲートウェイドキュメント, gecontroleerd op 2026年10月3日):

• Anthropic base URLにはhttps://api.kunavo.comが表示される必要があります。この行はゲートウェイアドレスが設定されている場合にのみ表示されます。表示されない場合、ANTHROPIC_BASE_URLはセッションに反映されていません。
• Auth tokenにはANTHROPIC_AUTH_TOKENが表示される必要があります。代わりにclaude.aiアカウントのLogin methodが表示される場合、変数が読み込まれておらず、セッションはサブスクリプションで動作しています。

以前にサブスクリプションでログインしていた場合、起動時にClaude Codeが2つのログイン元が有効であると警告することがあります（メッセージはauth may not work as expectedで終わります）。その場合もリクエストはキー経由で送信されます。/logoutで古いログインを削除できます。

Claude Codeを開く前にアドレスとキーをテストしたい場合は、ドキュメントの提案どおり、出力トークン1つ分のリクエストを送信してください。ごく少量の残高を消費します。コマンドはシェルから変数を読み取るため、すでに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": "."}]}'

{"id":"msg_で始まるJSONレスポンスは、アドレスとキーが機能していることを意味します。PowerShellでは、idがmsg_で始まる形で表示されます。401は、キーが拒否されたことを意味します。

APIキーで利用できるその他の機能

• Remote Controlと音声ディクテーションは利用できません。 どちらもclaude.aiアカウントが必要で、ANTHROPIC_AUTH_TOKENが有効な間は利用できません。さらに、ANTHROPIC_BASE_URLがAnthropic以外のアドレスを指している間はRemote Controlも無効になります。
• /fastはfast modeが無効であることを示します。 bearerトークンだけを使用すると、Claude Codeは確認リクエストを送信せずにfast modeを無効として扱います。
• MCPツール検索はデフォルトで無効です。ANTHROPIC_BASE_URLがAnthropic以外のアドレスを指している場合に該当します。
• /contextの数値は概算です。 Kunavo biedt /v1/messages/count_tokens nu niet aan. Volgens de ゲートウェイ向けの公式互換性ドキュメント (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サーバー、フック、プロンプトキャッシュは通常どおり機能します。詳細は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 Adaptive Pricingに関するStripeのドキュメント (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 (iDEALに関するStripeの説明, gecontroleerd op 2026年10月3日).
• Bancontact, voor België, met je Bancontact-kaart of de app (Bancontactに関するStripeの説明, 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はVAT請求書を発行しません。チャージ履歴はBillingに表示されます。これらの支払い方法でチャージできるのはKunavo APIのクレジットのみで、Claude ProまたはMaxのサブスクリプションの支払いには利用できません。ユーロでの支払いについて詳しくは、iDEALでClaudeに支払うをご覧ください。

よくあるエラー

インストール後

プロジェクトで初めて起動するときは、/initと入力します。Claude Codeがリポジトリを読み取り、見つかったテストコマンドと規約を記載したCLAUDE.mdを作成します。そのファイルを確認し、短く保ってください。毎回のセッションで読み込まれるためです。個別のタスクの間に/clearを実行すると新しい会話が始まり、タスクが長くなると/compactが履歴を要約して作業を続けられるようにします。

知っておくべきこと

• これはトークン単位の従量課金APIであり、Claude ProまたはMaxのサブスクリプションではありません。Claude Codeを毎日何時間も使う場合は、サブスクリプションのほうが安くなることが多く、トークン単位の支払いは利用量が変動する場合に適しています。1か月まったく使わなければ料金はかかりません。比較については、Claude Codeの料金（英語）をご覧ください。
• APIキーでは、Remote Controlと音声入力は利用できません。
• Kunavoでは共有容量を使用し、予約済みのクォータや契約上の保証はありません。これらが必要な場合は、Anthropicと直接契約してください。
• iDEALとBancontactは手動チャージ専用です。自動チャージはカードまたはLinkでのみ利用できます。
• ユーロ建ての金額にはStripeの為替換算手数料が含まれます。KunavoはVAT請求書を発行しません。

よくある質問