Claude Codeのインストール方法 — Mac・Windows・Linux別の手順と更新・アンインストール
Claude Codeはターミナルで1行のコマンドを実行すればインストールでき、Node.jsは要りません。使うにはPro(月額20ドル)以上のプランかConsoleアカウントが必要で、ネイティブ版なら更新も自動です。
Claude Codeのインストールは、ターミナルでコマンドを1行実行するだけです。macOS・Linux・WSLは curl、WindowsはPowerShellの irm で入り、Node.jsの準備は要りません。使うにはPro(月額20ドル)以上のプランか、Claude Consoleのアカウントが必要です。
Claude Codeのインストールは1行のコマンドで終わる
Claude Codeは、Anthropicが提供するエージェント型のコーディングツールです。ターミナルの中でコードを読み、ファイルを書き換え、テストやGitのコマンドまで自然言語の指示で実行します。何ができるかの全体像はClaude Codeの全体像と使い方にあります。ここでは、手元のマシンで claude が起動し、ログインが終わるまでを扱います。
推奨されているのはネイティブインストーラーです。自己完結型のバイナリを置くだけなので、Node.jsもnpmも使いません。OSに合わせて次のどれか1つを実行します。
curl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdダウンロード中は進捗が表示されません。止まって見えても、プロンプトが戻るまで待ちます。Windowsでは行頭が PS C:\ ならPowerShell、C:\ だけならCMDです。HomebrewやWinGet、apt、npmでも入れられますが、どれも入るバイナリは同じで、違うのは更新の届き方です(後述の「Claude Codeのアップデート」の表)。
インストールからclaudeの起動までの3ステップ
コマンドを実行した後は、確認とログインで終わりです。
Claude Codeを使い始めるまで
- 1
インストールコマンドを実行する
上の3つからOSとシェルに合うものを1つ実行します。管理者権限は要りません。
- 2
新しいターミナルで claude --version を実行する
2.1.287 (Claude Code)のようにバージョン番号が出れば成功です。command not foundなら、インストール先がまだPATHに入っていません。 - 3
プロジェクトのフォルダーで claude を起動してログインする
初回はブラウザーが開くので、Claudeのアカウントで承認します。認証情報は保存され、次回からはログイン不要です。
インストールに使ったウィンドウは古いPATHのままなので、確認は新しいウィンドウで行います。起動はプロジェクトのフォルダーに移動してからです。
cd /path/to/your/project
claude起動するとプロンプトの上にバージョン・モデル・作業フォルダーが出ます。最初は「このプロジェクトは何をするもの?」のように聞くと、Claude Codeがファイルを読んで要約します。具体的な題材が欲しければ、Claude CodeでHugoサイトを作る手順のように小さく作って試せます。
Claude Codeのインストールに必要なものと料金
インストール自体は無料ですが、起動後のログインには有料プランかAPIのアカウントが要ります。無料のClaude.aiプランにはClaude Codeが含まれていません。
Claude Codeを使うための数字
Pro
月額$20
年払いなら月$17($200一括)
Max
月額$100から
Proの5倍か20倍の使用量
必要なRAM
4GB以上
x64かARM64
Node.js
不要
npmで入れるときだけ22以上
ログインに使えるアカウントは4種類あります。
- Claudeのサブスクリプション: Pro・Max・Team・Enterprise。Teamのシートにも含まれます
- Claude Console: 前払いクレジットのAPI従量課金。初回ログインで「Claude Code」ワークスペースが自動で作られます
- クラウド事業者: Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundry
- Claude apps gateway: 組織が自前で運用するゲートウェイ。
/loginで社内SSOのサインイン画面が開きます
合うプランは、使用量の上限と従量課金の分かれ目で決まります。Claude Codeの料金とプラン選びの判断ガイドの軸に当てはめると、選びやすくなります。
動作環境は次のとおりです。
| 項目 | 要件 |
|---|---|
| OS | 要件macOS 13.0以上 / Windows 10 1809以上・Windows Server 2019以上 / Ubuntu 20.04以上・Debian 10以上・Alpine Linux 3.19以上 |
| ハードウェア | 要件4GB以上のRAM、x64またはARM64のプロセッサ |
| シェル | 要件Bash / Zsh / PowerShell / CMD |
| ネットワーク | 要件インターネット接続が必須 |
| 利用地域 | 要件Anthropicの対応国のみ |
対応国の外からインストールすると、App unavailable in region が出て止まります。32ビット版のWindowsも対象外です。
Claude Codeのインストールが要らない使い方 — デスクトップアプリ・VS Code・Web
ターミナルを使わずにClaude Codeを動かす経路もあります。CLIのインストールと何が違うかは、claude コマンドが手に入るかどうかです。
CLIを入れずにClaude Codeを使う3つの入口
デスクトップアプリ
Claudeのデスクトップアプリの「Code」タブにClaude Codeが入っています。Node.jsもCLIも不要です。macOSはIntelとApple Silicon共通のビルド、Windowsはx64とARM64、Linuxはベータ版をaptか.debで入れます。使うにはPro以上のプランが要ります。
VS Code拡張機能
拡張機能はチャット画面用にCLIのコピーを内蔵しています。ただしPATHには追加しないので、統合ターミナルで
claudeを打つには別途インストールが要ります。Web版
ブラウザーで
claude.ai/codeを開くと、クラウド上の環境でセッションが動きます。手元のマシンには何も入れません。
デスクトップアプリはClaude Desktopのインストールと使い方の手順で入ります。エディター中心ならVS Code拡張機能の使い方から、スマホやブラウザーからならClaude Code Web版の始め方から始められます。
Claude Codeのインストール方法の選び方 — ネイティブ・Homebrew・WinGet・apt・npm
迷ったらネイティブインストーラーです。ほかの経路を選ぶ理由は、ツールの管理をパッケージマネージャーにまとめたいときに限られます。
| 方法 | 対象 | 向いているケース |
|---|---|---|
| ネイティブインストーラー | 対象macOS / Linux / WSL / Windows | 向いているケースほとんどの利用者 |
| Homebrew | 対象macOS | 向いているケースbrewでツールを一元管理したい |
| WinGet | 対象Windows | 向いているケースwingetで管理を統一したい |
| apt / dnf / apk | 対象Debian系 / Fedora・RHEL / Alpine | 向いているケースサーバー群を構成管理したい |
| npm | 対象Node.js 22以上の環境 | 向いているケース既存のnpm運用やCIに載せたい |
npm版の中身も、ネイティブインストーラーと同じバイナリです。この点は誤解されやすいところです。
Node.jsが無いと入らない?
- 後輩
Claude Codeってnpmのパッケージですよね。Node.jsを先に入れないといけないんですか?
- 先輩
推奨のネイティブインストーラーならNode.jsは要らないよ。自己完結型のバイナリを置くだけだから。
- 後輩
じゃあnpmで入れた場合は、Node.jsの上で動くんですか?
- 先輩
npm版も中身は同じネイティブバイナリで、起動した
claudeはNode.jsを使わない。Node.jsが要るのはnpmコマンドを動かす間だけだね。
npmパッケージが要求するNode.jsは、v2.1.198から22以上に上がりました(v2.1.197までは18以上)。Claude CodeのNode.js要件では、Node.jsのバージョンと警告の関係を追えます。
macOSでClaude Codeをインストールする
macOSは curl のネイティブインストールが最短です。Homebrewで管理したい場合はcaskでも入ります。ネイティブとの違いはClaude CodeのMacインストールで追えます。
brew install --cask claude-codeHomebrewのcaskは2つあり、追うバージョンが違います。
Homebrewの2つのcask
claude-code
およそ1週間遅れの安定版を追い、大きな不具合が出たリリースを飛ばします。更新は brew upgrade claude-code です。
claude-code@latest
リリース直後のバージョンを受け取ります。更新は brew upgrade claude-code@latest です。
どちらを入れたか分からないときは brew list --cask | grep claude-code で確かめます。入れていない側をupgradeすると Cask 'claude-code@latest' is not installed が出ます。Cask 'claude-code' is unavailable と出るのは手元のcask一覧が古いためで、brew update の後にもう一度インストールします。Homebrewは古いバージョンをディスクに残すので、ときどき brew cleanup で片付けます。
バイナリは「Anthropic PBC」名義で署名され、Appleの公証も済んでいます。codesign --verify --verbose ./claude で署名を確かめられます。
WindowsでClaude Codeをインストールする
Windowsでは、ネイティブで動かすかWSLの中で動かすかを先に決めます。サンドボックス実行が使えるのはWSL 2だけで、ネイティブとWSL 1は対象外です。判断の材料とWindows固有のエラーはClaude CodeのWindowsインストールにまとめてあります。
Windowsでの動かし方
ネイティブWindows
PowerShellかCMDでインストールコマンドを実行します。Git for Windowsは任意で、入れるとBashツールが使えます。
WSL 2
WSLのターミナルの中で、Linux用の curl コマンドを実行します。サンドボックス実行に対応し、Git for Windowsは要りません。
ネイティブの場合、PowerShellでもCMDでも結果は同じで、違うのは打つコマンドだけです。シェルを取り違えると、次のようなエラーが出ます。
シェルを取り違えたときのエラー
'irm' is not recognized
CMDでPowerShell用のコマンドを打っています。PowerShellを開き直すか、CMD用のコマンドに替えます。
The token '&&' is not a valid statement separator
PowerShellでCMD用のコマンドを打っています。PowerShell用の
irmのコマンドに替えます。parameter name 'fsSL'
PowerShellでmacOS・Linux用の
curl -fsSLを打っています。PowerShellのcurlは別のコマンドの別名で、このフラグを受け付けません。スクリプトの本文が表示されるだけ
irm https://claude.ai/install.ps1だけを実行し、| iexを付け忘れています。コマンドを最後まで貼り直します。
WinGetで管理する場合は次の1行です。
winget install Anthropic.ClaudeCodeGit for Windowsを入れると、Claude CodeはGit BashでBashツールを動かします。入れなければシェルの実行はPowerShellツールが担います。Git for Windowsを入れたのにGit Bashが見つからない場合は、settings.jsonで bash.exe の場所を指定します。
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}この変数が受け付けるのは bash.exe・sh.exe・bash・sh という名前のファイルだけです。git-bash.exe を指定すると無視され、自動検出に戻ります。
WSLの場合は、ディストリビューション(Ubuntuなど)のターミナルを開き、Linux用の curl コマンドを実行します。PowerShellやCMDから入れたものはWSLの中では使えません。
落とし穴
スタートメニューのPowerShell (x86)から入れると止まる
スタートメニューには Windows PowerShell と Windows PowerShell (x86) の2つがあります。x86の方は32ビットで動くため、64ビットのWindowsでも Claude Code does not support 32-bit Windows が出ます。同じウィンドウで [Environment]::Is64BitOperatingSystem が True を返すなら、x86の付かない方を開き直せば入ります。
LinuxでClaude Codeをインストールする
Ubuntu・Debian・Alpineなどでも、ネイティブインストールの curl コマンドがそのまま使えます。サーバーを構成管理しているなら、署名付きのapt・dnf・apkリポジトリから入れる方法もあります。リポジトリにはstableとlatestの2チャネルがあり、下の手順はstableを登録します。
Debian・Ubuntuのaptでは、まず署名鍵を取得してからリポジトリを登録します。新しく作ったばかりの環境では curl と gpg が無いことがあるので、sudo apt install curl gnupg を先に済ませます。
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鍵のダウンロードに失敗すると、apt update が NO_PUBKEY BAA929FF1A7ECACE で止まります。鍵の確認は gpg --show-keys /etc/apt/keyrings/claude-code.asc です。表示される指紋が 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE なら、鍵は正しく取れています。
Fedora・RHELのdnfでは、リポジトリ定義を書いてからインストールします。
sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-codeAlpineのapkは、公開鍵を置いてリポジトリを1行足し、apk add claude-code で入ります。latestチャネルに替えるときは、aptはURLとスイート名の両方、dnfは baseurl、apkはリポジトリの行を差し替えます。手順の全体はClaude Codeのapt・dnf・apkインストールで追えます。Ubuntuで bubblewrap の依存エラーに当たったら、Claude CodeのUbuntuインストールの手順で解決します。
Alpineなどmusl系のディストリビューションでネイティブインストーラーを使うときは、下準備が要ります。素のAlpineには bash も curl も入っていないため、インストールコマンド自体が not found で失敗します。
apk add bash curl libgcc libstdc++ ripgrepripgrep はcommunityリポジトリにあるので、見つからなければ /etc/apk/repositories にcommunityを足して apk update します。そのうえでsettings.jsonの env に "USE_BUILTIN_RIPGREP": "0" を書いてから起動します。
npmでClaude Codeをインストールする
既存のNode.js環境やCIに載せたいときは、npmのグローバルインストールが使えます。Node.jsが21以下でも EBADENGINE の警告が出るだけで、インストールは完了し、claude も動きます。
npm install -g @anthropic-ai/claude-codeバイナリは、@anthropic-ai/claude-code-darwin-arm64 のようなプラットフォーム別の任意依存として届きます。postinstallの処理が、それを claude の位置に配置します。対応するプラットフォームは次の8つです。
darwin-arm64 / darwin-x64 / linux-x64 / linux-arm64 / linux-x64-musl / linux-arm64-musl / win32-x64 / win32-arm64
任意依存を省く設定(--omit=optional や .npmrc の optional=false)があると、バイナリが届きません。この場合、起動時に claude native binary not installed が出ます。npm・pnpm・yarnのどれで入れたかによって直し方が変わるので、「native binary not installed」の直し方で自分の環境の手順を選びます。
npm版で踏みやすい3点
sudo npm install -gは使いません。権限の問題とセキュリティ上のリスクにつながります- 更新は
npm install -g @anthropic-ai/claude-code@latestです。npm update -gは最初のsemver範囲に縛られ、最新に上がらないことがあります - WindowsのPowerShellで
running scripts is disabled on this systemが出たら、実行ポリシーがnpmの.ps1ランチャーを止めています。npm.cmd・claude.cmdで呼ぶか、PowerShellのインストーラーに切り替えます
Claude Codeのインストールを確かめる — claude doctorとログイン
claude --version でバージョンが出たら、claude doctor で導入状態を見ます。セッションを起動せずに、インストールの健全性や設定ファイルの検証エラー、修正案付きの警告を読み取り専用で出すコマンドです。v2.1.287のmacOS(ネイティブインストール)では次の出力でした。ホームのパスは ~ に置き換え、診断の一部は省いています。
$ claude --version
2.1.287 (Claude Code)
$ claude doctor
Claude Code doctor
Running: native (2.1.287)
Platform: darwin-arm64
Path: ~/.local/share/claude/versions/2.1.287
Config install method: native
Search: OK (bundled)
Auto-updates: enabled
Auto-update channel: latest
Last update attempt: success → 2.1.287 (2026-10-02)
No installation issues found.
For a full setup checkup that can also fix issues, run /doctor in a Claude Code session.見るのは3行です。Running と Config install method が導入形態で、ここではどちらも native です。Last update attempt には直近の更新結果が出ます。修復まで行う診断はセッション内の /doctor で、/doctorとclaude doctorの違いを読むと使い分けが分かります。
ログインの方式は、ブラウザーを使えるかどうかで分かれます。
ログインの方式は環境で変わる
手元のマシン・SSH先
claude を起動するとブラウザーで認証します。ANTHROPIC_API_KEY が設定されていると、そのキーを使うかの確認が出ます。承認すればログイン画面は出ません。
CI・スクリプト
claude setup-token で1年有効のOAuthトークンを発行し、CLAUDE_CODE_OAUTH_TOKEN に設定します。トークンは保存されず画面に出るだけです。発行にはPro以上のプランが要り、--bare 付きの実行ではこの変数は読まれません。
アカウントの作り方やログイン方式の全体像はClaudeログインガイドに任せ、切り替えるときは起動中のセッションで /login を打ちます。macOSでは認証情報をキーチェーンに保存し、キーチェーンがロックされていると平文の ~/.claude/.credentials.json に退避します。
Claude Codeのアップデート — 自動更新とclaude update
ネイティブ版は、起動時と実行中に更新を確かめ、裏でダウンロードして次の起動から新しいバージョンに切り替わります。普段は何もしなくても最新に保たれます。すぐ当てたいときは claude update を実行します(claude upgrade も同じ動作です)。
claude update更新が入ると Successfully updated from <old version> to version <new version> と返ります。最新なら Claude Code is up to date (<version>) です。Homebrew・WinGet・apkで入れた場合は Claude is up to date! と表示されます。
自動更新が届くかどうかは、インストールした経路で決まります。
| 経路 | 自動更新 | 手で更新するコマンド |
|---|---|---|
| ネイティブ | 自動更新あり | 手で更新するコマンドclaude update |
| Homebrew | 自動更新なし(代行の設定あり) | 手で更新するコマンドbrew upgrade claude-code |
| WinGet | 自動更新なし(代行の設定あり) | 手で更新するコマンドwinget upgrade Anthropic.ClaudeCode |
| apt / dnf / apk | 自動更新なし | 手で更新するコマンドsudo apt update && sudo apt upgrade claude-code など |
| npm | 自動更新あり(グローバル領域に書き込めるとき) | 手で更新するコマンドnpm install -g @anthropic-ai/claude-code@latest |
HomebrewとWinGetでは、v2.1.129から環境変数 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE を 1 にできます。すると新しいバージョンが出たときにClaude Codeが裏でupgradeを実行し、成功すると再起動を促します。対象はClaude Codeのパッケージだけで、ほかのソフトには触れません。WinGetは実行中の claude.exe がロックされて失敗することがあり、そのときは手で打つコマンドが表示されます。apt・dnf・apkは管理者権限が要るため、代行の対象になりません。
Homebrewで更新を代行させる設定
既定のまま
新しいバージョンが出ても入れ替わりません。brew upgrade claude-code を自分で実行するまで古いバージョンで動きます。
settings.jsonのenvに追加
{
"env": {
"CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "1"
}
}パッケージマネージャーに新しいバージョンが並ぶ前に通知が出て失敗することがあります。その場合は時間をおいて再試行します。
追うバージョンと更新の止め方は、settings.jsonで変えられます。
| 設定 | 効果 |
|---|---|
autoUpdatesChannel: "latest" | 効果既定。リリース直後のバージョンを受け取る |
autoUpdatesChannel: "stable" | 効果およそ1週間前のバージョンを追い、大きな不具合が出たリリースを飛ばす |
minimumVersion | 効果これより古いバージョンへの更新を拒む下限 |
env.DISABLE_AUTOUPDATER: "1" | 効果裏の自動更新だけ止める(claude update は動く) |
env.DISABLE_UPDATES: "1" | 効果手動を含むすべての更新経路を止める |
チャネルは /config の「Auto-update channel」でも切り替えられます。stableとlatestのどちらを選ぶかは、autoUpdatesChannelでstableとlatestを選ぶを読むと決めやすくなります。latestからstableに移ると、今のバージョンに留まるか戻すかを聞かれ、留まるとそのバージョンが minimumVersion に入ります。新しいモデルがstableより新しいバージョンを要求することもあり、すぐ使いたいならlatestに戻します。更新そのものが止まったときは、Claude Codeアップデートの方法の手順で切り分けます。起動そのものをバージョンの範囲で縛るなら、managed settingsの requiredMinimumVersion と requiredMaximumVersion を使います。
セッションの下に赤字で Auto-update failed · Run claude doctor が出たら、裏の更新が入らなかった印です。作業は続けられます。原因を知るには、シェルで claude update を実行して表示されるエラーを見ます。表示が消えないときは、Auto-update failedが消えないときの対処の順で切り分けます。
バージョンやチャネルを指定してインストールする
ネイティブインストーラーは、チャネル名(stable・latest)かバージョン番号を引数に取ります。インストール時に選んだチャネルが、その後の自動更新の既定になります。
curl -fsSL https://claude.ai/install.sh | bash -s stable
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89PowerShellでは、スクリプトをスクリプトブロックにして引数を渡します。CMDは install.cmd stable のように、install.cmd の後ろに書きます。
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stableこの引数は、スクリプトがダウンロードしたバイナリの claude install に渡されます。v2.1.287の claude install --help は次のとおりでした。
Usage: claude install [options] [target]
Install Claude Code native build. Use [target] to specify version (stable,
latest, or specific version)
Options:
--force Force installation even if already installed
-h, --help Display help for commandmacOSとLinuxでは、~/.local/bin/claude が ~/.local/share/claude/versions/ 配下を指すシンボリックリンクです。これを自作のスクリプトやリンクに置き換えると、v2.1.207以降の自動更新はそのランチャーを上書きしません。新しいバージョンは versions/ に追加されるだけで、どれを動かすかはランチャー側が決めます。管理をClaude Codeに戻すには、~/.local/bin/claude を消して claude update を実行します。
インストーラーと更新まわりの挙動は、v2.1.129以降に何度か変わっています。本文で触れた変更に加えて、配布形式とインストール中の挙動も変わりました。古い手順書と食い違うときは、次の日付を境に見ます。
インストールと更新まわりの主な変更
- 2026-08-24 v2.1.243バイナリの配布をzstd圧縮に
Linux x64のダウンロードが約340MBから約75MBに減りました。
- 2026-08-26 v2.1.246インストール中に承認ダイアログを出さなくなった
組織の管理設定が承認を求めると、パイプ経由のインストールが
Raw mode is not supportedで失敗していました。
Claude Codeをアンインストールする
アンインストールは、入れた経路に対応する削除コマンドを実行します。ネイティブインストールなら、ランチャーとバージョン別のフォルダーを消します。
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeRemove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Forceほかの経路の削除コマンドは次のとおりです。パッケージマネージャー経由は、パッケージを消してもリポジトリ設定が残ります。
| 経路 | 削除するコマンド | あわせて消すもの |
|---|---|---|
| Homebrew | 削除するコマンドbrew uninstall --cask claude-code | あわせて消すものlatestのcaskなら名前を claude-code@latest に |
| WinGet | 削除するコマンドwinget uninstall Anthropic.ClaudeCode | あわせて消すものなし |
| apt | 削除するコマンドsudo apt remove claude-code | あわせて消すもの/etc/apt/sources.list.d/claude-code.list と /etc/apt/keyrings/claude-code.asc |
| dnf | 削除するコマンドsudo dnf remove claude-code | あわせて消すもの/etc/yum.repos.d/claude-code.repo |
| apk | 削除するコマンドapk del claude-code | あわせて消すもの/etc/apk/repositories の該当行と /etc/apk/keys/claude-code.rsa.pub |
| npm | 削除するコマンドnpm uninstall -g @anthropic-ai/claude-code | あわせて消すものなし |
削除しても claude が動くなら、2つ目のインストールか、古いインストーラーが残したシェルのエイリアスがあります。claude update と claude doctor は、~/.zshrc や ~/.bashrc に残った古い claude エイリアスを見つけて知らせます。手で探すなら、後述の「複数のインストールが競合する」の手順です。
設定や履歴まで消すなら、~/.claude フォルダーと ~/.claude.json も削除します。許可済みのツール、MCPサーバーの構成、セッション履歴もすべて消えます。
落とし穴
設定フォルダーを消しても次の起動で復活する
VS Code拡張、JetBrainsプラグイン、デスクトップアプリも ~/.claude/ に書き込みます。どれかが残っていると、次に起動した時点でフォルダーが作り直されます。完全に消すなら、先にこの3つをアンインストールしてから設定ファイルを削除します。
経路ごとの残存ファイルやプロジェクト側の .claude フォルダーの扱いまで確かめるなら、Claude Codeアンインストールの手順に進みます。
Claude Codeのインストールでつまずいたときの切り分け
導入時のトラブルは、どこで止まったかで原因がほぼ決まります。上から順に確かめると、見る場所が絞れます。
インストールが終わらないときは上から順に確かめる
- Qインストールコマンドはエラーなく終わった?答えがエラーで止まった答えがはい
エラーの文面で原因を分けます。
syntax error near unexpected tokenや403は、ダウンロード先がスクリプト以外を返したサインです。Killedはメモリ不足、TLSやcertificateを含むものは証明書の問題です。それぞれ下の節に対処があります。 - Q新しいターミナルで claude --version がバージョン番号を返す?答えが見つからない答えがはい
インストール先がPATHに入っていません。下の「claudeコマンドが見つからない」で、シェルごとの追加方法を見ます。
- Q表示されたバージョンは思っていたとおり新しい?答えが古いバージョンが出る答えがはい
別の経路で入れた古い
claudeが先に見つかっています。下の「複数のインストールが競合する」で重複を探します。 - Qclaude を起動してログインまで進める?答えがログインで止まる答えがはい
WSL 2・SSH先・コンテナでは、ブラウザーに表示されるコードを貼る方式になります。下の「ログインでブラウザーが開かない」を見ます。
claude doctor が No installation issues found を返せば完了
ここまで進めば導入は終わりです。起動後のエラーは別の切り分けになります。
エラーメッセージから原因を1つずつ追うならClaude Codeインストールエラーの切り分けチェックリスト、起動後に出るエラーならClaude Codeのトラブルシューティングガイドへ進みます。
claudeコマンドが見つからない
インストールが成功したのに command not found: claude が出るのは、インストール先がPATHに入っていないためです。Windowsでは 'claude' is not recognized と出ます。インストーラーはこの状態を検知し、Setup notes: の下に次の1行を出します。
Native installation exists but ~/.local/bin is not in your PATH.
直し方は表示しますが、PATHは自分では変えません。
バイナリの置き場所は、macOS・Linuxが ~/.local/bin/claude、Windowsが %USERPROFILE%\.local\bin\claude.exe です。macOSの既定のZshなら、次の2行で追加します。
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcLinuxのBashは ~/.bashrc に、macOSのBashは ~/.bash_profile に書きます。macOSのターミナルはBashをログインシェルとして起動し、~/.bashrc を読まないためです。WindowsのPowerShellでは、ユーザー環境変数のPATHに追記します。
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')追記しても見つからないときは、開いたままのウィンドウかエディター内のターミナルを疑います。どちらも起動時のPATHを持ち続けるので、ウィンドウやエディターを開き直します。echo で permission denied が出るなら、シェルの設定ファイルが自分の所有になっていません。fishやNushellではPATHの書き方が変わるので、Claude Codeのcommand not foundをPATH設定で直すでシェル別の書き方を確かめます。
Windowsで更新の直後から 'claude' is not recognized になった場合は、更新の途中で claude.exe が消えています。同じフォルダーに claude.exe.old. で始まるバックアップが残っていれば、名前を claude.exe に戻すと動きます。バックアップが無ければ、インストールコマンドを再実行します。
インストールスクリプトがHTMLや403を返す
syntax error near unexpected token '<' や curl: (22) ... 403 が出たら、インストールURLがスクリプト以外を返しています。PowerShellでは System.Xml.XmlDocument を含むエラーや、HTMLやCSSを引用した構文エラーとして現れます。出力に App unavailable in region があれば、対応国の外からのアクセスです。本文の無い403は、企業のプロキシやファイアウォールが downloads.claude.ai を止めていることが多いです。
ダウンロード先に届くかは、次のコマンドで分かります。1行目が HTTP/2 200 なら届いています。
curl -sI https://downloads.claude.ai/claude-code-releases/latestWindowsのPowerShellでは、curl が別のコマンドの別名なので curl.exe -sI と書きます。一時的な障害のこともあるので、数分おいて再試行するか、HomebrewやWinGetの経路を試します。それでも出るときは、install scriptがHTML/403を返す原因と対処で原因を分け、PowerShell特有のエラーならinstall.ps1でSystem.Xml.XmlDocumentと出る原因を当たります。
企業プロキシ・TLS検査の環境
企業ネットワークでは、プロキシの指定と社内CA証明書の指定の2段階で切り分けます。プロキシ経由なら、HTTP_PROXY と HTTPS_PROXY を設定してからインストールコマンドを実行します。プロキシのアドレスはIT部門に確かめます。
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bashTLS検査(SSLインスペクション)を行うプロキシの配下では、unable to get local issuer certificate のような証明書エラーが出ます。インストール時は curl の --cacert で社内CA証明書を渡し、インストール後のClaude Codeには NODE_EXTRA_CA_CERTS で同じ証明書を指定します。
# インストール時: curlに社内CA証明書を渡す
curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
# インストール後: API通信にも同じ証明書を使わせる
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pemWindowsのPowerShellインストーラーは、Windowsの証明書ストアで検証します。社内CAがストアに入っていなければ、IT部門に追加してもらいます。CMDで CRYPT_E_NO_REVOCATION_CHECK が出る場合は、失効確認の通信が遮られています。最初の curl に --ssl-revoke-best-effort を付けるか、PowerShellのインストーラーかWinGetに切り替えます。
WSLでうまく動かない
WSL 1では cannot execute binary file: Exec format error が出て、ネイティブバイナリが動きません。GitHubのissue #38788で追跡されている既知の問題です。PowerShellで wsl --set-version <ディストリビューション名> 2 を実行し、WSL 2に変換するのが確実です。
WSL 1のまま使う場合は、~/.bashrc に次の関数を足して動的リンカー経由で起動します。
claude() {
/lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
}npm経由で入れた場合は、Windows側のNode.jsを拾って exec: node: not found が出ることがあります。which npm の結果が /mnt/c/ で始まっていれば該当するので、Linux側にディストリビューションのパッケージマネージャーかnvmでNode.jsを入れ直します。
ログインでブラウザーが開かない・コードが貼れない
WSL 2・SSH先・コンテナでは、ブラウザーが別のホストで開き、承認後の戻り先がClaude Codeに届きません。承認するとブラウザーにログインコードが表示されるので、ターミナルの Paste code here if prompted に貼ります。
WSL 2でブラウザーがまったく開かない場合は、Windows側のブラウザーのパスを BROWSER に設定します。
export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claudeログイン画面で c を押すとURLがコピーされ、手元のブラウザーで開けます。貼り付けが効かないときは、端末の別の貼り付け操作を試します。Windows Terminalなら右クリックやShift+Insertです。それでも駄目なら、標準入力からコードを読む claude auth login を使います。原因がはっきりしないときは、/logout で一度サインアウトし、Claude Codeを閉じてから claude で認証し直します。
低メモリのLinuxサーバーで止まる
VPSなどでインストールが途中で止まるのは、メモリ不足でLinuxのOOM killer(メモリが足りないときにプロセスを強制終了する仕組み)が claude install を止めたためで、Installation was killedの原因と対処と同じ型です。v2.1.200以降のスクリプトは原因を表示し、終了コード137で止まります。表示の行番号やプロセスIDは実行ごとに変わります。
Setting up Claude Code...
bash: line 183: 34803 Killed "$binary_path" install ${TARGET:+"$TARGET"}
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.インストールに要る空きメモリは約512MBで、動かすには4GB以上のRAMが前提です。ほかのプロセスを止めるか、スワップを2GB足してから、もう一度インストールコマンドを実行します。
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfileDockerコンテナでrootのままルートディレクトリ(/)からインストーラーを実行すると、ファイルシステム全体の走査でメモリを使い切り、固まることがあります。Dockerfileで WORKDIR /tmp を設定してからインストーラーを実行すると避けられます。
複数のインストールが競合する
過去にnpm版やHomebrew版を入れていた環境では、古い claude が先に見つかってバージョンが食い違うことがあります。which -a claude(Windowsは where.exe claude)でPATH上の全件を出します。~/.local/bin/claude のネイティブ版だけを残し、ほかは削除します。古いClaude Codeが作ったローカルのnpm版は rm -rf ~/.claude/local で消せます。
Windowsで claude を打つとデスクトップアプリが開く場合は、古いClaude Desktopが原因です。WindowsApps に登録された Claude.exe が、PATHで先に見つかっています。デスクトップアプリを最新に更新すると直ります。
まとめ
Claude Codeのインストールで迷う場面の多くは、どの経路で入れたかに行き着きます。更新が届かない、消したのに動く、古いバージョンが出る、のいずれも原因は経路の違いです。最初はネイティブインストーラー1本に寄せると、更新も切り分けも単純になります。
挙動を変えたくなったら、Claude Codeのsettings.json解説の設定項目から探せます。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。