Claude Codeのインストール問題を解決：Windows・macOS・Linux

Vibe Coding Rescue · 2026-07-22 · セットアップとアカウント
最終確認 2026-07-22対象 Claude Code公式資料 2件

npm install -g @anthropic-ai/claude-codeが失敗した場合と、インストール後にシェルがclaudeを見つけられない場合では、対処方法が異なります。npm関連の問題なら、ネイティブインストーラーへ切り替えるのが通常は最短です。

ネイティブインストーラーから始める

Anthropicは現在、ネイティブインストールスクリプトを推奨しています。Node.jsは必要ありません。

macOS、Linux、またはWSLの場合:


curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShellの場合:


irm https://claude.ai/install.ps1 | iex

コマンドプロンプトで開いた場合は、PowerShellコマンドではなく、CMD専用のインストーラーを使用してください:


curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

EBADENGINEが表示された場合

npmパッケージv2.1.198以降のClaude CodeにはNode.js 22以降が必要です。ただしAnthropicによると、古いNode.jsではEBADENGINEが警告として表示されても、インストール自体は成功する場合があります。インストールされる実行ファイルがネイティブバイナリで、実行時にはNode.jsへ依存しないためです。

claude --versionを最初に実行してください。バージョンが表示される場合はClaude Codeがインストールされています。表示されない場合はnode -vを確認し、Node.js 22以降にアップグレードするか、上記のネイティブインストーラーに切り替えてください。

EACCES: permission deniedが表示された場合

現在のユーザーに、npmのグローバルパッケージディレクトリへの書き込み権限がありません。sudo npm install -gで回避しないでください。Anthropicもこの方法を明示的に推奨していません。代わりにネイティブインストーラーを使います。

ネイティブインストールが同じ権限エラーに遭遇した場合、~/.localの所有権を現在のアカウントに戻し、もう一度試してください:


sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

Windowsでのインストールコマンド自体が失敗した場合

Claude CodeはWindows 10 1809以降、Windows Server 2019以降でネイティブに動作します。管理者権限やWSLは必要ありません。

WSLを選択した場合は、WSLのターミナル内でmacOS/Linuxのcurlコマンドを実行してください。Git for WindowsはネイティブのWindowsではオプションです。Git for Windowsがインストールされている場合はBashツール、インストールされていない場合はPowerShellツールを使用できます。

Claude Codeがインストールされたがコマンドが見つからない場合

ネイティブ実行ファイルはmacOSとLinuxでは~/.local/bin/claude、Windowsでは%USERPROFILE%\.local\bin\claude.exeにインストールされます。command not foundや「認識されていません」と表示される場合は、そのディレクトリがPATHに含まれていない可能性が高いです。

macOSのデフォルトのzshの場合:


echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

LinuxまたはWSLのbashの場合、~/.bashrcに同じ行を追加してください。Windowsでは、すべてのターミナルウィンドウを閉じて新しいウィンドウを開いてください。claudeがまだ見つからない場合は、ユーザーのPATHに%USERPROFILE%\.local\binを追加し、もう一度ターミナルを開いてください。

403またはFailed to fetch versionが表示された場合

これらのエラーは、企業のプロキシやファイアウォールがdownloads.claude.aiをブロックしているときによく発生します。403は、接続元の国・地域でClaudeを利用できない場合にも起こるため、VPNを使っているなら出口サーバーの国・地域も確認してください。

企業ネットワークの場合、ITにプロキシアドレスを確認し、対応する環境変数を設定してください:


export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

スマートフォンのテザリングなど別の回線で試すと、ネットワーク側の遮断か、その端末固有の問題かをすばやく切り分けられます。

インストールと設定の最終確認としてclaude doctorを実行してください。npm版とネイティブ版が両方残っている場合は、ls ~/.local/bin/claudeとnpm ls -g @anthropic-ai/claude-codeを確認し、どちらか一方だけを残してください。Anthropicはネイティブビルドを推奨しています。

インストールは成功しているがサインインができない場合は、アカウントも確認してください。Claude CodeはPro、Max、Team、Enterprise、またはAPIコンソールアカウントが必要です。無料のClaude.aiプランでは利用できません。エラーが解決しない場合は、表示された文言をそのままAnthropicのインストールトラブルシューティングガイドで検索してください。

参照した公式資料