Open3
Claude Codeはじめるぞい
イワケン
前提条件
- Windows11
- Mac
Winodws11の場合
- Node.js 18+
-
node --versionで確認
-
- git 2.23+(オプション)
-
git --versionで確認
-
- PRワークフロー用のGitHubまたはGitLab CLI (オプション)
-
gh --versionで確認
-
- 強化されたファイル検索用のripgrep (rg) (オプション)
-
rg --versionで確認 - ない場合
winget install BurntSushi.ripgrep.MSVC
-
install
npm install -g @anthropic-ai/claude-code
Windows特有のエラー
次の投稿にて
イワケンWindows11でClaude Codeをセットアップする完全ガイド
Claude CodeはWindows上で直接動作せず、WSL（Windows Subsystem for Linux）環境が必要です。この記事では、Windows11でClaude Codeを動作させるための完全なセットアップ手順を解説します。
前提条件
共通要件
- オペレーティングシステム: Windows 11
- ハードウェア: 最低4GB RAM
- ネットワーク: インターネット接続（認証とAI処理に必要）
Windows11の場合の確認事項
Node.js 18+
node --version
- ✅ v18.0.0以上が表示される → Claude Code使用可能
- ❌
command not found→ WSL内でインストールが必要
git 2.23+（オプション）
git --version
- ✅ git version 2.23.0以上 → 使用可能
- ❌ 古いバージョンまたは未インストール → アップデートが必要
PRワークフロー用のGitHub CLI（オプション）
gh --version
- ✅ gh version 2.x.x → 使用可能
- ❌
command not found→ インストールが必要
強化されたファイル検索用のripgrep（オプション）
rg --version
- ✅ ripgrep 13.x.x → 使用可能
- ❌
command not found→ 以下でインストール
winget install BurntSushi.ripgrep.MSVC
Windows特有のエラーとWSLセットアップ
エラーの原因
Windows PowerShellで直接Claude Codeをインストールしようとすると：
npm install -g @anthropic-ai/claude-code
以下のエラーが発生します：
npm error Error: Claude Code is not supported on Windows.
npm error Claude Code requires macOS or Linux to run properly.
npm error If you are using WSL (Windows Subsystem for Linux):
npm error 1. Make sure you are running npm install from within the WSL terminal
重要: 現在、Claude CodeはWindows上で直接実行できず、WSLが必要です。
WSLセットアップ手順
1. WSLの確認
wsl --version
期待される結果:
WSL バージョン: 2.3.26.0
カーネル バージョン: 5.15.167.4-1
2. インストール済みディストリビューションの確認
wsl --list --verbose
結果例:
NAME STATE VERSION
* docker-desktop Stopped 2
docker-desktop-data Stopped 2
Docker関連のWSLのみの場合、開発用Linuxディストリビューションが必要です。
3. Ubuntu 24.04のインストール
wsl --install -d Ubuntu-24.04
インストール完了後:
- ユーザー名とパスワードの設定が求められます
- WSLターミナルが自動的に起動します
4. WSL環境への切り替え
PowerShellからWSL環境に入ります：
wsl
プロンプトの変化:
# PowerShell
PS C:\Users\owner>
# WSL（Linux環境）
iwaken71@DESKTOP-US3LKJR:~$
5. システムの更新
WSL内で以下のコマンドを実行：
sudo apt update
sudo apt upgrade -y
6. 必要なツールのインストール
sudo apt install -y curl
7. Node.js環境のセットアップ
nvmのインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvmの有効化
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
nvmバージョン確認
nvm --version
# 期待される結果: 0.39.0
Node.js 18のインストール
nvm install 18
インストール完了例:
Downloading and installing node v18.20.8...
Now using node v18.20.8 (npm v10.8.2)
Creating default alias: default -> 18 (-> v18.20.8)
バージョン確認
node --version # v18.20.8
npm --version # 10.8.2
8. Claude Codeのインストール
WSL環境内で実行：
npm install -g @anthropic-ai/claude-code
9. インストール確認
claude --version
または
claude
正常に起動すれば、Claude Codeのインストール完了です！
よくあるトラブルシューティング
1. WSLが起動しない場合
PowerShellを管理者権限で実行：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
再起動後、WSLをインストール：
wsl --install -d Ubuntu-24.04
2. nvmが見つからない場合
以下のコマンドで再度有効化：
source ~/.bashrc
nvm --version
3. 権限エラーが発生する場合
# npm設定の変更
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
Unity開発者向けの追加設定
Gitの設定
git config --global user.name "あなたの名前"
git config --global user.email "your.email@example.com"
git config --global core.autocrlf input
git config --global core.quotepath false
Windowsファイルシステムへのアクセス
# Cドライブへのアクセス
cd /mnt/c/
# Unityプロジェクトフォルダへのアクセス例
cd /mnt/c/Users/owner/Documents/Unity Projects/
まとめ
WSLセットアップにより、Windows11でもClaude Codeが正常に動作するようになります。Unity開発と組み合わせることで、AI支援による効率的な開発環境が構築できます。
セットアップ完了後の次のステップ:
- Claude Codeでの認証設定
- Unity プロジェクトでの初期化（
/init） - GitHub Actions との連携設定
これでWindows11環境でのClaude Code導入は完了です！
イワケン初めてのClaudeコマンド
claude
を叩くと起動します。最初のDarkmodeなどを選択します。
Select login method:
1. Anthropic Console (API usage billing)
❯ 2. Claude app (requires Max subscription)
私は2.Claude appを選びます。