Claude Codeインストールガイド — macOS、Windowsのコマンド、インストール後のサブスクリプションまたはAPIキー接続

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の行）を実行します。インストール後、新しいターミナルを開き、claude --versionで確認してからclaudeを実行して開始します。初回接続には2つの方法があります。Pro、Max、Team、Enterprise、またはConsoleアカウントでログインする方法（Claude.ai無料プランにはClaude Codeは含まれません）と、ANTHROPIC_BASE_URLおよびANTHROPIC_AUTH_TOKENという2つの環境変数を設定して従量課金のAPIキーを使う方法です。APIキーを使う方法では、サブスクリプションは一切不要です。

コマンド確認日：2026年9月11日、Anthropic公式インストール文書に基づきます。このページではインストールと初回接続だけを説明します。インストール後の日常的な使い方はClaude Codeチュートリアルを参照してください。

インストール前の確認

macOSへのインストール

「ターミナル」を開き、この行を貼り付けます：

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

これは公式推奨のネイティブインストール方法です。独立した実行ファイルがインストールされ、バックグラウンドで自動更新されます。実行ファイルの入口は~/.local/bin/claudeです。開いたままのターミナルは新しいPATHを読み込まないため、インストール後は新しいウィンドウを開いてください。LinuxとWSLでも同じコマンドを使います。

Windowsへのインストール

Windowsには異なる2つのコマンドがあり、違いは開いているターミナルの種類だけです。プロンプトがPS C:\Users\你的名字>ならPowerShell、PSがなくC:\Users\你的名字>だけならコマンドプロンプト（CMD）です。管理者として実行する必要はありません。

# 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

貼り付け先を間違えるのがWindowsで最も一般的な失敗です。PowerShellでCMDの行を実行するとThe token '&&' is not a valid statement separator、CMDでPowerShellの行を実行すると'irm' is not recognized as an internal or external commandが表示されます。macOSのcurl … | bashをPowerShellに貼るとA parameter cannot be found that matches parameter name 'fsSL'が表示されます。いずれも対応する行に戻せば解決します。

Git for Windowsを別途インストールすることを推奨します。Claude Codeは付属のGit Bashでコマンドを実行し、未インストールならPowerShellを使います。インストール済みなのにGit Bashが見つからない場合は、設定ファイルのenvセクションにCLAUDE_CODE_GIT_BASH_PATHを追加し、bash.exeのパスを指定してください。

WSLを選ぶ場合は、WSLのターミナル内で上記のmacOS／Linux行を実行し、claudeもWSL内で起動してください。PowerShellやCMDからではありません。

パッケージマネージャーでインストール

既存のパッケージマネージャーで管理することもできますが、デフォルトでは自動更新されないため、自分で定期的に更新する必要があります（例：brew upgrade claude-code、winget upgrade Anthropic.ClaudeCode）。Debian／Ubuntu、Fedora／RHEL、Alpineには公式署名済みのapt、dnf、apkリポジトリもあります。

# Homebrew（macOS、Linux）— stable 通道
brew install --cask claude-code

# WinGet（Windows）
winget install Anthropic.ClaudeCode

# npm — 需要 Node.js 22 以上；絕對不要加 sudo
npm install -g @anthropic-ai/claude-code

npm経由ではv2.1.198以降Node.js 22以上が必要です。古いバージョンではnpmがEBADENGINE警告を表示するだけで、インストールは完了します。ネイティブインストーラーと同じ実行ファイルをインストールし、実行時にNode.jsは不要です。sudo npm install -gは絶対に使わないでください。権限問題とセキュリティリスクが残ります。

インストール成功の確認

claude --version   # 正常會印出版本號，例如 2.1.211 (Claude Code)
claude doctor      # 唯讀的安裝與設定診斷，不會開啟工作階段

claude doctorを覚えておく価値があります。作業セッションは開始せず、インストール状態、設定ファイルのエラー、推奨修正だけを表示するため、「インストールの問題」か「設定の問題」かを最速で判別できます。

command not found: claude、またはWindowsで'claude' is not recognizedが表示される場合、インストール先がPATHにありません。macOS／Linuxではまず新しいターミナルを開き、それでもだめなら~/.local/binを~/.zshrcまたは~/.bashrcのPATHに追加します。Windowsの場所は%USERPROFILE%\.local\binです。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. 重開後再確認一次；若有兩份安裝，這行會列出兩個路徑
where.exe claude

初回接続：サブスクリプションログインまたは従量課金キー

ルートA：サブスクリプションアカウントでログイン

プロジェクトフォルダーでclaudeを実行し、ブラウザーの指示に従ってPro、Max、Team、Enterprise、またはConsoleアカウントでログインします。環境にANTHROPIC_API_KEYがある場合、Claude Codeはそのキーを使うか一度確認します。そこで拒否すると、その後はキーを黙って無視します。再有効化するには/config内のUse custom API keyを選択します。

ルートB：サブスクリプションなしで従量課金キーを使用

Claude CodeはネイティブにANTHROPIC_BASE_URLをサポートするため、Anthropic Messages APIを提供する任意のエンドポイントを指す設定は公式に対応しています。手順はアカウント登録、チャージ（最低$10）、キー管理ページでsk-kn-で始まるキーを作成し、下記の変数を設定することです。macOS／Linux：

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ウィンドウから試す場合：

# 只對這個 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のenvセクションに書くことを推奨します（Windowsでは%USERPROFILE%\.claude\settings.json）。ここに書けば各ターミナル、エディター拡張、バックグラウンドプロセスが読み取れます。既存の設定があれば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は使わないでください。両者は異なるHTTPヘッダーに入り、前者はAuthorization: Bearerを送って即時有効、後者はx-api-keyを送り、上記の一度きりの確認が必要です。
• ANTHROPIC_MODELには完全で正確なモデル名を書きます。Kunavoは完全一致する名前だけを認識し、日付サフィックス付きの旧名を自動対応しません。
• ANTHROPIC_DEFAULT_OPUS_MODEL は opus エイリアスを担当します。Claude Codeのデフォルトモデルと opus エイリアスはいずれも最新のOpusを指します。Kunavoがまだ提供していない場合は404が返るため、この行と ANTHROPIC_MODEL は固定する必要があります。ここでは opus エイリアスをOpus 5.5（claude-opus-5-5）に固定します。Claude Code v2.1.280以降が必要で、旧バージョンでは先に claude update を実行してください。
• ANTHROPIC_DEFAULT_SONNET_MODEL は sonnet エイリアスを担当します。 Anthropic APIでは、sonnet エイリアスはSonnet 5.5を指しますが、Kunavoはこのモデルを提供していません。固定しない場合、/model sonnet、opusplan の実行フェーズ、および model: sonnet に設定したサブエージェントが404を返します。そのため、ここでも Claude Sonnet 5（claude-sonnet-5）に固定します。
• ANTHROPIC_DEFAULT_HAIKU_MODELはバックグラウンド呼び出しを担当します。Claude Codeが作成する要約とタイトルはこのモデルを使います。Claude Haiku 4.5は1M tokenあたり$0.70 / $3.50、主力のClaude Sonnet 5は$1.40 / $7.00です（Anthropic公式と同価格）。

キーをプロジェクト内のに.claude/settings.json書かないでください。そのファイルはcommitされ、cloneした全員に共有されます。VS Code拡張では、拡張が起動前に資格情報を確認するため、変数をVS Codeユーザー設定のclaudeCode.environmentVariablesに置きます。

どのルートで接続しているか確認

Claude Codeに入って/statusを実行します。Auth tokenの行があればキーが有効です。Login methodとclaude.aiアカウントが表示されるなら、変数は読み込まれていません。両者は重複せず、キー変数がある間はログイン済みサブスクリプションが保留されます。変数を削除すれば再インストールなしでサブスクリプションに戻ります。

ゲートウェイ経由では3点が異なります。Remote Controlと音声入力はclaude.aiアカウントでの認証が必要なため使えません。/fastの可用性チェックはAnthropicへ直接問い合わせるため利用不可と表示される可能性がありますが、通常のリクエストには影響しません。/contextの数値はローカルでの推定値になります。コーディング、ツール、サブエージェント、MCP、hooks、プロンプトキャッシュは通常どおり動作します。詳細はClaude Code統合ドキュメントとClaude Code APIキーガイド（いずれも英語）を参照してください。

よくあるエラー対照表

インストール後

初めてプロジェクトに入ったら、/initを実行してプロジェクト全体を読み込み、CLAUDE.mdを生成します。タスクごとのOpus、Sonnet、Haikuの切り替え、セッション費用、/clearと/compactで費用を抑える方法はClaude Codeチュートリアルで説明しています。

どちらを選ぶべきかも率直に言うと、毎日長時間使い利用量が大きい人は固定月額のサブスクリプションが通常有利です。従量課金は利用量の変動が大きい人や5時間の利用ウィンドウに縛られたくない人向けで、使わない月は$0です。Kunavoは共有容量で、専用割当も契約SLAもありません。これらが必要なチームはAnthropicから直接購入すべきです。両ルートの月額と損益分岐点はClaude Codeの費用にあります。

よくある質問