Claude Code 完全ガイド

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

対象: WindowsでClaude Codeを導入する開発者

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

ポイント:

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

この記事のポイント

• Windowsでは公式PowerShellインストーラーを使うのが最短導線だ。
• claude が認識されない場合、npmで入れ直す前にインストール先とPATHを確認する。
• macOS/Linux/WSL/bash/zshも含めたPATH切り分けは、全OS版エラー記事へ誘導する。

概要

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に追加

   # .local\bin をユーザーPATHに追加
   [Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\.local\bin", [EnvironmentVariableTarget]::User)
   
   # 現在のセッションにも反映
   $env:PATH = "$env:PATH;$env:USERPROFILE\.local\bin"
   

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に含まれていない場合は追加
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;C:\Users\<ユーザー名>\npm-global", [EnvironmentVariableTarget]::User)

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

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

現状の制限事項

Windows+Shift+S の制限

Windows+Shift+Sでキャプチャした画像をCtrl+Vで貼り付ける機能は、多くのユーザーから動作しないと報告されている。ファイル経由での画像共有を推奨する。

代替方法

1. Ctrl+VではなくALT+Vを使う
2. Claude Codeでは ALT+V でクリップボードから画像を貼り付け可能
3. Ctrl+V はテキストのみの貼り付け — バグではなく仕様

4. スクリーンショットをコピーしてALT+Vを試す

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

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

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

8. ファイルパスを指定

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

検証結果

Ctrl+Vでは画像を貼り付けできません

最新のネイティブWindows版でも、Windows+Shift+Sでキャプチャした画像のCtrl+V貼り付けは動作しない。Ctrl+Vはテキストのみだ。 画像貼り付けには ALT+V を使用するか、ファイル経由で共有する。

将来の展望

ネイティブWindows版のリリースにより、今後のアップデートでクリップボード機能の改善が期待される。元のクリップボード貼り付けIssue（#1361）は部分的に対応済みで、一部プラットフォームではALT+Vが動作するが、WindowsでのCtrl+V画像貼り付けは引き続き要望中だ（#26679、#22068）。

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の設定なしで簡単に利用開始できるようになった。クリップボード画像貼り付けには制限があるが、ファイル経由での画像共有は問題なく動作する。

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

チェックリスト

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

関連記事

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