📚 入門から実践活用まで — AIコーディングを、ふむふむと。

トラブル解決

Claude Codeがインストールできない時の対処法【エラーメッセージ別・Mac/Windows】

Claude Codeのインストールで出るエラーを、公式トラブルシューティングに沿ってメッセージ別に整理。「irm is not recognized」「syntax error near unexpected token '<'」「403」「EACCES」「32-bit」「Killed」など、原因と直し方を初心者向けに解説します。ターミナルが苦手な人向けの別ルートも紹介。

公開: 2026-05-10·更新: 2026-10-10·約9分で読める·#インストール#エラー#Windows

Claude Codeがインストールできない時の対処法

答え:インストールのエラーは、ほとんどが「OSやターミナルに合わないコマンドを使っている」「ネットワークで止められている」「PATHが通っていない」のどれかです。 表示されたエラー文を下の早見表で探せば、直し方が分かります。

ターミナルが苦手なら、デスクトップアプリ版を使うのがいちばん確実です。 公式も「ターミナルを使いたくない場合はデスクトップアプリで」と案内しています(「デスクトップアプリの始め方」)。

📌 本記事は2026年10月時点の公式ドキュメント「Troubleshoot installation and login」に基づいています。

公式のインストールコマンド(まずはこれを確認)

使っているOSとターミナルに合ったコマンドを使うのが大前提です。ここが違うと、エラーになります。

環境 コマンド
Mac・Linux(ターミナル) curl -fsSL https://claude.ai/install.sh | bash
Windows(PowerShell) irm https://claude.ai/install.ps1 | iex
Windows(コマンドプロンプト) curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Mac(Homebrewを使う場合) brew install --cask claude-code
Windows(WinGetを使う場合) winget install Anthropic.ClaudeCode

インストールが終わったら、ターミナルを新しく開いて claude --version を実行します。バージョン番号(例:2.1.211 (Claude Code))が出れば成功です。

💡 公式の推奨インストールでは、Node.jsは不要です。「Node.js 18以上が必要」という説明は、npmで入れていた頃の古い情報です。

エラーメッセージ別の早見表

表示されたエラー 原因 直し方
command not found: claude/'claude' is not recognized PATHが通っていない 「command not foundの直し方」へ
'irm' is not recognized コマンドプロンプトでPowerShell用のコマンドを打った PowerShellを開いて打ち直す(または上の表のコマンドプロンプト用を使う)
The token '&&' is not a valid statement separator PowerShellでコマンドプロンプト用のコマンドを打った irm https://claude.ai/install.ps1 | iex を使う
'bash' is not recognized/A parameter cannot be found that matches parameter name 'fsSL' WindowsでMac・Linux用のコマンドを打った irm https://claude.ai/install.ps1 | iex を使う
コマンドを打ったらスクリプトの文字がずらっと表示されて、何も入らない コマンドの前半しか実行していない | iex まで含めた全体を実行する
syntax error near unexpected token '<' インストール用のファイルではなく、Webページ(HTML)が返ってきた 下の「HTMLが返ってくる・403」へ
curl: (22) … error: 403 同上。またはネットワークで止められている 下の「HTMLが返ってくる・403」へ
EACCES: permission denied インストール先のフォルダに書き込めない 下の「権限エラー」へ
Claude Code does not support 32-bit Windows 「Windows PowerShell (x86)」を開いている x86が付かない「Windows PowerShell」で打ち直す
Killed(Linux) メモリ不足 空きメモリを増やす(約512MB必要)
TLS connect error/SSL/TLS secure channel 証明書・通信の問題 下の「通信・証明書のエラー」へ
App unavailable in region 提供されていない国・地域 対応国から利用する
dyld: Symbol not found(Mac) macOSが古い macOS 13.0以上に更新

HTMLが返ってくる・403エラー

インストール用のファイルを取りに行ったのに、Webページや拒否の返事が返ってきた状態です。公式によると、主な原因は次のとおりです。

  • 一時的な通信・配信の不具合 → 数分待ってもう一度
  • 会社のネットワークやプロキシで止められている → 社内のIT担当に相談
  • 提供されていない国・地域(ページに「App unavailable in region」と出る)

すぐに試せる別ルートとして、公式は次を案内しています。

  • Mac:brew install --cask claude-code
  • Windows:winget install Anthropic.ClaudeCode

権限エラー(EACCES)

インストール先のフォルダに書き込めないときに出ます。公式の確認方法(Mac・Linux)は次のとおりです。

test -w ~/.local/bin && echo "writable" || echo "not writable"

not writable と出たら、公式は次のコマンドでフォルダの持ち主を自分にするよう案内しています。

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

⚠️ sudo は管理者の権限で実行する命令で、パスワードを聞かれます。会社のパソコンでは、社内ルールを確認してから実行してください。

通信・証明書のエラー

  • Windowsで「SSL/TLS secure channel」:PowerShellで次を実行してから、インストールし直します(公式の案内)。 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  • 会社のネットワーク:通信を検査する仕組み(プロキシ)が原因のことがあります。公式は、会社の証明書ファイルを指定する方法を案内していますが、ファイルの用意が必要なので、社内のIT担当に相談するのが近道です
  • つながるかの確認:Mac・Linuxなら次のコマンドで、ダウンロード先に届くか調べられます。最初の行に 200 が出ればOKです curl -sI https://downloads.claude.ai/claude-code-releases/latest

2つ以上入っていて、おかしな動きをする

昔の方法(npm)と新しい方法の両方で入れていると、古い版が動いたりします。公式は、推奨の場所(~/.local/bin/claude)の1つだけを残すよう案内しています。確認と削除の方法は「command not foundの直し方」の「それでも直らないとき」で解説しています。

それでも解決しないとき

  • 起動できるなら、Claude Codeの中で /doctor と打つと、インストールや設定を自動で点検してくれます
  • 起動すらできないなら、ターミナルで claude doctor を実行します
  • 会社のパソコンなら、エラー文と試したことをメモしてIT担当に相談しましょう

よくある質問

Q1. PowerShellとコマンドプロンプトの見分け方は? A. 画面の行の先頭に PS と付いていればPowerShellです。付いていなければコマンドプロンプトです。スタートメニューで「PowerShell」と検索して開くのが確実です。

Q2. Gitは必要ですか?(Windows) A. 公式によると、Git for Windowsは任意です。入っていなければ、Claude CodeはPowerShellを使って動きます。

Q3. パソコンの条件は? A. MacはmacOS 13.0以上、Windowsは64ビット版が必要です。詳しくは「動作環境・必要スペック」をどうぞ。

まとめ

  • まずOSとターミナルに合った公式コマンドを使っているか確認
  • command not found はPATHの問題
  • HTMLや403が返ってきたら、時間をおくか、Homebrew・WinGetで入れる
  • 迷ったらデスクトップアプリ版がいちばん確実

関連記事

この記事をシェア

Related Articles

同じカテゴリの記事

Claude Codeの「court」エラーとは?謎の単語が出て作業が止まる現象の原因と対策トラブル解決

Claude Codeの「court」エラーとは?謎の単語が出て作業が止まる現象の原因と対策

Claude Codeで「court」という謎の単語と共にXMLのようなコードが表示され、ツールが実行されず作業が止まる——公式リポジトリで複数報告されている既知のバグです。発生の仕組み、起きやすい条件、今すぐできる4つの対処法を、実際に遭遇した運営者が解説します。

2026-08-11約11分
ClaudeCodeの認証エラーを解決する方法【ログインできない時の完全対処】トラブル解決

ClaudeCodeの認証エラーを解決する方法【ログインできない時の完全対処】

ClaudeCodeで「Authentication failed」「Invalid API key」「Unauthorized」などのログインエラーが出たときの解決手順を、非エンジニアにもわかるように完全解説。再ログイン、APIキー再発行、キャッシュクリアまで網羅した決定版ガイドです。

2026-05-12約24分
「command not found: claude」「'claude' is not recognized」の直し方【Mac・Windows・Linux】トラブル解決

「command not found: claude」「'claude' is not recognized」の直し方【Mac・Windows・Linux】

Claude Codeを入れたのに「command not found: claude」「'claude' is not recognized as an internal or external command」と出る原因は、ほとんどがPATH(コマンドの置き場所の登録)です。公式トラブルシューティングに沿って、Mac・Windows・Linux別に確認コマンドと直し方を初心者向けに解説します。

2026-05-12約11分
Claude Codeの「Context limit reached」「Prompt is too long」の直し方【コンテキスト・トークン上限】トラブル解決

Claude Codeの「Context limit reached」「Prompt is too long」の直し方【コンテキスト・トークン上限】

Claude Codeで「Context limit reached · /compact or /clear to continue」「Prompt is too long」と出たときの意味と直し方を、公式のエラー解説に沿って初心者向けに解説。/compactと/clearの使い分け、/contextで中身を確認する方法、自動圧縮、プランの利用上限との違いまで整理します。

2026-05-12約10分