ドキュメント
Claude Code の準備
Windows

Windows

Windows環境でClaude Codeを動作させる最も簡単な方法として、バイナリ版（ベータ）のインストール手順を紹介します。

動画解説はこちら

Tip

従来のWSLやGit Bashを使った方法と比べて、バイナリ版は権限トラブルが少なく、最も簡単にインストールできる方法です。

背景と経緯

Claude Codeは元々MacやLinuxとの相性が良く設計されており、Windows環境では以下の経緯をたどってきました：

  • 初期: WSL（Windows Subsystem for Linux）のみ対応
  • その後: Git for Windows Bashに対応（権限問題が頻発）
  • 現在: バイナリ版（ベータ）が利用可能 ← 推奨

参考リンク

インストール手順

Claude Codeのインストールは4つのステップで完了します：

Git for Windows をインストール

Claude CodeはBashシェルが必要なため、まずGit for Windowsをインストールします。

PowerShellを起動し、以下のコマンドを実行してください：

winget install Git.Git

Note

Git for WindowsにはBashシェルが含まれており、Claude Codeが内部で使用します。

環境変数を追加

Claude CodeにBashの場所を教えるため、環境変数を設定します：

  1. Windowsキー + R を押して「ファイル名を指定して実行」を開く
  2. sysdm.cpl と入力してEnter
  3. 「詳細設定」タブ → 「環境変数」をクリック
  4. 「ユーザー環境変数」セクションで「新規」をクリック
  5. 以下の内容を設定：
    • 変数名: 
      CLAUDE_CODE_GIT_BASH_PATH
    • 変数値: 
      C:\Program Files\Git\bin\bash.exe
  6. 「OK」をクリックして保存

Claude Code をインストール

Important

PowerShellは通常モードで起動してください。管理者権限は不要です。

  1. Windowsキー + X → 「Windows PowerShell」を選択（管理者ではない方）
  2. 以下のコマンドを実行：
irm https://claude.ai/install.ps1 | iex

インストールが完了するまで少し時間がかかります。

PATHに追加

インストール後、どこからでもclaudeコマンドを使えるようにPATHを設定します：

  1. 再度、環境変数の設定画面を開く（ステップ2の手順1〜3）

  2. 「ユーザー環境変数」セクションで「Path」を選択して「編集」をクリック

  3. 「新規」をクリック

  4. 以下の ような パスを追加（ユーザー名のところは、各人で違います）：

    C:\Users\ユーザー名\.local\bin

    Tip

    「参照」ボタンを使って、ユーザーフォルダから .local → bin フォルダを選択すると簡単です

  5. 「OK」をクリックしてすべての画面を閉じる

インストールの確認とテスト

インストールが正しく完了したかテストしてみましょう。

Warning

環境変数の変更を反映させるため、PowerShellを一度完全に終了してから再起動してください。

新しいPowerShellウィンドウで以下のコマンドを実行します：

# Claude Codeを起動し、すぐ終了
claude

Nodeのインストール

Webサイト構築のツールで、nodeを利用します。インストールしてください。

winget install OpenJS.NodeJS.LTS

PowerShellを再起動して、確認してください。

npm --version

エラーが出ます。これは、セキュリティによるものです。セキュリティーを緩和する設定をします。

まず、現在の設定をチェックします。

Get-ExecutionPolicy

次に、実行できるようにセキュリティレベルを変更します。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

続いて、ターミナルを再起動して、npmを実行します。

npm --version

トラブルシューティング

よくある問題と解決方法を以下にまとめました：

「claude コマンドが見つからない」エラー

原因: Claude Code をインストールしていない。あるいは、インストールしたが環境変数PATHが正しく設定されていない、またはPowerShellが再起動されていない

解決方法:

  1. PowerShellを完全に終了して再起動
  2. 環境変数PATHに C:\Users\ユーザー名\.local\bin が追加されているか確認
  3. コマンドプロンプトからも試してみる
インストールスクリプトが実行できない

原因: PowerShellの実行ポリシーが制限されている

解決方法:

# 実行ポリシーを確認
Get-ExecutionPolicy

# 必要に応じて一時的に緩和（管理者権限が必要）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Git for Windowsのインストールに失敗する

原因: wingetが利用できない、またはネットワーク接続の問題

解決方法:

  1. Git公式サイト から手動でダウンロード
  2. インストール時はデフォルト設定を推奨
  3. インストール後、コマンドプロンプトで git --version を実行して確認
windows ウィンドウズ インストール install setup セットアップ binary バイナリ版 powershell パワーシェル git bash 環境変数 environment variable path パス設定 claude code cli winget package manager パッケージマネージャー nodejs node npm execution policy 実行ポリシー security セキュリティ remotesigned administrator 管理者権限 command prompt コマンドプロンプト wsl windows subsystem linux 権限トラブル permission error anthropic 初期設定 開発環境 development environment troubleshooting トラブルシューティング エラー解決 system properties システムプロパティ sysdm.cpl 環境変数設定
macOSサブスク・ログイン