Claude Code 安裝方法【Windows・Mac】——無訂閱的 API key 設定與使用 JCB・Apple Pay 付款

安裝 Claude Code 只需執行官方原生安裝程式的一行命令。Mac、Linux 和 WSL 使用 install.sh，Windows 若使用 PowerShell，請使用 install.ps1；若使用 CMD，請使用 install.cmd（也可以透過 npm 安裝，但此時需要 Node.js 22 以上）。通常接著會使用 Pro、Max 等方案登入；若不訂閱，則設定 ANTHROPIC_BASE_URL=https://api.kunavo.com（不要加上 /v1）、包含 API 金鑰的 ANTHROPIC_AUTH_TOKEN，以及固定模型的 4 個變數，即可不登入啟動。可透過 /status 確認是否正常運作。API 餘額可使用 JCB 等卡片、Apple Pay、Google Pay 和 Link 從$10開始預付，付款畫面會以日圓顯示。

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

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

:: Windows コマンドプロンプト（CMD）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

インストール手順の一次情報は、日本語で読める Anthropic の公式ドキュメント（設定、安裝疑難排解、2026年10月3日確認）です。このページはその内容をなぞるのではなく、日本語の解説記事で食い違っている点（Node.js のバージョン、Windows の管理者権限と Git）と、公式ドキュメントが扱っていないこと——ログインせずに API キーで動かす設定と、日本からの支払い——を中心にまとめています。料金と決済手段は 2026年10月3日時点の情報です。日本は Anthropic の支援國家清單に、Claude.ai と API の両方で載っています（2026年10月3日確認）。

先決定：使用訂閱登入，還是使用 API 金鑰執行

安裝本身兩者相同，差異在第一次啟動之後。Claude Code 啟動時會要求驗證。若不確定，可依照以下 3 點判斷。

• 已訂閱 Pro、Max、Team 或 Enterprise，或擁有 Console 帳戶：直接登入即可使用。不需要設定本頁的 API 金鑰。免費方案不包含 Claude Code。
• 不想每月支付固定費用，且每月使用量差異很大：API キーで動かし、使ったトークン分だけ払う形が合います。参考までに、Claude のサブスクは Pro が月 $20（年払いは $200 で月 $17 相当）、Max は月 $100 からで、いずれも税別です（Claude 價格頁面、2026年10月3日確認）。どちらが安くなるかの分岐点は Claude Code 的價格で試算しています。
• 想使用 Remote Control 或語音輸入：兩者都需要 claude.ai 帳戶，因此無法使用 API 金鑰。請選擇登入。

支払い手段も違います。Anthropic の Web サイトで契約するサブスクはクレジットカードかデビットカードのみで、iPhone・Android アプリから契約した場合は App Store・Google Play が決済します（Anthropic 說明中心、英語版、2026年10月3日確認）。Kunavo の API 残高は、JCB を含むカード、Apple Pay、Google Pay、Link でチャージします（詳しくは後半の支払いの章）。

安裝前檢查

條件如官方文件所述（2026年10月3日確認）。右欄說明如何在本機確認。

選擇安裝方式

官方文件標示「建議」使用原生安裝程式。與其他方式的差異主要在更新方式。

# Homebrew（既定では自動更新されない）
brew install --cask claude-code

# WinGet（Windows・既定では自動更新されない）
winget install Anthropic.ClaudeCode

無論使用哪種方式，完成後都要重新開啟終端機再確認。因為安裝前已開啟的視窗可能尚未載入新的 PATH。claude doctor 不會開始工作階段，只會顯示安裝和設定狀態，因此可用於無法正常運作時的問題排查。

claude --version   # 2.1.211 (Claude Code) のようなバージョン番号が出れば OK
claude doctor      # セッションを開かずに、インストールと設定を診断する

使用 npm 安裝時的注意事項

日本語の解説記事では今も「Node.js 18 以上」という記載をよく見かけますが、公式ドキュメントの要件はNode.js 22 以上です（官方文件、2026年10月3日確認）。古い Node.js でも npm は EBADENGINE の警告を出すだけでインストールを止めず、claude も起動しますが、警告が出たら Node.js を上げておくほうが安全です。nvm や Volta などでバージョンを切り替えている場合は、インストールするシェルで node -v を確かめてください。

node -v                                    # v22 以上であること
npm install -g @anthropic-ai/claude-code   # sudo は付けない

# 更新は @latest で（npm update -g は使わない）
npm install -g @anthropic-ai/claude-code@latest

官方文件明確要求不要使用 sudo npm install -g。此外，主程式二進位檔會以選用相依項目安裝，因此如果在 --omit=optional 或 .npmrc 的 optional=false 中省略選用相依項目，Mac、Linux 會顯示 claude native binary not installed 並無法啟動。

在 Windows 上安裝時的重點

まず、ネットでよく見る 2 つの手順は不要です。「PowerShell を管理者として実行」と「Git for Windows を先に入れる」は、どちらも公式ドキュメントの要件ではありません。不需要系統管理員權限，Git for Windows 為選用項目で、入っていなければ Claude Code は PowerShell でコマンドを実行します（Windows 設定、2026年10月3日確認）。

接著，在貼上命令前只需確認兩件事。

1. 目前開啟的是 PowerShell 還是 CMD。如果提示字元為 PS C:\Users\ユーザー名>，請使用 PowerShell 的 irm 那一行；如果是沒有 PS 的 C:\Users\ユーザー名>，請使用 CMD 的 install.cmd 那一行。混用時，PowerShell 會出現無法將 && 識別為分隔符號的錯誤，CMD 則會出現無法識別 irm 的錯誤（使用日文介面的 Windows 時，訊息可能會以日文顯示）。
2. 是否開啟了「Windows PowerShell (x86)」。開始選單中標示 (x86) 的版本是 32 位元程序，因此即使電腦為 64 位元，也會因 Claude Code does not support 32-bit Windows 而停止。

在 Windows 上有 3 種執行方式。不確定時，直接從原生方式開始即可。

即使已安裝 Git for Windows，若 Claude Code 找不到 Git Bash，請在使用者設定檔的 env 中，於 CLAUDE_CODE_GIT_BASH_PATH 寫入 bash.exe 的位置。

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

安裝後 claude 無法運作時

'claude' is not recognized（Mac、Linux 則為 command not found: claude）表示安裝位置不在 PATH 中。原生安裝程式的位置在 Windows 為 %USERPROFILE%\.local\bin\claude.exe，Mac、Linux 為 ~/.local/bin/claude。重新開啟終端機後仍未修復時，請依照官方文件的步驟，從 PowerShell 確認並新增。

# 1. インストール先が PATH に入っているか確認する
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. 何も出なければユーザーの PATH に追加し、ターミナルを開き直す
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. 新しいターミナルで
claude --version

npm で入れた場合に npm.ps1 cannot be loaded because running scripts is disabled on this system （起動時なら claude.ps1）と出るのは、PowerShell の実行ポリシーが npm の .ps1 スクリプトを止めているためです（官方文件、2026年10月3日確認）。現在のユーザーにだけローカルのスクリプト実行を許可する次のコマンドで解消します。ポリシーを変えたくなければ、npm.cmd・claude.cmd を使うか、PowerShell 用のネイティブインストーラーに切り替えてください。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

不登入、使用 API 金鑰執行的設定

Kunavo 不是 Anthropic，而是獨立的 API 閘道，提供 Claude 等模型的 API 存取權，並採預付方式收費。Claude Code には送信先を差し替える ANTHROPIC_BASE_URL という変数が公式に用意されていて、公式ドキュメントにも「將 Claude Code 連接至 LLM 閘道」というページがあります。プラグインや改造版は使いません。この変数が変えるのは送信先だけで、どのモデルが答えるかは別の変数で決まります（模型設定、2026年10月3日確認）。

需要設定以下 6 項。

Mac、Linux 請追加至 Shell 設定檔（~/.zshrc 或 ~/.bashrc），然後重新開啟終端機。

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # ドメインだけ。/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 視窗中執行以下內容。關閉視窗後設定就會消失。

# このウィンドウの中だけで有効（閉じると消える）
$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 中。這會套用至所有專案，且 Mac 和 Windows 使用相同寫法即可。若檔案中已有其他設定，請只加入 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"
  }
}

關於儲存位置，有 3 點注意事項。

• プロジェクトの .claude/settings.json には不要寫入金鑰でください。リポジトリにコミットされ、クローンした人全員に渡ります（官方文件）。
• 如果 Shell 和設定檔中都有相同變數，會使用設定檔中的值。重新執行 export 後仍未變更時，請查看設定檔。
• 使用 VS Code 擴充功能時，請在 VS Code 使用者設定的 claudeCode.environmentVariables 中加入相同變數。

使用 ANTHROPIC_AUTH_TOKEN 的理由

ANTHROPIC_AUTH_TOKEN 會透過 Authorization: Bearer 標頭傳送，設定後立即生效。另一方面，ANTHROPIC_API_KEY 會透過 x-api-key 標頭傳送，互動模式第一次會要求核准是否可使用。若在此拒絕，之後金鑰會在沒有任何提示的情況下被忽略，直到在 /config 的 Use custom API key 中重新啟用為止。Kunavo 接受透過這兩種標頭傳送的金鑰，因此ANTHROPIC_API_KEY也能運作，但使用 ANTHROPIC_AUTH_TOKEN 就沒有這個陷阱，更加可靠。官方文件也建議，在未指定金鑰類型時使用 ANTHROPIC_AUTH_TOKEN。

固定模型的理由（截至 2026年10月3日）

官方文件（2026年10月3日確認）によると、API キーで使う場合、既定モデルと opus エイリアスは Opus 5.5、sonnet エイリアスは Sonnet 5.5 を指します。エイリアスの行き先は新しいモデルが出るたびに変わりますが、Kunavo で同じ日から使えるとは限りません。実際、Kunavo は 2026年10月3日時点で Sonnet 5.5 を提供していないので、固定せずに /model sonnet を選ぶと 404 になります。opusplan の実行フェーズや、model: sonnet を指定したサブエージェントも同じです。そのため上の設定では ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 で sonnet エイリアスも固定しています。opus エイリアスも、行き先が次の Opus に変わっても困らないよう ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 で Claude Opus 5.5 に固定しています。Claude Opus 5.5 には Claude Code v2.1.280 以降が必要なので、古い場合は claude update で更新してください。

固定しておくと、費用の見通しも立てやすくなります。何も指定しないと既定モデルが Claude Opus 5.5 になり、Claude Sonnet 5 をメインにした場合より 1 トークンあたりの単価が上がります。Kunavo の単価（1M トークンあたり、入力 / 出力）は、Claude Haiku 4.5 が $0.70 / $3.50、Claude Sonnet 5 が $1.40 / $7.00（Anthropic 的價格為 $2.00 / $10.00）、Claude Opus 5.5 が $2.80 / $14.00 です。ANTHROPIC_DEFAULT_HAIKU_MODEL を設定しないと、ANTHROPIC_AUTH_TOKEN で接続したセッションでは claude --resume 用の会話要約などのバックグラウンド処理もメインのモデルで動きます（閘道相容性指南、2026年10月3日確認）。なお Anthropic の價格頁では、メインに固定している Sonnet 5 は「レガシーモデル」の欄に移っています（2026年10月3日確認）。

分 3 個階段確認運作狀態

1. 啟動前，只測試 URL 和金鑰

這是與官方文件相同、只輸出 1 個 Token 的請求（會從餘額中扣除極少金額）。因為會讀取 Shell 變數，若只將金鑰寫入設定檔，請先在此終端機執行 export 再執行。若傳回以 {"id":"msg_ 開頭的 JSON 和 200，表示 URL 與金鑰均正常；若為 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 的情況如下；如果傳回的 id 以 msg_ 開頭，即表示成功。

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

2. 啟動 claude，確認不會出現登入畫面

第一次會顯示初次執行精靈和資料夾信任確認，但之後不會要求在瀏覽器中登入。如果要求登入，表示金鑰未傳遞到位。

常見原因是只將金鑰寫入專案的 .claude/settings.json 或 .claude/settings.local.json。在互動式工作階段中，專案設定的 env 會在精靈和資料夾信任確認完成後才載入，因此第一次啟動時會被視為沒有金鑰。請將其移至 Shell 的 export 或使用者的 ~/.claude/settings.json。

3. 查看 /status 的兩行

セッションの中で /status を実行し、Status タブを確認します（官方文件、2026年10月3日確認）。

• Anthropic base URL 中應出現 https://api.kunavo.com。這一行只會在設定閘道時出現，因此若整行都不存在，表示 ANTHROPIC_BASE_URL 未傳遞到工作階段。
• Auth token 中應顯示 ANTHROPIC_AUTH_TOKEN。如果改為顯示 claude.ai 帳戶的 Login method，表示目前使用已儲存的登入狀態。

使用 API 金鑰執行時的差異

• 無法使用 Remote Control 和語音輸入。兩者都以 claude.ai ID 為前提，因此在ANTHROPIC_AUTH_TOKEN等閘道驗證資訊有效期間會停用。v2.1.196 以上時，只要 ANTHROPIC_BASE_URL 指向 Anthropic 以外的主機，Remote Control 就會停用。
• /fast 會顯示為停用。如果只使用 Bearer Token 驗證，Claude Code 不會詢問高速模式是否可用，而會將其視為停用，並顯示 Fast mode has been disabled by your organization。
• /context 的數字為估算值。Kunavo は /v1/messages/count_tokens を提供していないため、Claude Code は文字数ベースの推定に切り替えます（閘道相容性指南、2026年10月3日確認）。

Kunavo 端的詳細設定請參閱Claude Code 整合文件和 ANTHROPIC_BASE_URL 文件（兩者皆為英文）。

API 餘額付款：JCB・Apple Pay・Google Pay・Link

先整理從日本付款時常被詢問的事項。

步驟共有 4 個。首先註冊 Kunavo（使用電子郵件地址或 Google 帳戶；註冊時不會要求提供卡片資訊）。接著在控制面板的 Billing 中選擇儲值金額。最低為$10，沒有月費，大額儲值會附贈獎勵（$100 で残高 $110、$1,000 で残高 $1,200、$5,000 で残高 $6,250）。在 Stripe 付款畫面中選擇上述方式完成付款後，最後在 API Keys 中建立 sk-kn- 金鑰，並填入 ANTHROPIC_AUTH_TOKEN。金鑰只會在建立時顯示一次，請當場複製。

餘額沒有有效期限，失敗的請求不會收費。在日本支付 Claude 訂閱時可使用哪些方式（包括透過 App Store、Google Play），已在Claude 的付款方式中附上來源整理。

費用估算（試算）

使用 API 金鑰執行的 Claude Code 採 Token 用量計費。Claude Code 每次請求都會完整傳送對話脈絡，但與上次相同的開頭部分可能適用快取讀取單價。下表假設每個請求的輸入為 40,000 個 Token（其中 36,000 = 90% 為快取讀取，剩餘 4,000 為快取寫入），輸出為 1,000 個 Token，且一次工作需要 50 個請求。未包含背景的 Claude Haiku 4.5 呼叫。Kunavo 的快取單價在Claude Sonnet 5情況下，讀取為輸入單價的 10%，寫入為 1.25 倍（表中各模型均依各自的比例計算）。這不是實測值，也不是上限。

實際金額會因脈絡長度、快取命中情況、回應長度，以及每項工作是否執行 /clear 而有所不同。所有模型的單價可在價格頁面查看；依自身使用方式的估算可使用 Claude Token 費用計算工具（英文）；各模型的 API 單價則可在Claude API 價格查看。

常見錯誤與處理方式

不適合使用此方式的情況

• 費用報銷必須提供合格請求書。Kunavo 的結帳不會開立發票，也不會開立附有登錄號碼的合格請求書。
• 想使用便利商店付款或 PayPay。兩者都不支援，銀行轉帳和電信商代收也不支援。自動儲值僅支援已儲存的卡片或 Link。
• 要使用 Remote Control 或語音輸入。API 金鑰無法使用，且 /fast 也會顯示為停用。請透過訂閱登入。
• 想使用 Sonnet 5.5。Kunavo 在 2026年10月3日時尚未提供。
• 想只使用日文文件完成設定。Claude Code 本體的官方文件可用日文閱讀，但 Kunavo 的整合文件僅提供英文。

接下來要做的事

確認 /status 後，在要工作的專案目錄中啟動 claude，先使用 /init 建立 CLAUDE.md。CLAUDE.md 應寫入哪些內容、如何減少確認對話框，以及如何建立自訂命令，會依序在Claude Code 使用方式中說明。

常見問題