メインコンテンツへスキップ
このページでは、システム要件、プラットフォーム固有のインストール詳細、更新、およびアンインストールについて説明します。初回セッションのガイド付きウォークスルーについては、クイックスタートを参照してください。ターミナルを使用したことがない場合は、ターミナルガイドを参照してください。

システム要件

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 サポート対象国

追加の依存関係

Claude Code をインストール

グラフィカルインターフェースをお好みですか?Desktop appを使用すると、ターミナルなしで Claude Code を使用できます。macOSWindows、またはLinuxでダウンロードしてください。ターミナルは初めてですか?ターミナルガイドで段階的な手順を参照してください。
To install Claude Code, use one of the following methods: You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine. インストールが完了したら、作業するプロジェクトでターミナルを開き、Claude Code を起動します。
インストール中に問題が発生した場合は、インストールとログインのトラブルシューティングを参照してください。

Windows でのセットアップ

Claude Code をネイティブに Windows で実行することも、WSL 内で実行することもできます。プロジェクトの場所と必要な機能に基づいて選択してください。 オプション 1: ネイティブ Windows PowerShell または CMD からインストールコマンドを実行します。管理者として実行する必要はありません。Git for Windowsをインストールすることはオプションです。これにより Git Bash が提供され、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 ファイルでパスを設定します。
Git for Windows がインストールされている場合、PowerShell ツールは Bash と並行して追加オプションとして段階的にロールアウトされています。オプトインするには CLAUDE_CODE_USE_POWERSHELL_TOOL=1 を設定するか、オプトアウトするには 0 を設定します。セットアップと制限については、PowerShell ツールを参照してください。 オプション 2: WSL WSL ディストリビューションを開き、上記のインストール手順から Linux インストーラーを実行します。PowerShell または CMD からではなく、WSL ターミナル内で claude をインストールして起動します。

Alpine Linux と musl ベースのディストリビューション

Alpine およびその他の musl/uClibc ベースのディストリビューション上のネイティブインストーラーには、libgcclibstdc++、および ripgrep が必要です。ディストリビューションのパッケージマネージャーを使用してこれらをインストールしてから、USE_BUILTIN_RIPGREP=0 を設定します。 この例は Alpine で必要なパッケージをインストールします。
次に、settings.jsonファイルで USE_BUILTIN_RIPGREP0 に設定します。

インストールを確認

インストール後、Claude Code が機能していることを確認します。
これが command not found または別のエラーで失敗する場合は、インストールとログインのトラブルシューティングを参照してください。 インストールと構成をより詳しく確認するには、claude doctorを実行します。

認証

Claude Code には、Pro、Max、Team、Enterprise、または Console アカウントが必要です。無料の Claude.ai プランには Claude Code アクセスは含まれていません。Amazon BedrockGoogle Cloud の Agent Platform、またはMicrosoft Foundryなどのサードパーティ API プロバイダーで Claude Code を使用することもできます。 インストール後、claude を実行してブラウザーのプロンプトに従ってログインします。すべてのアカウントタイプとチームセットアップオプションについては、認証を参照してください。

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_UPDATE1 に設定します。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 ファイルに追加します。
エンタープライズデプロイメントの場合、管理設定を使用して、組織全体で一貫したリリースチャネルを適用できます。 Homebrew インストールは、この設定ではなく cask 名でチャネルを選択します。claude-code は安定版を追跡し、claude-code@latest は最新版を追跡します。

最小バージョンをピン留め

minimumVersion 設定は下限を確立します。バックグラウンド自動更新と claude update は、この値より下のバージョンのインストールを拒否するため、"stable" チャネルに移動しても、既に新しい "latest" ビルドを使用している場合はダウングレードされません。 /config 経由で "latest" から "stable" に切り替えると、現在のバージョンに留まるか、ダウングレードを許可するかを選択するよう求められます。留まることを選択すると、minimumVersion がそのバージョンに設定されます。"latest" に戻すと、それがクリアされます。 settings.json ファイルに追加して、下限を明示的にピン留めします。
管理設定では、これはユーザーおよびプロジェクト設定がオーバーライドできない組織全体の最小値を適用します。 minimumVersion ピンは更新のみを制約します。Claude Code がバージョン範囲外で起動することを拒否するようにするには、代わりに管理設定の requiredMinimumVersionrequiredMaximumVersion を使用します。更新は requiredMaximumVersion の上限も尊重します。利用可能な設定を参照してください。

自動更新を無効にする

settings.jsonファイルの env キーで DISABLE_AUTOUPDATER"1" に設定します。
DISABLE_AUTOUPDATER はバックグラウンドチェックのみを停止します。claude updateclaude install は引き続き機能します。手動更新を含むすべての更新パスをブロックするには、代わりに DISABLE_UPDATESを設定します。独自のチャネルを通じて Claude Code を配布し、ユーザーが提供するバージョンに留まる必要がある場合に使用します。

手動で更新

次のバックグラウンドチェックを待たずに更新をすぐに適用するには、以下を実行します。

高度なインストールオプション

これらのオプションは、バージョンピニング、Linux パッケージマネージャー、npm、およびバイナリ整合性の検証用です。

特定のバージョンをインストール

ネイティブインストーラーは、特定のバージョン番号またはリリースチャネル(latest または stable)を受け入れます。インストール時に選択したチャネルが自動更新のデフォルトになります。詳細については、リリースチャネルを構成を参照してください。 最新バージョンをインストールするには(デフォルト):
安定版をインストールするには:
特定のバージョン番号をインストールするには:

Linux パッケージマネージャーでのインストール

Claude Code は署名付き apt、dnf、および apk リポジトリを公開しています。各リポジトリは 2 つのチャネルを提供します。stable は通常約 1 週間前のバージョンを提供し、大きな回帰を伴うリリースをスキップします。latest はリリースが出荷されるとすぐにすべてのリリースを提供します。以下のコマンドは stable チャネルを構成します。これはほとんどのユーザーに適しています。各タブは latest リポジトリ URL も表示します。パッケージマネージャーのインストールは Claude Code を通じて自動更新されません。更新は通常のシステムアップグレードワークフローを通じて提供されます。 すべてのリポジトリは Claude Code リリース署名キーで署名されています。キーを信頼する前に、各タブで説明されているとおりに検証してください。
Debian および Ubuntu 用です。以下のインストールコマンドは curl で署名キーをダウンロードします。新しい Debian および Ubuntu インストールには curl が含まれていない場合があります。ダウンロードが sudo: curl: command not found で失敗する場合は、まず curl をインストールしてください:
以下のコマンドは stable チャネルを構成します:
代わりに latest チャネルを使用するには、URL パスとスイート名の両方が変わります。この deb 行を使用します:
信頼する前に GPG キーフィンガープリントを検証します。gpg --show-keys /etc/apt/keyrings/claude-code.asc31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE を報告する必要があります。後で更新するには、sudo apt update && sudo apt upgrade claude-code を実行します。

npm でのインストール

Claude Code をグローバル npm パッケージとしてインストールすることもできます。v2.1.198 以降、npm パッケージには Node.js 22 以上が必要です。古い Node.js バージョンでは、npm はインストール中に EBADENGINE 警告を出力するのではなく失敗します。インストールは完了し、パッケージがランタイムで Node.js を使用しないネイティブバイナリをダウンロードするため、claude は引き続き実行されます。
npm パッケージは、スタンドアロンインストーラーと同じネイティブバイナリをインストールします。npm は @anthropic-ai/claude-code-darwin-arm64 などのプラットフォーム固有のオプション依存関係を通じてバイナリをプルし、postinstall ステップがそれを所定の位置にリンクします。インストールされた claude バイナリ自体は Node を呼び出しません。 サポートされている npm インストールプラットフォームは darwin-arm64darwin-x64linux-x64linux-arm64linux-x64-musllinux-arm64-muslwin32-x64、および win32-arm64 です。パッケージマネージャーはオプション依存関係を許可する必要があります。インストール後にバイナリが見つからない場合は、トラブルシューティングを参照してください。 npm インストールをアップグレードするには、npm install -g @anthropic-ai/claude-code@latest を実行します。npm update -g は避けてください。これは元のインストールからの semver 範囲を尊重し、最新リリースに移動しない可能性があります。
sudo npm install -g を使用しないでください。これはアクセス許可の問題とセキュリティリスクにつながる可能性があります。アクセス許可エラーが発生した場合は、トラブルシューティングアクセス許可エラーを参照してください。

バイナリ整合性とコード署名

各リリースは、すべてのプラットフォームバイナリの SHA256 チェックサムを含む manifest.json を公開します。マニフェストは Anthropic GPG キーで署名されているため、マニフェスト上の署名を検証することで、それが列挙するすべてのバイナリを推移的に検証します。

マニフェスト署名を検証

ステップ 1~3 には、gpgcurl を備えた 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.jsonplatforms.<platform>.checksum の下にリストされている値と比較します。以下のコマンドは、現在のディレクトリに claude バイナリがあることを想定しています。代わりにインストールされたネイティブバイナリを検証するには、~/.local/share/claude/versions/VERSION に対してコマンドを実行します。VERSION をステップ 2 で設定したリリースに置き換えます。
マニフェスト署名は 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 バイナリとバージョンファイルを削除します:

Homebrew インストール

インストールした Homebrew cask を削除します。安定版 cask をインストールした場合:
最新版 cask をインストールした場合:

WinGet インストール

WinGet パッケージを削除します:

apt / dnf / apk

パッケージとリポジトリ構成を削除します:

npm

グローバル npm パッケージを削除します:

構成ファイルを削除

構成ファイルを削除すると、すべての設定、許可されたツール、MCP サーバー構成、およびセッション履歴が削除されます。
VS Code 拡張機能、JetBrains プラグイン、および Desktop アプリも ~/.claude/ に書き込みます。それらのいずれかがまだインストールされている場合、ディレクトリは次回実行時に再作成されます。Claude Code を完全に削除するには、これらのファイルを削除する前に、VS Code 拡張機能、JetBrains プラグイン、および Desktop アプリをアンインストールしてください。 Claude Code の設定とキャッシュされたデータを削除するには: