はじめに
Claude CodeはAnthropicが提供するCLIベースのAIコーディングエージェントだ。macOS/Linuxではインストールが比較的簡単だが、WindowsではGit Bashパス設定、PowerShell実行ポリシー、PATH問題など、いくつかの段階で詰まることがある。
このガイドはWindows環境でClaude Codeをインストールする際に実際に遭遇した問題と解決方法をまとめた実践ガイドだ。Quick Startで素早くインストールするか、問題が発生したらステップバイステップの詳細ガイドを参照しよう。
1. 検証済み環境
| 項目 | バージョン/値 |
|---|
| OS | Windows 11 Home (10.0.26200) |
| Node.js | v24.12.0 (LTS) |
| npm | 11.6.2 |
| Git | 2.51.0.windows.2 |
| Claude Code | @anthropic-ai/claude-code@2.1.63 |
| デフォルトモデル | Claude Opus 4.6 (claude-opus-4-6) |
使用可能なClaudeモデル
| モデル | モデルID | 特徴 |
|---|
| Opus 4.6 | claude-opus-4-6 | 最も強力、複雑なタスクに適合 (デフォルト) |
| Sonnet 4.6 | claude-sonnet-4-6 | 高速応答、一般タスクに適合 |
| Haiku 4.5 | claude-haiku-4-5-20251001 | 最速、シンプルなタスクに適合 |
2. Quick Start（5ステップ）
すでにNode.jsとGitがインストールされているなら、以下の5ステップですぐにインストールできる。問題が発生したらステップバイステップ詳細ガイドを参照しよう。
事前確認
PowerShellを開いて以下のコマンドで現在の状態を確認する：
1
2
3
4
| node -v # バージョンが出る → Step 2でNode.jsをスキップ
npm -v # バージョンが出る → npm正常
git --version # バージョンが出る → Step 2でGitをスキップ
claude --version # バージョンが出る → すでにインストール済み！「アップグレード」セクションのみ参照
|
Step 1. 実行ポリシー設定（初回のみ）
1
| Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
|
Step 2. 必須プログラムのインストール
1
2
| winget install -e --id OpenJS.NodeJS.LTS
winget install -e --id Git.Git
|
インストール後は必ずPowerShellターミナルを完全に閉じて新しく開く必要がある。新しいターミナルを開くことでPATHが更新され、node、gitコマンドが認識される。
Step 3. Git Bashパス環境変数設定（初回のみ）
1
| [Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "User")
|
最後の引数"User"は実際のユーザー名ではない。Windows環境変数の適用範囲（Scope）を意味するキーワードだ。自分のユーザー名に置き換えてはいけない。
Step 4. Claude Codeのインストール
1
2
3
4
5
| # 方法A：公式スクリプト（推奨）
irm https://claude.ai/install.ps1 | iex
# 方法B：npm直接インストール（方法Aがダメな時）
npm install -g @anthropic-ai/claude-code
|
Step 5. インストール確認
1
2
| claude --version
# 例：2.1.63 (Claude Code) ← バージョン番号が出たら成功！
|
3. ステップバイステップ詳細ガイド
Quick Startで問題が発生した場合、このセクションで各ステップの詳細なトラブルシューティングを確認しよう。
3-1. PowerShell実行ポリシー設定
1
| Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
|
設定確認：
1
2
| Get-ExecutionPolicy -List
# CurrentUser項目がRemoteSignedである必要がある
|
| ポリシー | 説明 | 推奨 |
|---|
| Restricted | すべてのスクリプトをブロック（Windowsのデフォルト） | |
| RemoteSigned | ローカルスクリプト許可、リモートは署名必要 | 推奨 |
| Unrestricted | すべてのスクリプトを許可 | セキュリティリスク |
なぜ必要か？ Windowsはデフォルトでpowerシェルスクリプトの実行をブロック（Restricted）する。Claude Codeインストールスクリプトを実行するには、このポリシーをRemoteSignedに変更する必要がある。
3-2. Node.jsのインストール
1
| winget install -e --id OpenJS.NodeJS.LTS
|
インストール確認（新しいターミナルで）：
1
2
| node -v # 例：v24.12.0
npm -v # 例：11.6.2
|
wingetが使えない場合
wingetがない古いバージョンのWindowsなら手動インストール：
- https://nodejs.org/ にアクセス
- LTSバージョンをダウンロード
- インストーラー（.msi）を実行
- デフォルトオプションでインストール
- 新しいターミナルを開く
node -vで「コマンドが見つかりません」
原因： PATHにNode.jsパスが登録されていない。
解決手順：
- ターミナルを完全に閉じて新しく開く
- それでもダメならシステムを再起動
- それでもダメなら手動でPATHを追加：
- スタート → 「環境変数」で検索 → 「ユーザー環境変数」
- Pathを編集 →
C:\Program Files\nodejs\ を追加
3-3. Gitのインストール
1
| winget install -e --id Git.Git
|
インストール確認：
1
| git --version # 例：git version 2.51.0.windows.2
|
wingetが使えない場合
- https://gitforwindows.org/ にアクセス
- ダウンロード後、インストーラーを実行
- インストールオプションはデフォルトのまま（Git Bashが含まれてインストールされる）
- 新しいターミナルを開く
3-4. Git Bashパス環境変数設定
なぜ必要か？ Claude Codeは内部的にbashシェルを使用する。WindowsではGit Bashを使うが、自動でパスを見つけられない場合があるため、手動で指定する必要がある。
1
| [Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "User")
|
設定確認（新しいターミナルで）：
1
2
| echo $env:CLAUDE_CODE_GIT_BASH_PATH
# 例：C:\Program Files\Git\bin\bash.exe
|
"User"パラメータの説明
| 値 | 意味 | 備考 |
|---|
"User" | 現在ログインしているユーザーの環境変数 | 推奨（そのまま使用） |
"Machine" | システム全体の環境変数 | 管理者権限が必要 |
"Process" | 現在のターミナルセッションでのみ有効 | ターミナルを閉じると消える |
Gitが別のパスにインストールされている場合
1
2
3
4
5
6
7
8
9
10
11
| # Gitインストール場所の確認
where git
# 例：C:\Program Files\Git\cmd\git.exe
# → bash.exeは同じGitフォルダのbin内にある
# 一般的なGit Bashパス：
# C:\Program Files\Git\bin\bash.exe ← 64ビット（ほとんど）
# C:\Program Files (x86)\Git\bin\bash.exe ← 32ビット
# 確認されたパスで環境変数を設定
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "実際のパス", "User")
|
WSLを使う場合（代替）
1
| wsl --install # WSLインストール（初回のみ、再起動必要）
|
WSLでも可能だが、Git Bashパス設定の方が簡単なのでGit Bash方式を推奨する。
3-5. Claude Codeのインストール
方法A：公式インストールスクリプト（推奨）
1
| irm https://claude.ai/install.ps1 | iex
|
上記コマンドがうまくいかない時：
1
2
3
4
5
| # バリエーション1：scriptblockとして実行
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest
# バリエーション2：CMDスクリプトを使用
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
|
方法B：npm直接インストール（方法A失敗時）
1
| npm install -g @anthropic-ai/claude-code
|
npmコマンドの文法に注意しよう：
1
2
3
4
| npm install -g パッケージ名 # ✅ 正しい文法
npm i -g パッケージ名 # ✅ 省略形
npm --install パッケージ名 # ❌ 間違った文法
npm -install パッケージ名 # ❌ 間違った文法
|
3-6. インストール確認とPATH問題の解決
1
2
| claude --version
# 例：2.1.63 (Claude Code)
|
claudeコマンドが見つからない場合
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
| # 1. ターミナルを閉じて新しく開く
# 2. npmグローバルパスを確認
npm config get prefix
# 例：C:\Users\ユーザー名\AppData\Roaming\npm
# 3. そのパスがPATHに含まれているか確認
echo $env:PATH
# 4. PATHになければ追加（$env:USERPROFILEでユーザーパスを自動補完）
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\AppData\Roaming\npm",
"User"
)
# 5. 新しいターミナルを開いて再試行
claude --version
|
Windowsユーザー名の確認方法
パスでユーザー名を直接入力する必要がある場合：
1
2
3
4
5
6
7
8
9
10
11
| # 方法1：ユーザープロファイルフォルダのフルパス
echo $env:USERPROFILE
# 例：C:\Users\太郎 ← 「太郎」がユーザー名
# 方法2：ユーザー名のみ
echo $env:USERNAME
# 例：太郎
# 方法3：whoami
whoami
# 例：DESKTOP-ABC123\太郎 ← 「\」の後がユーザー名
|
$env:USERPROFILEを活用すればユーザー名を知らなくてもパスを自動的に補完できるので、できるだけ直接入力の代わりにこの変数を使おう。
4. インストール後の設定
設定ファイルの場所
| ファイル | パス | 用途 |
|---|
| グローバル設定 | %USERPROFILE%\.claude\settings.json | 言語、ステータスバーなど |
| プロジェクト設定 | プロジェクトフォルダ\.claude\settings.local.json | プロジェクト別権限など |
| プロジェクトコンテキスト | プロジェクトフォルダ\CLAUDE.md | AIに渡すルール/指示 |
グローバル設定の例
%USERPROFILE%\.claude\settings.json：
1
2
3
4
5
6
7
| {
"statusLine": {
"type": "command",
"command": "bash ~/.claude/statusline-command.sh"
},
"language": "Korean"
}
|
"language": "Korean" 設定でClaude Codeが韓国語で応答する。
5. Claude Codeの基本的な使い方
実行コマンド
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
| # プロジェクトフォルダで対話型セッションを開始
cd C:\MyProject
claude
# 1行質問（対話型セッションなしで直接回答）
claude -p "このコードのバグを探して"
# パイプで入力を渡す
cat main.cpp | claude -p "このコードをレビューして"
# 特定モデルで実行
claude --model claude-sonnet-4-6
# 前の会話を続ける
claude --continue
# 最新の会話を再開
claude --resume
|
会話中のスラッシュコマンド
| コマンド | 説明 |
|---|
/help | ヘルプを表示 |
/model | モデルの確認/変更 |
/compact | 会話コンテキストを圧縮（長い会話で便利） |
/clear | 会話をリセット |
/cost | 現在のセッションコストを確認 |
/fast | Fastモードのトグル（同じモデル、より速い出力） |
/commit | 変更をGitコミット |
/simplify | 変更コードの自動レビューと改善 |
/batch | 大規模コードベースの並列変更 |
/simplifyと/batchの詳細な説明はClaudeメモリ無料開放と/simplify、/batchの記事を参照しよう。
6. アップグレード
方法A：npm update（推奨）
1
| npm update -g @anthropic-ai/claude-code
|
方法B：最新バージョンの強制インストール
1
| npm install -g @anthropic-ai/claude-code@latest
|
アップグレード後の確認：
1
2
3
4
| # 新しいターミナルを開いて
claude --version
# 既存の設定ファイルは自動的に維持される。
|
7. 全体診断スクリプト
どこで問題が発生したかわからない時、このスクリプトをPowerShellに貼り付ければ環境全体を一度に診断できる。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
| Write-Host "=== Claude Code 環境診断 ===" -ForegroundColor Cyan
Write-Host "`n[Node.js]" -ForegroundColor Yellow
try { node -v } catch { Write-Host " ❌ 未インストール" -ForegroundColor Red }
Write-Host "`n[npm]" -ForegroundColor Yellow
try { npm -v } catch { Write-Host " ❌ 未インストール" -ForegroundColor Red }
Write-Host "`n[Git]" -ForegroundColor Yellow
try { git --version } catch { Write-Host " ❌ 未インストール" -ForegroundColor Red }
Write-Host "`n[Git Bashパス]" -ForegroundColor Yellow
$gitBash = [Environment]::GetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "User")
if ($gitBash) { Write-Host " $gitBash" } else { Write-Host " ❌ 未設定" -ForegroundColor Red }
Write-Host "`n[実行ポリシー]" -ForegroundColor Yellow
Get-ExecutionPolicy -Scope CurrentUser
Write-Host "`n[Claude Code]" -ForegroundColor Yellow
try { claude --version } catch { Write-Host " ❌ 未インストール" -ForegroundColor Red }
Write-Host "`n[npmグローバルパス]" -ForegroundColor Yellow
npm config get prefix
|
実行結果の例：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
| === Claude Code 環境診断 ===
[Node.js]
v24.12.0
[npm]
11.6.2
[Git]
git version 2.51.0.windows.2
[Git Bashパス]
C:\Program Files\Git\bin\bash.exe
[実行ポリシー]
RemoteSigned
[Claude Code]
2.1.63 (Claude Code)
[npmグローバルパス]
C:\Users\ユーザー名\AppData\Roaming\npm
|
すべての項目が正常ならインストール完了だ。赤い❌が表示されたら、該当セクションのトラブルシューティングを参照しよう。
8. トラブルシューティングまとめ
ファイルパスまとめ
| 項目 | パス |
|---|
| Claude実行ファイル | %USERPROFILE%\AppData\Roaming\npm\claude.cmd |
| npmグローバルパッケージ | %USERPROFILE%\AppData\Roaming\npm\ |
| Claudeグローバル設定 | %USERPROFILE%\.claude\settings.json |
| Claudeプロジェクト設定 | プロジェクト\.claude\settings.local.json |
| Git Bash | C:\Program Files\Git\bin\bash.exe |
おわりに
WindowsでClaude Codeをインストールする際に最も多く詰まる3つのポイント：
- ターミナル未再起動 — PATHが更新されず、インストールしたプログラムを認識しない
CLAUDE_CODE_GIT_BASH_PATH未設定 — Claude Codeがbashを見つけられず実行失敗"User"パラメータの混同 — 環境変数のScopeキーワードを自分のユーザー名と勘違い
この3つに注意すれば、ほとんどのインストール問題を解決できる。問題が発生したら診断スクリプトをまず実行してみよう。
References
