Windows、macOS、LinuxにClaude Codeをインストールする方法 — サブスクリプションなしで使う方法

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を実行します。最初に役立つコマンドは/initです。接続方法は2つあります。Pro、Max、Team、Enterprise、またはConsoleアカウントでログインする方法（Claude.aiの無料プランにはClaude Codeが含まれません）と、ANTHROPIC_BASE_URLおよびANTHROPIC_AUTH_TOKENの2つの環境変数を定義し、サブスクリプションなしで従量課金のAPIキーを使う方法です。

2026年9月11日時点で確認済みのコマンド。Anthropic公式インストールドキュメントに基づきます。

要件

macOSとLinuxにインストールする

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

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

推奨される方法です。バックグラウンドで自動更新される独立したバイナリをインストールします。実行ファイルは~/.local/bin/claudeに配置されます。すでに開いていたターミナルでは新しいPATHが認識されないため、試す前に別のウィンドウを開いてください。WSLでも同じコマンドを使います。

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

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

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

:: Windows Símbolo del sistema (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

間違ったターミナルに行を貼り付けるのが最も一般的な失敗です。CMD用の行をPowerShellで実行するとThe token '&&' is not a valid statement separatorが表示され、PowerShell用の行をCMDで実行すると'irm' is not recognized as an internal or external commandが表示されます（スペイン語版Windowsでは「内部または外部のコマンドとして認識されません」）。macOSのcurl … | bashをPowerShellに貼り付けるとA parameter cannot be found that matches parameter name 'fsSL'が表示されます。いずれの場合も、対応する行を使えば解決します。

Git for Windowsのインストールは任意ですが推奨です。Claude Codeはコマンド実行にGit Bashを使用し、ない場合はPowerShellを使用します。Gitがインストール済みなのにGit Bashが見つからない場合は、設定のenvブロックでCLAUDE_CODE_GIT_BASH_PATHをbash.exeのパスに設定してください。

WSLでは、macOS/Linuxの行をWSLターミナル内で実行し、claudeもそこで起動してください。PowerShellやCMDからは実行しません。

パッケージマネージャーを使う

これも利用できますが、重要な違いがあります。いずれもデフォルトでは自動更新されません（brew upgrade claude-codeまたはwinget upgrade Anthropic.ClaudeCodeを実行する必要があります）。Debian/Ubuntu、Fedora/RHEL、Alpine向けに、署名済みのapt、dnf、apkリポジトリもあります。

# Homebrew (macOS, Linux) — canal stable
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

# npm — requiere Node.js 22 o posterior; nunca con sudo
npm install -g @anthropic-ai/claude-code

npmでは、バージョン2.1.198以降のパッケージにNode.js 22以降が必要です。古いNodeを使うとnpmは警告EBADENGINEだけを表示し、インストールは完了します。実行時にNode.jsを使用しない同じネイティブバイナリがインストールされます。sudo npm install -gは絶対に使用しないでください。権限の問題を引き起こし、セキュリティ上のリスクになります。

インストールを確認する

claude --version   # imprime la versión, por ejemplo 2.1.211 (Claude Code)
claude doctor      # diagnóstico de la instalación y la configuración, sin abrir sesión

claude doctorを使ってください。ログインせずに、インストールの状態、設定ファイルのエラー、推奨される解決策を表示します。インストールに問題があるのか、設定に問題があるのかを最も早く確認できます。

command not found: claudeと表示される場合（Windowsではclaudeが認識されない場合）、インストール先フォルダがPATHに入っていません。macOSとLinuxでは新しいターミナルを開き、それでも解決しない場合は~/.zshrcまたは~/.bashrcのPATHに~/.local/binを追加します。Windowsではフォルダは%USERPROFILE%\.local\binです。確認し、PowerShellから追加してください。

# 1. Comprueba si la carpeta de instalación ya está en el PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. ¿Sin salida? Añádela al PATH de usuario y abre una terminal nueva
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. En la terminal nueva: si hay dos instalaciones, verás dos rutas
where.exe claude

初回接続：サブスクリプションまたはAPIキー

オプションA — サブスクリプションでログイン

プロジェクトフォルダでclaudeを実行し、Pro、Max、Team、Enterprise、またはConsoleアカウントを使ってブラウザでログインします。混乱しやすい点があります。ANTHROPIC_API_KEY変数がすでに定義されている場合、Claude Codeはそのキーを使うかどうかを一度だけ尋ねます。「いいえ」と答えると、それ以降は再度尋ねずに無視するため、変数が読み込まれていないように見えます。再度有効にするには、/config → カスタムAPIキーを使用を選択します。

オプションB — サブスクリプションなしで従量課金キーを使う

Claude CodeはANTHROPIC_BASE_URLをネイティブに読み取るため、Anthropic Messages APIの任意のエンドポイントを指定できます。これは対応している設定で、プラグイン、プロキシ、変更されたバイナリは不要です。手順は、アカウントを作成し、残高をチャージ（最低$10）し、キーダッシュボードでsk-kn-キーを生成し（表示は1回のみ）、ユーザー設定~/.claude/settings.json（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"
  }
}

まずPowerShellの1つのウィンドウだけで試すには：

# Solo para esta ventana de PowerShell (en macOS/Linux: export VARIABLE=valor)
$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

• 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も固定してください。 Claude Codeのデフォルトモデルとそのエイリアスopusは最新のOpusを指しており、Kunavoがまだ提供していない場合、最初のリクエストは404を返します。ここではエイリアスopusをClaude Opus 5.5（claude-opus-5-5）に固定します。これはClaude Code v2.1.280以降が必要です。以前のバージョンではclaude updateを実行してください。
• そしてANTHROPIC_DEFAULT_SONNET_MODELも同様です。 エイリアスsonnetはSonnet 5.5を要求しますが、Kunavoでは提供していません。この変数がないと、/model sonnet、opusplanの実行フェーズ、およびsonnetで設定されたサブエージェントは404を返します。claude-sonnet-5に設定すると回避できます。
• ANTHROPIC_DEFAULT_HAIKU_MODELはClaude Codeが自動的に実行するバックグラウンド呼び出し（要約、タイトル）を対象にします。これをHaikuに指定すれば、手間なく節約できます。

プロジェクトの.claude/settings.jsonにキーを絶対に置かないでください。このファイルはリポジトリに入ります。VS Code拡張機能では、変数をVS Codeのユーザー設定内にあるclaudeCode.environmentVariablesに設定します。拡張機能は起動前に認証情報を確認するためです。

カタログから読み取った1Mトークンあたりの料金：

有効なオプションを確認する方法

Claude Code 内で /status を実行します。Auth token の行はキーが使用中であることを意味し、claude.ai アカウントを伴う Login method の行は変数が読み込まれていないことを意味します。両者は加算されません。変数が存在する間はサブスクリプションが一時停止され、変数を削除すると Claude Code は再インストールなしでサブスクリプションに戻ります。

ゲートウェイ経由では3つの点が変わります。Remote Control と音声入力は利用できません（claude.ai の認証情報が必要です）。/fast は高速モードが利用できないと表示することがあります。この確認は Anthropic に直接接続するためですが、通常のリクエストは変わりません。また、/context の数値はローカル推定値になります。コード、ツール、サブエージェント、MCP、フック、プロンプトキャッシュは同じように動作します。詳細は統合ドキュメントとClaude Code の API キーガイド（いずれも英語）をご覧ください。

Claude Code の使い方：最初の手順

# 1. Arranca siempre dentro de la carpeta del proyecto
cd ~/proyectos/mi-app
claude

# 2. Primer comando: lee el repositorio y genera CLAUDE.md
> /init

# 3. Pide las tareas en español y con la ruta del archivo
> cambia la validación de src/api/user.ts a zod y arregla los tests

# 4. Para tareas que tocan muchos archivos: Shift+Tab activa el modo plan

Claude Code は、ファイルを編集したりコマンドを実行したりする前に許可を求めます。誤った方向に進んだ場合は Esc を押して停止し、/rewind で以前の時点に戻せます。/init が生成する CLAUDE.md は草稿です。各セッションで繰り返す内容（テストコマンド、規約、触れてはいけないフォルダー）だけを記載してください。毎回のセッションで読み込まれ、各リクエストに含まれるため、Anthropic は200行を超えないことを推奨しています。

• モデルを切り替える： /model の後に完全な名前（例：/model claude-opus-5）を指定するか、claude --model claude-opus-5 で起動します。タスクの間で切り替えてください。各モデルには固有のキャッシュがあるため、タスクの途中で切り替えると、キャッシュなしで会話全体を再読み込みすることになります。
• 無関係なタスクの間で/clear。新しい会話を開始しても費用はかかりません。以前の会話は /resume で復元できます。
• タスクが長引いたら/compact：履歴を要約して続行します。API キーではキャッシュの有効期間がデフォルトで5分なので、長い休止の後ではなく、休止する前にコンパクト化してください。
• セッションの費用： /usage はトークン数を表示しますが、計算される金額は Anthropic の定価に基づくローカル推定値です。Kunavo では実際の請求額は使用状況ページで確認できます。

支払いと選択の正直な比較

残高はStripeによる前払いです。カード（Visa、Mastercard、American Express、JCB、UnionPay）、Apple Pay、Google Pay、またはLinkを利用できます。SEPA口座振替は利用できません。最低チャージ額は$10で、残高に有効期限はなく、失敗したリクエストには課金されません。また、各キーには月間利用上限を設定できます。すべての料金は料金ページに記載されています。

Claude Code を毎日長時間使う場合は、サブスクリプションの固定料金のほうが通常は安くなります。従量課金は、利用が不規則な場合や5時間ウィンドウに依存したくない場合に有利で、活動しない月の費用はゼロです。完全な比較（英語）は Claude Code pricing にあります。Kunavo 経由では共有容量を使用するため、専用容量も契約上の SLA もありません。これらの保証が必要な場合は Anthropic と直接契約してください。

よくある質問