システム要件
Claude Code は以下のプラットフォームと構成で実行されます。- オペレーティングシステム:
- macOS 13.0 以上
- Windows 10 1809 以上または Windows Server 2019 以上
- Ubuntu 20.04 以上
- Debian 10 以上
- Alpine Linux 3.19 以上
- ハードウェア: 4 GB 以上の RAM、x64 または ARM64 プロセッサ
- ネットワーク: インターネット接続が必要です。ネットワーク構成を参照してください。
- シェル: Bash、Zsh、PowerShell、または CMD。
- 場所: Anthropic サポート対象国
追加の依存関係
- ripgrep: 通常は Claude Code に含まれています。検索が失敗する場合は、検索トラブルシューティングを参照してください。
Claude Code をインストール
Claude Code をインストールするには、ターミナルを開いてシステムのコマンドを実行してください。ターミナルを使用したことがない場合は、ターミナルガイドでターミナルを開いてコマンドを貼り付ける方法を確認できます。- ネイティブインストール(推奨)
- Homebrew
- WinGet
macOS、Linux、WSL:Windows では、PowerShell を使用している場合はシェルプロンプトに Windows CMD:インストーラーが完了したら、新しいターミナルウィンドウを開いて
PS C:\ と表示され、CMD を使用している場合は PS なしで C:\ と表示されます。Windows PowerShell:claude --version を実行してください。インストールが正常に完了すると、バージョン番号が表示されます。シェルが claude が見つからない、または認識されていないと表示される場合は、インストールディレクトリがまだ PATH に含まれていません。PATH を修正するを参照してください。The token '&&' is not a valid statement separator というエラーが表示される場合は、CMD ではなく PowerShell を使用しています。'irm' is not recognized as an internal or external command というエラーが表示される場合は、PowerShell ではなく CMD を使用しています。インストールコマンドが syntax error near unexpected token '<'、403、またはその他のエラーで失敗する場合は、インストールのトラブルシューティングを参照して、エラーを修正方法に照合し、代替インストール方法を確認してください。Git for Windows は、Claude Code が Bash ツールを使用できるようにネイティブ Windows で推奨されます。Git for Windows がインストールされていない場合、Claude Code はシェルツールとして PowerShell を代わりに使用します。WSL セットアップは Git for Windows を必要としません。ネイティブインストールは、最新バージョンに保つために自動的にバックグラウンドで更新されます。
Windows でのセットアップ
Claude Code をネイティブに Windows で実行することも、WSL 内で実行することもできます。プロジェクトの場所と必要な機能に基づいて選択してください。
オプション 1: ネイティブ Windows
PowerShell または CMD からインストールコマンドを実行します。管理者として実行する必要はありません。Git for Windowsをインストールすることはオプションです。これにより、Bash ツールとMonitor ツールに必要な Git Bash が提供されます。
PowerShell または CMD からインストールするかどうかは、実行するインストールコマンドにのみ影響します。プロンプトは PowerShell では
PS C:\Users\YourName> と表示され、CMD では PS なしで C:\Users\YourName> と表示されます。ターミナルが初めての場合は、ターミナルガイドで各ステップを説明しています。
インストール後、任意のターミナルから claude を起動します。
- Git for Windows がない場合、Claude Code はPowerShell ツール経由でシェルコマンドを実行します。
-
Git for Windows がある場合、Claude Code はBash ツールに Git Bash を使用します。Claude Code が Git Bash を見つけられない場合は、settings.json ファイルでパスを設定します。
CLAUDE_CODE_USE_POWERSHELL_TOOL=1 で有効になります。0 に設定してツールをオフにします。セットアップと制限については、PowerShell ツールを参照してください。
オプション 2: WSL
WSL ディストリビューションを開き、上記のインストール手順から Linux インストーラーを実行します。PowerShell または CMD からではなく、WSL ターミナル内で claude をインストールして起動します。
Alpine Linux と musl ベースのディストリビューション
Alpine およびその他の musl/uClibc ベースのディストリビューション上に Claude Code をインストールするには、インストールコマンド用にbash と curl が必要であり、実行時に libgcc、libstdc++、および ripgrep が必要です。Alpine はデフォルトで bash と curl を含まないため、ドキュメント化されたインストールコマンドは not found エラーで失敗します。これらをインストールするまで、ディストリビューションのパッケージマネージャーを使用してこれらのパッケージをインストールしてから、USE_BUILTIN_RIPGREP=0 を設定します。
この例は Alpine で必要なパッケージをインストールします。
ripgrep はコミュニティリポジトリにあります。apk がパッケージが見つからないと報告する場合は、Alpine バージョンを使用して /etc/apk/repositories にコミュニティリポジトリを追加します。
apk update を実行してパッケージインデックスを更新し、apk add コマンドを再試行します。
次に、settings.jsonファイルで USE_BUILTIN_RIPGREP を 0 に設定します。
インストールを確認
インストール後、Claude Code が機能していることを確認します。2.1.211 (Claude Code) のようなバージョン番号が表示されます。
これが command not found または別のエラーで失敗する場合は、インストールとログインのトラブルシューティングを参照してください。
インストールと構成をより詳しく確認するには、claude doctorを実行します。
claude doctor は、セッションを開始せずに読み取り専用のインストールと設定の診断を出力します。これには、インストールの正常性、設定ファイルの検証エラー、および推奨される修正を含む警告が含まれます。
認証
Claude Code には、Pro、Max、Team、Enterprise、または Console アカウントが必要です。無料の claude.ai プランには Claude Code アクセスは含まれていません。Amazon Bedrock、Google Cloud の Agent Platform、またはMicrosoft Foundryなどのサードパーティ API プロバイダーで Claude Code を使用することもできます。 インストール後、claude を実行してブラウザーのプロンプトに従ってログインします。ANTHROPIC_API_KEY 環境変数を設定しており、そのキーを使用するかどうかを Claude Code に尋ねられたときにキーを承認すると、Claude Code はログインプロンプトをスキップします。すべてのアカウントタイプとチームセットアップオプションについては、認証を参照してください。
Claude Code を更新
ネイティブインストールは自動的にバックグラウンドで更新されます。リリースチャネルを構成して、更新をすぐに受け取るか遅延安定スケジュールで受け取るかを制御することも、自動更新を完全に無効にすることもできます。Homebrew、WinGet、およびLinux パッケージマネージャーインストールは手動更新が必要です。自動更新
Claude Code は起動時と実行中に定期的に更新をチェックします。更新はバックグラウンドでダウンロードおよびインストールされ、次に Claude Code を起動するときに有効になります。claude doctor を実行して、最新の更新試行の結果を確認します。
macOS と Linux では、ネイティブインストーラーは ~/.local/bin/claude のランチャーを ~/.local/share/claude/versions/ へのシンボリックリンクとして管理します。そのランチャーを独自のスクリプトまたはシンボリックリンクに置き換えた場合、自動更新と claude update はそれをそのまま保持します。新しいバージョンは引き続き versions/ ディレクトリの下にインストールされ、ランチャーはどのバージョンを実行するかを決定します。v2.1.207 より前では、自動アップデーターは毎回の更新時にそのパスのカスタムランチャーを独自のシンボリックリンクに置き換えていました。
カスタムランチャーを使用する場合、Claude Code はランチャーがどのバージョンを必要とするかを判断できないため、インストール済みのすべてのバージョンをディスク上に保持します。claude doctor はネイティブインストーラーが作成しなかったランチャーを報告します。
Claude Code にランチャーを再度管理させるには、~/.local/bin/claude を削除して claude update を実行します。
npm グローバルインストールが npm グローバルディレクトリが書き込み可能でないため自動更新できない場合、Claude Code は起動時に 1 回限りの通知を表示し、claude doctor は利用可能な修正を一覧表示します。詳細については、インストール中の権限エラーを参照してください。
Homebrew、WinGet、apt、dnf、および apk インストールはデフォルトでは自動更新されません。Homebrew と WinGet でオプトインするには、以下を参照してください。Homebrew を手動でアップグレードするには、
brew upgrade claude-code または brew upgrade claude-code@latest を実行します(インストールした cask によって異なります)。WinGet の場合は、winget upgrade Anthropic.ClaudeCode を実行します。Linux パッケージマネージャーの場合は、Linux パッケージマネージャーでインストールのアップグレードコマンドを参照してください。Claude Code が Homebrew または WinGet で自動的にアップグレードコマンドを実行するようにするには、CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEを 1 に設定します。Claude Code は新しいバージョンが利用可能な場合、バックグラウンドでアップグレードを実行し、成功時に再起動プロンプトを表示します。アップグレードは Claude Code パッケージのみを対象とし、インストール済みの他のソフトウェアには影響しません。WinGet では、Claude Code の実行中にアップグレードが失敗する場合があります。これは Windows が実行可能ファイルをロックするためです。その場合、Claude Code は代わりに手動コマンドを表示します。apt、dnf、および apk は、これらのコマンドが昇格された権限を必要とするため、手動アップグレードが必要です。既知の問題: Claude Code は、新しいバージョンがこれらのパッケージマネージャーで利用可能になる前に更新を通知する場合があります。アップグレードが失敗した場合は、しばらく待ってからもう一度試してください。Homebrew はアップグレード後、古いバージョンをディスク上に保持します。brew cleanup を定期的に実行してディスク容量を回収します。リリースチャネルを構成
autoUpdatesChannel 設定を使用して、Claude Code が自動更新と claude update に従うリリースチャネルを制御します。
"latest"、デフォルト: リリースされるとすぐに新機能を受け取ります"stable": 通常約 1 週間前のバージョンを使用し、大きな回帰を伴うリリースをスキップします
/config → 自動更新チャネル経由で構成するか、settings.json ファイルに追加します。
claude-code は安定版を追跡し、claude-code@latest は最新版を追跡します。
apt、dnf、および apk リポジトリからのインストールは、この設定ではなくリポジトリでチャネルを選択します。チャネルを切り替えるには、Linux パッケージマネージャーでインストールの手順に従ってください。
最小バージョンをピン留め
minimumVersion 設定は下限を確立します。バックグラウンド自動更新と claude update は、この値より下のバージョンのインストールを拒否するため、"stable" チャネルに移動しても、既に新しい "latest" ビルドを使用している場合はダウングレードされません。
/config 経由で "latest" から "stable" に切り替えると、現在のバージョンに留まるか、ダウングレードを許可するかを選択するよう求められます。留まることを選択すると、minimumVersion がそのバージョンに設定されます。"latest" に戻すと、それがクリアされます。
settings.json ファイルに追加して、下限を明示的にピン留めします。
minimumVersion ピンは更新のみを制約します。Claude Code がバージョン範囲外で起動することを拒否するようにするには、代わりに管理設定の requiredMinimumVersion と requiredMaximumVersion を使用します。更新は requiredMaximumVersion の上限も尊重します。requiredMinimumVersionとrequiredMaximumVersionを参照してください。
自動更新を無効にする
settings.jsonファイルの env キーで DISABLE_AUTOUPDATER を "1" に設定します。
claude doctor を実行して変更が有効になったことを確認し、Auto-updates 行が enabled ではなく disabled (set by env: DISABLE_AUTOUPDATER) を表示していることを確認します。
DISABLE_AUTOUPDATER はバックグラウンドチェックのみを停止します。claude update と claude install は引き続き機能します。手動更新を含むすべての更新パスをブロックするには、代わりに DISABLE_UPDATESを設定します。独自のチャネルを通じて Claude Code を配布し、ユーザーが提供するバージョンに留まる必要がある場合に使用します。
手動で更新
次のバックグラウンドチェックを待たずに更新をすぐに適用するには、以下を実行します。Successfully updated from <old version> to version <new version> を報告します。既に最新バージョンを使用している場合は、Claude Code is up to date (<version>) を報告します。Homebrew、WinGet、または apk で管理されるインストールは、代わりに Claude is up to date! を報告します。
高度なインストールオプション
これらのオプションは、バージョンピニング、Linux パッケージマネージャー、npm、ネットワークストレージ、およびバイナリ整合性の検証用です。特定のバージョンをインストール
ネイティブインストーラーは、特定のバージョン番号またはリリースチャネル(latest または stable)を受け入れます。インストール時に選択したチャネルが自動更新のデフォルトになります。詳細については、リリースチャネルを構成を参照してください。
最新バージョンをインストールするには(デフォルト):
- macOS, Linux, WSL
- Windows PowerShell
- Windows CMD
- macOS, Linux, WSL
- Windows PowerShell
- Windows CMD
- macOS, Linux, WSL
- Windows PowerShell
- Windows CMD
claude --version を実行します。このコマンドは、2.1.89 (Claude Code) など、渡した正確なバージョンを出力します。
Linux パッケージマネージャーでのインストール
Claude Code は署名付き apt、dnf、および apk リポジトリを公開しています。各リポジトリは 2 つのチャネルを提供します。stable は通常約 1 週間前のバージョンを提供し、大きな回帰を伴うリリースをスキップします。latest はリリースが出荷されるとすぐにすべてのリリースを提供します。以下のコマンドは stable チャネルを構成します。これはほとんどのユーザーに適しています。各タブは latest リポジトリ URL も表示します。パッケージマネージャーのインストールは Claude Code を通じて自動更新されません。更新は通常のシステムアップグレードワークフローを通じて提供されます。
すべてのリポジトリは Claude Code リリース署名キーで署名されています。キーを信頼する前に、各タブで説明されているとおりに検証してください。
- apt
- dnf
- apk
Debian および Ubuntu 用です。以下のインストールコマンドは 署名キーをダウンロードします:このダウンロードが失敗した場合、後で gpg が出力するフィンガープリントは 代わりに 後で更新するには、
curl で署名キーをダウンロードし、gpg で検証します。新しい Debian および Ubuntu インストールには curl と gpg が含まれていない場合があります。いずれかのコマンドが command not found を報告する場合は、まず両方をインストールしてください:apt update が NO_PUBKEY BAA929FF1A7ECACE で失敗します。キーがダウンロードされ、Anthropic に属していることを確認してから続行します:31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE である必要があります。gpg がファイルを開けない、または有効な OpenPGP データが含まれていないと報告する場合、ダウンロードが失敗したか、間違ったコンテンツが返されました。ネットワークが downloads.claude.ai に到達できることを確認してから、ダウンロードコマンドを再実行します。stable チャネルでリポジトリを登録してインストールします:latest チャネルを使用するには、URL パスとスイート名の両方が変わります。この deb 行を使用します:sudo apt update && sudo apt upgrade claude-code を実行します。npm でのインストール
Claude Code をグローバル npm パッケージとしてインストールすることもできます。npm パッケージには Node.js 22 以上が必要です。古い Node.js バージョンでは、npm はインストール中に失敗するのではなくEBADENGINE 警告を出力します。インストールは完了し、パッケージがランタイムで Node.js を使用しないネイティブバイナリをダウンロードするため、claude は引き続き実行されます。
@anthropic-ai/claude-code-darwin-arm64 などのプラットフォーム固有のオプション依存関係を通じてバイナリをプルし、postinstall ステップがそれを所定の位置にリンクします。インストールされた claude バイナリ自体は Node を呼び出しません。
サポートされている npm インストールプラットフォームは darwin-arm64、darwin-x64、linux-x64、linux-arm64、linux-x64-musl、linux-arm64-musl、win32-x64、および win32-arm64 です。パッケージマネージャーはオプション依存関係を許可する必要があります。インストール後にバイナリが見つからない場合は、トラブルシューティングを参照してください。
npm インストールをアップグレードするには、npm install -g @anthropic-ai/claude-code@latest を実行します。npm update -g は避けてください。これは元のインストールからの semver 範囲を尊重し、最新リリースに移動しない可能性があります。
ネットワークストレージへのインストール
実行中のセッションは、起動時だけでなく動作中にも Claude Code 実行ファイルの一部をディスクから読み取ります。ネットワークストレージ上でファイルが切り詰められたり削除されたりするなどして、セッションの途中でファイルが読み取れなくなると、セッションはクラッシュします。Linux では、シェルはこれをBus error として報告します。
複数のマシンにマウントされた NFS ホームなど、ホームディレクトリがネットワークストレージ上にある場合は、各セッションの実行ファイルがセッション終了まで読み取り可能な状態を保つようにインストールを配置してください:
- ローカルディスクにインストールする: Linux パッケージマネージャーや独自のデプロイツールなどを使用して、各マシンのローカルファイルシステムにバイナリを配置します。ユーザーごとの npm プレフィックスとネイティブインストーラーのデフォルトの
~/.local/share/claude/versions/ディレクトリは、どちらもホームディレクトリ内にあります。 - 各バージョンを専用のディレクトリに保持する:
npm install -gで npm インストールをその場でアップグレードすると、以前のバイナリが削除されます。複数のマシンが共有するストレージでは、他のマシン上のセッションがまだ実行中のファイルが削除されることになります。新しいバージョンはそれぞれ古いバージョンの隣にインストールし、ユーザーをそちらに移行してください。 - 古いバージョンは、どのマシンでも実行されている可能性がなくなってから削除する: マシンは他のマシンで実行中のプロセスを確認できないため、削除前に実行中のプロセスを確認するだけでは不十分です。
- Claude Code 自体の更新をオフにする:
DISABLE_UPDATESを設定し、独自のツールで新しいバージョンをインストールします。そうしないと、あるマシンでの npm インストールの自動更新が同じインプレースアップグレードを実行し、他のマシン上のセッションが実行中のバイナリを削除してしまいます。ユーザーは引き続きclaude updateやclaude installを実行できるため、DISABLE_AUTOUPDATERを設定するだけでは不十分です。自動更新を無効にするを参照してください。
~/.local/share/claude/versions/ から古いバージョンを自動的に削除します。このディレクトリが共有ストレージ上にある場合、この点が問題になります。ランチャーが指しているバージョンと、同じマシン上のセッションが実行中のバージョンに加えて、最新の 2 つのバージョンを保持し、残りを削除します。削除されたバージョンを実行している別のマシン上のセッションは、そのバイナリを失います。カスタムランチャーを使用する場合、Claude Code はインストールされたすべてのバージョンを保持し、クリーンアップはユーザーに任されます。
バイナリ整合性とコード署名
各リリースは、すべてのプラットフォームバイナリの SHA256 チェックサムを含むmanifest.json を公開します。マニフェストは Anthropic GPG キーで署名されているため、マニフェスト上の署名を検証することで、それが列挙するすべてのバイナリを推移的に検証します。
マニフェスト署名を検証
ステップ 1~3 には、gpg と curl を備えた POSIX シェルが必要です。Windows では、Git Bash または WSL で実行します。ステップ 4 には PowerShell オプションが含まれています。
1
公開鍵をダウンロードしてインポート
リリース署名キーは固定 URL で公開されています。インポートされたキーのフィンガープリントを表示します。出力にこのフィンガープリントが含まれていることを確認します:
2
マニフェストと署名をダウンロード
VERSION を検証するリリースに設定します。3
署名を検証
マニフェストに対して分離された署名を検証します。有効な結果は
Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>" を報告します。gpg は新しくインポートされたキーに対して WARNING: This key is not certified with a trusted signature! も出力します。これは予想されています。Good signature 行は暗号化チェックが成功したことを確認します。ステップ 1 のフィンガープリント比較はキー自体が本物であることを確認します。4
バイナリをマニフェストに対して確認
バイナリの SHA256 チェックサムを
manifest.json の platforms.<platform>.checksum の下にリストされている値と比較します。以下のコマンドは、現在のディレクトリに claude バイナリがあることを想定しています。代わりにインストールされたネイティブバイナリを検証するには、~/.local/share/claude/versions/VERSION に対してコマンドを実行します。VERSION をステップ 2 で設定したリリースに置き換えます。- Linux
- macOS
- Windows PowerShell
マニフェスト署名は
2.1.89 以降のリリースで利用可能です。以前のリリースは分離された署名なしで manifest.json にチェックサムを公開します。プラットフォームコード署名
署名付きマニフェストに加えて、個別のバイナリはサポートされている場所でプラットフォーム固有のコード署名を実行します。- macOS: “Anthropic PBC” によって署名され、Apple によって公証されています。
codesign --verify --verbose ./claudeで検証します。 - Windows: “Anthropic, PBC” によって署名されています。
Get-AuthenticodeSignature .\claude.exeで検証します。 - Linux: バイナリは個別にコード署名されていません。
claude-code-releasesバケットから直接ダウンロードするか、ネイティブインストーラーを使用する場合は、上記のマニフェスト署名で整合性を検証します。apt、dnf、または apkでインストールする場合、パッケージマネージャーはリポジトリ署名キーを使用して署名を自動的に検証します。
Claude Code をアンインストール
Claude Code を削除するには、インストール方法の指示に従ってください。アンインストール後もclaude が実行される場合は、2 番目のインストールまたは古いインストーラーからの残存シェルエイリアスがある可能性があります。競合するインストールを確認を参照して、それを見つけて削除してください。
ネイティブインストール
Claude Code バイナリとバージョンファイルを削除します:- macOS, Linux, WSL
- Windows PowerShell
Homebrew インストール
インストールした Homebrew cask を削除します。安定版 cask をインストールした場合:WinGet インストール
WinGet パッケージを削除します:apt / dnf / apk
パッケージとリポジトリ構成を削除します:- apt
- dnf
- apk
npm
グローバル npm パッケージを削除します:構成ファイルを削除
VS Code 拡張機能、JetBrains プラグイン、および Desktop アプリも~/.claude/ に書き込みます。それらのいずれかがまだインストールされている場合、ディレクトリは次回実行時に再作成されます。Claude Code を完全に削除するには、これらのファイルを削除する前に、VS Code 拡張機能、JetBrains プラグイン、および Desktop アプリをアンインストールしてください。
Claude Code の設定とキャッシュされたデータを削除するには:
- macOS, Linux, WSL
- Windows PowerShell