← すべての記事

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

ガイドより: Claude Code Comprehensive Guide

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月)時点の内容でまとめました。1 {.answer-block}

TL;DR

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

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アカウントで認証します。1 ネイティブインストーラーにNode.jsもsudoも事前インストールも不要です。どうしてもレガシーのnpm経路(npm install -g @anthropic-ai/claude-code)を使う場合は、Node.js 22以降が必要で、sudo での実行は絶対に避けてください——root所有のグローバルモジュールは、インストール後まで尾を引く権限問題を生みます。1 すでにnpm版をお使いなら、claude install でその場のままネイティブバイナリへ移行できます。

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

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

プラットフォーム ステータス 備考
macOS 13以降(Apple Silicon) 対応 v2.1.113以降はネイティブarm64バイナリ。Rosetta不要
macOS 13以降(Intel) 対応 ネイティブインストーラーまたはHomebrew
Ubuntu 20.04以降 / Debian 10以降 対応 glibc互換性はv2.1.50で修正済み
Fedora / RHEL 8以降 ベストエフォート 同じglibc修正で動作。公式のサポート対象ではありません
Alpine / musl 追加作業ありで対応 apk add libgcc libstdc++ ripgrepUSE_BUILTIN_RIPGREP=0 が必要
Windows 10以降(x64およびARM64) 対応 PowerShellツールには CLAUDE_CODE_USE_POWERSHELL_TOOL=1 が必要
Windows WSL 2 対応。Windowsでの推奨経路 Linuxと完全に同等
Windows WSL 1 / Git Bash 対応 WSL 2を推奨。Git Bashでは CLAUDE_CODE_GIT_BASH_PATH が必要な場合あり

繰り返し出るWindowsの疑問への答えはこうです。ネイティブWindowsでも動きますが、WSL 2ならLinuxと同一の体験が得られ、ネイティブインストーラーもその中で同じように動作します。1

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

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

claude update

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

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

スイッチ 効果
DISABLE_AUTOUPDATER=1 バックグラウンドの自動アップデートを停止。claude update は引き続き動作
DISABLE_UPDATES=1(v2.1.118以降) 手動の claude update を含む、すべての更新経路をブロック

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

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

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

# 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 ピッカーで読めます。2 バージョンを固定するなら DISABLE_AUTOUPDATER=1 とセットで使いましょう——さもないと、自動アップデーターが次回起動時にその固定を丁寧に解除してしまいます。(手動の claude update も締め出したい場合は、代わりに DISABLE_UPDATES=1 を使ってください。)

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

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

方法 アンインストール
ネイティブ(macOS / Linux / WSL) rm -f ~/.local/bin/claude && rm -rf ~/.local/share/claude
ネイティブ(Windows) Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force; Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Homebrew brew uninstall --cask claude-code
winget winget uninstall Anthropic.ClaudeCode
npm(レガシー) npm uninstall -g @anthropic-ai/claude-code

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

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

方法 インストール アップデート バージョン確認
ネイティブ(macOS/Linux/WSL) curl -fsSL https://claude.ai/install.sh \| bash claude update または自動アップデート claude --version
ネイティブ(Windows PS) irm https://claude.ai/install.ps1 \| iex claude update claude --version
Homebrew brew install --cask claude-code brew upgrade --cask claude-code claude --version
winget winget install Anthropic.ClaudeCode winget upgrade Anthropic.ClaudeCode claude --version
npm(レガシー) npm install -g @anthropic-ai/claude-code npm install -g @anthropic-ai/claude-code@latest claude --version

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

よくある質問

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

claude update を実行するか、単に再起動してください。Claude Codeはデフォルトで起動時とセッション中にアップデートを確認し、バックグラウンドでダウンロードして次回起動時に適用します。Homebrewとwingetでインストールした場合は、代わりに brew upgrade --cask claude-codewinget 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以降はx64とARM64で対応していますが、Linuxと完全に同等の環境を求めるならWSL 2が推奨経路です——その中で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 を使えば、インストール種別と検出されたセットアップ上の問題も併せて報告されます。



  1. Anthropic「Set up Claude Code」——プラットフォーム別のインストールコマンド、推奨経路としてのネイティブインストーラー、npmのNode.js 22以降という要件、認証オプション。2026年8月7日に確認。プラットフォーム対応表の詳細はClaude Codeガイドに掲載しています。 

  2. Anthropic、Claude Codeのchangelogとリリースノート。Claude Codeガイドで追跡した内容にもとづきます(v2.1.224、2026年8月7日まで確認済み。v2.1.221〜224にインストールおよびアップデート挙動の変更はありません)——自動アップデートの挙動、DISABLE_AUTOUPDATERDISABLE_UPDATES の違い(v2.1.118)、CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE(v2.1.129)、バージョンを固定したインストール、claude doctor、そして診断と修正を行う点検としての /doctor(v2.1.205)。 

関連記事

Codex CLIのインストールと更新:Mac、Linux、Windows

OpenAI Codex CLIをインストール、更新、バージョン固定、アンインストールするすべての方法。インストールスクリプト、npm、Homebrew、wingetを、macOS、Linux、WSL、Windowsで解説します。

13 分で読める

Anthropic Python SDK 1.0への移行:手作業か、Claude Codeか

anthropic 0.xから1.0への移行:httpx2、非同期raw response、Bedrockのリージョン。MIGRATION.mdを見ながら手作業で、またはClaude Codeの/claude-api upgrade pyt…

8 分で読める

Ralphループ:自律型AIエージェントを一晩中稼働させる方法

ストップフック、スポーンバジェット、ファイルシステムメモリを備えた自律エージェントシステムを構築しました。失敗から学んだことと、実際にコードをシップする仕組みを紹介します。

11 分で読める