Claude Code 完全ガイド

Claude Code Windowsインストール: WSL不要（3分設定）

対象 / ポイント

対象: Claude CodeをWindowsに入れたが、PowerShellで claude コマンドが見つからない開発者

ポイント:

• 最初に見るのはターミナル再起動、次に %USERPROFILE%\.local\bin のPATH確認
• ネイティブWindowsとWSLはどちらもサポート対象であり、WSLは必須ではない
• Git for WindowsはBash toolのために推奨されるが、必須条件ではない

概要

PowerShellで claude がcmdletとして認識されない場合、まず見るべき箇所は3つだ。公式PowerShellインストーラーを実行し、ターミナルを開き直し、%USERPROFILE%\.local\bin がPATHに入っているか確認する。

全OS版のPATH修正を見たい場合

この記事はWindowsセットアップに絞っている。macOS/Linux/WSLも含めた claude not found / command not recognized の切り分けは Claude Code「認識されない」エラーの解決法 を参照する。

Claude Codeは 2025年にネイティブWindows版 をリリースした。これまでWSL（Windows Subsystem for Linux）が必須だったが、Windowsで直接動作するようになり、Windowsユーザーの利便性が大幅に向上した。最新バージョンは claude --version で確認できる。

ネイティブWindows版のメリット

• WSL不要 - Windowsで直接動作
• ワンコマンドインストール - 公式インストーラーがすべて処理（Node.jsの個別インストール不要）
• Git for Windowsは推奨だが必須ではない - Git BashがあるとBash toolを使える。未導入の場合はPowerShell tool側で動作する
• Windows Package Manager (winget) 対応 - winget upgrade Anthropic.ClaudeCode で簡単アップデート
• 安定性の継続的改善 - .bashrcファイル処理、コンソールウィンドウのフラッシング、OAuthトークン有効期限、プロキシ設定、bashサンドボックスエラー、日本語IMEサポート等の修正

インストール手順

1. PowerShellで公式インストーラーを実行

管理者権限は不要だ。PowerShellで以下のコマンドを実行する。

irm https://claude.ai/install.ps1 | iex

これはAnthropicの公式インストーラーだ。Claude Codeのバイナリが ~/.local/bin に自動配置される。Node.jsの個別インストールは不要だ。

代替方法：Windows CMD または WinGet でインストール

**Windows CMD**（PowerShellよりコマンドプロンプトを使いたい場合）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

**WinGet**（自動更新されません — 定期的に `winget upgrade` を実行）：

winget install Anthropic.ClaudeCode

npmよりNative Installを優先

Anthropicの現行セットアップガイドでは、メインの導線として Native Install（Recommended）、Homebrew、WinGet が案内されている。npmもadvanced installation optionsとしてサポートされており、Node.js 18以降が必要だ。一般的なWindows利用ではPowerShellまたはCMDのネイティブインストーラーを優先するのが短い。

2. 認証

インストール後、claude を初回実行するとブラウザが自動で開き、OAuth認証が行われる。APIキーの管理は不要だ。

claude

Git for Windowsは任意だが有用

Claude CodeはPowerShellまたはCMDからWindowsネイティブで起動できる。Git for Windowsを入れるとGit Bash経由でBash toolを使える。Git for Windowsがない場合はPowerShell tool側で動作する。

Git Bashを標準以外の場所に入れている場合は、settings.json で明示する。

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

3. インストール完了後の重要な手順

必須：ターミナルを再起動

インストール完了後、必ずターミナルウィンドウを閉じて新しく開き直す。PATHの変更を反映させるために必要だ。

claude doctor でインストールを検証

インストール後、claude doctor を実行すると、インストールの種類・バージョン・一般的な設定問題を検出できる。

トラブルシューティング

claudeコマンドが認識されない場合

症状

PS C:\Users\username> claude
claude : 用語 'claude' は、コマンドレット、関数、スクリプト ファイル、
または操作可能なプログラムの名前として認識されません。

または：

Native installation exists but C:\Users\<ユーザー名>\.local\bin is not in your PATH.

原因と解決方法（公式インストーラーの場合）

公式インストーラーはバイナリを ~/.local/bin に配置する。このパスがPATHに含まれていないとコマンドが見つからない。

1. .local\bin がPATHに含まれているか確認

   $env:PATH -split ";" | Where-Object {$_ -like "*.local*"}
   

2. 含まれていなければPATHに追加

   # 統合済みのプロセスPATHをコピーせず、ユーザーPATHだけに追加
   $claudeBin = "$env:USERPROFILE\.local\bin"
   $userPath = [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)
   if (($userPath -split ";") -notcontains $claudeBin) {
       $newUserPath = if ([string]::IsNullOrWhiteSpace($userPath)) { $claudeBin } else { "$userPath;$claudeBin" }
       [Environment]::SetEnvironmentVariable("Path", $newUserPath, [EnvironmentVariableTarget]::User)
   }
   
   # 現在のセッションにも反映
   $env:Path = "$env:Path;$claudeBin"
   

3. 動作確認

   claude --version
   

それでも動作しない場合

直接実行でテスト：

& "$env:USERPROFILE\.local\bin\claude.exe"

旧npmインストールのトラブルシューティング

以前 npm (`npm install -g @anthropic-ai/claude-code`) でインストールした場合、バイナリの場所が異なります： 1. **npmグローバルプレフィックスを確認**

npm config get prefix
# 出力例: C:\Users\username\npm-global

2. **npmのPATHを確認・修正**

$env:PATH -split ";" | Where-Object {$_ -like "*npm*"}

# npm-globalがPATHに含まれていない場合は追加
$npmPrefix = npm config get prefix
$userPath = [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)
if (($userPath -split ";") -notcontains $npmPrefix) {
    $newUserPath = if ([string]::IsNullOrWhiteSpace($userPath)) { $npmPrefix } else { "$userPath;$npmPrefix" }
    [Environment]::SetEnvironmentVariable("Path", $newUserPath, [EnvironmentVariableTarget]::User)
}

Note: npmインストールは現在もサポートされているが、現行ドキュメントではadvanced installation options側に置かれている。組織でnpm配布を管理している場合を除き、Native Installを優先する。

クリップボード画像貼り付けについて

現在の挙動

ターミナルとバージョンで挙動が変わる

現行のClaude CodeにはCtrl+Vの画像貼り付け処理と、Windows向けAlt+V修正が入っている¹。最新版のネイティブセッションではCtrl+Vから試し、画像を渡せないターミナルではAlt+Vまたはファイル共有へ切り替える。

代替方法

1. Ctrl+Vを試し、動かなければAlt+Vへ切り替える
2. スクリーンショットをコピーし、Claude Codeの入力欄でCtrl+Vを押す
3. ターミナルが画像クリップボードを渡せない場合はAlt+Vを使う

4. 古い制限を調べる前にClaude Codeを更新する

5. ファイルとして保存してドラッグ&ドロップ（最も確実）

6. スクリーンショットをファイルに保存

7. Claude Codeのウィンドウに直接ドロップ

8. ファイルパスを指定

   画像を見てください: C:\Users\username\Pictures\screenshot.png
   

トラブルシューティング

クリップボード画像を検出しない場合

claude updateを実行し、新しいターミナルでCtrl+Vを再試行する。それでも統合ターミナルやクリップボード形式の影響で失敗する場合は、Alt+Vまたはファイル共有を使う。

古い手順と違う理由

以前のWindows向け手順ではAlt+Vだけが案内されていた。その後、Ctrl+Vの画像貼り付け処理とWindows・WSL向けの修正が複数追加された¹。現在は「Ctrl+Vはテキスト専用」と断定せず、利用中のバージョンとターミナルに応じて切り替えるのが正確だ。

WSL版との比較

ネイティブWindows版のメリット

• 簡単セットアップ - WSLのインストール・設定が不要
• Windows統合 - PowerShell/コマンドプロンプトで直接動作
• 軽量 - Linux環境を立ち上げる必要なし
• Windows権限 - Windowsのファイルシステムに直接アクセス

WSL版のメリット

• 既存Linux環境活用 - 既にWSL環境がある場合は追加設定不要
• Bashツールのサンドボックス - WSL 2はサンドボックスによるセキュリティ強化に対応（WSL 1は非対応）
• パッケージ管理 - apt/yumなどLinuxパッケージマネージャーが使用可能
• コンテナ連携 - Dockerなどとのシームレスな統合

公式の推奨

Anthropic公式：ネイティブインストールが推奨

公式ドキュメントでは「Native Install」が推奨インストール方法として記載されている。Windows環境では、ネイティブWindowsとWSLの両方がサポートされている。WSL 2はサンドボックスによるセキュリティ強化が利点、ネイティブWindowsはシンプルなセットアップが利点だ。

使い分けの指針

こんな時はネイティブWindows版（公式推奨）

• 一般的な用途（公式推奨のため）
• Windows開発をしている
• Git Bashが使える、またはPowerShellだけで運用したい
• シンプルに使いたい

こんな時はWSL版

• 既にWSL環境が構築済み
• Dockerと連携したい
• Linuxツールチェーンが必要

まとめ

Claude CodeのネイティブWindows版により、WSLの設定なしで利用開始できるようになった。画像は最新版でCtrl+Vを試し、環境依存で失敗する場合はAlt+Vまたはファイル共有へ切り替える。

用途に応じてネイティブ版とWSL版を使い分けることで、より効率的な開発環境を構築できる。

チェックリスト

• PowerShellで公式インストーラー実行（irm https://claude.ai/install.ps1 | iex）
• claude を実行してブラウザで認証
• ターミナルを再起動
• PATHの設定確認（.local\bin がPATHに含まれているか）
• claudeコマンドの動作確認

関連記事

• Claude Code 完全ガイド
• Claude Code インストール完全ガイド
• Claude Code トラブルシューティング

---

1. Claude Code changelog — Ctrl+Vの画像貼り付け処理とWindows・WSL向けクリップボード修正。 ↩↩