背景
Claude CodeをWindows環境にセットアップする際、Node.js版のセットアップ記事は多く見かけますが、現在推奨されているネイティブインストールと、Windows特有の注意点を整理します。
1. ネイティブインストールが現在の推奨方法
# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Node.js・npmへの依存がなく、自動アップデートにも対応しています。従来のnpm版（npm install -g @anthropic-ai/claude-code）も引き続き使えますが、Anthropicが主にテスト・サポートしているのはネイティブ版です。
2. WindowsではGit for Windowsが別途必須
⚠️ Git for Windows が必須です
Claude Code はGit Bashを内部的に使用するため、
Gitがインストールされていないとインストール後に正常動作しません。
ネイティブインストーラー自体はGitの有無をチェックしないため、「インストールは成功したのに動作がおかしい」という状態になりがちです。事前にgit-scm.comからインストールしておくのが確実です。
3. コマンドはclaude、バージョン確認で間違えやすい
claude --version
# claude-code v2.x.x などが表示されればOK
パッケージ名は@anthropic-ai/claude-codeですが、実行コマンドはclaudeです。claude-codeと打つとコマンドが見つからずバージョン確認ができません。
4. APIキー設定は基本的に不要
■CI/CD環境での自動化以外はブラウザ認証（OAuth）で完結する
初回起動時にブラウザが自動的に開き、Claude.aiアカウントでログイン・許可するだけで認証が完了します。APIキーは従量課金のため、CI/CD環境などブラウザ認証ができない特殊なケースを除き、初心者は使わない方が安全です。
5. CLAUDE.mdで永続的な日本語化設定
> このプロジェクトのルートディレクトリに、今後のルールとして
「常に日本語で回答すること」と「コードの右側にコメントを書くこと」を
記載したCLAUDE.mdファイルを作成してください。
セッションごとに日本語指示を入力する代わりに、この一言でプロジェクトルートにCLAUDE.mdが自動生成されます。Gitで管理すればチーム共有も可能です。
# プロジェクトルール
- 常に日本語で回答してください。
- コード生成時はステップ数を抑え、コメントはコードの右側に記述してください。
6. ワークスペースの起動場所に注意
Accessing workspace: に表示されているフォルダが、
AIが自由に閲覧・編集できる範囲です。
claudeコマンドを実行したディレクトリがそのままアクセス範囲になります。C:\Windows\System32のようなシステムフォルダで起動するのは避け、必ず目的のプロジェクトフォルダに移動してから起動するのが鉄則です。
まとめ
WindowsでのClaude Codeセットアップは、ネイティブインストーラー自体は簡単でも「Git for Windowsが別途必須」という前提条件でつまずきやすいポイントでした。CLAUDE.mdの詳細な記述例やトラブルシューティングは元記事にまとめています。