Claude Code ネイティブインストール｜npmから移行と自動更新
「Claude Code をネイティブインストールしたい」と検索したものの、curl の 1 行だけで本当に完結するのか、これまで使っていた npm グローバル版とどう違うのか、どこに入るのかが分からず手が止まっていませんか。本記事では Anthropic が公式に推奨するネイティブインストーラを主題に、OS 別の導入コマンド・npm からの移行・インストール確認・自動更新の仕組みまで、公式情報ベースで一気に整理します。
Claude Code のネイティブインストールは、Mac/Linux/WSL なら curl -fsSL https://claude.ai/install.sh | bash、Windows PowerShell なら irm https://claude.ai/install.ps1 | iex の 1 行で完結し、Node.js に依存せず ~/.local/bin/claude にバイナリが入るとわかる。3 経路の中で唯一バックグラウンド自動更新が付き、npm グローバル版からも移行できる。
Contents (12)
ネイティブインストールとは — Node.js に依存しない公式推奨方式
ネイティブインストールとは、Claude Code のプラットフォーム別バイナリを直接ダウンロードして配置する、Anthropic 公式の推奨方式です。従来の npm install -g @anthropic-ai/claude-code と違い、Node.js の実行環境を必要としません。
公式ドキュメントによれば、Homebrew・WinGet・Linux パッケージマネージャ・npm など複数の導入経路が用意されていますが、バックグラウンドで自動更新されるのはネイティブインストールだけです。nvm や asdf などの Node.js バージョン管理ツールと衝突しない点も、開発者にとって大きな利点です。
対応環境は macOS 13.0 以降、Windows 10 1809 以降、Ubuntu 20.04 以降、Debian 10 以降、Alpine Linux 3.19 以降で、ハードウェアは 4 GB 以上の RAM と x64 または ARM64 プロセッサが必要です(出典: Advanced setup - Claude Code Docs)。
OS 別のインストール手順
ネイティブインストーラは OS ごとにコマンドが異なります。ターミナルを開き、自分の環境に合った 1 行を実行してください。
Mac / Linux / WSL
- ターミナルを開く。
curl -fsSL https://claude.ai/install.sh | bashを実行する。- インストール完了後、作業したいプロジェクトのフォルダで
claudeと入力して起動する。
Windows(PowerShell)
- PowerShell を開く(管理者権限は不要)。
irm https://claude.ai/install.ps1 | iexを実行する。- 完了後、任意のターミナルから
claudeで起動する。
プロンプトが PS C:\ で始まっていれば PowerShell、PS が付かず C:\ なら CMD です。'irm' is not recognized というエラーが出た場合は CMD にいるので、curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd を使います。
Windows で Git for Windows を入れる意味
ネイティブ Windows で Git for Windows を入れておくと、Claude Code が Git Bash 経由で Bash ツールを使えるようになります。未導入の場合は PowerShell がシェルツールとして使われます。
npm グローバル版からネイティブへ移行する
すでに npm install -g で Claude Code を使っている場合も、ネイティブインストーラへ移行できます。
- 上記の OS 別コマンドでネイティブインストーラを実行する。
- 過去に使ったすべての Node.js 環境から
npm uninstall -g @anthropic-ai/claude-codeを実行し、npm 版を削除する。 - asdf や nvm を使っている場合は、各バージョンで削除を繰り返す(古い
claudeが残ると競合の原因になる)。 - ターミナルを開き直し、後述の方法でネイティブ版が使われていることを確認する。
なお公式ドキュメントによれば、npm パッケージ自体もスタンドアロンインストーラと同じネイティブバイナリを取得しており、プラットフォーム別のオプション依存と postinstall スクリプトでバイナリをリンクする仕組みです。つまり npm 版も内部的には Node.js を実行しませんが、自動更新が付かない点がネイティブインストールとの違いです。
インストールの確認方法
移行後は、本当にネイティブ版が動いているかを確認しておくと安心です。
claude --versionを実行し、バージョンが表示されることを確認する。claude doctorを実行し、インストールと設定の詳細診断を確認する。which claude(Windows はwhere claude)でパスを確認し、~/.local/bin/claudeが表示されればネイティブ版が正しく使われている。
command not found が出る場合は、~/.local/bin が PATH に含まれていない可能性があります。ターミナルを開き直すか、シェルの設定ファイルで PATH を確認してください。
自動更新とリリースチャンネル
ネイティブインストールの最大の利点が、バックグラウンド自動更新です。Claude Code は起動時と実行中に定期的に更新を確認し、ダウンロードとインストールをバックグラウンドで行い、次回起動時に反映します。
リリースチャンネルは settings.json の autoUpdatesChannel で制御できます。
"latest"(既定): 新機能をリリース直後に受け取る。"stable": 大きな不具合を含むリリースを避け、おおむね 1 週間前のバージョンを使う。
即時に更新したいときは claude update、自動更新を止めたいときは settings.json の env に DISABLE_AUTOUPDATER を "1" と設定します。組織全体で最低バージョンを固定したい場合は minimumVersion を使えます(出典: Advanced setup - Claude Code Docs)。
アンインストール手順
ネイティブインストール版を削除するには、バイナリとバージョンファイルを消します。
Mac / Linux / WSL
rm -f ~/.local/bin/claudeでバイナリを削除する。rm -rf ~/.local/share/claudeでバージョンファイルを削除する。
Windows(PowerShell)
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Forceを実行する。Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Forceを実行する。
削除後も claude が動く場合は、別のインストール(npm 版や Homebrew 版)や古いシェルエイリアスが残っています。設定まで完全に消したいときは ~/.claude と ~/.claude.json も削除しますが、これで設定・許可ツール・MCP サーバ設定・セッション履歴がすべて消える点に注意してください。
どの経路を選ぶべきか
ネイティブインストールは自動更新が付き、Node.js 不要でシンプルなため、特別な理由がなければ第一候補です。他経路との使い分けは次のとおりです。
- Homebrew / WinGet: パッケージ管理を一元化したい場合。ただし自動更新はなく、
brew upgradeやwinget upgradeの手動更新が必要。 - apt / dnf / apk: 署名済みリポジトリで Linux のシステム更新フローに載せたい場合。これも自動更新は非対応。
- npm: 既存の Node.js ワークフローに組み込みたい場合。Node.js 18 以降が必要で、自動更新は付かない。
認証には Pro・Max・Team・Enterprise・Console いずれかのアカウントが必要で、無料の Claude.ai プランでは Claude Code を利用できません(出典: Advanced setup - Claude Code Docs)。
Mac・Windows それぞれの環境固有のつまずきや WSL の使い分けについては、OS 別のセットアップ記事も併せて参照してください。ネイティブインストールを軸に据えれば、更新もアンインストールも最小の手順で管理できます。