「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つです。
Claude Codeのシステム要件
見落としやすいのはアカウントです。claude.aiの無料プランにはClaude Codeが含まれていないので、インストールまで進んでもログインの後で使えません。プランの料金と日本円での見え方は、別の記事で実際の請求をもとに書いています。
もう1つ、ネット接続が必須です。インストーラは downloads.claude.ai からファイルを取ってくるので、会社のネットワークではここが通るかどうかで結果が変わります(後半の「できないとき」で扱います)。
入れ方は4種類、迷ったらネイティブ版
Claude Codeの入れ方は、ネイティブのインストーラ・Homebrew・WinGet・npmの4種類が中心です。Linuxならapt・dnf・apkも使えます。違いが一番出るのは「自動で更新されるかどうか」です。
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のグローバルにも入っていませんでした。
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つあり、名前で更新の早さが変わります。
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で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を起動してブラウザでログインする
最初の起動からログイン完了までは、こう進みます。
- 作業したいフォルダに移動して
claudeを実行する - ブラウザが開くので、claude.aiのアカウント(またはConsoleのアカウント)でログインする
- ターミナルに
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のチャット・デスクトップアプリは同じアカウントで使います。どれで何ができるかの違いは、別の記事にまとめました。
ANTHROPIC_API_KEYがあるとAPIの従量課金が優先される
ANTHROPIC_API_KEY という環境変数が入っていると、Claude Codeは起動時に「このキーを使うか」を聞き、使うと答えるとサブスクのログインより優先して使います。
認証が複数あるときに使われる順番
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での使い方は別の記事で書いています。
Claude Codeをインストールできないときの対処法
インストールできないときは、まず表示されたエラーの文を見て、次の表のどれに当たるかを探します。多いのは、PATHが通っていない・ダウンロードが通らない・入れ方が2つ混ざっている、の3つです。
エラーの文は英語ですが、表の左の列の言葉がそのまま出るので、Ctrl+Fで探せます。それでも分からないときは、ネットワークを確かめる1行を流すと、原因が「自分のPC」か「途中の経路」かが切り分けられます。
インストールでよく出るエラーと対処
ネットワークの切り分けは、次の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が使えません。そうでなければ、一時的な障害か、途中のネットワークで止められています。
対処の順番はこうです。
- 数分おいて、同じコマンドをもう一度流す
- 前の節の
curl -sIでdownloads.claude.aiに届くかを確かめる - それでもだめなら、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の小さなサーバーではメモリ不足が出ます。どれも手順を少し変えれば通ります。
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! という表示になります。
入れ方ごとの更新コマンドをまとめます。
入れ方ごとのアップデートのコマンド
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 を使うなら、この記事の手順で別にインストールします。
入れ方・自動更新・チャンネルが一目で分かります。「disabled」や見覚えのない入れ方が出たら、この記事のできないときの節に戻ってください。
続きを追う:X(@Tom_Java_Tech) / RSS
途中経過は、また書きます。

