AmoriのAI実験室Amori’s AI Lab
ホーム / 記事一覧 / 開発・自動化
開発・自動化

Claude Codeをインストールする OS別の初期設定と起動確認

Claude CodeのインストールをMac・Windows・WSL別に解説。WSLの必要性、command not found、初回ログインできない場合の確認と、導入後の読み取り練習を紹介します。

編集：AmoriのAI実験室公式資料と練習用テンプレート
ノートパソコンへコードのモジュールを導入するイメージ
記事のテーマを表したAI生成イラストです。

Claude Codeのインストールは、普段使うOSとシェル（macOS・Linux・Windows PowerShell・WSL）に合わせて公式コマンドを実行し、新しいターミナルで claude --version でバージョン番号が表示されれば、本体の導入を確認できます。続けて練習用の空フォルダで初回ログインを済ませ、ファイルを書き換えない最小の読み取りテストまで通すのが最初の到達点になります。

※2026年10月29日時点の公式ドキュメント（Claude Code Advanced setup）にもとづく手順ガイドです。手元のMac・Windows実機での新規インストール検証は未実施のため、OS別の詳細な要件は公式案内もあわせて確認してください。

自分のOSと利用条件を確認する

導入コマンドを実行する前に、「普段コードを編集するOS・シェル環境」と「ログインに使うアカウントの契約状態」の2点を揃えます。ここが食い違うと、導入後にコマンドが見つからないエラーや初回ログイン停止の原因になります。

WindowsでWSLは必要か（ネイティブ版とWSLの選び方）

WindowsへClaude Codeをインストールする際、Windowsネイティブ環境とWSL（Windows Subsystem for Linux）の両方に対応しているため、WSLは必須ではありません。普段プロジェクトを開いている環境に合わせて導入先を選んでください。

  • Windowsネイティブ（PowerShell / WinGet）：Windows上のフォルダでそのまま開発する場合に選びます。Git for Windowsは任意で、未導入の環境ではPowerShellのシェルツールが使われます。
  • WSL：Linux向けツールチェーンを使う場合や、WSL2のサンドボックス機能を利用したい場合に選びます。

どちらを選ぶ場合も、「インストールを実行したシェル（PowerShellかWSLか）」と「claude コマンドを起動するシェル」を必ず一致させます。

公式の配布方法でインストールする

現行の公式案内では、OS別のネイティブインストーラまたはパッケージマネージャー（Homebrew / WinGet）を使用します。

コマンド実行前の安全確認

実行前に次の3点を確認します。

  • 接続先URL・パッケージ名：取得先が公式ドメイン（https://claude.ai/...）、または公式パッケージ名（claude-code / Anthropic.ClaudeCode）であること。
  • 開いているシェル：WindowsではPowerShellかWSLのどちらを開いているかをウィンドウ表示で確認すること。
  • 権限確認の表示：パッケージ管理ツールや環境設定の更新時にOSの承認を求められた場合は、表示内容を確認して許可すること。

macOS・Linux・WSLでのインストール手順

macOS、Linux、およびWindowsのWSL内では、ターミナルで公式インストーラを実行します。

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

curl で取得した公式スクリプトを bash に渡して実行します。-fsSL はHTTPエラーやリダイレクトを扱う curl 側のオプションであり、パイプ全体の成功を保証するものではないため、完了メッセージまで確認してください。

macOSでHomebrewを使っている場合は、Caskでも導入できます。

brew install --cask claude-code

Windows（PowerShell・WinGet）でのインストール手順

Windowsネイティブ環境では、PowerShellで以下を実行します。

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

irm（Invoke-RestMethod）で公式のPowerShell用スクリプトを取得し、iex（Invoke-Expression）で実行します。

WinGetを使う場合は以下のコマンドです。

winget install Anthropic.ClaudeCode

古い手順との見分け方とインストール後のバージョン確認

検索結果に旧来の非推奨手順が出てくることがありますが、導入コマンドは公式の Claude Code Advanced setup の記載を基準にします。

インストールが終わったら、環境変数（PATH）の変更を反映させるため、現在のターミナル（またはPowerShell）を一度閉じて新しく開き直してから次を実行します。

claude --version

バージョン番号が表示されれば、本体のインストールは完了です。

認証と初回設定を終える

バージョン表示を確認したら、練習用の空フォルダを作って初回起動と認証を行います。

作業フォルダの作成と権限（パーミッション）の確認

Claude Codeは起動時のカレントディレクトリを基準にファイルを探索します。ホームディレクトリやデスクトップ直下での起動は避け、専用の練習用フォルダを作って移動してから起動してください。

mkdir claude-practice
cd claude-practice
claude

起動時にフォルダへのアクセス確認が表示されたら、カレントディレクトリが claude-practice であることを確かめて許可します。作業中のファイル変更やシェル実行は、通常の手動確認モードでは都度確認を求められますが、読み取り専用操作や既存の許可ルール、権限モードによる例外があります。内容が不明なコマンドや作業フォルダ外への変更はキャンセルしてください。

初回ログインが完了しないときの確認手順

claude 起動後に初回ログインができない場合や、ブラウザ認証後にターミナル側で止まる場合は、次の順で切り分けます。

  1. アカウントの契約条件を確認する
    ログインしたアカウントが、Claude Code対応の契約プランまたは有効な課金設定済みのAnthropic Consoleアカウントか確認します。
  2. ブラウザ画面とターミナル表示を照合する
    認証URLが自動で開かない場合は、ターミナル上のURLをコピーしてブラウザへ貼り付けます。認証コードの入力待ちかローカル通信の連携待ちか、ターミナルの表示メッセージを確認します。
  3. ネットワーク制限を確認する
    プロキシ、VPN、社内ファイアウォール等で通信が遮断されていないか確認します。Network error、Timeout、SSL error 等が出る場合は通信設定を見直します。

起動できない原因を切り分ける

起動や認証で止まるときは、再インストールを繰り返す前にエラー表示で原因を切り分けます。

症状別の原因切り分けチェック表

発生する症状・表示 主に疑う原因 最初に試す確認・対処
command not found や「認識されません」と出る ターミナルの未再起動、PATH未反映、または別環境（WSLとPowerShellの取り違え） 新しいターミナルを開き直す／インストールした環境と同じシェルか確認する
インストールコマンド自体が途中で止まる ネットワーク制限、またはパッケージ管理ツールの権限・更新待ち エラーが出た行のメッセージを確認し、通信環境やツールの状態を見直す
起動後に認証エラーで終了する 非対応アカウントでのログイン、認証トークンの期限切れ・不整合 再ログイン手順を実行し、ブラウザ側のログインアカウントを確認する
応答が返ってこない・接続エラーになる プロキシ・VPN・ファイアウォール、またはサービス側の一時的な障害 管理者の案内と通信状態を確認する／エラー文字列で通信系か認証系かを切り分ける

command not found やコマンド未検出になるときの対処法

インストール直後に claude: command not found（macOS / Linux / WSL）や「'claude' は、内部コマンドまたは外部コマンド...として認識されていません」（Windows）と出る場合は、次の4ステップで確認します。

  1. 新しいターミナルを開き直す
    導入時のウィンドウには新しい PATH が反映されないことがあります。ウィンドウを閉じて開き直し、claude --version を再実行します。
  2. インストール環境と起動環境の一致を確認する
    WSL内に導入してWindows側のPowerShellから実行している（またはその逆）ケースがよくあります。導入時と同じシェルで実行しているか確かめます。
  3. 実行ファイルの配置場所を探す
    macOS・Linux・WSLでは which claude、PowerShellでは where.exe claude を実行します。何も出ない場合はインストーラ完了時の出力パスを確認します。
  4. シェル設定ファイルのPATHを確認する
    ~/.zshrc や ~/.bashrc などを利用している場合、インストール先ディレクトリが PATH に含まれているか確認し、設定を再読み込みします。

エラーメッセージの確認順

コマンド未検出以外のエラーは、ターミナルに出た最初のエラー行で分類します。

  • 認証系（401 / 403 / Unauthorized / login など）：アカウントの契約条件やログイン状態を確認します。
  • 通信系（ENOTFOUND / ETIMEDOUT / certificate / proxy など）：ネットワーク接続やプロキシ設定を確認します。
  • 権限系（EACCES / Permission denied など）：作業フォルダや設定ファイルの読み書き権限を見直します。

最小の読み取り作業で確認する

ログイン後に入力待ち画面が出たら、ファイルを書き換えない読み取り依頼で動作を確かめます。

練習用フォルダと読み取り確認プロンプト

claude-practice フォルダに以下の memo.txt を用意し、同じフォルダで claude を起動します（すでに起動中の場合はそのまま質問しても構いません）。

プロジェクト名：Claude Code 導入テスト
目的：インストールと初回起動、ファイル読み取りの確認
ルール：このテストではファイルの作成・編集・削除を行わないこと

起動後、次のプロンプトを入力します。

今は導入直後の動作テスト中です。
ファイルの作成・変更・削除や、シェルコマンドの実行は一切行わないでください。

次の2点だけを日本語で短く教えてください。
1. 現在あなたが参照している作業フォルダ内にあるファイルの一覧
2. もし memo.txt があれば、その中に書かれている内容の要約（3行以内）

ファイルを書き換えずに、フォルダ内のファイル一覧と memo.txt の3行要約が日本語で返ってくれば、インストール・認証・作業フォルダ認識のすべてが完了です。

導入完了後に進む次のステップ

出典・参考資料

Amoriのプロフィールアイコン
AmoriのAI実験室

本文執筆：agy ／ 確認・編集：制作担当

編集・検証方針

あわせて読む

すべての記事を見る