Claude Code バイナリ版 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の場所を教えるため、環境変数を設定します:
- Windowsキー + R を押して「ファイル名を指定して実行」を開く
sysdm.cpl
と入力してEnter- 「詳細設定」タブ → 「環境変数」をクリック
- 「ユーザー環境変数」セクションで「新規」をクリック
- 以下の内容を設定:
- 変数名:
CLAUDE_CODE_GIT_BASH_PATH
- 変数値:
C:\Program Files\Git\bin\bash.exe
- 変数名:
- 「OK」をクリックして保存
Claude Code をインストール
Important
PowerShellは通常モードで起動してください。管理者権限は不要です。
- Windowsキー + X → 「Windows PowerShell」を選択(管理者ではない方)
- 以下のコマンドを実行:
irm https://claude.ai/install.ps1 | iex
インストールが完了するまで少し時間がかかります。
PATHに追加
インストール後、どこからでもclaude
コマンドを使えるようにPATHを設定します:
再度、環境変数の設定画面を開く(ステップ2の手順1〜3)
「ユーザー環境変数」セクションで「Path」を選択して「編集」をクリック
「新規」をクリック
以下のパスを追加:
C:\Users\ユーザー名\.local\bin
Tip
「参照」ボタンを使って、ユーザーフォルダから
.local
→bin
フォルダを選択できます。「OK」をクリックしてすべての画面を閉じる
インストールの確認とテスト
インストールが正しく完了したかテストしてみましょう。
Warning
環境変数の変更を反映させるため、PowerShellを一度完全に終了してから再起動してください。
新しいPowerShellウィンドウで以下のコマンドを実行します:
# テスト用フォルダを作成
mkdir tmp
cd tmp
# Claude Codeを起動
claude
初回起動時の設定
Claude Codeが起動したら、以下の手順で初期設定を完了してください:
- ログイン: 画面の指示に従ってAnthropicアカウントでログイン
- 動作確認: 簡単なコマンドを実行してみる
- 終了:
exit
コマンドでClaude Codeを終了
Tip
テスト用のtmp
フォルダは不要になったら削除して構いません。
トラブルシューティング
よくある問題と解決方法を以下にまとめました:
「claude
コマンドが見つからない」エラー
原因: 環境変数PATHが正しく設定されていない、またはPowerShellが再起動されていない
解決方法:
- PowerShellを完全に終了して再起動
- 環境変数PATHに
C:\Users\ユーザー名\.local\bin
が追加されているか確認 - コマンドプロンプトからも試してみる
インストールスクリプトが実行できない
原因: PowerShellの実行ポリシーが制限されている
解決方法:
# 実行ポリシーを確認
Get-ExecutionPolicy
# 必要に応じて一時的に緩和(管理者権限が必要)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Git for Windowsのインストールに失敗する
原因: wingetが利用できない、またはネットワーク接続の問題
解決方法:
- Git公式サイトから手動でダウンロード
- インストール時はデフォルト設定を推奨
- インストール後、コマンドプロンプトで
git --version
を実行して確認
次のステップ
Claude Codeのインストールが完了したら、以下を参考に活用してください:
Claude Code Windows インストール バイナリ版 開発環境構築 AI開発ツール PowerShell Git Bash 環境変数設定 PATH設定