Claude Code CLIのインストールとアップデート：Mac、Linux、Windows

Claude Codeのインストールは、プラットフォームごとにコマンド1つで済みます——macOS、Linux、WSLでは curl -fsSL https://claude.ai/install.sh | bash、Windows PowerShellでは irm https://claude.ai/install.ps1 | iex。アップデートも自動（デフォルト）か、claude update の一発かのどちらかです。多くのページが省いてしまうのは、その最初のコマンドから先の話です。選択肢が4つあるときにどのインストール方法を選ぶのか、自動アップデーターはどう動き、どう止めるのか、特定のバージョンをどう固定するのか、そして各方法をどうきれいにアンインストールするのか。このページはそのためのリファレンスです。用途ごとに表を1つずつ、v2.1.224（2026年8月）時点の内容でまとめました。¹

TL;DR

• ネイティブインストーラーを使いましょう。 Node.jsへの依存がなく、プラットフォームごとにテスト済みのバイナリを配布し、v2.1.113以降はこれがデフォルトとなっています。npmパッケージはレガシー扱いで、v2.1.15で非推奨となり、現在はNode.js 22以降を必要とします。¹
• アップデートはデフォルトで自動です。 起動時とセッション中に定期的にチェックし、バックグラウンドでダウンロードして、次回の起動時に適用されます。claude update を実行すれば、その場ですぐに更新できます。²
• アップデートを止めるスイッチは2種類あります。 DISABLE_AUTOUPDATER=1 はバックグラウンドのアップデートを停止し、DISABLE_UPDATES=1（v2.1.118以降）は手動の claude update を含むすべての更新経路をブロックします。²
• バージョンの固定は、インストーラーに引数として渡すだけです：curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58。実行中のバージョンは claude --version で確認し、変更点は /release-notes で追えます。¹²
• 挙動がおかしいときは claude doctor を実行してください。 インストール種別、バージョン、検出された問題を報告してくれます。v2.1.205以降は、セッション内の /doctor がセットアップの問題を診断し、修正まで行います。²

Claude Code CLIはどうインストールしますか？

プラットフォーム別に、コマンド1つです。

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

# 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

パッケージマネージャーがお好みなら、どちらも一級市民として扱われています。

brew install --cask claude-code          # macOS / Linux (stable channel)
winget install Anthropic.ClaudeCode      # Windows

あとはプロジェクトディレクトリで claude を実行し、Claude Pro/Max/Teamのサブスクリプション、またはAnthropic APIアカウントで認証します。¹ ネイティブインストーラーにNode.jsもsudoも事前インストールも不要です。どうしてもレガシーのnpm経路（npm install -g @anthropic-ai/claude-code）を使う場合は、Node.js 22以降が必要で、sudo での実行は絶対に避けてください——root所有のグローバルモジュールは、インストール後まで尾を引く権限問題を生みます。¹ すでにnpm版をお使いなら、claude install でその場のままネイティブバイナリへ移行できます。

初回セッションのセットアップ——認証の選択肢、最初のプロンプト、権限モード——については、クイックスタート解説がゼロから最初の結果までの道筋をカバーしています。

Claude Codeはどのプラットフォームに対応していますか？

繰り返し出るWindowsの疑問への答えはこうです。ネイティブWindowsで動作し、管理者権限も要りません。Anthropic自身の指針は、プロジェクトの置き場所と必要な機能で選ぶというもので、Linuxのツールチェーンやサンドボックス化されたコマンド実行が必要ならWSL 2を使い、その中では同じLinux用インストーラーが動きます。³ Claude Codeのオートモードはセキュリティ境界ではないは、本当の境界はオートモードではなくOSによる隔離だと論じています。

Claude Codeはどうアップデートしますか？

たいていの場合、何もする必要はありません。Claude Codeはデフォルトで自動アップデートします——起動時とセッション中に定期的に新バージョンを確認し、バックグラウンドでダウンロードして、次回の起動時に適用するのです。² すぐに更新したい場合や、自動アップデーターを無効にしている場合は次のコマンドを使います。

claude update

パッケージマネージャー経由のインストールは、それぞれのチャンネルで更新します——brew upgrade --cask claude-code、winget upgrade Anthropic.ClaudeCode です。v2.1.129以降は CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 を設定すると、これらのインストールでもバックグラウンドでパッケージマネージャーのアップグレードが走り、再起動を促してくれます。²

アップデートの制御は2つの別々のスイッチに分かれており、制限の厳しい環境ではこの違いが効いてきます。

いずれも環境変数として設定するか、settings.json の "env" 配下に記述します。²

特定のバージョンをインストールするには？

バージョンをインストーラーに渡すだけです。バグの再現、チーム全体を既知の安定リリースに揃える、ロールバックするといった場面で役に立ちます。

# Specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Latest, explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell, specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

claude --version で確認し、各リリースの変更点はセッション内の /release-notes ピッカーで読めます。² バージョンを固定するなら DISABLE_AUTOUPDATER=1 とセットで使いましょう——さもないと、自動アップデーターが次回起動時にその固定を丁寧に解除してしまいます。（手動の claude update も締め出したい場合は、代わりに DISABLE_UPDATES=1 を使ってください。）

Claude Codeはどうアンインストールしますか？

アンインストール方法は、インストール方法に合わせます。

設定は ~/.claude/ に別途置かれているため、バイナリを削除しても設定・スキル・履歴は消えません。完全にまっさらな状態にしたいときだけ、このディレクトリも削除してください。¹

ライフサイクル全体を1つの表に

そして何かがおかしいとき——報告されるバージョンが違う、アップデート後にコマンドが見つからない、インストールが中途半端に適用された——には、シェルから claude doctor を実行すればインストール種別、バージョン、検出された問題が報告されます。セッション内の /doctor（v2.1.205以降）なら、フルチェックを走らせて見つかった問題を修正することもできます。² インストール後のすべて——設定、権限、hooks、MCP、サブエージェント——はClaude Code完全ガイドがカバーしています。

Windowsのトラブルシューティング：claude が認識されない、シェルが違う、スクリプトがブロックされる

Windowsでの失敗の大半は次の9つのどれかで、それぞれに見分けのつくエラー文字列があります。以下の修正はすべて、2026年9月7日時点のAnthropicのインストールのトラブルシューティングページとセットアップページにもとづいています。³⁴

1. 'claude' is not recognized as an internal or external command（CMD）または The term 'claude' is not recognized as the name of a cmdlet（PowerShell）。 インストーラーは claude.exe を %USERPROFILE%\.local\bin\claude.exe に配置します。このディレクトリが PATH に入っていないか、インストールに使ったターミナルをそのまま使っているため古い PATH が残っているかのどちらかです。確認して追加し、新しいターミナルを開いてください。⁴

$env:PATH -split ';' | Select-String '\.local\\bin'      # no output = not on PATH
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

CMDでの確認は echo %PATH% | findstr /i "local\bin" で、修正は「環境変数」からユーザーの PATH に %USERPROFILE%\.local\bin を追加することです。⁴

2. 'irm' is not recognized、The token '&&' is not a valid statement separator、または A parameter cannot be found that matches parameter name 'fsSL'。 別のシェル用のインストール行を実行しています。irm が見つからないなら、いるのはCMDです（プロンプトが C:\ と表示されます）。上記のCMD用インストーラーを使うか、PowerShell（PS C:\）を開いてください。&& が拒否されるなら、PowerShellでCMD用の行を実行しています。irm https://claude.ai/install.ps1 | iex を使いましょう。fsSL のエラーは、macOS/Linux用の curl -fsSL ... | bash の行をPowerShellに貼り付けたことを意味します。PowerShellでは curl が Invoke-WebRequest のエイリアスだからです。コマンドがスクリプトのテキストを表示するだけで何もインストールしない場合は、ダウンロードの部分だけを実行し、それを実行する部分が抜けています。⁴

3. running scripts is disabled on this system / PSSecurityException。 PowerShellの実行ポリシーが、npmが作成する .ps1 ランチャーシム（npm.ps1、claude.ps1）をブロックしています。ネイティブインストーラーには影響しません。ダウンロードしたテキストを保存済みファイルではなく iex 経由で実行するためです。また、保存した ClaudeInstall.ps1 を -ExecutionPolicy Bypass -File で実行する方法は、Anthropicが文書化しているインストール経路ではありません（セットアップページに載っているのは irm の行、CMD用インストーラー、WinGet、npmだけです）。修正は次の順で試してください。Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser を実行する、claude.cmd を呼び出す（ポリシーは .cmd を対象にしません）、あるいはnpm版をネイティブインストーラーに置き換える、のいずれかです。⁴

4. HTMLタグやCSSを引用する iex のパースエラー、または curl: (22) The requested URL returned error: 403。 インストールURLがスクリプトではなくWebページを返しています。ページに「App unavailable in region」とあれば、お住まいの国ではClaude Codeが提供されていません。それ以外なら、プロキシかフィルターが間に入っています。到達性は curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest で確かめられます（curl.exe を明示的に呼び出してください。PowerShellの curl エイリアスは -sI を受け付けません）。1行目が 200 ならホストには到達でき、失敗は一時的なものだったということです。文書化された代替手段は winget install Anthropic.ClaudeCode です。⁴

5. Could not establish trust relationship for the SSL/TLS secure channel、または CRYPT_E_NO_REVOCATION_CHECK (0x80092012)。 前者の場合は、インストーラーの前にTLS 1.2を強制します：[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12。失効確認のエラーは、ネットワークが証明書の失効確認をブロックしていることを意味します。CMDの curl の行に --ssl-revoke-best-effort を追加するか、PowerShell用インストーラーを使ってください。こちらは.NET経由でダウンロードするため、失効確認サーバーに到達できなくても処理を続けられます。⁴

6. The process cannot access the file ... because it is being used by another process。 以前のインストーラーがまだ動いているか、ウイルス対策ソフトが %USERPROFILE%\.claude\downloads にある途中までのダウンロードをスキャンしています。ほかのPowerShellウィンドウを閉じ、スキャンが終わるのを待ってから、次を実行してください。⁴

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

7. 違うバージョンが起動する、または2つのインストールの結果が食い違う。 where.exe claude は PATH 上にあるすべての claude を一覧表示し、Test-Path "$env:USERPROFILE\.local\bin\claude.exe" はネイティブインストーラーがバイナリを配置したかどうかを示します。ネイティブ版を残し、それ以外は削除しましょう（winget uninstall Anthropic.ClaudeCode、npm uninstall -g @anthropic-ai/claude-code、レガシーのローカルnpmインストールなら Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"）。claude doctor は、実際に動いているインストール種別とバージョンを表示します。⁴

8. Claude Code on Windows requires either Git for Windows (for bash) or PowerShell。 どちらのシェルも見つかりませんでした。Git for Windowsは必須ではありません。なければClaude CodeはPowerShellツール経由でコマンドを実行し、あればBashツールがGit Bashを使います。Git Bashをインストール済みなのに見つからない場合は、settings.json でその場所を指定してください。³

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

9. Claude Code does not support 32-bit Windows。 64ビットのマシンでx86版のPowerShellを開いています。「(x86)」の付いたものではなく、「Windows PowerShell」を開いてください。⁴

どれにも当てはまらない場合は、claude doctor（読み取り専用で、セッションは開始しません）がインストールの健全性、設定ファイルのエラー、直近のアップデート試行の結果を報告します。エラーと修正の完全な対応表は、Anthropicのトラブルシューティングページにあります。³⁴

よくある質問

Claude Code CLIを最新バージョンにアップデートするには？

claude update を実行するか、単に再起動してください。Claude Codeはデフォルトで起動時とセッション中にアップデートを確認し、バックグラウンドでダウンロードして次回起動時に適用します。Homebrewとwingetでインストールした場合は、代わりに brew upgrade --cask claude-code と winget upgrade Anthropic.ClaudeCode で更新します。

Claude Codeは自動でアップデートされますか？

はい、デフォルトでそうなります。起動時と実行中の定期チェックで確認し、ダウンロード済みのアップデートを次回起動時に適用します。DISABLE_AUTOUPDATER=1 は手動の claude update を残したままバックグラウンド更新だけを止め、DISABLE_UPDATES=1 はすべての更新経路をブロックします。

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

PowerShellで irm https://claude.ai/install.ps1 | iex を実行します（または winget install Anthropic.ClaudeCode）。ネイティブのWindows 10（1809以降）はx64とARM64で管理者権限なしに対応しています。Linuxのツールチェーンやサンドボックス化されたコマンド実行が必要ならWSL 2を選び、Linuxと完全に同等の環境にするため、その中でLinux用のインストールコマンドを実行してください。

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

いいえ。推奨されるネイティブインストーラーにNode.jsへの依存はありません。Node.jsが必要なのはレガシーのnpmパッケージ（npm install -g @anthropic-ai/claude-code、v2.1.15で非推奨）だけで、こちらはNode.js 22以降を要求します。npm版を使っている場合は、claude install でネイティブバイナリへ移行できます。

使っているClaude Codeのバージョンを確認するには？

シェルから claude --version、またはセッション内で /release-notes を使うと対話的な変更履歴ピッカーが開きます。claude doctor を使えば、インストール種別と検出されたセットアップ上の問題も併せて報告されます。