Claude Code Windows インストール手順とトラブルシューティング

Contents

1 1. 前提条件と環境設定
2 2. ダウンロードとファイルの検証
3 3. インストールと PATH 設定
- 3.1 3‑1. ファイル配置の推奨場所
- 3.2 3‑2. システム環境変数 PATH に追加
4 4. 初回起動と認証フロー
- 4.1 4‑1. 基本的な起動コマンド
- 4.2 4‑2. 「Plan Mode」について（※バージョン依存）
5 5. よくあるエラーと対処法
6 6. アンインストールとクリーンアップ
- 6.1 6‑1. 標準アンインストーラの利用
- 6.2 6‑2. 残存ファイル・レジストリの手動削除（完全クリーン）
7 7. 補足：自動化スクリプト例
8 おわりに

スポンサードリンク

1. 前提条件と環境設定

項目	必要な理由	設定手順
Git for Windows (Git Bash)	Claude Code の内部スクリプトは `git` コマンドを呼び出すため、Unix 系シェルが必要です。	公式サイトからインストーラ（例：`Git‑2.xx.x‑64-bit.exe`）を取得し、デフォルト設定でインストール → スタートメニュー→「Git Bash」を起動して `git --version` が表示されれば完了。
PowerShell の実行ポリシー	デフォルトの `Restricted` では外部から取得した `.ps1` スクリプトがブロックされ、インストールや自動化に支障があります。	管理者権限で PowerShell を開き、次を実行 `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force` 設定後は `Get-ExecutionPolicy -Scope CurrentUser` が `RemoteSigned` と表示されることを確認。
管理者権限	デフォルトのインストール先（例：`C:\Program Files\Claude Code`）はシステム保護領域であり、書き込みに UAC の承認が必要です。	PowerShell／コマンドプロンプトを「管理者として実行」で起動し、以降の操作はすべてこのウィンドウで行う。

2. ダウンロードとファイルの検証

2‑1. 正式サイトから取得する

URL：公式ダウンロードページ（例：https://code.claude.com/download）にアクセスし、Windows 用実行ファイル ClaudeCode-windows-x64.exe をクリックして保存。
注意点：非公式ミラーは改ざんリスクがあるため、必ず公式 URL から取得してください。

2‑2. SHA256 ハッシュで整合性を確認

公式ページに記載されている SHA256 値（例として以下を使用）とローカルで計算したハッシュが一致するか確認します。

# ダウンロード先のフルパスに置き換えて実行
$localPath = "$env:USERPROFILE\Downloads\ClaudeCode.exe"
$calcHash  = (Get-FileHash -Path $localPath -Algorithm SHA256).Hash

# 公式ページから取得したハッシュ（64 桁の16進数）※実際は公式値に差し替える
$officialHash = "3A7F5C9E4B6D8F1A2C3E4F56789ABCDEF1234567890ABCDEFFEDCBA098765432"

if ($calcHash -eq $officialHash) {
    Write-Host "&#x2705; SHA256 が一致しました。"
} else {
    throw "&#x274c; SHA256 が一致しません。ダウンロードをやり直してください。"
}

# ダウンロード先のフルパスに置き換えて実行

$localPath = "$env:USERPROFILE\Downloads\ClaudeCode.exe"

$calcHash = (Get-FileHash -Path $localPath -Algorithm SHA256).Hash

# 公式ページから取得したハッシュ（64 桁の16進数）※実際は公式値に差し替える

$officialHash = "3A7F5C9E4B6D8F1A2C3E4F56789ABCDEF1234567890ABCDEFFEDCBA098765432"

if ($calcHash -eq $officialHash) {

Write-Host "✅ SHA256 が一致しました。"

} else {

throw "❌ SHA256 が一致しません。ダウンロードをやり直してください。"

}

ポイント：ハッシュが一致しない場合は、必ず再ダウンロードまたは別のネットワークから取得し直すこと。

2‑3. Authenticode 署名で配布元を確認

PowerShell の Get-AuthenticodeSignature を使い、ファイルに正しい署名が付与されているかチェックします。

$sig = Get-AuthenticodeSignature -FilePath $localPath
if ($sig.Status -eq 'Valid' -and $sig.SignerCertificate.Subject -match "Anthropic") {
    Write-Host "&#x2705; 正規の署名が確認できました。"
} else {
    throw "&#x274c; 署名が無効または配布元が不明です。公式サイトから再取得してください。"
}

$sig = Get-AuthenticodeSignature -FilePath $localPath

if ($sig.Status -eq 'Valid' -and $sig.SignerCertificate.Subject -match "Anthropic") {

Write-Host "✅ 正規の署名が確認できました。"

} else {

throw "❌ 署名が無効または配布元が不明です。公式サイトから再取得してください。"

}

3. インストールと PATH 設定

3‑1. ファイル配置の推奨場所

配置例	用途
`C:\Program Files\Claude Code`（インストーラ使用）	システム全体で利用する標準的なインストール先。
`C:\Tools\ClaudeCode`（単体 exe のみ）	管理しやすいカスタムディレクトリ。権限が必要な場合は管理者 PowerShell から作成。

手順例（単体 exe を配置するケース）

$dest = "C:\Tools\ClaudeCode"
New-Item -ItemType Directory -Force -Path $dest   # フォルダ作成
Move-Item -Force "$localPath" "$dest\ClaudeCode.exe"

$dest = "C:\Tools\ClaudeCode"

New-Item -ItemType Directory -Force -Path $dest # フォルダ作成

Move-Item -Force "$localPath" "$dest\ClaudeCode.exe"

3‑2. システム環境変数 PATH に追加

# 管理者 PowerShell で実行
$dir = "C:\Tools\ClaudeCode"
$current = &#91;Environment]::GetEnvironmentVariable('Path', 'Machine')
if ($current -notmatch &#91;regex]::Escape($dir)) {
    $new = "$current;$dir"
    &#91;Environment]::SetEnvironmentVariable('Path', $new, 'Machine')
    Write-Host "&#x2705; PATH に追加しました。再起動または `refreshenv` 後に有効化されます。"
}

# 管理者 PowerShell で実行

$dir = "C:\Tools\ClaudeCode"

$current = [Environment]::GetEnvironmentVariable('Path', 'Machine')

if ($current -notmatch [regex]::Escape($dir)) {

$new = "$current;$dir"

[Environment]::SetEnvironmentVariable('Path', $new, 'Machine')

Write-Host "✅ PATH に追加しました。再起動または `refreshenv` 後に有効化されます。"

}

確認：コマンドプロンプト／PowerShell で claude --version と入力し、バージョン情報が表示されれば完了です。

4. 初回起動と認証フロー

4‑1. 基本的な起動コマンド

claude start

1 2	claude start

実行すると「Starting Claude Code...」というログが出力され、内部で必要コンポーネントの取得や API キー入力が自動化されます。バージョンやオプションは claude --help で確認できます。

4‑2. 「Plan Mode」について（※バージョン依存）

一部のリリースでは トークン使用量を上限管理する「Plan Mode」 がデフォルトで有効になっています。
- 有効状態は claude config show の出力に planMode = true と表示されます。
- 無効化したい場合は claude config set --plan-mode off（または公式ドキュメントの指示）を実行し、再起動してください。

注意：機能名やオプションはバージョンごとに変わる可能性があります。最新情報は必ず公式ヘルプ (claude --help) を参照してください。

5. よくあるエラーと対処法

エラーメッセージ	原因	解決策
`git: command not found`	Git Bash が未インストールまたは PATH に登録されていない	前述の Git for Windows を再インストールし、`git --version` が正しく表示されることを確認
`ExecutionPolicy prevents running scripts`	PowerShell の実行ポリシーが `Restricted` のまま	管理者 PowerShell で `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force` を再実行
`Get-AuthenticodeSignature : NotSigned / HashMismatch`	ダウンロードファイルの破損または非公式配布	公式サイトから再ダウンロードし、SHA256 と署名を改めて検証
`File not found: ClaudeCode.exe` (WSL)	Windows パスと Linux パスの不一致	WSL 側では `/mnt/c/Tools/ClaudeCode/ClaudeCode.exe` のように /mnt/ プレフィックスで指定

6. アンインストールとクリーンアップ

6‑1. 標準アンインストーラの利用

Windowsキー + I → 「アプリ」→「インストールされたアプリ一覧」
「Claude Code」を選択し「アンインストール」ボタンをクリック
画面指示に従い完了

6‑2. 残存ファイル・レジストリの手動削除（完全クリーン）

# 管理者 PowerShell で実行
Remove-Item -Recurse -Force "C:\Program Files\Claude Code"
Remove-Item -Recurse -Force "$env:APPDATA\ClaudeCode"

# レジストリキー例（Anthropic が残っている場合）
Remove-Item -Path 'HKLM:\Software\Anthropic' -Recurse -Force

# 管理者 PowerShell で実行

Remove-Item -Recurse -Force "C:\Program Files\Claude Code"

Remove-Item -Recurse -Force "$env:APPDATA\ClaudeCode"

# レジストリキー例（Anthropic が残っている場合）

Remove-Item -Path 'HKLM:\Software\Anthropic' -Recurse -Force

注意：レジストリ操作は誤削除の危険があります。対象キーが存在しない場合はエラーは無視して構いません。

7. 補足：自動化スクリプト例

以下は「ダウンロード → ハッシュ検証 → 署名確認 → 配置 & PATH 追加」までを一括で実行する PowerShell スニペットです。管理者権限の PowerShell からコピーして使用してください。

# -------------------------------------------------
# 1. ダウンロード
# -------------------------------------------------
$downloadUrl = "https://code.claude.com/download/ClaudeCode-windows-x64.exe"
$outPath     = "$env:USERPROFILE\Downloads\ClaudeCode.exe"
Invoke-WebRequest -Uri $downloadUrl -OutFile $outPath

# -------------------------------------------------
# 2. SHA256 検証（公式ハッシュは実際のものに差し替えてください）
# -------------------------------------------------
$expectedHash = "3A7F5C9E4B6D8F1A2C3E4F56789ABCDEF1234567890ABCDEFFEDCBA098765432"
$actualHash   = (Get-FileHash -Path $outPath -Algorithm SHA256).Hash
if ($actualHash -ne $expectedHash) {
    throw "&#x274c; SHA256 が一致しません。ダウンロードをやり直してください。"
}
Write-Host "&#x2705; SHA256 確認完了"

# -------------------------------------------------
# 3. Authenticode 署名確認
# -------------------------------------------------
$sig = Get-AuthenticodeSignature -FilePath $outPath
if ($sig.Status -ne 'Valid' -or $sig.SignerCertificate.Subject -notmatch "Anthropic") {
    throw "&#x274c; 署名が無効です。公式サイトから再取得してください。"
}
Write-Host "&#x2705; 正規の署名を確認"

# -------------------------------------------------
# 4. 配置 &amp; PATH 追加
# -------------------------------------------------
$destDir = "C:\Tools\ClaudeCode"
New-Item -ItemType Directory -Force -Path $destDir
Move-Item -Force $outPath "$destDir\ClaudeCode.exe"

# PATH に追記（重複チェック付き）
$currentPath = &#91;Environment]::GetEnvironmentVariable('Path', 'Machine')
if ($currentPath -notmatch &#91;regex]::Escape($destDir)) {
    &#91;Environment]::SetEnvironmentVariable('Path', "$currentPath;$destDir", 'Machine')
    Write-Host "&#x2705; PATH に $destDir を追加しました。再起動後に有効です。"
}

Write-Host "`nインストールが完了しました。'claude --version' で確認してください。"

# -------------------------------------------------

# 1. ダウンロード

# -------------------------------------------------

$downloadUrl = "https://code.claude.com/download/ClaudeCode-windows-x64.exe"

$outPath = "$env:USERPROFILE\Downloads\ClaudeCode.exe"

Invoke-WebRequest -Uri $downloadUrl -OutFile $outPath

# -------------------------------------------------

# 2. SHA256 検証（公式ハッシュは実際のものに差し替えてください）

# -------------------------------------------------

$expectedHash = "3A7F5C9E4B6D8F1A2C3E4F56789ABCDEF1234567890ABCDEFFEDCBA098765432"

$actualHash = (Get-FileHash -Path $outPath -Algorithm SHA256).Hash

if ($actualHash -ne $expectedHash) {

throw "❌ SHA256 が一致しません。ダウンロードをやり直してください。"

}

Write-Host "✅ SHA256 確認完了"

# -------------------------------------------------

# 3. Authenticode 署名確認

# -------------------------------------------------

$sig = Get-AuthenticodeSignature -FilePath $outPath

if ($sig.Status -ne 'Valid' -or $sig.SignerCertificate.Subject -notmatch "Anthropic") {

throw "❌ 署名が無効です。公式サイトから再取得してください。"

}

Write-Host "✅ 正規の署名を確認"

# -------------------------------------------------

# 4. 配置 & PATH 追加

# -------------------------------------------------

$destDir = "C:\Tools\ClaudeCode"

New-Item -ItemType Directory -Force -Path $destDir

Move-Item -Force $outPath "$destDir\ClaudeCode.exe"

# PATH に追記（重複チェック付き）

$currentPath = [Environment]::GetEnvironmentVariable('Path', 'Machine')

if ($currentPath -notmatch [regex]::Escape($destDir)) {

[Environment]::SetEnvironmentVariable('Path', "$currentPath;$destDir", 'Machine')

Write-Host "✅ PATH に $destDir を追加しました。再起動後に有効です。"

}

Write-Host "`nインストールが完了しました。'claude --version' で確認してください。"

おわりに

公式情報を常に参照 – ダウンロード URL、SHA256 ハッシュ、CLI オプションはバージョン更新ごとに変わります。
検証を怠らない – ハッシュ・署名の両方が一致した時点でのみインストールを進めてください。
管理者権限で作業 – インストール先や環境変数変更はシステムレベルの操作になるため、必ず「管理者として実行」してください。

本手順に沿って設定すれば、Windows 環境でも安全かつスムーズに Claude Code を利用できるはずです。質問やトラブルがあれば公式サポートフォーラムをご活用ください。

スポンサードリンク