macOS、Windows、LinuxにClaude Codeをインストールする方法

Claude Codeをインストールするには、Anthropicのターミナル向けコーディングエージェントを、ドキュメントに書かれたOSの最小要件、4GBのRAM、x64またはARM64プロセッサ、Bash、Zsh、PowerShellまたはCMD、インターネット接続、Anthropicがサポートする国を満たすマシンでネイティブインストーラーから実行します。macOS、Linux、WSLでのコマンドは curl -fsSL https://claude.ai/install.sh | bash で、Windows PowerShellは install.ps1、コマンドプロンプトは install.cmd を使います。

Anthropicはネイティブインストーラーを推奨方法として文書化しています。macOS、Linux、Windows Subsystem for Linux（WSL）では https://claude.ai/install.sh をbashにパイプします。Windows PowerShellは install.ps1、コマンドプロンプトは install.cmd を使います。stableとピン留めビルドはシェルごとに引数が違います。Unixは bash -s、PowerShellはscriptblock、CMDは install.cmd <channel-or-version> です。バイナリがディスクに置かれたあと、claude --version はバージョン番号のあとに (Claude Code) を表示し、続けて claude がブラウザでのログインを始めます。ANTHROPIC_API_KEY が設定されている場合、Claude Codeはブラウザを開かず、そのキーの承認を一度だけ求めます。

ネイティブインストールは更新をバックグラウンドで取得します。Homebrew、WinGet、apt、dnf、apkは、それぞれのパッケージマネージャ経由でアップグレードします。npmは同じネイティブバイナリをoptional dependency経由のグローバルパッケージとして配布し、npmのグローバルディレクトリが書き込めない場合を除いて自動更新します。選んだ方法に対応するアップグレードとアンインストールのコマンドを使います。

インストール前に満たすべき条件

インストールが成功すると、動作する claude バイナリ、Claude Codeが受け付けるアカウント、自分で選んだリリースチャンネル、インストーラーと対応するアンインストール手順が残ります。Claude CodeはAnthropicのターミナル向けコーディングエージェントです。プロジェクトディレクトリで開くコマンドラインのプログラムで、必要なファイルを読み、シェルからコードを書いて変更するのを助けます。AnthropicのDesktopアプリは、Claude Codeをグラフィカルに使う選択肢です。この記事が扱うのはターミナルのインストーラー、更新、アンインストールです。

Anthropicの setup ページが挙げるOSの最小要件は、macOS 13.0以降、Windows 10 1809以降またはWindows Server 2019以降、Ubuntu 20.04以降、Debian 10以降、Alpine Linux 3.19以降です。ハードウェアは4GB以上のRAMと、x64またはARM64プロセッサです。インターネット接続が必要です。ドキュメントにあるシェルはBash、Zsh、PowerShell、CMDです。setup ページの所在地要件は、Anthropicがサポートする国です。

Claude Codeには Pro、Max、Team、Enterprise、Console のいずれかのアカウント、またはAmazon Bedrock、Google CloudのAgent Platform、Microsoft Foundryが必要です。Anthropicのドキュメントは、無料のclaude.aiプランにClaude Codeの利用が含まれないとしています。プロバイダの資格情報は、各クラウド製品自身の setup ページを使います。

claude が動いたらログインします。最初のコーディング用プロンプトはAnthropicのquickstartにあります。インストール中の command not found、PATHの問題、EACCES、TLSエラー、curl 403には、Anthropicの Troubleshoot installation and login ページを使います。ログインのループ、OAuthエラー、ログインの403 Forbiddenは、同じページの login and authentication の節にあります。

Claude Codeのセットアップ

Anthropicのサポート対象国

インストールとログインのトラブルシューティング

推奨方法であるネイティブインストーラー

Anthropicはネイティブインストーラーを推奨方法として文書化しています。macOS、Linux、Windows Subsystem for Linux（WSL）では、インストールスクリプトを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 を使います。The token '&&' is not a valid statement separator と出たらPowerShellです。'irm' is not recognized as an internal or external command と出たらCMDです。PowerShellのプロンプトは PS C:\ で始まり、CMDのプロンプトは PS なしの C:\ を表示します。

macOSとLinuxのランチャーは ~/.local/bin/claude で、~/.local/share/claude/versions/ へのsymlinkです。インストーラーが終わったら、プロジェクトでターミナルを開き claude を実行します。

ネイティブインストーラーは latest、stable、または 2.1.89 のようなバージョン（Anthropicのピン留め例）を受け付けます。インストール時に選んだチャンネルが自動更新の既定になります。シェルごとに構文が違います。bashは bash -s、PowerShellはscriptblock、CMDは引数を install.cmd に渡します。

macOS、Linux、WSL（latest）: curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell（latest）: irm https://claude.ai/install.ps1 | iex
Windows CMD（latest）: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
stable、macOS/Linux/WSL: curl -fsSL https://claude.ai/install.sh | bash -s stable
stable、PowerShell: & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
stable、CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd
ピン留め例 2.1.89、macOS/Linux/WSL: curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
ピン留め例 2.1.89、PowerShell: & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89
ピン留め例 2.1.89、CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd

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

Homebrew、WinGet、Linuxリポジトリ、npm

Homebrewは brew install --cask claude-code でインストールし、このcaskはstableチャンネルを追います。stableは通常およそ1週間遅れで、大きなリグレッションのあるリリースは飛ばします。brew install --cask claude-code@latest はlatestを追います。アップグレードは対応する brew upgrade のcaskを使います。Homebrewは古いバージョンをディスクに残します。brew cleanup で領域を戻せます。

WinGetは winget install Anthropic.ClaudeCode でインストールし、winget upgrade Anthropic.ClaudeCode でアップグレードします。

Claude Codeは署名付きのapt、dnf、apkリポジトリを公開し、それぞれにstableとlatestのチャンネルがあります。stableは通常およそ1週間前のバージョンで、大きなリグレッションのあるリリースを飛ばします。latestはリリースが出るとすぐ、すべてのリリースを届けます。以下のコマンドはstableを構成するもので、setup ページはほとんどのユーザーに合うとしています。パッケージマネージャ経由のインストールは、通常のシステムアップグレードの流れで更新を受け取ります。

DebianとUbuntuでは、curl と gnupg がなければインストールします（sudo apt install curl gnupg）。コードブロックのコマンドは /etc/apt/keyrings を作り、署名キーをダウンロードしてフィンガープリント確認のために表示し、/etc/apt/sources.list.d/claude-code.list を書いたうえでパッケージをインストールします。フィンガープリントは 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE である必要があります。キーのダウンロードに失敗すると、その後の apt update は NO_PUBKEY BAA929FF1A7ECACE で失敗します。latestではURLパスとsuite名の両方が変わります。deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main です。後からのアップグレードは sudo apt update && sudo apt upgrade claude-code です。

FedoraとRHELでは、コードブロックのコマンドが /etc/yum.repos.d/claude-code.repo を書き、パッケージをインストールします。latestでは baseurl=https://downloads.claude.ai/claude-code/rpm/latest にします。dnfは初回インストール時にキーをダウンロードし、フィンガープリントの確認を求めます。受け入れる前に 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE であることを確認します。後からのアップグレードは sudo dnf upgrade claude-code です。

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

Alpineでは https://downloads.claude.ai/keys/claude-code.rsa.pub を /etc/apk/keys/claude-code.rsa.pub にダウンロードし、https://downloads.claude.ai/claude-code/apk/stable を /etc/apk/repositories に追加してから apk add claude-code を実行します。latestにするには sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories を実行し、https://downloads.claude.ai/claude-code/apk/latest を追加します。sha256sum /etc/apk/keys/claude-code.rsa.pub は 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6 を報告する必要があります。後からのアップグレードは apk update && apk upgrade claude-code です。

npmは同じネイティブバイナリをインストールします。npm install -g @anthropic-ai/claude-code です。npmはそのバイナリを @anthropic-ai/claude-code-darwin-arm64 のようなプラットフォームごとのoptional dependencyで取り込むため、パッケージマネージャがoptional dependencyを許可している必要があります。v2.1.198以降、このパッケージはNode.js 22以降を必要とします。それより古いNodeではnpmが EBADENGINE を表示し、インストール自体は完了し得ます。CLIがネイティブバイナリをダウンロードし、実行時にはNodeの上で動かないためです。npmパッケージは、npmのグローバルディレクトリが書き込めない場合を除いて自動更新します。書き込めない場合、起動時に一度だけの通知が出て、claude doctor が対処を列挙します。アップグレードは npm install -g @anthropic-ai/claude-code@latest です。Anthropicは npm update -g を避けるよう警告しています。元のsemver範囲の中に留まることがあるためです。sudo npm install -g も避けるよう警告しており、権限の問題とセキュリティ上のリスクを招くことがあります。npmがサポートするプラットフォームは darwin-arm64、darwin-x64、linux-x64、linux-arm64、linux-x64-musl、linux-arm64-musl、win32-x64、win32-arm64 です。

brew install --cask claude-code
brew install --cask claude-code@latest
winget install Anthropic.ClaudeCode
npm install -g @anthropic-ai/claude-code
latestのapt suite行: deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main
latestのdnf baseurl: https://downloads.claude.ai/claude-code/rpm/latest
latestのapkリポジトリ: https://downloads.claude.ai/claude-code/apk/latest

インストール方法ごとのドキュメント上の更新経路

方法	バックグラウンド自動更新	アップグレードコマンド
ネイティブ	はい。起動時と実行中	`claude update`
Homebrew	既定は手動。`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1`	`brew upgrade claude-code` または `brew upgrade claude-code@latest`
WinGet	既定は手動。`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1`	`winget upgrade Anthropic.ClaudeCode`
apt	手動（昇格した権限）	`sudo apt update && sudo apt upgrade claude-code`
dnf	手動（昇格した権限）	`sudo dnf upgrade claude-code`
apk	手動（昇格した権限）	`apk update && apk upgrade claude-code`
npm	はい。npmのグローバルディレクトリが書き込めない場合を除く	`npm install -g @anthropic-ai/claude-code@latest`

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
gpg --show-keys /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

WindowsネイティブとWSL、そしてAlpineの追加要件

ネイティブWindowsのインストールは、管理者権限なしでPowerShellまたはCMDから実行します。インストールにGit for Windowsは任意です。なければClaude CodeはPowerShellツールでシェルコマンドを実行します。Git for Windowsがあれば、Claude CodeはBashツールにGit Bashを使います。WSLの構成ではGit for Windowsは不要です。Claude CodeがGit Bashを見つけられない場合は、ユーザー設定ファイル ~/.claude/settings.json の CLAUDE_CODE_GIT_BASH_PATH を C:\Program Files\Git\bin\bash.exe にします。この上書きは、Git Bashがインストールされているのに見つからないWindowsだけで使います。

AnthropicのWindowsの表は、サンドボックスをネイティブWindowsでは非対応、WSL 2では対応、WSL 1では非対応としています。WSLの経路では、WSLターミナルの中で claude をインストールして起動します。WSLで /mnt/c をまたぐ検索は、claude doctor がSearchをOKと表示していても、一致が少なくなることがあります。ドキュメントにある緩和策は、検索を狭くする、プロジェクトを /home/ の下に置く、ネイティブWindowsで実行する、です。

Alpineとその他のmusl/uClibcシステムでは、インストールコマンドに bash と curl、実行時に libgcc、libstdc++、ripgrep が必要です。Alpineはbashとcurlを既定で入れないため、それらのパッケージがあるまで、ドキュメントのcurlコマンドは not found で失敗します。ドキュメントのAlpineの例は apk add bash curl libgcc libstdc++ ripgrep です。Alpineではripgrepはcommunityリポジトリにあります。apk がripgrepを見つけられない場合は、そのリリースのcommunityリポジトリを /etc/apk/repositories に追加し、apk update を実行してから apk add をやり直します。ドキュメントの https://dl-cdn.alpinelinux.org/alpine/v3.22/community というURLは、Alpine 3.22向けの例です。パッケージを入れたあと、~/.claude/settings.json の env キーで USE_BUILTIN_RIPGREP を 0 にします。このフラグは、WindowsのGit Bashパスとは別のスイッチです。

ドキュメント上のWindowsセットアップの選択肢

| — | — | — | — |

| WSL 2 | WSL 2が有効 | 対応 | Linuxのツールチェーン、またはサンドボックスされたコマンド実行 |

| WSL 1 | WSL 1が有効 | 非対応 | WSL 2が使えない場合 |

~/.claude/settings.json

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

バイナリを確認してからログインする

claude --version を実行します。インストールできていれば、バージョン番号のあとに (Claude Code) が表示されます。Anthropicの例の文字列は 2.1.211 (Claude Code) です。

claude doctor はセッションを始めずに、インストールと設定の読み取り専用の診断を表示します。インストールの健全性、設定ファイルの検証エラー、対処案付きの警告が含まれます。インストール後と、自動更新フラグを変えたあとに実行します。この報告は、バージョン行とは別の診断です。

claude を実行し、ブラウザの案内に従ってログインします。環境変数 ANTHROPIC_API_KEY が設定されている場合、Claude Codeはそのキーの承認を一度求めます。実行中のセッションでアカウントを切り替えるには /login と入力します。組織がセルフホストのClaude apps gatewayを運用している場合、管理者がgateway URLを事前設定し、/login は企業SSO用のCloud gateway画面で開きます。

Searchツール、@file メンション、カスタムエージェント、カスタムスキルがファイルを見つけられない場合は、プラットフォームのripgrepパッケージをインストールし、~/.claude/settings.json の env キーで USE_BUILTIN_RIPGREP を 0 にします。claude doctor で、Searchが OK (bundled) ではなくシステムパスを表示することを確認します。

claude --version

出力例: 2.1.211 (Claude Code)

Claude Codeクイックスタート

検索と検出の問題

自動更新、チャンネル、バージョン固定、更新停止フラグ

ネイティブインストールは、起動時と実行中に定期的に更新を確認します。更新はバックグラウンドでダウンロードされ、次にClaude Codeを起動したときに有効になります。claude update はすぐに適用します。ネイティブ更新が成功すると Successfully updated from <old version> to version <new version> と報告します。すでに最新のネイティブインストールは Claude Code is up to date (<version>) と報告します。すでに最新のHomebrew、WinGetまたはapkのインストールでは、claude update は Claude is up to date! と報告します。

autoUpdatesChannel の既定は latest で、stable にもできます。stableは通常およそ1週間前のバージョンで、大きなリグレッションのあるリリースを飛ばします。/config → Auto-update channel で設定するか、ユーザー設定ファイル ~/.claude/settings.json に書きます。Homebrewはこの設定ではなくcask名でチャンネルを選びます。claude-code はstable、claude-code@latest はlatestを追います。

minimumVersion は下限です。バックグラウンドの自動更新と claude update は、それより下のバージョンを拒否します。この下限があると、stableへ移しても、より新しいlatestビルドはそのまま残ります。/config でlatestからstableへ切り替えると、現在のバージョンに留まるか、ダウングレードを許可するかを尋ねます。留まるを選ぶと、minimumVersion が現在のバージョンに設定されます。latestへ戻すとその下限は消えます。自分で下限を固定するには ~/.claude/settings.json に minimumVersion を追加します。Anthropicの setup ページはサンプル値に 2.1.100 を使い、下限は自分で設定します。管理設定の requiredMinimumVersion と requiredMaximumVersion があると、Claude Codeはそのバージョン範囲の外では起動を拒否し、更新は requiredMaximumVersion の上限に従います。

バックグラウンドの確認を止めるには、~/.claude/settings.json の env キーで DISABLE_AUTOUPDATER を 1 にします。claude update と claude install は引き続き動きます。ネイティブまたはnpmのインストールでは、claude doctor の Auto-updates が disabled (set by env: DISABLE_AUTOUPDATER) と表示される必要があります。DISABLE_UPDATES は手動更新を含むすべての更新経路を止めます。

Homebrew、WinGet、apt、dnf、apkのインストールは、既定では自動更新しません。CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 にすると、Claude CodeがHomebrewまたはWinGetのアップグレードをバックグラウンドで実行し、成功すると再起動を促します。WinGetでは、Claude Codeの実行中はWindowsが実行ファイルをロックするためアップグレードが失敗することがあり、その場合Claude Codeは手動コマンドを表示します。apt、dnf、apkは、それらのコマンドに昇格した権限が必要なため、引き続き手動アップグレードが必要です。Anthropicは既知の問題を文書化しています。Claude Codeは、そのバージョンがHomebrew、WinGet、apt、dnf、apkで入手できるより前に更新を通知することがあります。アップグレードが失敗したら、待ってから後でやり直します。

v2.1.207以降、自動更新と claude update は ~/.local/bin/claude にあるカスタムランチャーをそのまま残します。それより前のバージョンでは、アップデータが更新のたびにカスタムランチャーを自身のsymlinkに置き換えていました。ネイティブインストーラーにランチャーを再び管理させるには、~/.local/bin/claude を削除して claude update を実行します。

2.1.89以降、各リリースはSHA256チェックサムを収めたGPG署名付き manifest.json を公開します。https://downloads.claude.ai/keys/claude-code.asc からキーをインポートし、フィンガープリント 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE を確認します。macOSのバイナリはAnthropic PBCが署名し、Appleが公証します。WindowsのバイナリはAnthropic, PBCが署名します。Linuxのバイナリは個別にはコード署名されていないため、manifestか、apt、dnf、apkのリポジトリキーを使います。

~/.claude/settings.json

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

入れた方法でアンインストールし、設定を消すか決める

Claude Codeは、インストールに使ったのと同じ方法で削除します。下の一覧は各インストーラーに対応しています。そのあとも claude が動く場合、Anthropicは、別のインストールか、古いインストーラーが残したシェルaliasの可能性が高いとしています。Troubleshoot installation ページの Check for conflicting installations を使います。

ユーザー設定は ~/.claude と ~/.claude.json にあります。プロジェクト設定はリポジトリ内の .claude と .mcp.json にあります。MCP（Model Context Protocol）サーバーは、Claude Codeがそれらの設定ファイルから読み込む追加のツールです。これらのパスを削除すると、設定、許可したツール、MCPサーバーの構成、セッション履歴が消えます。VS Code拡張、JetBrainsプラグイン、Desktopアプリが残っていると、~/.claude は再作成されます。

changelogページはGitHubの CHANGELOG.md から生成されます。入っているバージョンは claude --version で確認します。

ネイティブ macOS、Linux、WSL: rm -f ~/.local/bin/claude と rm -rf ~/.local/share/claude
ネイティブ Windows PowerShell: Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force のあと Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
brew uninstall --cask claude-code
brew uninstall --cask claude-code@latest
winget uninstall Anthropic.ClaudeCode
sudo apt remove claude-code のあと sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc
sudo dnf remove claude-code のあと sudo rm /etc/yum.repos.d/claude-code.repo
apk del claude-code、続けて sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories、続けて rm /etc/apk/keys/claude-code.rsa.pub
npm uninstall -g @anthropic-ai/claude-code

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

OSに合うインストーラーを選び、claude --version と claude doctor を実行し、claude でログインします。アップグレードとアンインストールも同じ方法を使います。

出典

Advanced setup · 確認 2026-09-24
Quickstart · 確認 2026-09-24
Troubleshooting · 確認 2026-09-24
Claude Code changelog · 確認 2026-09-24