高度なセットアップ
Claude Code のシステム要件、プラットフォーム固有のインストール、バージョン管理、およびアンインストール。
このページでは、システム要件、プラットフォーム固有のインストール詳細、更新、およびアンインストールについて説明します。初回セッションのガイド付きウォークスルーについては、クイックスタートを参照してください。ターミナルを使用したことがない場合は、ターミナルガイドを参照してください。
システム要件
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。Windows ネイティブセットアップには Git for Windows が Git Bash に必要です。WSL セットアップは Git for Windows を必要としません。
- 場所: Anthropic サポート対象国
追加の依存関係
- ripgrep: 通常は Claude Code に含まれています。検索が失敗する場合は、検索トラブルシューティングを参照してください。
Claude Code をインストール
To install Claude Code, use one of the following methods:
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
If you see The token '&&' is not a valid statement separator, you're in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you're in CMD, not PowerShell. Your prompt shows PS C:\ when you're in PowerShell and C:\ without the PS when you're in CMD.
Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.
brew install --cask claude-code
Homebrew offers two casks. claude-code tracks the stable release channel, which is typically about a week behind and skips releases with major regressions. claude-code@latest tracks the latest channel and receives new versions as soon as they ship.
winget install Anthropic.ClaudeCode
You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine.
インストールが完了したら、作業するプロジェクトでターミナルを開き、Claude Code を起動します。
claude
インストール中に問題が発生した場合は、インストールとログインのトラブルシューティングを参照してください。
Windows でのセットアップ
Claude Code をネイティブに Windows で実行することも、WSL 内で実行することもできます。プロジェクトの場所と必要な機能に基づいて選択してください。
| オプション | 必須 | サンドボックス | 使用時期 |
|---|---|---|---|
| ネイティブ Windows | Git for Windows推奨；不在の場合は PowerShell を使用 | サポートされていません | Windows ネイティブプロジェクトとツール |
| WSL 2 | WSL 2 有効 | サポートされています | Linux ツールチェーンまたはサンドボックス化されたコマンド実行 |
| WSL 1 | WSL 1 有効 | サポートされていません | WSL 2 が利用できない場合 |
オプション 1: Git Bash を使用したネイティブ Windows
Git for Windowsをインストールしてから、PowerShell または CMD からインストールコマンドを実行します。管理者として実行する必要はありません。
PowerShell または CMD からインストールするかどうかは、実行するインストールコマンドにのみ影響します。プロンプトは PowerShell では PS C:\Users\YourName> と表示され、CMD では PS なしで C:\Users\YourName> と表示されます。ターミナルが初めての場合は、ターミナルガイドで各ステップを説明しています。
インストール後、PowerShell、CMD、または Git Bash から claude を起動します。Git Bash がインストールされている場合、Claude Code は起動元に関係なく、内部的に Git Bash を使用してコマンドを実行します。Claude Code が Git Bash インストールを見つけられない場合は、settings.json ファイルでパスを設定します。
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}
Claude Code は Windows でネイティブに PowerShell を実行することもできます。Git Bash がインストールされている場合、PowerShell ツールは追加オプションとして段階的にロールアウトされています。オプトインするには CLAUDE_CODE_USE_POWERSHELL_TOOL=1 を設定するか、オプトアウトするには 0 を設定します。セットアップと制限については、PowerShell ツールを参照してください。
オプション 2: WSL
WSL ディストリビューションを開き、上記のインストール手順から Linux インストーラーを実行します。PowerShell または CMD からではなく、WSL ターミナル内で claude をインストールして起動します。
Alpine Linux と musl ベースのディストリビューション
Alpine およびその他の musl/uClibc ベースのディストリビューション上のネイティブインストーラーには、libgcc、libstdc++、および ripgrep が必要です。ディストリビューションのパッケージマネージャーを使用してこれらをインストールしてから、USE_BUILTIN_RIPGREP=0 を設定します。
この例は Alpine で必要なパッケージをインストールします。
apk add libgcc libstdc++ ripgrep
次に、settings.jsonファイルで USE_BUILTIN_RIPGREP を 0 に設定します。
{
"env": {
"USE_BUILTIN_RIPGREP": "0"
}
}
インストールを確認
インストール後、Claude Code が機能していることを確認します。
claude --version
これが command not found または別のエラーで失敗する場合は、インストールとログインのトラブルシューティングを参照してください。
インストールと構成をより詳しく確認するには、claude doctorを実行します。
claude doctor
認証
Claude Code には、Pro、Max、Team、Enterprise、または Console アカウントが必要です。無料の Claude.ai プランには Claude Code アクセスは含まれていません。Amazon Bedrock、Google Vertex AI、またはMicrosoft Foundryなどのサードパーティ API プロバイダーで Claude Code を使用することもできます。
インストール後、claude を実行してブラウザーのプロンプトに従ってログインします。すべてのアカウントタイプとチームセットアップオプションについては、認証を参照してください。
Claude Code を更新
ネイティブインストールは自動的にバックグラウンドで更新されます。リリースチャネルを構成して、更新をすぐに受け取るか遅延安定スケジュールで受け取るかを制御することも、自動更新を完全に無効にすることもできます。Homebrew、WinGet、およびLinux パッケージマネージャーインストールは手動更新が必要です。
自動更新
Claude Code は起動時と実行中に定期的に更新をチェックします。更新はバックグラウンドでダウンロードおよびインストールされ、次に Claude Code を起動するときに有効になります。
リリースチャネルを構成
autoUpdatesChannel 設定を使用して、Claude Code が自動更新と claude update に従うリリースチャネルを制御します。
"latest"、デフォルト: リリースされるとすぐに新機能を受け取ります"stable": 通常約 1 週間前のバージョンを使用し、大きな回帰を伴うリリースをスキップします
これを /config → 自動更新チャネル経由で構成するか、settings.json ファイルに追加します。
{
"autoUpdatesChannel": "stable"
}
エンタープライズデプロイメントの場合、管理設定を使用して、組織全体で一貫したリリースチャネルを適用できます。
Homebrew インストールは、この設定ではなく cask 名でチャネルを選択します。claude-code は安定版を追跡し、claude-code@latest は最新版を追跡します。
最小バージョンをピン留め
minimumVersion 設定は下限を確立します。バックグラウンド自動更新と claude update は、この値より下のバージョンのインストールを拒否するため、"stable" チャネルに移動しても、既に新しい "latest" ビルドを使用している場合はダウングレードされません。
/config 経由で "latest" から "stable" に切り替えると、現在のバージョンに留まるか、ダウングレードを許可するかを選択するよう求められます。留まることを選択すると、minimumVersion がそのバージョンに設定されます。"latest" に戻すと、それがクリアされます。
settings.json ファイルに追加して、下限を明示的にピン留めします。
{
"autoUpdatesChannel": "stable",
"minimumVersion": "2.1.100"
}
管理設定では、これはユーザーおよびプロジェクト設定がオーバーライドできない組織全体の最小値を適用します。
自動更新を無効にする
settings.jsonファイルの env キーで DISABLE_AUTOUPDATER を "1" に設定します。
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
DISABLE_AUTOUPDATER はバックグラウンドチェックのみを停止します。claude update と claude install は引き続き機能します。手動更新を含むすべての更新パスをブロックするには、代わりに DISABLE_UPDATESを設定します。独自のチャネルを通じて Claude Code を配布し、ユーザーが提供するバージョンに留まる必要がある場合に使用します。
手動で更新
次のバックグラウンドチェックを待たずに更新をすぐに適用するには、以下を実行します。
claude update
高度なインストールオプション
これらのオプションは、バージョンピニング、Linux パッケージマネージャー、npm、およびバイナリ整合性の検証用です。
特定のバージョンをインストール
ネイティブインストーラーは、特定のバージョン番号またはリリースチャネル（latest または stable）を受け入れます。インストール時に選択したチャネルが自動更新のデフォルトになります。詳細については、リリースチャネルを構成を参照してください。
最新バージョンをインストールするには（デフォルト）:
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
安定版をインストールするには:
curl -fsSL https://claude.ai/install.sh | bash -s stable
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd
特定のバージョン番号をインストールするには:
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd
Linux パッケージマネージャーでのインストール
Claude Code は署名付き apt、dnf、および apk リポジトリを公開しています。ローリングチャネルの場合は stable を latest に置き換えてください。パッケージマネージャーのインストールは Claude Code を通じて自動更新されません。更新は通常のシステムアップグレードワークフローを通じて提供されます。
すべてのリポジトリは Claude Code リリース署名キーで署名されています。キーを信頼する前に、各タブで説明されているとおりに検証してください。
Debian および Ubuntu 用です。ローリングチャネルを使用するには、deb 行の両方の stable を変更します。URL パスとスイート名です。
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
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
信頼する前に GPG キーフィンガープリントを検証します。gpg --show-keys /etc/apt/keyrings/claude-code.asc は 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE を報告する必要があります。
後で更新するには、sudo apt update && sudo apt upgrade claude-code を実行します。
Fedora および RHEL 用:
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
dnf は最初のインストール時にキーをダウンロードし、フィンガープリントを確認するよう求めます。受け入れる前に 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE と一致することを確認してください。
後で更新するには、sudo dnf upgrade claude-code を実行します。
Alpine Linux 用:
wget -O /etc/apk/keys/claude-code.rsa.pub \
https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code
sha256sum /etc/apk/keys/claude-code.rsa.pub でダウンロードされたキーを検証します。これは 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6 を報告する必要があります。
後で更新するには、apk update && apk upgrade claude-code を実行します。
npm でのインストール
Claude Code をグローバル npm パッケージとしてインストールすることもできます。パッケージには Node.js 18 以上が必要です。
npm install -g @anthropic-ai/claude-code
npm パッケージは、スタンドアロンインストーラーと同じネイティブバイナリをインストールします。npm は @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 範囲を尊重し、最新リリースに移動しない可能性があります。
バイナリ整合性とコード署名
各リリースは、すべてのプラットフォームバイナリの SHA256 チェックサムを含む manifest.json を公開します。マニフェストは Anthropic GPG キーで署名されているため、マニフェスト上の署名を検証することで、それが列挙するすべてのバイナリを推移的に検証します。
マニフェスト署名を検証
ステップ 1～3 には、gpg と curl を備えた POSIX シェルが必要です。Windows では、Git Bash または WSL で実行します。ステップ 4 には PowerShell オプションが含まれています。
公開鍵をダウンロードしてインポート
リリース署名キーは固定 URL で公開されています。
curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import
インポートされたキーのフィンガープリントを表示します。
gpg --fingerprint security@anthropic.com
出力にこのフィンガープリントが含まれていることを確認します。
31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE
マニフェストと署名をダウンロード
VERSION を検証するリリースに設定します。
REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"
署名を検証
マニフェストに対して分離された署名を検証します。
gpg --verify manifest.json.sig manifest.json
有効な結果は 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 のフィンガープリント比較はキー自体が本物であることを確認します。
バイナリをマニフェストに対して確認
ダウンロードしたバイナリの SHA256 チェックサムを manifest.json の platforms.<platform>.checksum の下にリストされている値と比較します。
sha256sum claude
shasum -a 256 claude
(Get-FileHash claude.exe -Algorithm SHA256).Hash.ToLower()
プラットフォームコード署名
署名付きマニフェストに加えて、個別のバイナリはサポートされている場所でプラットフォーム固有のコード署名を実行します。
- 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 バイナリとバージョンファイルを削除します：
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Homebrew インストール
インストールした Homebrew cask を削除します。安定版 cask をインストールした場合：
brew uninstall --cask claude-code
最新版 cask をインストールした場合：
brew uninstall --cask claude-code@latest
WinGet インストール
WinGet パッケージを削除します：
winget uninstall Anthropic.ClaudeCode
apt / dnf / apk
パッケージとリポジトリ構成を削除します：
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
グローバル npm パッケージを削除します：
npm uninstall -g @anthropic-ai/claude-code
構成ファイルを削除
VS Code 拡張機能、JetBrains プラグイン、および Desktop アプリも ~/.claude/ に書き込みます。それらのいずれかがまだインストールされている場合、ディレクトリは次回実行時に再作成されます。Claude Code を完全に削除するには、これらのファイルを削除する前に、VS Code 拡張機能、JetBrains プラグイン、および Desktop アプリをアンインストールしてください。
Claude Code の設定とキャッシュされたデータを削除するには：
# ユーザー設定と状態を削除
rm -rf ~/.claude
rm ~/.claude.json
# プロジェクト固有の設定を削除（プロジェクトディレクトリから実行）
rm -rf .claude
rm -f .mcp.json
# ユーザー設定と状態を削除
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force
# プロジェクト固有の設定を削除（プロジェクトディレクトリから実行）
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force