Claude Codeのインストール：Windows、macOS、Linuxのコマンドとサブスクリプションなしでの使い方

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 が含まれません）か、2つの環境変数 ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN を設定して、サブスクリプション不要の従量課金 API キーを使用します。

2026年9月11日で確認されたコマンドは、Anthropic公式のインストールドキュメントに基づいています。

インストール前に

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

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

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

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

Windowsにインストールする

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

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

:: Windows Prompt de Comando (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では「内部または外部のコマンドとして認識されません」）。また、macOSのcurl … | bashをPowerShellに貼り付けるとA parameter cannot be found that matches parameter name 'fsSL'が表示されます。いずれの場合も、正しい行を使えば解決します。

Git for Windowsのインストールは任意ですが、推奨します。Claude Codeは、コマンドの実行に付属のGit Bashを使用します。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 — exige Node.js 22 ou mais novo; nunca com 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 a versão, por exemplo 2.1.211 (Claude Code)
claude doctor      # diagnóstico da instalação e das configurações, sem abrir sessão

claude doctorを保存しておいてください。セッションを開始せずに実行すると、インストールの状態、設定ファイルのエラー、推奨される修正方法が表示されます。問題がインストールにあるのか設定にあるのかを知る最も早い方法です。

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

# 1. Veja se a pasta de instalação já está no PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sem saída? Adicione ao PATH do usuário e abra um terminal novo
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. No terminal novo: se houver duas instalações, aparecem dois caminhos
where.exe claude

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

方法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   # só o domínio, sem /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のウィンドウ内でテストする場合：

# Vale só para esta janela do 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"
  }
}

これらの各行には注意点があります。

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

プロジェクトの.claude/settings.jsonにキーを絶対に置かないでください。このファイルはgitに送られ、リポジトリをクローンする人にも渡ります。VS Code拡張機能では、認証情報を開始前に確認するため、環境変数をclaudeCode.environmentVariables、つまりVS Code自体のユーザー設定に置きます。

カタログから取得した100万トークンあたりの料金：

セッション中にモデルを切り替えるには、完全な名前を指定して/modelを使用します（例：/model claude-opus-5-5）。または、claude --model claude-opus-5-5でClaude Codeを起動します。1か月の利用料金と、サブスクリプションの方が得になるタイミングについては、Claude Codeの料金ガイドをご覧ください。

現在有効な方法を確認する

Claude Code内で/statusを実行します。Auth tokenという行があれば、キーが有効です。claude.aiのアカウントとともにLogin methodという行が表示される場合、環境変数は読み込まれていません。両方が同時に使われることはありません。環境変数を設定するとサブスクリプションは停止し、環境変数を削除すると再インストールなしでサブスクリプションに戻ります。

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

ブラジルから支払う—チェックアウトでPix

claude.aiのサブスクリプションはドル建ての継続課金で、海外利用が有効な国際カードが必要です。APIキー経由では、チャージはStripeのチェックアウトを通り、Pixはブラジルから支払うユーザーの支払い方法として表示されます。価格はUSD建てで、Stripeは確定前に換算後のレアル額を表示します。国際カード（Visa、Mastercard、American Express）、Apple Pay、Google Pay、Linkもチェックアウトに表示されます。残高は前払い式で、最低チャージ額は$10、残高に有効期限はなく、失敗したリクエストには課金されません。また、各キーには月間支出上限を設定できます。画面ごとの手順はPixでAPIに支払う方法にあります。

よくあるエラー

インストール後

初回利用時は、プロジェクト内で/initを実行します。Claude Codeがリポジトリを読み取り、見つかったテストコマンドと規約を含むCLAUDE.mdを生成します。このファイルを確認し、短く保ってください。すべてのセッションで読み込まれます。関係のないタスクの間では、/clearで新しい会話を開始します。長くなったタスクでは、/compactが履歴を要約して続行します。

率直に選択を述べると、Claude Codeを毎日何時間も使う人にとっては、サブスクリプションの月額料金の方が安くなることが多いです。従量課金は、利用量が変動する場合や5時間のウィンドウに縛られたくない場合に適しています。1か月使わなければ費用はゼロです。Kunavoでは共有容量を使用するため、専用クォータも契約上のSLAもありません。これらの保証が必要な場合は、Anthropicと直接契約してください。

よくある質問