Claude Code導入ガイド: Windows/macOS/WSLと初期設定

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

対応環境と推奨

公式の要件はmacOS 13以降、Windows 10 1809以降、Ubuntu 20.04以降など、4GB以上のメモリとインターネット接続です。推奨のネイティブインストールにNode.jsは不要です。Windows版とWSL版は、リポジトリの置き場に合わせて選びます。

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

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

インストール

公式推奨はネイティブインストーラーです。次は公式が案内するコマンドです。ここでは導入コマンドを再実行しておらず、手順の確認を行っています。

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.sh | bash

公式サイトからスクリプトを取得して実行します。内容や組織のソフトウェア導入ルールを確認してから実行してください。

cd your-project
claude --version
claude

初回は案内に従ってブラウザで認証します。Claudeの対象サブスクリプションかConsoleなどの対応アカウントが必要です。サブスクリプションとAPI利用は別の課金経路なので、使用するアカウントを確認してください。詳しくは公式Quickstartを参照してください。

npm経由は代替の導入方法です。利用する場合はNode.js 22以降が必要で、sudo npm install -g は避けます。

Windowsでの選び方

WSLを選ぶ場合

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

cd ~/projects/your-app
claude

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

Windowsネイティブを選ぶ場合

Windowsネイティブで使う場合は、PowerShellなどからインストールし、プロジェクトもWindows側に置きます。Git for Windowsは任意ですが、Bashツールを使う場合に必要です。Git Bashを見つけられない場合は、パスを指定します。

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

うまく動かない時は、まず claude doctor で状態を確認します。Windows版とWSL版のどちらで起動したかも確認してください。

初回設定: CLAUDE.md

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

# Project Rules

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

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

最初に依頼するタスク

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

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

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

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

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

よくあるエラー

claude が見つからない

ターミナルを開き直し、公式セットアップのPATH案内と claude doctor を確認します。npm経由で導入した場合は、npmのグローバルbinも確認してください。

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

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

npmの権限エラーが出る

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

チェックリスト

• リポジトリを置く環境を決めた
• 公式推奨の導入方法と対応OSを確認した
• Windows版 / WSL版のどちらを使うか決めた
• claude doctor で状態を確認した
• CLAUDE.md に禁止事項と検証コマンドを書いた
• 最初の依頼を「調査だけ」にした

次に読む

• Codex CLI 導入と初期設定
• AGENTS.md完全ガイド
• Claude CodeとCodexはどう使い分けるべきか

出典

• Claude Code setup - Anthropic
• Claude Code Quickstart - Anthropic
• Claude Code memory - Anthropic
• AI駆動開発協会のClaude Code研修（料金・カリキュラムの確認）