Windows版 Claude Code インストール完全ガイド【実体験レポート】

プログラミング関連

AnthropicのAIコーディングエージェント「Claude Code」をWindowsにインストールした際の手順と、実際に発生したエラーの対処法をまとめました。同じところで詰まっている方の参考になれば幸いです。

Claude Codeとは？

Claude Codeは、Anthropicが提供するターミナル（コマンドライン）上で動作するAIツールです。ファイルの作成・編集・削除、コマンドの実行まで、自然言語の指示だけで行ってくれます。

チャット型のAIとの大きな違いは、実際にあなたのパソコン上のファイルを直接操作できる点です。「このフォルダのファイルを全部読んでまとめて」「このExcelを分析してレポートを作って」といった指示を、ファイルの保存まで含めて全自動でこなしてくれます。

⚠️ 注意：Claude.aiデスクトップアプリとは別物です
Claude.aiのデスクトップアプリはチャット機能を提供するものです。ファイルを直接操作するClaude Codeとは別のツールです。混同しないようにご注意ください。

必要なもの（事前確認）

  • Windows 10 / Windows 11
  • Claude Pro・Max・Teams・Enterprise・ConsoleいずれかのアカウントとProプラン以上の契約（無料プランは不可）
  • インターネット接続

インストール手順

ステップ1：Git for Windowsをインストール

Claude CodeはWindows上でGit Bashを内部的に使用しているため、Gitが必須です。

  1. https://git-scm.com にアクセス
  2. 「Download for Windows」をクリックしてダウンロード
  3. インストーラーを実行（設定はすべてデフォルトのままでOK）

⚠️ 注意：「Add Git to PATH」のチェックはデフォルトでオンになっています。これが外れているとClaude Codeが動作しないので確認してください。

ステップ2：Node.jsをインストール

npm経由でインストールする場合、Node.js 18以上が必要です。

  1. https://nodejs.org にアクセス
  2. 「LTS版（推奨版）」をダウンロード・インストール

⚠️ 実体験エラー：Node.jsのバージョンが古いとインストールが失敗する
今回の試行では、Node.js 14.15.4がすでにインストールされていましたが、Claude Codeは18以上を要求するためエラーが発生しました。古いバージョンが入っている場合は必ず最新のLTS版に更新してください。

npm WARN notsup Unsupported engine for @anthropic-ai/claude-code: wanted: {"node":">=18.0.0"} (current: {"node":"14.15.4"})

ステップ3：PowerShellでClaude Codeをインストール

スタートメニューから「PowerShell」を起動し（管理者権限は不要）、以下のコマンドを実行します：

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

または、npmでインストールすることもできます：

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

以下のように表示されれば成功です：

changed 2 packages in 850ms
1 package is looking for funding

ステップ4：環境変数（PATH）の設定

インストール後にclaudeコマンドが認識されない場合、PATHが通っていない可能性があります。

GUIで設定する方法（推奨）：

  1. スタートメニューで「環境変数」と検索し「システム環境変数の編集」を開く
  2. 「環境変数」ボタンをクリック
  3. ユーザー環境変数の「Path」を選択して「編集」
  4. 「新規」で以下を追加：%APPDATA%\npm
  5. 「OK」で閉じる
  6. コマンドプロンプトを開き直す

⚠️ 実体験エラー：setxコマンドで1024文字制限に引っかかる
コマンドで環境変数を追加しようとしたところ、既存のPATHが長すぎて1024文字に切り捨てられるエラーが発生しました。この場合はGUIから設定する方法が安全です。

ステップ5：起動と認証

作業したいフォルダに移動してからClaude Codeを起動します：

cd 作業フォルダのパス
claude

例：

cd D:\Dropbox\backup\プロジェクト
claude

初回起動時はブラウザが自動で開き、Claudeアカウントのサインイン画面が表示されます。サインインすると認証コードが発行されるので、それをコマンドプロンプトに貼り付けてEnterを押します。

以下のように表示されれば認証成功です：

Logged in as your@email.com
Login successful. Press Enter to continue...

⚠️ 実体験エラー：OAuth error: Invalid code
認証コードが正しく入力されなかった場合に発生します。Enterを押してリトライし、ブラウザに表示されたコードを全文コピーして貼り付けてください。途中で切れると同じエラーになります。

⚠️ 注意：claudeコマンドはフォルダを指定してから起動する
作業フォルダに移動せずにclaudeを起動すると、どのファイルを操作すればよいかClaudeが判断できません。必ずcdで作業フォルダに移動してからclaudeを実行してください。

インストール完了後の使い方

Claude Codeが起動したら、日本語でそのまま指示を入力できます。例えば：

  • 「このフォルダの中のPDFを全部読んで、内容をまとめたレポートをWordで保存して」
  • 「このExcelのデータを分析してグラフ付きのレポートを作って」
  • 「バグを修正してテストを実行して」

Claudeが自動でファイルを読み込み、作業し、保存まで行ってくれます。

エラーまとめ一覧

エラー内容原因対処法
claudeコマンドが認識されないPATHが通っていない環境変数にて%APPDATA%\npmを追加。コマンドプロンプトを再起動
Unsupported engine（Node.jsバージョンエラー）Node.jsが18未満nodejs.orgから最新LTS版をインストール
setxで「1024文字に切り捨てられました」既存のPATHが長すぎるGUIの環境変数設定画面から手動で追加する
OAuth error: Invalid code認証コードが不完全Enterでリトライし、コードを全文コピーして貼り付ける
ログイン後Enterを押しても動かない作業フォルダが指定されていないcd フォルダパスで移動してからclaudeを実行

まとめ

Windows版Claude Codeのインストールは、手順通りに進めれば難しくありません。ただし、以下の2点が特に詰まりやすいポイントです。

  1. Node.jsのバージョン：必ず18以上（LTS版推奨）を使用する
  2. 作業フォルダの指定：claudeを実行する前に必ずcdで移動する

この2点を押さえておけば、スムーズにインストールできるはずです。ぜひ試してみてください！

コメント

タイトルとURLをコピーしました