Claude Code Windowsのはじめ方｜インストール手順とエラー対処

関連記事Claude Code（クロードコード）とは？できること・料金・使い方を初心者にもやさしく解説【2026年版】 ／ Claude Code 使用量を完全制御する実装ガイド【2026年版】 ／ Claude Code ログイン方法・できない時の対処法｜2026年版ガイド

Windows環境でClaude Codeを始める方法

Claude CodeはWSLなしでWindowsにそのままインストールできます。PowerShellを開いて次の1行を実行し、新しいターミナルでclaudeと入力するだけです。管理者権限もNode.jsも不要です（公式ドキュメント、2026年10月7日確認）。

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

• 対応OS：Windows 10 1809以降／Windows Server 2019以降（x64・ARM64、メモリ4GB以上）
• 必要なアカウント：Pro・Max・Team・Enterpriseのいずれかか、Console（API）アカウント。Freeプランでは使えません。
• Git for Windows：任意。入れるとBashツールとMonitorツールが使えるようになり、入れなければシェル操作はPowerShellで行われます。
• ターミナルを使いたくない場合：Windows版のデスクトップアプリや、VS Codeの拡張機能からも使えます。

Linuxのツールを使う開発や、コマンドをサンドボックス内で動かしたい場合だけWSL 2を選びます。この違いと判断基準は次のセクションで詳しく解説します。

本記事はこの後、環境選択の技術的な根拠からインストール後によく出るエラーの対処まで、初めて導入する方が迷いやすい順番で解説していきます。複数端末での展開・チーム運用における実務上の知見は、記事の最後にまとめています。

Claude Code Windows 環境選択からエラー対処まで完全解説

Claude Codeとは をWindowsに導入する際、最初の判断は「ネイティブWindows・WSL2・どのインストーラを使うか」だ。この選択を誤ると、インストール自体は成功してもサンドボックスが動かない、Git連携ができない、という問題が後から現れる。本記事は公式ドキュメント（code.claude.com/docs/en/setup ほか公式リリースノート、2026-10-07確認）を一次情報として、環境選択の根拠・インストールコマンドの実装上の違い・頻出エラーへの対処を技術者の目線で整理する。

Claude Code Windows の動作要件と環境選択の根拠

公式ドキュメントが定めるシステム要件は次のとおりだ（出典：code.claude.com/docs/en/setup）。

• OS：Windows 10 1809以降 / Windows Server 2019以降
• RAM：4GB以上
• アーキテクチャ：x64またはARM64
• シェル：PowerShell・CMD対応（Bash/Zshも可）
• ネットワーク接続必須
• ripgrepは通常同梱

要件を満たしたうえで、プロジェクトの性質に応じて3つの動作環境から選ぶ。公式が提示する使い分けの根拠は「サンドボックスの要否」と「ツールチェーンの一致」の2軸に集約される。

環境	追加要件	サンドボックス	推奨ユースケース
ネイティブWindows	なし（Git for Windowsは任意）	非対応	C#・WPF・PowerShell中心のWindowsネイティブコードベース
WSL 2	WSL 2の有効化が必要	対応	Linuxツールチェーン使用・サンドボックス実行が必要な開発
WSL 1	WSL 1のみ利用可能な場合	非対応	WSL 2が使えない環境での代替手段

Dockerベースのワークフローを持ちLinux環境のCIと整合させたいチームは、サンドボックスが利用できるWSL 2を選ぶのが合理的だ。一方、.NETやPowerShellを中心に据えたWindowsネイティブのコードベースであれば、余分な変換レイヤーを挟まないネイティブインストールの方が実行環境と一致する。WSL 1はWSL 2が利用できない制約がある場合の代替であり、サンドボックスが使えないため積極的に選ぶ理由は少ない。

Claude Code Windows インストールコマンドの実装上の違い

公式が提供するインストール方法は複数あり、それぞれ動作メカニズムと制約が異なる。インストール後は claude --version で動作確認し、詳細な診断は claude doctor で実行できる。公式ドキュメントは管理者権限不要を明記している（”You do not need to run as Administrator”）。

PowerShell を使う方法（ネイティブWindows推奨）

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

PowerShellの Invoke-RestMethod エイリアスでスクリプトを取得し即時実行する。このインストール方式はバックグラウンド自動更新が有効になるため、日常的な運用で手動更新の手間が省ける。特定バージョンに固定したい場合（CI環境での再現性確保など）は末尾にバージョン番号を指定できる。

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

CMD を使う方法

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

コマンドプロンプト専用だ。&& はCMDのステートメント区切りであり、PowerShellで実行するとエラーになる（後述）。

WinGet を使う方法

winget install Anthropic.ClaudeCode

パッケージマネージャ経由の導入はIT管理部門によるソフトウェア管理との親和性が高い。ただし自動更新が無効になるため、アップグレードは別途 winget upgrade Anthropic.ClaudeCode を実行する。公式ドキュメントは「実行中だとexeロックで更新が失敗することがある」と明記しているため、更新前にClaude Codeを終了させること。

npm を使う方法（Node.js環境がある場合）

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

npm版はNode.js 22以上が前提だ（2026年10月7日確認の公式セットアップガイド）。古いNode.jsではインストール時にEBADENGINEの警告が出るが、npmパッケージの中身はネイティブバイナリで実行時にNode.jsを使わないため、インストール自体は完了し動作する。更新はnpm update -gではなくnpm install -g @anthropic-ai/claude-code@latestで行う。公式が推奨するのはNode.jsを使わないネイティブインストーラーで、npmは代替手段という位置づけになる。公式は sudo 付き実行に警告を出しており、Windowsでも管理者権限なしで実行することが推奨される。

インストール後に確認すること（公式手順）

• 動作確認：新しいターミナルを開いてclaude --versionを実行し、バージョン番号が表示されればOK。より詳しく診断するならclaude doctor（セッションを起動せずにインストール状態・設定ファイルの誤り・警告を表示）。
• 「claude は認識されません」と出る：インストール先がまだPATHに入っていない状態。まずターミナルを開き直し、それでも出る場合は公式のトラブルシューティング（Fix your PATH）の手順でPATHを通す。
• 本物のファイルか確かめる：Windows版の実行ファイルは「Anthropic, PBC」の署名付き。PowerShellでGet-AuthenticodeSignature .\claude.exeを実行すると確認できる。
• 安定版を入れたい：新機能より安定性を優先するなら、PowerShellで & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable を実行すると、約1週間遅れで大きな不具合のある版を飛ばす「stable」チャネルで入る。
• WinGetでも自動更新したい：WinGet版は既定で自動更新されないが、環境変数CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1を設定すると、新しい版が出たときにClaude Codeがバックグラウンドでwinget upgradeを実行する（実行中はファイルがロックされて失敗することがあり、その場合は手動コマンドが表示される）。

WSL 2 環境へのインストール

WSL 2を選んだ場合、インストールコマンドは必ずWSLターミナル内で実行する。PowerShellやCMDのウィンドウからではなく、WSLセッションを開いてから以下を走らせる。

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

WSL 2では claude auth login のブラウザコールバックがlocalhostに届かないことがある。v2.1.126以降はOAuthコードをターミナルに直接貼り付ける方式に対応し、SSHセッション・devcontainerでも同様に対処されている（出典：Week 18 リリースノート、code.claude.com）。

インストール手順全体の詳細（全OS横断）についてはClaude Codeインストール完全ガイドも参照されたい。

Claude Code Windows で頻出するエラーと具体的な対処

公式ドキュメントが実際のエラー文言として明示しているWindows固有の問題を整理する。エラー文言は公式ドキュメント原文に基づく。

シェルの取り違えエラー（最多）

プロンプトが「PS C:\」で始まればPowerShell、「C:\」のみであればCMDと判断できる。

• The token '&&' is not a valid statement separator：CMD用コマンドをPowerShellで実行している。PowerShell用の irm コマンドを使うか、CMDを開き直す。
• 'irm' is not recognized as an internal or external command：PowerShell用コマンドをCMDで実行している。CMDを使うなら curl ベースのコマンドに切り替える。

この取り違えは、ターミナルエミュレータ（Windows Terminal）がデフォルトシェルをPowerShellに設定しているのにCMD用コマンドをコピーペーストするケースで特に発生しやすい。

Git Bashが見つからないエラーと回避策

ネイティブWindowsでGit for Windowsを導入すると、Git Bash経由でBashツールが有効になる。インストール済みにもかかわらずClaude CodeがGit Bashを検出できない場合は、~/.claude/settings.json にパスを明示する。

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

なお、v2.1.84（2026年3月、Week 13アップデート、プレビュー）でWindowsネイティブ向けのPowerShellツールが追加された。Git Bashなしでもシェルコマンドを実行できる選択肢が追加されたわけだ（出典：Week 13 リリースノート、code.claude.com）。現在の公式ドキュメント（2026年10月7日確認）では、Git for Windowsを入れた環境でもPowerShellツールはBashと並んで使え、claude.aiとConsoleのアカウントでは既定でオンになっている。Amazon Bedrock・Google CloudのAgent Platform・Microsoft Foundry経由の場合は CLAUDE_CODE_USE_POWERSHELL_TOOL=1 で有効化し、0にするとオフにできる（Git Bashが無い環境では自動的にPowerShellツールが使われる）。

さらにv2.1.120〜v2.1.126（2026年4月末、Week 18アップデート）でGit BashなしのWindows動作が改善されており、Git for Windowsが未導入でも基本的な操作が可能になっている（出典：Week 18 リリースノート、code.claude.com）。

WinGetによる更新失敗

WinGetで更新する際、Claude Codeが実行中だとexeファイルにロックがかかり更新が失敗する。公式ドキュメントが明記するこの制約への対処は、更新前にClaude Codeを完全終了してから winget upgrade Anthropic.ClaudeCode を実行することだ。

Claude Code Windows インストール後の設定・更新・アンインストール

認証と必要なプラン

インストール後、初回起動でブラウザ経由のログインを求められる。利用にはPro・Max・Team・Enterprise・Consoleのいずれかのアカウントが必要で、Freeプランでは使用できない（出典：code.claude.com/docs/en/setup）。料金体系の詳細はClaude Code 料金ガイドを参照されたい。

2026年9月時点でClaude Codeから選べる最上位モデルはClaude Fable 5.1で、どのプランでも既定モデルではないため /model fable で明示的に選ぶ。公式が推奨する既定の選択肢はClaude Opus 5.5（Claude Code v2.1.280以降）だ。バージョンが古いと新しいモデルを選べないので、Windowsでも claude update で最新化しておきたい（出典：Claude Code公式ドキュメント「Model configuration」）。

更新チャネルの選択と手動更新

PowerShellインストールはバックグラウンド自動更新が有効だ。更新チャネルは latest（既定）と stable（約1週間遅れ・大きなリグレッションをスキップ）の2系統が用意されており、~/.claude/settings.json の autoUpdatesChannel で切り替えられる。本番環境に近い用途では stable を選ぶことでリスクを抑えやすい。手動更新は claude update で実行できる。

パーミッションモードとサンドボックスの関係

ネイティブWindowsではサンドボックスが利用できないため、Claude Codeが実行するシェルコマンドはホストOS上で直接動く。Week 13（v2.1.83〜v2.1.85）で追加されたAuto mode（Shift+Tabで切り替え、または ~/.claude/settings.json で "permissions": {"defaultMode": "auto"} を設定）を使うことで、安全な編集・コマンドは自動承認し、破壊的・疑わしい操作は自動ブロックして通知するという中間的な制御が可能になる（出典：Week 13 リリースノート）。ただしAuto modeはリサーチプレビュー段階であり、サンドボックスによるOSレベルの隔離とは異なることを理解しておく必要がある。

アンインストール手順（PowerShellインストールの場合）

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

設定もすべて削除する場合は、PowerShellで Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force と Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force を実行する。VS Code拡張機能・JetBrainsプラグイン・デスクトップアプリも同じフォルダに書き込むため、完全に消すにはそれらを先にアンインストールしておく。ただし、これらにはセッション履歴・MCP設定が含まれるため、他の環境で同一設定を継続利用する予定があれば事前にバックアップを取ること。

ターミナルレスの選択肢

ターミナル操作を避けたい場合、AnthropicはDesktopアプリ（Windows対応）を公式提供している。GUIから操作でき、CLIとの使い分けが可能だ。CLIでの基本操作についてはClaude Code の使い方ガイドで解説している。

スラッシュコマンドの活用や初期設定の詳細についてはClaude Code スラッシュコマンド解説・Claude Code はじめかたガイドを参照されたい。他のAIコーディングツールとの比較を検討しているならClaude Code vs Cursor 比較記事が参考になる。

実運用の現場から：Windows環境でClaude Codeを数十端末に展開して分かったこと

クリスタルメソッドはAI・ディープラーニングの研究開発企業として、Claude Codeを1年以上・数十台の端末で日常的に実運用しています。その中にはWindows環境も含まれ、複数の開発者・複数マシンへ横展開する過程で、公式ドキュメントだけでは見えにくい実務上の勘所がいくつか見えてきました。以下は、その現場運用から得た知見です。

まず環境選択は「あとで揃える」より「最初に揃える」方が総コストが低いという点です。端末ごとにネイティブWindowsとWSL2が混在すると、パスの扱い・改行コード・シェル依存の挙動差が個人環境ごとの再現しにくい不具合として表面化し、切り分けに時間を取られます。チーム内で環境の方針（どのシェル・どのインストール方式を標準にするか）を先に一本化し、端末を増やすときも同じ手順で再現できる状態にしておくことが重視されています。本記事前半の「環境選択の根拠」を、個人の好みではなくチームの標準として決めておくと、端末が増えても運用が破綻しません。

次に、Git連携と権限まわりは端末追加のたびに確認する項目として固定化すると安定します。1台では問題なく動いていた設定が、別のWindows端末では権限やパスの前提が違って再現しないことは珍しくありません。こうした差異を都度ドキュメント化し、新しい端末をセットアップする際の確認リストとして使い回すことで、同じつまずきを繰り返さない運用にしています。「一度直した問題を標準手順に落とし込み、全端末へ横展開する」という考え方が、多端末運用では特に効きます。

---

参考文献

• Anthropic, “Claude Code Setup”, code.claude.com, 2026-10-07確認 — https://code.claude.com/docs/en/setup
• Anthropic, “What’s New: Week 13 · March 23–27, 2026”, code.claude.com — https://code.claude.com/docs/en/whats-new/2026-w13.md
• Anthropic, “What’s New: Week 18 · April 27 – May 1, 2026”, code.claude.com — https://code.claude.com/docs/en/whats-new/2026-w18.md
• Anthropic, “Redeploying Fable 5”, anthropic.com, 2026-07-01 — https://www.anthropic.com/news/redeploying-fable-5

よくある質問

Q. WindowsでClaude Codeを始める最短ルートは何ですか？
A. PowerShellで irm https://claude.ai/install.ps1 | iex を実行するネイティブインストールです。WSLやNode.js、管理者権限は不要で、インストール後に新しいターミナルで claude と入力すれば使い始められます。ターミナルを使いたくない場合はWindows版デスクトップアプリやVS Codeの拡張機能も使えます。

Q. Claude Code Windows版のシステム要件は何ですか？
A. OSはWindows 10 1809以降またはWindows Server 2019以降、RAMは4GB以上、アーキテクチャはx64またはARM64が必要です。シェルはPowerShell・CMD対応（Bash/Zshも可）、ネットワーク接続が必須で、ripgrepは通常同梱されています。

Q. ネイティブWindowsとWSL 2はどちらを選べばよいですか？
A. Dockerベースのワークフローを持ちLinux環境のCIと整合させたいチームは、サンドボックスが利用できるWSL 2を選ぶのが合理的です。.NETやPowerShellを中心に据えたWindowsネイティブのコードベースであれば、余分な変換レイヤーを挟まないネイティブインストールの方が実行環境と一致します。WSL 1はWSL 2が使えない場合の代替です。

Q. インストール方法にはどんな種類がありますか？
A. PowerShell（irm https://claude.ai/install.ps1 | iex）、CMD（curlベースのコマンド）、WinGet（winget install Anthropic.ClaudeCode）、npm（Node.js環境がある場合）、WSL 2環境用のコマンドなど、複数の方法が公式に提供されています。

Q. PowerShellとCMDのコマンドを取り違えるとどうなりますか？
A. CMD用コマンドをPowerShellで実行すると「The token ‘&&’ is not a valid statement separator」というエラーになります。逆にPowerShell用コマンドをCMDで実行すると「’irm’ is not recognized as an internal or external command」というエラーになります。プロンプトが「PS C:\」で始まればPowerShell、「C:\」のみであればCMDと判断できます。

Q. Git Bashが見つからないエラーはどう対処しますか？
A. ~/.claude/settings.jsonにCLAUDE_CODE_GIT_BASH_PATHでパスを明示します。またv2.1.84でWindowsネイティブ向けのPowerShellツールが追加され、Git Bashなしでもシェルコマンドを実行できる選択肢が加わりました。v2.1.120〜v2.1.126ではGit BashなしのWindows動作がさらに改善されています。

Q. WinGetでの更新が失敗する場合はどう対処しますか？
A. Claude Codeが実行中だとexeファイルにロックがかかり更新が失敗します。更新前にClaude Codeを完全終了してからwinget upgrade Anthropic.ClaudeCodeを実行する必要があります。

Q. Claude Code Windows版の利用に必要なプランは何ですか？
A. Pro・Max・Team・Enterprise・Consoleのいずれかのアカウントが必要で、Freeプランでは使用できません。

---