Claude Media
Claude Codeのインストール方法 — Mac・Windows・Linux別の手順と更新・アンインストール

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 | bash
irm https://claude.ai/install.ps1 | iex
curl -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. 1

    インストールコマンドを実行する

    上の3つからOSとシェルに合うものを1つ実行します。管理者権限は要りません。

  2. 2

    新しいターミナルで claude --version を実行する

    2.1.287 (Claude Code) のようにバージョン番号が出れば成功です。command not found なら、インストール先がまだPATHに入っていません。

  3. 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以上

個人プランの料金はclaude.comの料金ページの表示額で、税は含みません

ログインに使えるアカウントは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が無いと入らない?

  1. 後輩

    Claude Codeってnpmのパッケージですよね。Node.jsを先に入れないといけないんですか?

  2. 先輩

    推奨のネイティブインストーラーならNode.jsは要らないよ。自己完結型のバイナリを置くだけだから。

  3. 後輩

    じゃあnpmで入れた場合は、Node.jsの上で動くんですか?

  4. 先輩

    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-code

Homebrewのcaskは2つあり、追うバージョンが違います。

くらべる

Homebrewの2つのcask

stable

claude-code

およそ1週間遅れの安定版を追い、大きな不具合が出たリリースを飛ばします。更新は brew upgrade claude-code です。

latest

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のプロジェクト向け

ネイティブWindows

PowerShellかCMDでインストールコマンドを実行します。Git for Windowsは任意で、入れるとBashツールが使えます。

Linuxの道具が要るとき

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.ClaudeCode

Git 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-code

Alpineの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++ ripgrep

ripgrep は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で更新を代行させる設定

BEFORE

既定のまま

新しいバージョンが出ても入れ替わりません。brew upgrade claude-code を自分で実行するまで古いバージョンで動きます。

AFTER

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.89

PowerShellでは、スクリプトをスクリプトブロックにして引数を渡します。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 command

macOSとLinuxでは、~/.local/bin/claude が ~/.local/share/claude/versions/ 配下を指すシンボリックリンクです。これを自作のスクリプトやリンクに置き換えると、v2.1.207以降の自動更新はそのランチャーを上書きしません。新しいバージョンは versions/ に追加されるだけで、どれを動かすかはランチャー側が決めます。管理をClaude Codeに戻すには、~/.local/bin/claude を消して claude update を実行します。

インストーラーと更新まわりの挙動は、v2.1.129以降に何度か変わっています。本文で触れた変更に加えて、配布形式とインストール中の挙動も変わりました。古い手順書と食い違うときは、次の日付を境に見ます。

あゆみ

インストールと更新まわりの主な変更

  1. 2026-08-24 v2.1.243バイナリの配布をzstd圧縮に

    Linux x64のダウンロードが約340MBから約75MBに減りました。

  2. 2026-08-26 v2.1.246インストール中に承認ダイアログを出さなくなった

    組織の管理設定が承認を求めると、パイプ経由のインストールが Raw mode is not supported で失敗していました。

Claude Codeをアンインストールする

アンインストールは、入れた経路に対応する削除コマンドを実行します。ネイティブインストールなら、ランチャーとバージョン別のフォルダーを消します。

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
Remove-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のインストールでつまずいたときの切り分け

導入時のトラブルは、どこで止まったかで原因がほぼ決まります。上から順に確かめると、見る場所が絞れます。

切り分け

インストールが終わらないときは上から順に確かめる

  1. Qインストールコマンドはエラーなく終わった?
    答えがエラーで止まった

    エラーの文面で原因を分けます。syntax error near unexpected token や 403 は、ダウンロード先がスクリプト以外を返したサインです。Killed はメモリ不足、TLS や certificate を含むものは証明書の問題です。それぞれ下の節に対処があります。

    答えがはい
  2. Q新しいターミナルで claude --version がバージョン番号を返す?
    答えが見つからない

    インストール先がPATHに入っていません。下の「claudeコマンドが見つからない」で、シェルごとの追加方法を見ます。

    答えがはい
  3. Q表示されたバージョンは思っていたとおり新しい?
    答えが古いバージョンが出る

    別の経路で入れた古い claude が先に見つかっています。下の「複数のインストールが競合する」で重複を探します。

    答えがはい
  4. 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 ~/.zshrc

Linuxの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/latest

Windowsの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 | bash

TLS検査(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.pem

Windowsの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 /swapfile

Dockerコンテナで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解説の設定項目から探せます。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/ja/setup
  2. code.claude.com/docs/ja/quickstart
  3. code.claude.com/docs/ja/troubleshoot-install
  4. code.claude.com/docs/ja/authentication
  5. code.claude.com/docs/ja/desktop-quickstart
  6. code.claude.com/docs/ja/changelog
  7. claude.com/ja/pricing
この記事を共有:XはてブLinkedIn