ガイド一覧へ戻る
セットアップ·2026年8月5日·最終更新 2026年10月3日·読了8分

Claude Codeのインストール — すべてのOS向けコマンド、初回ログイン、よくあるエラー

Claude Codeのインストールは、どのプラットフォームでも1つのコマンドで行えます。各OSで使うコマンド、動作しない場合に実行する内容、後から別のエンドポイントを指定する4つの環境変数を説明します。

最終確認日：。

Claude Codeはサポートされているすべてのプラットフォームで1つのコマンドからインストールでき、初回実行全体は、インストール、claudeの入力、ログインです。このガイドでは、各OSの正確なコマンド、動作しない場合に確認すること、そして動作後に別のエンドポイントへ向ける方法を説明します。

コマンドを検証済み 2026年10月3日 — AnthropicのClaude Codeセットアップドキュメントに基づいています。

開始する前に

要件サポート対象
オペレーティングシステムmacOS 13.0以降、Windows 10 1809以降 / Server 2019以降、Ubuntu 20.04以降、Debian 10以降、Alpine Linux 3.19以降
ハードウェア4 GB以上のRAM、x64またはARM64
シェルBash、Zsh、PowerShellまたはCMD
ネットワークインターネット接続が必要
アカウントPro、Max、Team、EnterpriseまたはConsole — 無料のClaude.aiプランにはClaude Codeは含まれません

インストール — ネイティブインストーラー

すべてのプラットフォームで推奨される方法です。自己完結型バイナリをインストールし、バックグラウンドで自動的に最新状態を維持します。

install.sh
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

使用しているWindowsシェルがわからない場合は、プロンプトで確認できます。PowerShellにはPS C:\が表示され、CMDにはC:\がPSなしで表示されます。間違ったコマンドを実行することが、Windowsで最も一般的なインストール失敗の原因です。それぞれの場合に表示される正確なエラーについては、以下のトラブルシューティング表を参照してください。

パッケージマネージャー

既存のパッケージマネージャーでインストールを管理したい場合は、こちらを使用してください。トレードオフは更新です。ネイティブインストーラーとは異なり、これらはデフォルトでは自動更新されません。

package-managers.sh
# Homebrew (macOS, Linux) — stable channel
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

# npm — requires Node.js 22+; never with sudo
npm install -g @anthropic-ai/claude-code

Homebrewでは2つのcaskを公開しています。claude-codeは安定版チャンネルを追跡し（通常は約1週間遅れ、重大なリグレッションがあるリリースはスキップします）、claude-code@latestはすべてのリリースを即座に配布します。署名付きのapt、dnf、apkリポジトリは、Debian / Ubuntu、Fedora / RHEL、Alpine向けに存在し、それぞれ同じ安定版とlatestチャンネルを提供します。

npmでは、sudo npm install -gは絶対に使用しないでください。権限の問題を引き起こし、セキュリティリスクにもなります。npmパッケージはスタンドアロンインストーラーとまったく同じネイティブバイナリをインストールするため、どちらの方法でも実行時のNode依存関係はありません。

インストールを確認する

verify.sh
claude --version   # prints e.g. "2.1.211 (Claude Code)"
claude doctor      # read-only install + settings diagnostics
claude             # start a session in the current project

claude doctorだけは覚えておいてください。セッションを開始せずに、インストールの健全性、設定ファイルの検証エラー、推奨される修正方法を表示します。壊れたインストールと壊れた設定を見分ける最速の方法です。

初回起動とログイン

作業対象のプロジェクトでターミナルを開き、claudeを実行します。インタラクティブセッションが開き、ブラウザでのログイン手順が案内されます。Claude CodeにはPro、Max、Team、EnterpriseまたはConsoleアカウントが必要です。

予期せぬ動作を防ぐため、1つ知っておくべきことがあります。環境にすでにANTHROPIC_API_KEYが設定されている場合、Claude Codeはブラウザを開く代わりに、そのキーを承認するよう一度だけ求めます。このプロンプトを拒否すると、それ以降は追加のプロンプトなしにキーが暗黙的に無視されます。そのため、変数が読み取られていないように見えます。/config → カスタムAPIキーを使用で再び有効にできます。

Windows：ネイティブまたはWSL

オプション必要条件サンドボックス次の場合に選択
ネイティブWindowsなし。Git for Windowsは任意サポート対象外プロジェクトとツールはWindowsネイティブです
WSL 2WSL 2が有効サポート対象Linuxツールチェーンを使用する場合、またはサンドボックス化されたコマンド実行が必要な場合
WSL 1WSL 1が有効サポート対象外WSL 2を利用できない場合

ネイティブWindowsでは、Git for Windowsのインストールは任意ですが推奨されます。Bashツールを支えるGit Bashが提供されるためです。これがない場合、Claude Codeは代わりにPowerShellツール経由でシェルコマンドを実行します。WSLでは、PowerShellからではなくWSLターミナル内でclaudeをインストールして起動してください。

トラブルシューティング

症状原因と修正方法
The token '&&' is not a valid statement separatorPowerShellでCMDコマンドを実行しました。代わりにirm … | iexの行を使用してください。
'irm' is not recognized…逆に、CMDでPowerShellコマンドを実行しました。curl … install.cmdの行を使用してください。
syntax error near unexpected token '<'、403、またはその他のcurlエラーダウンロードでスクリプトが返されませんでした。通常は、ユーザーとインストーラーの間にあるプロキシまたはネットワークフィルターが原因です。再試行するか、代わりにパッケージマネージャーでインストールしてください。
クリーンインストール後のclaude: command not found新しいターミナルを開いて、シェルにインストール先ディレクトリを認識させてから、claude doctorを実行してください。もう1つの古いインストール、または古いシェルエイリアスもよくある原因です。
npmインストール中の権限エラーsudoを使用したか、npmのグローバルディレクトリに書き込み権限がありません。sudoを再実行するのではなく、ディレクトリの所有権を修正してください。書き込み不可のグローバルディレクトリでは、自動更新もブロックされます。
npm install -g後にネイティブバイナリが見つからないパッケージマネージャーがオプションの依存関係をスキップする設定になっています。プラットフォームバイナリはオプション依存関係として配布されるため、それらを許可して再インストールしてください。
Alpineまたは別のmuslディストリビューションでインストールに失敗するAlpineにはbashとcurlが含まれていません。bash curl libgcc libstdc++ ripgrepをインストールし、設定ファイルのenvブロックでUSE_BUILTIN_RIPGREPを"0"に設定してください。
検索とファイル検出が失敗する通常、ripgrepは同梱されています。プラットフォーム上で実行できない場合は、システムのripgrepをインストールしてUSE_BUILTIN_RIPGREP=0を設定してください。
ネイティブWindowsでBashツールが見つからないGit for Windowsをインストールしてください。それでもClaude CodeがGit Bashを見つけられない場合は、~/.claude/settings.jsonのenvブロックでCLAUDE_CODE_GIT_BASH_PATHを設定してください。
キー設定後も401になるキーがサーバーが読み取らないヘッダーに入っています。ANTHROPIC_AUTH_TOKENとANTHROPIC_API_KEYを切り替えてください。詳細はAPIキーガイドを参照してください。

Claude CodeをKunavoに接続する

起動後、Claude CodeはAnthropic Messages APIを提供する任意のエンドポイントで動作します。ANTHROPIC_BASE_URLをネイティブに読み取るため、これは回避策ではなくサポート対象の構成です。プラグインも、プロキシも、パッチ済みバイナリも必要ありません。

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com
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

このブロックについて知っておくべき5つの事項があります。どれも、間違えるとそれぞれ1時間を無駄にします：

  • ANTHROPIC_BASE_URLはオリジンのみです。Claude Codeは/v1/messagesを自動的に追加するため、パスまで含めると404になります。
  • ANTHROPIC_AUTH_TOKENを使用し、ANTHROPIC_API_KEYは使用しないでください。これらは異なるHTTPヘッダーに入ります。ベアラートークンは即座に有効になりますが、ANTHROPIC_API_KEYには上記の一度限りの承認が必要です。Kunavoは/v1/modelsを含め、どちらのヘッダーからもキーを読み取るため、Kunavoではその承認手順が両者を分けます。
  • ANTHROPIC_MODELを明示的に設定してください。Kunavoはモデルスラッグを完全一致で処理し、日付サフィックス付きの名前を別名扱いしません。そのため、claude-sonnet-4-5-20250929は404を返し、claude-sonnet-5は動作します。
  • ANTHROPIC_DEFAULT_OPUS_MODELとANTHROPIC_DEFAULT_SONNET_MODELも固定してください。Claude Codeの組み込みデフォルトとopusエイリアスはどちらも最新のOpusに解決されます。Kunavoがそのモデルをまだ提供していない場合、最初のリクエストは404になります。このブロックでは、opusをOpus 5.5（claude-opus-5-5）に固定します。これにはClaude Code v2.1.280以降が必要です。古いインストールではclaude updateを実行してください。sonnetエイリアスはSonnet 5.5を要求しますが、Kunavoは提供していないため、sonnetの固定/model sonnetがないとopusplanの実行フェーズとmodel: sonnetに設定されたサブエージェントは404を返します。
  • ANTHROPIC_DEFAULT_HAIKU_MODELはバックグラウンド呼び出しを対象にします。Claude Codeは要約とタイトルのために独自にこれらを実行します。claude-haiku-4-5は1Mあたり$0.70 / $3.50で、メインモデルの$1.40 / $7.00と比べて安価なので、恒久的な節約につながる1行です。

これらは~/.claude/settings.jsonのenvブロックに設定してください。シェルのexportではなくここに設定すれば、エディターやバックグラウンドエージェントからも参照できます。また、プロジェクトにコミットされた.claude/settings.jsonには絶対に入れないでください。ダッシュボードでsk-kn-キーを作成し、サインアップ後に利用してください。最低入金額は$10で、月額料金はなく、残高に有効期限はありません。各モデルのトークンあたりの料金とAnthropicの公式API料金との差によって、その$10でどれだけ利用できるかが決まります。

ゲートウェイの背後で変わること

コーディング、ツール、サブエージェント、MCP、フック、プロンプトキャッシュはすべて影響を受けません。変わるのは3つで、何かが壊れたと考える前に知っておく価値があります。

  • Remote Controlと音声ディクテーションは利用できません。どちらもclaude.aiのIDを必要としますが、ゲートウェイ認証情報によって置き換えられます。
  • /fastでは高速モードが無効と表示される場合があります。可用性チェックはベースURLに従わず、Anthropicを直接呼び出します。通常のリクエストには影響しません。
  • /contextのカウントはローカル推定になります。トークンカウントはAnthropic自身のゲートウェイ仕様で任意とされている唯一のエンドポイントです。存在しない場合、Claude Codeはローカルで推定します。現在、Kunavoは/v1/messages/count_tokensを提供していません。自動コンパクションとセッション自体には影響しません。

完全な一覧と、ルーターを使用するかどうかの判断については、Claude Codeルーターガイドを参照してください。

よくある質問

Claude Codeをインストールするにはどうすればよいですか？

macOS、Linux、またはWSLでは、`curl -fsSL https://claude.ai/install.sh | bash`を実行します。Windowsでは、PowerShellで`irm https://claude.ai/install.ps1 | iex`を実行するか、CMDで`curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd`を実行します。ネイティブインストーラーが推奨される方法で、バックグラウンドで自身を更新します。Homebrew（`brew install --cask claude-code`）、WinGet（`winget install Anthropic.ClaudeCode`）、npm、署名済みのapt/dnf/apkリポジトリもサポートされていますが、いずれもデフォルトでは自動更新されません。

Claude CodeのインストールにNode.jsは必要ですか？

ネイティブインストーラー、Homebrew、WinGet、Linuxパッケージリポジトリでは必要ありません。これらはすべて、実行時にNodeを使用しないネイティブバイナリをインストールします。Nodeを必要とするのはnpmのインストール経路だけで、v2.1.198時点ではNode.js 22以降が必要です。それでもnpmが取得するのは、プラットフォームごとのオプション依存関係を通じた同じネイティブバイナリです。

Claude Codeのシステム要件は何ですか？

macOS 13.0以降、Windows 10 1809以降またはWindows Server 2019以降、Ubuntu 20.04以降、Debian 10以降、またはAlpine Linux 3.19以降。x64またはARM64プロセッサ上で4 GB以上のRAM、インターネット接続、そしてシェルとしてBash、Zsh、PowerShell、またはCMDが必要です。また、Anthropicがサポートしている国に所在している必要があります。

初回にClaude Codeへログインするにはどうすればよいですか？

プロジェクトディレクトリで`claude`を実行し、ブラウザに表示される指示に従ってください。Claude CodeにはPro、Max、Team、Enterprise、またはConsoleアカウントが必要です。無料のClaude.aiプランにはClaude Codeへのアクセスが含まれません。ANTHROPIC_API_KEY環境変数が設定されている場合、Claude Codeはブラウザを開く代わりに、そのキーを承認するよう一度だけ尋ねます。

WSLなしでWindowsにClaude Codeをインストールできますか？

はい。PowerShellまたはCMDのインストーラーを実行し、任意のターミナルから`claude`を起動できます。管理者権限は必要ありません。Git for Windowsは任意ですが推奨されます。Bashツールを支えるGit Bashが提供されるためです。これがない場合、Claude CodeはPowerShellツールを通じてシェルコマンドを実行します。Linuxのツールチェーンや、ネイティブWindowsではサポートされないサンドボックス化されたコマンド実行が必要なら、WSL 2を選択してください。

インストール後に`claude`がcommand not foundと表示されるのはなぜですか？

インストールディレクトリが、使用しているシェルのPATHに入っていません。まず新しいターミナルを開いてください。インストーラーはmacOSとLinuxでは~/.local/binを追加しますが、既存のセッションには反映されません。インストールと設定ファイルを読み取り専用で診断するには、`claude doctor`を実行します。2つ目の古いインストールや、残ったシェルエイリアスもよくある原因です。

Claude Codeを別のAPIエンドポイントに向けるにはどうすればよいですか？

Anthropic Messages APIを提供する任意のエンドポイントのオリジンをANTHROPIC_BASE_URLに設定します。Claude Codeはこれをネイティブに読み取り、自身で/v1/messagesを追加するため、プラグインやプロキシは不要です。認証情報にはANTHROPIC_AUTH_TOKENを組み合わせ、ANTHROPIC_MODELを明示的に設定します。また、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODELを、そのエンドポイントが提供するモデルに固定してください。固定しない場合、opusとsonnetのエイリアスはAnthropicの最新モデルに従います。Kunavoでは、同じClaudeモデルをAnthropicの定価より30%低い従量制で利用できます。

次のステップ