Office Mizuki
60分無料相談
JJournal AI導入

AIツール導入

Claude CodeをWindowsで使う公式手順|WSL不要の導入とエラー対策

Claude CodeをWindowsで使う公式手順|WSL不要の導入とエラー対策

Windows環境のClaude Codeは「ネイティブ実行」が公式標準

コマンドラインで動作するAIツール「Claude Code」について、Web上の情報を調べるとMac向けの手順や「WSL2の導入が前提」とする古い解説が目立ちます。しかし、現在の公式仕様において、Windows環境の導入基準は大きく整理されました。

Anthropicの公式ドキュメント(Claude Code Docs: Advanced setup)によると、現在のWindows環境ではWSLを経由するよりもネイティブWindows環境での直接実行が案内されています。仮想Linux環境を構築しなくても、標準のターミナルからそのまま起動できる設計です。

Windows環境への導入にあたり、事前に把握しておくべき公式要件は以下の通りです。

  • OS要件: Windows 10 1809以上、またはWindows Server 2019以上(64ビット環境)
  • ハードウェア要件: 4GB以上のRAM(32ビット環境には非対応)
  • 権限要件: 管理者権限(Administrator)は不要(一般ユーザー領域に安全に導入される)
  • ツールの位置づけ: Git for Windowsの導入は任意(推奨)。未導入時はPowerShellツール、導入時はBashが内部ツールとして使用される

なお、実行環境を保護するサンドボックス機能(Sandboxing)はネイティブWindowsでは非対応であり、WSL環境でのみ利用可能とされています。一方で、ファイルシステムの処理性能を重視する場合は、ネイティブ環境での実行が適しています。

1行で完了する公式導入コマンドとシェル別の選び方

Claude Codeの導入方式は更新されており、過去に主流だったNode.jsを個別に導入してnpmコマンドを叩く手順は不要となりました。現在は、公式に用意された専用インストーラーを実行する方式へ変更されています。

Windows環境で利用できる導入手段は、操作するシェル(コマンド実行画面)ごとに分かれています。環境に合わせて自身の端末のシェルに適した1行コマンドを選択することが確実なセットアップの第一歩です。

PowerShellでのネイティブインストール(推奨)

Windows環境で最も推奨されているのが、標準搭載されているPowerShellを用いた導入です。PowerShellを通常権限で開き、以下のコマンドを実行します。

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

このスクリプト経由でセットアップを行うと、バックグラウンドでの自動更新に対応する構成でツールが配置されます。

コマンドプロンプトおよびWinGetによる導入

普段からコマンドプロンプト(CMD)を利用している場合や、Windowsの標準パッケージ管理機能であるWinGetを使いたい環境向けにも、以下の公式構文が提供されています。

  • コマンドプロンプト(CMD)用構文:
    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  • WinGet(手動更新)用構文:
    winget install Anthropic.ClaudeCode

ターミナル以外の選択肢(Desktopアプリ・VS Code拡張)

コマンドライン操作に慣れていない実務担当者が社内にいる場合、黒い画面(ターミナルCLI)を使わずに利用する方法も公式に提供されています。

Claude Desktopアプリの「Code」タブを利用する方法や、VS Code拡張機能・JetBrains拡張機能を導入することで、GUI(視覚的な操作画面)を通じてClaude Codeの機能を活用できます。業務の習熟度に合わせて窓口を選択するとよいでしょう。

Mac向け記事の誤コピペで起きるWindows特有の構文エラー

ネット上の技術ブログを参考に導入を進めると、MacやLinux向けに書かれた構文をWindowsへ貼り付けてしまい、意味の分かりにくい英字エラーで止まるケースが多発します。

Claude Code Docs(Troubleshoot installation and login)には、ユーザーが遭遇しやすい構文エラーとその要因が明確に記載されています。発生したエラーメッセージと照らし合わせて切り分けてください。

ターミナルに表示されるエラーメッセージ

発生する原因

公式ドキュメントに基づく対処法

The token '&&' is not a valid statement separator

コマンドプロンプト(CMD)用のコマンドをPowerShellで実行した

PowerShell用の構文(irmから始まるコマンド)を実行し直す

'irm' is not recognized as an internal or external command

PowerShell用のコマンドをコマンドプロンプト(CMD)で実行した

コマンドプロンプト用の構文を実行するか、PowerShellを開き直す

A parameter cannot be found that matches parameter name 'fsSL'
または 'bash' is not recognized as the name of a cmdlet

Mac/Linux/WSL向けのcurl構文をそのままPowerShellに貼り付けた

Windows向けに案内されている公式コマンドを実行する

command not found: claude
または 'claude' is not recognized

インストール直後で、実行ファイルの場所(PATH)がシェルに反映されていない

一度ターミナルを完全に閉じて開き直す(または環境変数PATHを確認する)

特に多いのは、インストールスクリプトが正常終了した直後に「claude」と打ち込んで認識されない現象です。ターミナルを一度閉じて再起動するだけで、追加されたPATHが読み込まれて起動できるようになります。

現場で起きる起動エラーの切り分け|公式トラブルシューティングに基づく点検

導入時にトラブルが起きると、ネット上では「管理者権限で実行してみる」「レジストリを修正する」といった根拠の薄い俗説が出回りがちです。しかし、不必要な管理者権限の行使は社内PCの安全性を損ねる原因になります。

まずは公式トラブルシューティング(Troubleshoot installation and login)に沿って、論理的に原因を特定することが重要です。

32ビット版シェル誤起動の確認

コマンド実行時に Claude Code does not support 32-bit Windows と表示される事例があります。このエラーは、使用している端末が64ビットOSであっても発生します。

原因は、Windowsのスタートメニューから誤って「Windows PowerShell (x86)」という32ビット互換環境を開いてしまっていることです。表記に「x86」と付いていない通常の64ビット版PowerShellを起動し直して実行してください。

プロセス競合エラーの解消手順

インストールやアップデートの最中に The process cannot access the file ... because it is being used by another process という表示が出ることがあります。

これはファイルが別のプロセスによって一時的にロックされている状態です。公式ドキュメントでは、インストーラーを実行中の他のPowerShellを閉じ、ウイルス対策ソフトのスキャン完了を待ってから、%USERPROFILE%\.claude\downloads フォルダを削除してコマンドを再試行する手順が案内されています。

俗説に惑わされないための3点チェック

社内PCで予期しない挙動に直面した際は、推測で設定をいじる前に以下の3項目が公式の要件を満たしているかを確認してください。

  • 開いているシェルと入力した構文の組み合わせ(PowerShellにCMD用を入力していないか)
  • 起動しているシェルのビット数(x86版ではなく64ビット版のシェルを開いているか)
  • インストール後の環境変数PATHの読み込み(ターミナル画面を開き直したか)

公式ドキュメントに記載のない対処を場当たり的に試すのではなく、確定している仕様に基づいて点検することが、安全な運用の基本です。

社内Windows PCでClaude Codeを立ち上げるための点検リスト

これから社内のPC環境へClaude Codeを順次導入していく際は、作業の手順と確認事項をあらかじめ整理しておくと混乱を防げます。作業前の確認チェックリストとして活用してください。

  • OSの前提条件の確認: 64ビット版のWindows 10(バージョン1809以上)またはWindows Server 2019以上であり、メモリが4GB以上あるか
  • 実行権限の確認: 管理者権限ではなく、業務で使用する一般ユーザー権限でPowerShellを開いているか
  • コマンドの実行: PowerShell専用の導入スクリプトを正確に実行したか
  • シェルの再起動: コマンド完了後、ターミナルを終了して新しいウィンドウを立ち上げたか
  • 起動テスト: 「claude」と入力して対話画面が立ち上がるか

起動が確認できた後は、社内実務でどのような指示を出して業務効率化を図るかという活用のフェーズに移ります。日常業務でのプロンプト指示や基本的な対話の流れについては、Claude活用マニュアルの資料もあわせて確認しておくと社内展開が円滑になります。

まとめ:状況別の次の一手

Claude CodeのWindows導入において発生する疑問や問題は、公式の仕様に立ち返ることで大半が切り分けられます。現在の状況に合わせて、以下の対応を進めてください。

  • インストール直後で「claude」コマンドが認識されない場合: ターミナル(PowerShell)を一度完全に終了し、新しいウィンドウを開き直してPATHが反映されているか点検する
  • コマンド実行時に構文エラーや見慣れない英字メッセージが出た場合: 記事内のエラー対照表を確認し、開いているシェル(PowerShellかCMDか)と貼り付けたコマンドの組み合わせが一致しているか確認する
  • 社内のWindows端末へClaude Codeを本格展開し、業務自動化を進めたい場合: 社内マニュアルの整備とともに、組織的な定着やセキュリティ設定の伴走支援について法人AI導入支援・外部AI担当者サービスなどの専門窓口を活用する

自社の業務環境に合わせた具体的なAIツールの活用計画や導入時の不安については、Office Mizuki のお問い合わせ窓口へお気軽にご相談ください。

参考にした一次情報