Claude Code のインストール方法【Windows・Mac】— サブスクなしの API キー設定と JCB・Apple Pay での支払い

Claude Code のインストールは、公式のネイティブインストーラーを 1 行実行するだけです。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、モデルを固定する 3 つの変数を設定すれば、ログインなしで起動できます。動いているかは /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日確認）。

そのうえで、コマンドを貼る前に 2 つだけ確認してください。

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 ではなく、Claude などのモデルへの API アクセスを前払いで提供している独立した API ゲートウェイです。Claude Code には送信先を差し替える ANTHROPIC_BASE_URL という変数が公式に用意されていて、公式ドキュメントにも「Claude Code を LLM ゲートウェイに接続する」というページがあります。プラグインや改造版は使いません。この変数が変えるのは送信先だけで、どのモデルが答えるかは別の変数で決まります（モデル設定、2026年10月3日確認）。

設定するのは次の 5 つです。

Mac・Linux なら、シェルの設定ファイル（~/.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
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"
$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",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

置き場所について、3 つ注意があります。

• プロジェクトの .claude/settings.json にはキーを書かないでください。リポジトリにコミットされ、クローンした人全員に渡ります（公式ドキュメント）。
• シェルと設定ファイルの両方に同じ変数があると、設定ファイルの値が使われます。export し直しても変わらないときは、設定ファイルを見てください。
• VS Code 拡張機能で使うときは、VS Code のユーザー設定の claudeCode.environmentVariables に同じ変数を入れます。

ANTHROPIC_AUTH_TOKEN を使う理由

ANTHROPIC_AUTH_TOKEN は Authorization: Bearer ヘッダーで送られ、設定した時点で有効になります。一方の ANTHROPIC_API_KEY は x-api-key ヘッダーで送られ、対話モードでは初回に 1 回、使ってよいかの承認を求められます。ここで拒否すると、その後は何も表示されないままキーが無視され、/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 になります。/model sonnet を使うなら ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 も足してください。

固定しておくと、費用の見通しも立てやすくなります。何も指定しないと既定モデルが Opus になり、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 が $3.50 / $17.50 です。ANTHROPIC_DEFAULT_HAIKU_MODEL を設定しないと、ANTHROPIC_AUTH_TOKEN で接続したセッションでは claude --resume 用の会話要約などのバックグラウンド処理もメインのモデルで動きます（ゲートウェイ互換性ガイド、2026年10月3日確認）。なお Anthropic の料金ページでは、Sonnet 5 と Opus 5 は「レガシーモデル」の欄に移っています（2026年10月3日確認）。

動作確認は 3 段階で

1. 起動する前に、URL とキーだけを試す

公式ドキュメントと同じ、出力 1 トークンだけのリクエストです（残高からごくわずかに引かれます）。シェルの変数を読むので、キーを設定ファイルにしか書いていない場合は、このターミナルで 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 はウィザードとフォルダーの信頼確認が終わってから読み込まれるので、初回起動の時点ではキーがないものとして扱われます。シェルの export か、ユーザーの ~/.claude/settings.json に移してください。

3. /status の 2 行を見る

セッションの中で /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 は無効と表示されます。ベアラートークンだけで認証していると、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 はトークンの従量課金です。Claude Code はリクエストのたびに会話の文脈をまとめて送りますが、前回と同じ先頭部分はキャッシュ読み取りの単価になることがあります。下の表は、1 リクエストの入力を 40,000 トークン（うち 36,000 = 90% がキャッシュ読み取り、残り 4,000 がキャッシュ書き込み）、出力を 1,000 トークンとし、1 回の作業を 50 リクエストと仮定した計算です。バックグラウンドの Claude Haiku 4.5 呼び出しは含めていません。Kunavo のキャッシュ単価は、Claude Sonnet 5 の場合で読み取りが入力単価の 10%、書き込みが 1.25 倍です（表の各モデルはそれぞれの比率で計算）。実測値でも上限でもありません。

実際の金額は、文脈の長さ、キャッシュの効き方、応答の長さ、作業ごとに /clear するかどうかで変わります。全モデルの単価は料金ページ、自分の使い方での見積もりは Claude のトークン料金計算ツール（英語）、モデル別の 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 の使い方で順に説明しています。

よくある質問