Claude Code 導入完全ガイド: Windows/macOS/WSL の使い分けと初期設定

結論

この記事は、2026年4月24日時点の公式情報を前提に、個人開発者がClaude Codeを最初に使うための導入手順を整理します。料金・プラン・認証方式は変わりやすいため、導入前に必ず公式ドキュメントを確認してください。

対応環境と推奨

Anthropicの公式セットアップガイドでは、Claude Codeの要件として、macOS、Ubuntu/Debian系Linux、Windows 10+、Node.js 18+、インターネット接続などが示されています。WindowsではWSLまたはGit for Windowsを使う選択肢があります。

個人開発では、次の基準で選ぶと失敗しにくいです。

迷う場合、リポジトリがどこにあるかで決めます。WSL上のファイルを触るならWSL側で起動し、Windows側のファイルを触るならWindows側で起動します。両方をまたぐとパス、改行、権限の問題が増えます。

インストール

公式ドキュメントでは、標準的なインストール方法としてnpm経由のコマンドが案内されています。

npm install -g @anthropic-ai/claude-code

インストール後、対象プロジェクトに移動して起動します。

cd your-project
claude

公式ドキュメントでは sudo npm install -g は権限問題やセキュリティリスクにつながるため避けるよう案内されています。npmのグローバルインストールで権限エラーが出る場合は、npmのprefixを見直すか、公式が案内する代替インストール方法を確認してください。

Windowsでの選び方

WSLを選ぶ場合

WSLを選ぶべきなのは、普段の開発がすでにWSL内で完結している場合です。

cd ~/projects/your-app
claude

WSL側でClaude Codeを使うなら、Node.js、Git、パッケージマネージャー、テストコマンドもWSL側に揃えます。Windows側の C:\Users\... 配下をWSLから頻繁に触る構成は、I/Oやパーミッションでつまずきやすくなります。

Windowsネイティブを選ぶ場合

Windowsネイティブで使う場合は、Git for Windowsを入れ、プロジェクトもWindows側に置きます。公式ドキュメントでは、必要に応じて bash.exe のパスを環境変数で指定する例が示されています。

$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

PowerShell中心で開発している場合でも、ツールが内部でUnix系シェルを必要とすることがあります。うまく動かない時は、まず claude doctor で状態を確認します。

初回設定: CLAUDE.md

インストール直後に大きな実装を任せる前に、プロジェクトルートに CLAUDE.md を置きます。

# Project Rules

- 変更前に関連ファイルを確認する
- 変更範囲を説明してから編集する
- `.env`、秘密鍵、本番DB接続情報には触れない
- 新しい依存関係を追加する前に理由を説明する
- 実装後は `npm run build` または関連テストを実行する
- 同じエラーが2回続いたら修正を止め、原因仮説を3つ提示する

このファイルは長くしすぎない方がよいです。プロジェクト固有の規約、禁止事項、検証コマンドに絞ります。

最初に依頼するタスク

初回は実装ではなく、調査から始めます。

このリポジトリの構成を確認し、AIエージェントに安全に任せられる作業と、任せるべきでない作業を分類してください。
まだファイルは変更しないでください。

次に、小さな修正を依頼します。

READMEの表記ゆれを確認し、明らかな誤字だけを修正してください。
コード、設定ファイル、依存関係は変更しないでください。

この段階で、どのファイルを読み、どのように報告するかを見ます。いきなり認証、決済、DBスキーマ変更を任せるべきではありません。

よくあるエラー

claude が見つからない

npmのグローバルbinにPATHが通っていない可能性があります。Node.jsのインストール方法、npm prefix、シェルのPATHを確認します。

Windowsでパス関連のエラーが出る

WSL側とWindows側を混ぜていないか確認します。リポジトリ、Node.js、Git、Claude Codeを同じ側に揃えるのが基本です。

npmの権限エラーが出る

sudo npm install -g で強引に入れるのではなく、npmのグローバルインストール先を見直します。公式の代替インストール方法も確認してください。

チェックリスト

• リポジトリを置く環境を決めた
• Node.js 18+ を確認した
• Git / Git Bash / WSL のどれを使うか決めた
• claude doctor で状態を確認した
• CLAUDE.md に禁止事項と検証コマンドを書いた
• 最初の依頼を「調査だけ」にした

次に読む

• Codex CLI 導入と初期設定
• AGENTS.md / CLAUDE.mdに何を書くべきか
• Claude CodeとCodexはどう使い分けるべきか

出典

• Claude Code setup - Anthropic
• Claude Code overview - Anthropic
• Claude Code settings - Anthropic