Knowledge Notebook
一覧に戻る
tool 2026年06月09日

Windows 11でClaude Codeを導入する最短手順と「できること」・「権限・プライバシー」の注意点まとめ

噂の自律型AIエージェント「Claude Code」を、私のメインマシンであるWindows 11環境へ実際に導入してみました。macOSやLinux向けの情報は多く見かけるものの、Windows環境ではPowerShellのセキュリティ制限や環境変数（PATH）の反映など、Windowsならではのつまずきやすいポイントがいくつか存在します。

今回は、実際にセットアップを行った際の手順と、途中で遭遇したエラーの解決策を含めて、最短かつ安全にWindows 11でClaude Codeを使い始めるためのマニュアルを整理しました。

1. Claude Codeで「できること」

Claude Codeは、従来のチャット型AI（Webブラウザ上のClaudeなど）と異なり、ローカルマシン上のファイルシステムや開発用CLIツールと直接連携してタスクを自律的にこなせるのが最大の特徴です。

  • コードの自動編集・新規作成: 「〇〇機能を実装して」「リファクタリングして」と指示するだけで、関係するファイルを探し出し、差分を作成して適用します。
  • ビルドとテストの自動実行・修復: ターミナル上でテストコマンドやビルドコマンドを実行し、エラーが発生した場合はエラーメッセージを自動的に分析し、問題のあるコードを自動修正します。
  • Git連携とコミットメッセージ自動生成: 変更差分（git diff）を解析し、適切なコミットメッセージを日本語で自動生成してコミットまで実行させることができます。
  • プロジェクトの理解とコード探索: 複雑なコードベース全体をスキャンし、「この機能はどこで定義されている？」「全体のアーキテクチャはどうなっている？」といった質問に詳しく回答します。

2. 利用の前提条件

導入する前に、以下の要件を満たしているか確認してください。

  • OS環境: Windows 10 (version 1809以降) または Windows 11。
  • アカウントプラン: Claude Codeの動作には、Claude Pro または Team（またはMax）のアクティブなサブスクリプションが必要です（無料枠アカウントでは利用できません）。

3. 【推奨】ネイティブインストーラーでの導入（Node.js不要）

最新のアップデートにより、Windows環境ではNode.jsやnpmを事前にインストールしなくても、コマンド一発でセットアップできるネイティブインストーラーが公式に提供されるようになりました。

PowerShellでインストールする場合（推奨）

PowerShellを起動し、以下のコマンドを実行します。

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

コマンドプロンプト (CMD) でインストールする場合

コマンドプロンプトを起動し、以下のコマンドを実行します。

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

Windows環境特有のインストールエラーと対策

実際にWindowsでセットアップした際、あるいは周囲の開発者が導入する際によく発生する代表的なエラーと、その具体的な回避策を記述しておきます。

① PowerShellの実行ポリシーエラー

【現象】 PowerShellでインストール用スクリプトを実行しようとした際、以下のようなエラーテキストが表示されてインストールが停止する。

スクリプトの実行がシステムで無効になっているため、ファイル...を読み込めません。

【対策】 Windowsのデフォルト設定でスクリプトの実行制限（Execution Policy）がかかっていることが原因です。この場合、PowerShellを一時的にポリシー変更して実行します。以下のコマンドを入力して実行許可を与えてから、再度インストールコマンドを実行してください。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

② インストール後に「コマンドが見つかりません」となる現象

【現象】 インストール完了のログが出たにもかかわらず、claude コマンドを実行すると「名前はコマンド、関数...として認識されません」と表示される。

【対策】 インストーラーがユーザーの環境変数（PATH）にClaudeの実行ファイルの場所を追加したものの、現在開いているPowerShellウィンドウにそれがまだ反映されていないためです。PowerShell（またはVS Codeのターミナル）を一度完全に閉じて、再起動（新しく開き直す）してください。これにより新しい環境変数が読み込まれ、コマンドが認識されるようになります。

4. 【代替】npm (Node.js) 経由での導入

すでにNode.js環境をお持ちの開発者の場合、従来のnpm（グローバルパッケージ）経由でインストール・管理することも可能です。

  1. Node.js (バージョン 18以上) がインストールされていることを確認します。
  2. ターミナルで以下のインストールコマンドを実行します。 
    npm install -g @anthropic-ai/claude-code

5. 初回セットアップとアカウント認証の流れ

  1. ターミナル上で、開発したいプロジェクトのフォルダに移動します。
  2. claude コマンドを実行します。 
    claude
  3. 初回のみ、コンソールにワンタイム認証コードが表示され、WebブラウザでAnthropicのアカウントログイン画面が自動的に開きます。
  4. ブラウザ上でログインし、画面にコードを入力して認証を完了させます。
  5. ターミナルに戻ると、Claudeとの対話型セッション（CLI入力画面）が起動します。

6. 【重要】セキュリティと実行権限（Permissions）の注意点

Claude Codeはローカル環境で強力なコマンドを実行できるため、セキュリティ上の安全設計（サンドボックス機構）が組み込まれています。

① 明示的承認（Explicit Approval）ポリシー
デフォルトでは、Claudeが「ファイルを編集する」「コマンドを実行する」「テストを走らせる」といった行動を起こす際、ターミナル上に必ずユーザーの確認プロンプト（y/n）が表示されます。勝手に危険なコマンドが実行されることはありません。

② 書き込みディレクトリ制限
セキュリティ上、Claude Codeは起動されたディレクトリとそのサブディレクトリ（子フォルダ）内にのみ書き込み権限がデフォルトで制限されています。親ディレクトリの重要なシステムファイルを意図せず書き換えられるリスクを防いでいます。

③ 危険なフラグ（スキップ）は避ける
確認プロンプトをすべてスキップして自律実行させる --dangerously-skip-permissions というオプションもありますが、本番環境や機密データが存在するプロジェクトでの使用は強く非推奨です。必ず手動で確認しながら実行してください。

7. 【重要】データプライバシーとオプトアウト（モデル学習対策）

業務コードや個人のプロダクトのソースコードを読み込ませるにあたり、送信したデータがAIモデルの学習（トレーニング）に使われるのを防ぎたい場合は、アカウント側でオプトアウトの設定が必要です。

プランによる学習ポリシーの違い

  • 商用プラン（Team / Enterprise / API経由）: デフォルトで、送信されたデータがAnthropicのモデル学習に利用されることはありません。特別な設定は不要です。
  • 個人プラン（Pro / Max / Free）: デフォルトでモデル学習（モデルの改善）にデータが使用される設定になっています。手動でオフにする必要があります。

モデル学習をオフにする手順（オプトアウト）

  1. ブラウザで、Claudeの データプライバシー設定（claude.ai/settings/data-privacy-controls） にアクセスします。
  2. 「改善のためのデータ使用 (Use my data to improve Claude)」という設定項目を探します。
  3. このスイッチをオフ（無効）に切り替えます。これにより、今後送信された会話やコードセッションがモデル学習に使用されなくなります（※過去に送信済みのデータには遡及適用されません）。

WindowsでのCLIツールのセットアップは、以前は環境構築や依存関係の解消で一苦労するイメージがありましたが、Node.js不要の公式インストーラーが整備されたことで、思った以上にスムーズに導入することができました。PowerShellの実行ポリシー制限のエラーだけ最初つまずきましたが、上記の対策で無事に解決できています。

安全なオプトアウト設定と確認プロンプトの目視確認を怠らないように注意しつつ、Windows 11での快適なAIエージェント共同開発環境を構築していくのが良さそうです。