本文へスキップ

本ページはプロモーションが含まれています

AI

Claude Codeインストール|Windows・Macとできない時

CATEGORY
DRAWN BY
TOM
DATE
REV.
READ
約29分
SHEETS
7枚
Claude Codeインストール(Windows・Mac・できない時)

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

「zsh: command not found: claude」。

公式のコマンドを1行貼っただけなのに、ターミナルがそう返してくる。Claude Codeのインストールでつまずく人の多くは、この最初の確認で止まります。

答えを先に書くと、Macは curl -fsSL https://claude.ai/install.sh | bash、WindowsはPowerShellで irm https://claude.ai/install.ps1 | iex の1行で入ります。Node.jsは要りません。

私はClaude Codeを仕事でも家でも毎日使っていて、手元のMacに入っているのはネイティブ版の2.1.310です。その中身を claude doctor で開きながら、入れ方の選び方、入らないときの直し方、更新とアンインストールまでを1本にまとめました。

この記事でわかること

  • Mac・Windows・WSLそれぞれのインストールコマンドと、4種類ある入れ方の違い
  • claude --version と claude doctor で「ちゃんと入ったか」を確かめる方法
  • command not found・403・証明書エラーなど、入らないときの原因と直し方
  • 自動更新・手動更新・更新チャンネル(latest と stable)と、アンインストールの手順

PARTS LIST /目次

Claude Codeのインストールは1行のコマンドで終わる

Claude Codeのインストールは、公式のインストーラを1行実行して、新しいターミナルで claude が動くかを確かめるだけです。

Claude Codeとは、Anthropicが作っているAIのコーディングツールです。ターミナルの中で会話しながら、ファイルを読み、コードを書き換え、コマンドを実行します。インストールとは、claude という実行ファイルを自分のPCに置き、どのフォルダからでも呼べるようにPATHを通す作業のことです。

手順そのものは短いのに、ネットで調べると「Node.jsを入れてnpmで」という古い手順も並んでいて、ここで迷う人が出ます。今の推奨はネイティブのインストーラで、npmは選択肢の1つに下がりました。入れ方を混ぜると claude が2つ入って古いほうが動く、という面倒なつまずきにつながるので、先に条件と入れ方の違いを押さえておきます。

使い方の全体(基本操作・VS Code・CLAUDE.md・サブエージェント)は、使い方まとめの記事にまとめています。この記事は「入れるまで」と「入らないとき」に絞りました。

あわせて読む

インストール前に確かめる3つの条件

入れる前に見ておくのは、OSの版、メモリ、アカウントの3つです。

項目条件
MacmacOS 13.0以上
WindowsWindows 10 1809以上、またはWindows Server 2019以上
LinuxUbuntu 20.04以上・Debian 10以上・Alpine Linux 3.19以上
ハードメモリ4GB以上、x64かARM64のCPU
シェルBash・Zsh・PowerShell・CMDのどれか
アカウントPro・Max・Ultra・Team・EnterpriseのいずれかのClaudeプラン、またはClaude Console

Claude Codeのシステム要件

見落としやすいのはアカウントです。claude.aiの無料プランにはClaude Codeが含まれていないので、インストールまで進んでもログインの後で使えません。プランの料金と日本円での見え方は、別の記事で実際の請求をもとに書いています。

料金を確かめる

もう1つ、ネット接続が必須です。インストーラは downloads.claude.ai からファイルを取ってくるので、会社のネットワークではここが通るかどうかで結果が変わります(後半の「できないとき」で扱います)。

入れ方は4種類、迷ったらネイティブ版

Claude Codeの入れ方は、ネイティブのインストーラ・Homebrew・WinGet・npmの4種類が中心です。Linuxならapt・dnf・apkも使えます。違いが一番出るのは「自動で更新されるかどうか」です。

入れ方使えるOS入れるコマンド自動更新
ネイティブ(推奨)Mac・Linux・WSL・Windowscurl または irm の1行◎ バックグラウンドで自動
HomebrewMacbrew install --cask claude-code△ 手動(brew upgrade)
WinGetWindowswinget install Anthropic.ClaudeCode△ 手動(winget upgrade)
npmMac・Linux・Windowsnpm install -g @anthropic-ai/claude-code@latest○ 自動(sudoなしで入れた場合)
apt・dnf・apkLinux署名付きリポジトリを登録× OSの更新と一緒に

Claude Codeの入れ方と更新のされ方

ネイティブ版はNode.jsを使いません。npm版も中身は同じネイティブの実行ファイルで、npmはそれを運ぶ役に回っています。npmで入れる場合でもNode.js 22以上が条件になるだけで、動くときにNode.jsは使われません。

どれを選ぶかの目安を図にしました。

flowchart TD
    A["Claude Codeを入れる"] --> B{"OSは?"}
    B -->|"Mac・Linux"| C{"Homebrewで<br>まとめて管理したい?"}
    C -->|"いいえ"| N["ネイティブ版<br>curlの1行"]
    C -->|"はい"| H["Homebrew<br>claude-code"]
    B -->|"Windows"| W{"Linuxの道具や<br>サンドボックスを使う?"}
    W -->|"使う"| L["WSL 2の中で<br>curlの1行"]
    W -->|"使わない"| P["PowerShellで<br>irmの1行"]

Homebrewを選ぶ理由は「Macのアプリを全部brewで管理している」くらいで、そうでなければネイティブ版で困りません。更新を自分で回す手間がない分、ネイティブ版のほうが放っておけます。

私のMacに入っていたのはネイティブ版だった

自分のMacにどの方法で入っているのか、改めて確かめたことがありませんでした。調べてみると、入り方は3つのコマンドで分かります。

which -a claude
ls -la ~/.local/bin/claude
claude --version

私のMac(ユーザー名は伏せています)で流した結果がこれです。

/Users/you/.local/bin/claude
/Users/you/.local/bin/claude
lrwxr-xr-x  1 you  staff  58 Oct 24 10:49 /Users/you/.local/bin/claude -> /Users/you/.local/share/claude/versions/2.1.310
2.1.310 (Claude Code)

~/.local/bin/claude が ~/.local/share/claude/versions/ の中へのシンボリックリンクになっていれば、ネイティブ版です。Homebrewで入れた claude-code は無く、npmのグローバルにも入っていませんでした。

LOG2026-11-21which -a で同じ行が2回出て一瞬あせった

which -a claude を打ったら、同じパスが2行返ってきました。2つ入っているのかと思ったら、実体は1つ。PATHに ~/.local/bin が2回入っていただけでした。

.zshrc に自分で書いた export の行が1回。.zprofile が読み込む uv のスクリプトがもう1回。どちらも ~/.local/bin を足していました。uv も同じフォルダに入るツールなので、こういう重なりは起きます。害はないのでそのままにしていますが、「2行出た=2つ入っている」とは限らない、というのは覚えておくと安心です。

本当に2つ入っているときは、2行のパスが別々の場所を指します。見分け方は「できないとき」の節で書きます。

ターミナルが苦手ならデスクトップアプリから始める

ターミナルにコマンドを打つこと自体に抵抗があるなら、Claudeのデスクトップアプリから使う道もあります。デスクトップアプリにはClaude Codeを動かす画面があり、インストールのコマンドを打たずに始められます。Mac・Windows・Linux向けに配られています。

私はメインのターミナルをWarpからGhosttyに替えています。理由の1つは、デスクトップアプリの中にターミナルが載って、ターミナル自体を開く回数が減ったことでした。外出中にスマホから家のMacのClaude Codeを触るときも、デスクトップアプリ側の機能を使っています。

スマホから操作する

ただ、ターミナルで claude を打ちたい場面(スクリプトから呼ぶ、claude -p で1回だけ実行する、など)は残ります。ターミナルでも使うなら、デスクトップアプリとは別に、この記事の手順でコマンド版をインストールしておきます。

Mac・Linuxにインストールする手順

Macへのインストールは、ターミナルでcurlの1行を実行し、新しいウィンドウで claude --version を打つまでの3ステップです。LinuxとWSLも同じ1行で入り、Linuxなら apt・dnf・apk でも入れられます。

ターミナルを触ったことがない人でも、やることはコピーと貼り付けだけです。Homebrewを普段から使っている人は、2つ目のH3のcaskの違いだけ読んでから選んでください。インストール後の確認は claude --version と claude doctor の2段階にすると、PATHと更新の設定までまとめて見えます。

ターミナルでcurlの1行を実行する

ネイティブ版の手順はこの3つです。

step
1
ターミナルを開く

Spotlight(command+スペース)で「ターミナル」と打って開きます。iTerm2やGhosttyなど、普段使っているものでかまいません。

step
2
インストールのコマンドを貼り付けて実行する

次の1行を貼り付けてEnterを押します。管理者権限(sudo)は要りません。

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

ダウンロード中は進み具合が表示されないので、止まったように見えても少し待ちます。終わると ~/.local/bin/claude に実行ファイルが置かれます。

step
3
新しいターミナルで版を確かめる

インストールしたウィンドウはPATHが古いままなので、新しいウィンドウを開いてから確かめます。

claude --version

2.1.310 (Claude Code) のように版の番号が出れば成功です。ここで command not found が出たら、PATHが通っていません(直し方は後半)。

特定の版や、少し遅れて配られる安定版を入れたいときは、コマンドの末尾に指定を足します。

# 安定版(stable)を入れる
curl -fsSL https://claude.ai/install.sh | bash -s stable

# 版を指定して入れる
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

Homebrewで入れるならcaskは2種類

HomebrewにはClaude Codeのcaskが2つあり、名前で更新の早さが変わります。

cask名追いかける版更新コマンド
claude-codestable(だいたい1週間遅れ。大きな不具合が出た版は飛ばす)brew upgrade claude-code
claude-code@latestlatest(出たらすぐ)brew upgrade claude-code@latest

Homebrewの2つのcask

brew install --cask claude-code

Homebrew版は自動で更新されません。brew upgrade を忘れると、気づかないうちに古い版のまま使い続けることになります。Homebrewは更新後も古い版をディスクに残すので、ときどき brew cleanup で片付けます。

Cask 'claude-code' is unavailable と出たときは、手元のHomebrewの一覧が古いだけです。brew update をしてから入れ直せば通ります。

Linux(Ubuntu・Fedora・Alpine)に入れる方法

Linuxでも、基本はMacと同じcurlの1行です。サーバーで複数人が使う、OSの更新と一緒にClaude Codeも上げたい、という場合は、署名付きのパッケージのリポジトリから入れる方法があります。

UbuntuとDebianなら、署名の鍵を置いて、リポジトリを登録してから apt で入れます。

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

この形は stable のチャンネルです。出たらすぐの版を追いたいなら、URLの apt/stable stable を apt/latest latest に替えます。鍵が本物かは gpg --show-keys /etc/apt/keyrings/claude-code.asc で確かめ、指紋が 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE だけなら合っています。

FedoraとRHELは /etc/yum.repos.d/claude-code.repo を作って sudo dnf install claude-code、Alpineは apk add bash claude-code で入ります。Alpineは最初から bash と curl が入っていないので、curlの1行を使うなら先に apk add bash curl が要ります。

パッケージで入れた場合、Claude Codeは自分では更新しません。sudo apt update と sudo apt upgrade claude-code のように、OSの更新の流れで上げます。

名前が似ているcaskに注意
Homebrewには claude というcaskもありますが、こちらはClaudeのデスクトップアプリです。私のMacにも入っていますが、ターミナルで使う claude コマンドとは別物です。

claude --version と claude doctor で確かめる

claude --version は「動くかどうか」、claude doctor は「どう入っていて、更新がどうなっているか」を見るコマンドです。doctorはセッションを始めずに、読み取りだけで診断を出します。

私のMacで流した結果がこれです(パスは伏せています)。

Claude Code doctor

Running: native (2.1.310)
Platform: darwin-arm64
Path: ~/.local/share/claude/versions/2.1.310
Config install method: native
Search: OK (bundled)
Auto-updates: disabled (set by env: DISABLE_AUTOUPDATER)
Auto-update channel: latest
Last update attempt: success → 2.1.281 (2026-09-24)

No installation issues found.

見るところは4行です。

  • Running: native:ネイティブ版で動いている
  • Search: OK (bundled):ファイル検索に使うripgrepが同梱で動いている
  • Auto-updates:自動更新が有効か
  • Auto-update channel:latestとstableのどちらを追っているか

Auto-updates: disabled と出ていて、一瞬「止めた覚えはないぞ」と思いました。理由はすぐ分かって、私はこのコマンドをClaudeのデスクトップアプリの中から流していて、そのシェルに DISABLE_AUTOUPDATER=1 が入っていたからです。doctorは実行した環境の変数をそのまま読むので、同じMacでも開いた場所によって表示が変わります。普段のターミナルで「disabled」と出たら、settings.jsonの env か、シェルの設定ファイルに DISABLE_AUTOUPDATER が書かれていないかを探します。

Windowsにインストールする手順

Windowsでは、PowerShellかCMDで動かす「ネイティブ」と、WSLの中で動かす方法の2つがあり、先にどちらにするかを決めます。

どちらを選んでもコマンドは1行です。違うのは、Claude Codeがコマンドを実行するときに使うシェルと、サンドボックス(コマンドの実行範囲を閉じ込める仕組み)が使えるかどうかです。Windowsのプロジェクトをそのまま触るならネイティブ、Linuxの道具で開発しているならWSL 2、と考えると決めやすくなります。

ネイティブかWSLかを先に決める

3つの選択肢の違いを表にしました。

選択肢必要なものサンドボックス向いている場面
ネイティブWindowsなし(Git for Windowsは任意)× 使えないWindowsのプロジェクトや道具を使う
WSL 2WSL 2を有効にする◎ 使えるLinuxの道具で開発する・実行範囲を閉じ込めたい
WSL 1WSL 1を有効にする× 使えないWSL 2が使えないとき

WindowsでClaude Codeを動かす3つの方法

サンドボックスを使いたいなら、WSL 2一択です。サンドボックスの設定とWindowsでの扱いは、別の記事で詳しく書いています。

サンドボックスの設定

PowerShell・CMD・WinGetのインストールコマンド

ネイティブのWindowsでは、開いているのがPowerShellかCMDかでコマンドが変わります。見分け方は、行の頭が PS C:\ ならPowerShell、C:\ だけならCMDです。管理者として実行する必要はありません。

PowerShellの場合:

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

CMDの場合:

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

WinGetで入れる場合:

winget install Anthropic.ClaudeCode

ネイティブのインストーラは %USERPROFILE%\.local\bin\claude.exe に置かれます。終わったら新しいターミナルを開いて claude --version で確かめるのは、Macと同じです。WinGet版はHomebrewと同じく自動更新されないので、winget upgrade Anthropic.ClaudeCode をときどき流します。

32ビット版のWindowsでは動きません。スタートメニューで「Windows PowerShell (x86)」を開くと Claude Code does not support 32-bit Windows と出ます。(x86) の付いていない「Windows PowerShell」を開き直してください。

Git for Windowsは必須ではなくなった

ネイティブのWindowsでも、Git for Windowsは必須ではなく、入れておくと便利なもの、という扱いです。入っていない場合、Claude Codeはコマンドの実行にPowerShellを使います。

Git for Windowsなし

コマンドはPowerShellで実行される。Bashのスクリプトを前提にした手順や、Bashが必要なツール(Monitorなど)は使えない。

Git for Windowsあり

Git Bashでコマンドが実行される。PowerShellも並んで使える。Bash前提の手順をそのまま流せる。

ネット上の記事やAIに書いてもらった手順は、Macで動かす前提のBashコマンドが多めです。そういう手順をWindowsでなぞるなら、Git for Windowsを入れておいたほうがつまずきは減ります。入れるときはセットアップの画面で「Add to PATH」を選びます。

Git Bashが入っているのに見つからないと言われたら、settings.jsonでbash.exeの場所を教えます。

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

ここで指定できるのは bash.exe などの名前のファイルだけで、git-bash.exe を指しても無視されます。

WSLに入れるときの注意

WSLに入れるときは、WSLのターミナルを開いて、Mac・Linuxと同じcurlの1行を実行します。

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

つまずきやすいのは、PowerShellやCMDから入れてしまうことです。WSLで使うなら、インストールも起動も必ずWSLのターミナルの中で行います。

npmでWSLに入れた場合は、もう1つ落とし穴があります。exec: node: not found と出るときは、WSLがWindows側のNode.jsを使っています。which node の結果が /mnt/c/ で始まっていればそれです。ネイティブのインストーラを使えばNode.jsが関係なくなるので、この問題ごと消えます。

初回ログインはサブスクとAPIキーで分かれる

インストールが終わったら、作業したいフォルダで claude を起動し、ブラウザでログインします。ログインの方法は、サブスクのプランで入るか、ConsoleのAPIで従量課金にするかで分かれます。

どちらで入ったかによって、お金の出どころが変わります。サブスクならプランの月額の中で、Consoleなら使った分だけAPIの料金がかかります。私は家ではMaxプランで使っていて、ログインはclaude.aiのアカウントです。違いを知らないまま環境変数にAPIキーを入れていると、サブスクを契約しているのに従量課金で動く、ということが起こります。

claudeを起動してブラウザでログインする

最初の起動からログイン完了までは、こう進みます。

  1. 作業したいフォルダに移動して claude を実行する
  2. ブラウザが開くので、claude.aiのアカウント(またはConsoleのアカウント)でログインする
  3. ターミナルに Login successful と出たらEnterを押す

ブラウザが勝手に開かないときは、ターミナルで c を押すとログイン用のURLがコピーされるので、ブラウザに貼ります。ブラウザ側にコードが表示されたら、ターミナルの Paste code here のところに貼り付けます。コードは途中の # まで含めて丸ごとコピーしないと That doesn't look like the full code と言われます。

WSL 2やSSHの先ではブラウザがうまく開かないことがあります。WSL 2なら、Windows側のブラウザの場所を BROWSER に入れておくと、次から開いてくれます。

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

ログインし直したいときは、Claude Codeの中で /logout を打ってから起動し直します。いまどの方法でログインしているかは /status で確かめられます。

Claude Codeと、Claudeのチャット・デスクトップアプリは同じアカウントで使います。どれで何ができるかの違いは、別の記事にまとめました。

Claude CodeとClaudeの違い

ANTHROPIC_API_KEYがあるとAPIの従量課金が優先される

ANTHROPIC_API_KEY という環境変数が入っていると、Claude Codeは起動時に「このキーを使うか」を聞き、使うと答えるとサブスクのログインより優先して使います。

順位認証のもと主な使い道
1Amazon Bedrockなどクラウドの認証会社でクラウド経由で使う
2ANTHROPIC_AUTH_TOKENゲートウェイやプロキシを通す
3ANTHROPIC_API_KEYConsoleのAPIキーで従量課金
4apiKeyHelper(キーを返すスクリプト)期限の短いキーを都度取る
5CLAUDE_CODE_OAUTH_TOKENCIなどブラウザが無い場所
6Anthropicのプロファイルantコマンドで作ったログイン
7/login のサブスクのログインPro・Maxなどの個人利用

認証が複数あるときに使われる順番

ハマりポイント
昔入れたAPIキーが残っていると、サブスクがあっても従量課金で動く

APIの勉強で .zshrc などに ANTHROPIC_API_KEY を書いたまま、あとからMaxやProを契約したとします。Claude Codeは、そのキーを使い続けます。キーの組織が止まっていれば認証エラーになり、生きていれば請求がConsole側に積み上がります。

サブスクで使いたいなら、unset ANTHROPIC_API_KEY で外し、設定ファイルからも消します。Claude Codeの中で /status を開くと、使っていないほうの認証に印が付くので、どちらで動いているかが分かります。

ログインが切れる・何度も聞かれるとき

一度ログインしたのに、しばらくしてまたログインを求められるのは、保存したログインの期限が切れたときです。Claude Codeの中で /login を打てば入り直せます。

ログインがいつ切れるかは、ターミナルで確かめられます。

claude auth status --text

2.1.318以降では Sign-in ends: で始まる行に、切れる日の幅が出ます。私のMacの2.1.310で流すと、出たのは Login method: Claude Max account などの行だけで、Sign-in ends: の行はありませんでした。

切れる日が近づくと、起動時に Your login expires in 3 days · run /login to renew のような警告も出ます。使っているだけでは期限は延びないので、警告が出たら早めに /login で入り直します。

それでも何度も切れるときに見るところは2つです。

  • PCの時計:ログインの確かめに時刻を使うので、時計がずれていると通らなくなる
  • Macのキーチェーン:SSHの先などでキーチェーン(パスワードの金庫)に書き込めないと、ログインが ~/.claude/.credentials.json に保存される。claude doctor に macOS Keychain is not writable と出たら、security unlock-keychain ~/Library/Keychains/login.keychain-db で開いてからログインし直す

CIやスクリプトのようにブラウザを開けない場所で使うなら、claude setup-token で1年有効のトークンを作り、CLAUDE_CODE_OAUTH_TOKEN に入れる方法があります。GitHub Actionsでの使い方は別の記事で書いています。

GitHub Actionsで使う

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

インストールできないときは、まず表示されたエラーの文を見て、次の表のどれに当たるかを探します。多いのは、PATHが通っていない・ダウンロードが通らない・入れ方が2つ混ざっている、の3つです。

エラーの文は英語ですが、表の左の列の言葉がそのまま出るので、Ctrl+Fで探せます。それでも分からないときは、ネットワークを確かめる1行を流すと、原因が「自分のPC」か「途中の経路」かが切り分けられます。

出たエラー原因対処
command not found: claudePATHが通っていない~/.local/bin をPATHに足す
'claude' is not recognizedPATHが通っていない(Windows)ユーザーのPATHに追加して開き直す
syntax error near unexpected tokenスクリプトの代わりにWebページが返った時間をおいて再実行、Homebrew・WinGetで入れる
curl: (22) ... error: 403地域の制限か、会社のプロキシ接続を確かめる、プロキシを設定する
unable to get local issuer certificate会社のプロキシが証明書を差し替えている会社のCA証明書を指定する
'irm' is not recognizedCMDでPowerShellのコマンドを打ったPowerShellを開くか、CMD用のコマンドにする
The token '&&' is not a valid statement separatorPowerShellでCMDのコマンドを打ったPowerShell用のコマンドにする
EACCES: permission denied書き込めないフォルダに入れようとしたsudoを使わず、ネイティブ版に切り替える
Killed(Linux)メモリ不足メモリを空けるかスワップを足す

インストールでよく出るエラーと対処

ネットワークの切り分けは、次の1行です。1行目に 200 が出ればダウンロード先までは届いています。

curl -sI https://downloads.claude.ai/claude-code-releases/latest

WindowsのPowerShellでは、curl が別のコマンドの別名になっているので curl.exe -sI と書きます。

command not found はPATHが通っていない

インストールは成功しているのに command not found: claude と出るのは、~/.local/bin がPATHに入っていないからです。インストーラの出力にも Native installation exists but ~/.local/bin is not in your PATH と出ますが、PATHを書き換えるところまではしてくれません。

まず、ファイルがあるかとPATHに入っているかを確かめます。

ls -la ~/.local/bin/claude
echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

2行目が何も出さなければ、PATHに入っていません。Macの標準のZshなら、この2行で直ります。

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

LinuxのBashなら ~/.bashrc、MacでBashを使っているなら ~/.bash_profile に同じ行を足します。Windowsは、PowerShellでユーザーのPATHに追加してから、ターミナルを開き直します。

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

直したのにまだ見つからないときは、ターミナルが古いPATHのまま開いています。VS Codeの中のターミナルはVS Code本体からPATHをもらうので、VS Codeごと終了して開き直します。

syntax error や 403 はダウンロードが届いていない

bash: line 1: syntax error near unexpected token のあとに <!DOCTYPE html> が続くのは、インストールのスクリプトの代わりにWebページが返ってきた印です。PowerShellなら iex が HTMLを読もうとしてパースエラーを出し、CMDなら < was unexpected at this time. と出ます。

出力に「App unavailable in region」と書かれていれば、その国ではClaude Codeが使えません。そうでなければ、一時的な障害か、途中のネットワークで止められています。

対処の順番はこうです。

  1. 数分おいて、同じコマンドをもう一度流す
  2. 前の節の curl -sI で downloads.claude.ai に届くかを確かめる
  3. それでもだめなら、MacはHomebrew、WindowsはWinGetで入れる

HomebrewやWinGetに切り替えると、取ってくる経路が変わるので通ることがあります。そのかわり自動更新は無くなるので、更新は自分で回します。

会社のプロキシや証明書でつまずくとき

会社のネットワークでは、プロキシの指定と、プロキシの証明書の2つでつまずきます。プロキシの住所が分からなければ、社内のIT担当に聞くのが一番早い道です。

プロキシを通すときは、インストールの前に2つの変数を入れます。

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

unable to get local issuer certificate や SELF_SIGNED_CERT_IN_CHAIN が出るのは、プロキシが通信の中身を検査するために証明書を差し替えているからです。会社のルート証明書(PEMファイル)をもらって、ダウンロード用とClaude Code用の両方に教えます。

export CURL_CA_BUNDLE=/path/to/corporate-ca.pem
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
curl -fsSL https://claude.ai/install.sh | bash

NODE_EXTRA_CA_CERTS は、インストールの後もClaude CodeがAPIにつなぐときに使うので、シェルの設定ファイルに残しておきます。WindowsのPowerShellのインストーラはWindowsの証明書ストアを見るので、そちらに会社の証明書を入れてもらいます。

2つ入っていて古い版が動くとき

claude --version が思ったより古い版を返すときは、入れ方の違う claude が2つ入っていて、古いほうが先に見つかっています。npmで入れた後にネイティブ版を入れた、Homebrewとネイティブ版を両方入れた、というのがよくある形です。

Macでは、この3か所を見れば出どころが分かります。

which -a claude
ls -la ~/.claude/local/
npm -g ls @anthropic-ai/claude-code 2>/dev/null

which -a が別々の場所を2行返したら、2つ入っています(私のように同じ場所が2回なら、PATHが重なっているだけです)。~/.claude/local/ は昔のClaude Codeが作ったローカルのnpm版の場所です。

残すのはネイティブ版1つにして、ほかを消します。

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local
brew uninstall --cask claude-code

Windowsでは where.exe claude で同じ確認ができます。古いClaudeのデスクトップアプリが claude の名前を先に取ってしまい、打つとデスクトップアプリが開く、という例もあります。その場合はデスクトップアプリを新しい版に更新すると直ります。

npmやsudoで入れて権限エラーになるとき

npmで入れるときに sudo npm install -g を使うのは避けます。Claude Codeは自分を更新するときにsudoなしでnpmを動かすので、sudoで入れると自動更新が通らなくなります。

EACCES: permission denied が出たら、npmのフォルダの権限を直すより、ネイティブ版に切り替えるほうが早く片付きます。

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

切り替えた後は、前の節のとおりnpm版を消して、which -a claude が1行(または同じ場所だけ)になっているかを確かめます。npm 12を使っている場合は手順が別なので、公式のインストールのトラブル対処の「Fix an npm 12 install」を見てください。

トム
トム

Node.jsを入れてnpmで、という古い手順をなぞって、sudoまで付けてしまう。これが一番こじれるパターンです。

Windowsだけで出るエラーとLinuxのメモリ不足

Windowsでは、PowerShellの決まりやウイルス対策ソフトが原因のエラーが、Linuxの小さなサーバーではメモリ不足が出ます。どれも手順を少し変えれば通ります。

出たエラー原因対処
running scripts is disabled on this systemnpmが作る .ps1 の起動スクリプトをPowerShellが止めているPowerShellのインストーラに切り替える
The process cannot access the file前のインストールが動いている、またはウイルス対策ソフトがファイルをつかんでいるほかのPowerShellを閉じ、downloadsフォルダを消して再実行
更新の直後に 'claude' is not recognized更新中に claude.exe が消えた同じフォルダのバックアップの名前を戻す
Killed(exit code 137)Linuxのメモリ不足。インストールに空きが512MBほど要るスワップを足すか、ほかのプロセスを止める

OSごとに出やすいエラー

running scripts is disabled は、npm版だけで起きるエラーです。PowerShellのインストーラ(irm の1行)はスクリプトのファイルを置かないので、切り替えればこの問題ごと消えます。npm版を使い続けたいなら、Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser で自分のユーザーだけスクリプトを許可します。

ファイルがつかまれているときは、downloadsフォルダを消してから入れ直します。

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

更新の直後に claude が見つからなくなったときは、%USERPROFILE%\.local\bin に claude.exe.old. で始まるバックアップが残っていないかを見ます。一番新しいものの名前を claude.exe に戻せば動きます。

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

Linuxのメモリが少ないサーバー(小さなVPSなど)では、2GBのスワップを作ってから入れ直す手があります。ただし、動かすのにメモリ4GB以上という条件は変わらないので、入ったあとも重いようなら大きいサーバーに移すほうが早く片付きます。

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

アップデート・再インストール・アンインストールの方法

ネイティブ版は起動時と使っている間に新しい版を探し、裏でダウンロードして、次に起動したときに切り替わります。HomebrewやWinGet、apt・dnf・apkで入れた場合は自動では更新されないので、自分でコマンドを流します。

更新まわりで覚えておくのは、手動で今すぐ更新するコマンド、どの版を追いかけるか(更新チャンネル)、止め方の3つです。最後に、入れ直すときと完全に消すときの手順も並べます。

自動更新と claude update の違い

今すぐ新しい版にしたいときは、ターミナルでこれを打ちます。

claude update

新しい版が入ると末尾が to version <新しい版> の行が出て、すでに最新なら Claude Code is up to date (<版>) と出ます。Homebrew・WinGet・apkで入れた場合は Claude is up to date! という表示になります。

入れ方ごとの更新コマンドをまとめます。

入れ方自動更新手動で更新するコマンド
ネイティブ◎ するclaude update
Homebrew(stable)× しないbrew upgrade claude-code
Homebrew(latest)× しないbrew upgrade claude-code@latest
WinGet× しないwinget upgrade Anthropic.ClaudeCode
npm○ するnpm install -g @anthropic-ai/claude-code@latest
apt× しないsudo apt update のあと sudo apt upgrade claude-code

入れ方ごとのアップデートのコマンド

npm版を npm update -g で更新しようとすると、最初に入れたときの版の範囲に縛られて、最新まで上がらないことがあります。npm版は @latest を付けて入れ直す形で更新します。

HomebrewとWinGetでも、CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE を 1 にすると、Claude Codeが更新のコマンドを裏で代わりに流してくれます。

セッションの下に赤く Auto-update failed · Run claude doctor と出たときは、そのまま作業を続けてかまいません。原因を知りたければ、ターミナルで claude update を流すと、失敗の理由がエラーの文で出ます。

更新チャンネルは latest と stable の2つ

Claude Codeの更新には、出たらすぐ配る latest と、だいたい1週間遅れで大きな不具合の出た版を飛ばす stable の2つのチャンネルがあります。何も設定しなければ latest です。

切り替えはClaude Codeの中の /config の「Auto-update channel」か、~/.claude/settings.json で行います。

{
  "autoUpdatesChannel": "stable"
}

latestからstableに切り替えると、ネイティブ版は「stableの版」まで下がることがあります。今の版より下げたくないなら、minimumVersion に今の版を一緒に書きます。

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.310"
}

私の手元の設定は、claude doctor で見るとlatestになっていました。新しい機能を早く使いたいならlatest、不具合を避けたいならstableです。新しいモデルが出たときに、stableの版ではまだそのモデルを使えないこともあります。

自動更新を止めたいときは、settings.jsonの env に DISABLE_AUTOUPDATER を "1" で入れます。止まるのは裏での確認だけで、claude update は使えます。手動の更新まで含めて全部止めたいときは DISABLE_UPDATES を使います。

再インストールとアンインストールの手順

入れ直すだけなら、アンインストールは要りません。ネイティブ版なら、インストールのコマンドをもう一度流すか、claude install --force で入れ直せます。claude install stable のように版やチャンネルも指定できます。

完全に消すときは、入れ方ごとに次のコマンドを使います。

# ネイティブ版(Mac・Linux・WSL)
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

# Homebrew
brew uninstall --cask claude-code

# npm
npm uninstall -g @anthropic-ai/claude-code

Windowsのネイティブ版とWinGet版はこうです。

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

winget uninstall Anthropic.ClaudeCode

ここまでで消えるのは本体だけで、設定・会話の履歴・MCPの設定は残ります。それも消すなら ~/.claude と ~/.claude.json を削除し、プロジェクトの中の .claude と .mcp.json も消します。

設定のフォルダを消す前にバックアップを
~/.claude には、自分で書いたCLAUDE.md・スキル・settings.jsonが入っています。私の場合は ~/.claude/CLAUDE.md や自作のスキルが入っているので、消したら一から作り直しです。VS Codeの拡張やデスクトップアプリが残っていると、次に起動したときに ~/.claude はまた作られます。

入れ直した後に最初に整えておきたい設定(承認の手間を減らす設定など)は、おすすめ設定の記事にまとめています。

おすすめ設定

よくある質問

Claude Codeのインストールについて、よく聞かれる質問をまとめました。Node.jsの要否、Windowsの権限、インストール先、更新の確かめ方など、手順の途中で引っかかりやすい点です。くわしい手順は各見出しの本文もあわせて見てください。

Q1. Claude Codeは無料プランで使えますか?

A1. 使えません。claude.aiの無料プランにはClaude Codeが含まれていません。Pro・Max・Ultra・Team・EnterpriseのプランかClaude Consoleのアカウントが必要です。インストール自体は無料でできますが、ログインした後に使えません。

Q2. Claude CodeのインストールにNode.jsは必要ですか?

A2. ネイティブのインストーラ・Homebrew・WinGetで入れるなら不要です。npmで入れる場合だけNode.js 22以上が条件になりますが、npm版も中身はネイティブの実行ファイルなので、動くときにNode.jsは使いません。

Q3. Windowsでのインストールに管理者権限は要りますか?

A3. 要りません。PowerShellかCMDを普通に開いてインストールのコマンドを流せば、ユーザーのフォルダ(%USERPROFILE%\.local\bin)に入ります。

Q4. Git for Windowsは入れたほうがいいですか?

A4. 必須ではありませんが、Bashのコマンドを前提にした手順を使うなら入れておくと楽です。入っていなければPowerShellでコマンドが実行され、入っていればGit Bashが使われます。WSLに入れる場合は要りません。

Q5. Claude Codeのインストール先はどこですか?

A5. ネイティブ版は、Mac・Linuxでは ~/.local/bin/claude、Windowsでは %USERPROFILE%\.local\bin\claude.exe です。Macの ~/.local/bin/claude は ~/.local/share/claude/versions/ の中の版へのシンボリックリンクになっています。

Q6. アップデートされているかはどう確かめますか?

A6. ターミナルで claude doctor を流すと、自動更新が有効か、追いかけているチャンネル、最後に更新を試した結果が出ます。今すぐ更新したいときは claude update を使います。

Q7. VS Codeの拡張機能を入れればターミナルでも使えますか?

A7. 使えません。VS Codeの拡張機能は自分専用のClaude Codeを中に持っていて、PATHには足しません。ターミナルで claude を使うなら、この記事の手順で別にインストールします。

NEXT STEP
インストールが終わったら、新しいターミナルで claude doctor を1回流してみる。

入れ方・自動更新・チャンネルが一目で分かります。「disabled」や見覚えのない入れ方が出たら、この記事のできないときの節に戻ってください。

途中経過は、また書きます。

NEXT READ本棚から1本

AIで開発を組み直すなら、まずこの5冊から

入門・実践・設計まで、Claude Codeの本をレベル別に5冊選んで比べました。

→ おすすめ5冊を見る

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

AI

TOC