Claude Code を Windows にインストールする完全ガイド：Git、PATH、PowerShell、WSL、よくあるエラーまでまとめて解説
Windows で Claude Code を入れようとすると、意外とつまずくのは「インストールコマンド」そのものではありません。
実際には、その前後でこういう問題が起きやすいです。
- インストールは成功したはずなのに
claudeコマンドが見つからない - Git を入れたのに PowerShell から認識されない
- npm は成功したが PATH が通っていない
- 環境変数が今のウィンドウでは見えるのに、開き直すと消える
- PowerShell、Git Bash、WSL を混ぜてしまい、どこで何を設定したのか分からなくなる
この記事では、Windows 環境で Claude Code を 本当に使える状態にするまで を、順番に整理して説明します。
まず結論：初心者向けの一番安定した構成
最初は次の構成で進めるのが一番安定します。
- Windows Terminal
- PowerShell
- winget
- Git for Windows
- Node.js LTS
- npm で Claude Code をグローバルインストール
- ユーザー環境変数
最初から以下を混ぜない方が安全です。
- cmd
- Git Bash
- WSL
どれも使えますが、最初の導入では「環境が複数ある」こと自体がトラブルの原因になります。
Step 1: PowerShell を使う
まず Windows Terminal を開き、PowerShell を選びます。
バージョン確認：
$PSVersionTable.PSVersion
PowerShell が正常に動いていることを確認できたら、以降の作業はこの環境で統一します。
なぜ PowerShell に統一するのか
たとえば以下のような混乱が起きやすいからです。
- PowerShell でインストールして、Git Bash で確認する
- Windows 側で環境変数を設定して、WSL 側で動かそうとする
- Node.js は Windows 側、Git は WSL 側、Claude Code は Git Bash 側、という状態になる
これでは問題が起きたときに切り分けが難しくなります。
Step 2: Git を先に入れる
Claude Code 自体は、場合によっては Git がなくても起動することがあります。
しかし、実際の開発作業では Git がないとかなり不便です。
まず確認します。
git --version
入っていなければ、winget でインストールします。
winget install --id Git.Git -e --source winget
インストール後は PowerShell を閉じて開き直す のが重要です。
その後、再確認します。
git --version
where.exe git
必要ならテスト用ディレクトリも作っておきます。
mkdir $HOME\Projects\claude-code-test -Force
cd $HOME\Projects\claude-code-test
git init
Step 3: Node.js と npm を入れる
Claude Code は npm 経由で入れるケースが多いため、Node.js と npm が正常であることが前提です。
確認：
node --version
npm --version
未インストールなら LTS を入れます。
winget install --id OpenJS.NodeJS.LTS -e --source winget
終わったら再度 PowerShell を開き直します。
確認：
node --version
npm --version
where.exe node
where.exe npm
ここで node は動くのに npm が不安定な場合は、Claude Code ではなく Node.js 側の問題である可能性が高いです。
Step 4: Claude Code をインストールする
まず既に入っていないか確認します。
where.exe claude
claude --version
なければインストールします。
npm install -g @anthropic-ai/claude-code
インストール後に再確認します。
where.exe claude
claude --version
Step 5: claude が見つからない場合は PATH を疑う
Windows で一番多いのは次のようなエラーです。
claude : The term 'claude' is not recognized as the name of a cmdlet...
この場合、ほとんどは「Claude Code が壊れている」のではなく、PATH が通っていない だけです。
確認手順：
npm config get prefix
npm list -g --depth=0
Get-Command claude -ErrorAction SilentlyContinue
さらに必要なら PATH を確認します。
[Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::GetEnvironmentVariable("Path", "Machine")
先にやるべきこと
- PowerShell を完全に閉じて開き直す
-
where.exe claudeを実行する -
npm config get prefixを確認する - npm の global パッケージ一覧を見る
- PATH を確認する
この順番で見ていくと、無駄な再インストールをかなり減らせます。
Step 6: 環境変数を正しく設定する
PowerShell では一時的に次のように設定できます。
$env:ANTHROPIC_API_KEY = "your_key_here"
ただし、これは 今のセッションだけ 有効です。PowerShell を閉じると消えます。
永続化したい場合は、ユーザー環境変数として設定します。
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your_key_here", "User")
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "your_gateway_key", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://crazyrouter.com/v1", "User")
その後、PowerShell を開き直して確認します。
echo $env:ANTHROPIC_API_KEY
echo $env:OPENAI_API_KEY
echo $env:OPENAI_BASE_URL
Step 7: WSL は必要か？
初心者なら、最初は不要
まずは PowerShell 環境だけで Claude Code が動く状態 を作る方が簡単です。
Linux に慣れているなら WSL は有力
ただし注意点があります。
WSL は Windows の延長ではなく、別の Linux 環境です。
つまり：
- WSL 内で Git を入れる必要がある
- WSL 内で Node.js を入れる必要がある
- WSL 内で Claude Code を入れる必要がある
- WSL 側で環境変数を設定する必要がある
Windows 側で設定した内容が、そのまま WSL 側で使えるとは限りません。
動作確認に使えるチェックコマンド
git --version
node --version
npm --version
claude --version
where.exe git
where.exe node
where.exe npm
where.exe claude
これに加えて、Git リポジトリの中で試すと実運用に近いです。
cd $HOME\Projects\claude-code-test
git status
よくあるエラー 5 選
1. claude が認識されない
確認ポイント：
- PowerShell を開き直したか
- PATH は更新されているか
- npm global に本当に入っているか
2. Git を入れたのに PowerShell で使えない
多くは PowerShell の再起動不足です。
3. Node.js はあるのに npm が不安定
古い Node.js が残っている、あるいは PATH 競合の可能性があります。
4. 環境変数が次のウィンドウで消える
一時変数だけ設定して、ユーザー環境変数に保存していない可能性があります。
5. PowerShell では動くのに WSL では動かない
別環境なので当然起こり得ます。WSL は別途セットアップが必要です。
まとめ
Windows で Claude Code を安定して使いたいなら、次の順番で整えるのが一番わかりやすいです。
- PowerShell
- Git
- Node.js / npm
- Claude Code
- PATH
- 環境変数
- Git リポジトリでテスト
この順番を守るだけで、「インストールできたのに使えない」という問題の大半は整理しやすくなります。