.AI TIMES
ガイド

Claude Code npmインストール完全ガイド【2026年最新】：コマンド・非推奨の理由・ネイティブ移行手順まで

室谷東吾
監修者室谷東吾（@0x__tom）

株式会社MYUUU 代表取締役 / 日本最大級AIコミュニティ「.AI」創設者（累計2,000名超）/ セプテーニ・ホールディングス（電通グループ）と資本業務提携 / 著書「お金を使わず、AIを働かせる『Dify』活用」（ぱる出版、3刷）/ Xフォロワー約2万人

テキトー教師
監修者テキトー教師（@tekitoo_T_cher）

.AI 認定講師 / 教育×AIの専門家 / 累計300名以上にAI活用を指導 / 「テキトーに学ぶ」がモットーの実践派講師 / Xアカウント

Claude Code npmインストール完全ガイド【2026年最新】：コマンド・非推奨の理由・ネイティブ移行手順まで

Claude Code npmとは？パッケージ名と基本を整理する

室谷室谷
今回はClaude Codeのnpmインストールについて、ぜんぶまとめていきましょう。「npm install claude code」で調べてくる人が多いんですよね。

でも実は、これには知っておかないといけない大前提があって・・・
テキトー教師テキトー教師
ですよね。コミュニティのメンバーさんでも「なんかインストールできない」「昔と違う方法が出てきた」って声が結構あって。

2026年現在、Claude Codeのnpmインストールは公式に非推奨になっているんですよね。
室谷室谷
そこ、最初に言っておかないとダメですよね。npmパッケージ自体は今でも存在していて、@anthropic-ai/claude-codeという名前でnpmjs.comで公開されています。

ただ、Anthropicの公式ドキュメントでは「Deprecated npm installation（非推奨のnpmインストール）」と明記されるようになった。
テキトー教師テキトー教師
整理すると、こういう基本情報になりますね。
項目内容
パッケージ名@anthropic-ai/claude-code
npmjs.comhttps://www.npmjs.com/package/@anthropic-ai/claude-code
最新バージョン2.1.92（2026年4月時点）
週間ダウンロード数1,000万件超
Node.js要件18以上
公式の位置付けDeprecated（非推奨）
室谷室谷
週間1,000万件超は本当にすごい数字ですよね。npmパッケージとして存在感は抜群なんだけど、公式がネイティブインストーラーへの移行を推奨している・・・という二面性がある。
テキトー教師テキトー教師
「なぜ非推奨になったのか」という理由を知っておくと、どちらの方法を選ぶかが自然と判断できるようになります。ネイティブインストーラーの方が「速い」「依存関係がない」「バックグラウンドで自動更新される」という3つの優位点があるんですよね。
室谷室谷
Node.jsへの依存がなくなるのは大きいですよ。npmでインストールするにはNode.js 18以上が必要で、その管理が地味に面倒なんです。

MYUUUでも最初はnpm派だったんですが、ネイティブに変えた途端「なんで早くしなかったんだろう」ってなりました。

npm install claude code：コマンドと手順

Claude Code公式ドキュメントのnpmインストール手順（「Do NOT use sudo」の警告付き）（公式サイトより）

テキトー教師テキトー教師
それでも「npmで管理したい」「既存のプロジェクト環境に合わせたい」という理由でnpmインストールを選ぶ方もいます。講座でも互換性の都合でnpmを使っているケースは実際あって。

そういう方向けに、正しい手順を解説していきます。
室谷室谷
まず前提として、Node.js 18以上が必要です。これは公式ドキュメントで明記されています。

バージョン確認から始めましょう。
# Node.jsのバージョン確認
node --version

# npm自体のバージョン確認
npm --version
テキトー教師テキトー教師
Node.jsが18未満の場合は先にアップデートが必要ですね。nvmやFnmなどのバージョン管理ツールを使っている方は、そこから最新のLTSをインストールするのが確実です。
室谷室谷
インストールコマンドはこれです。
npm install -g @anthropic-ai/claude-code
テキトー教師テキトー教師
-gフラグでグローバルインストールします。ここで注意してほしいのが、公式ドキュメントが明示している「やってはいけないこと」があって。
室谷室谷
sudo npm install -gですよね。これをやると権限まわりの問題とセキュリティリスクが発生する、と公式に書いてあります。
テキトー教師テキトー教師
「permission denied」でつまずいた人が真っ先にやりがちなんですよね（笑）。sudoで解決しようとするのは逆効果です。

代わりにnpmのデフォルトディレクトリを変更するか、もうネイティブインストーラーに切り替えた方が早い。
室谷室谷
インストールが完了したら、動いているか確認します。
# バージョン確認でインストール成功を確かめる
claude --version

# 起動してみる
claude
テキトー教師テキトー教師
claude --versionで現在のバージョンが表示されればOKですね。表示されない場合はPATHの問題が多いので、そちらをチェックします。

特定バージョンを指定してインストールする

室谷室谷
「最新じゃなくて特定バージョンを使いたい」という場合は、バージョンを指定できます。npmなら柔軟にバージョン管理できるのはメリットの1つですね。
# 特定バージョンを指定してインストール
npm install -g @anthropic-ai/claude-code@2.1.88

# 最新版を明示的に指定
npm install -g @anthropic-ai/claude-code@latest
テキトー教師テキトー教師
ただし、ネイティブインストーラーでもstableチャンネルに切り替えることで、最新から約1週間遅れの安定版を使うことができます。バージョンを固定したいがためだけにnpmを選ぶのは、もったいないかもしれないですね。
室谷室谷
そうなんですよ。ネイティブはsettings.jsonで"autoUpdatesChannel": "stable"を設定するだけで安定版チャンネルになります。

この辺の柔軟性は、思ったより高くなっている。

Windowsでnpmインストールする場合

テキトー教師テキトー教師
Windowsの方からの質問も多いので、ここも整理しておきます。WindowsでClaude CodeをnpmからインストールするにはNode.js 18以上が必要で、PowerShellかCMDで実行します。
室谷室谷
Windowsの場合、ネイティブインストーラーの方が実は楽なんですよね。PowerShellから一発で入る。
# Windows PowerShell（ネイティブインストーラー：推奨）
irm https://claude.ai/install.ps1 | iex

# WinGetを使う方法
winget install Anthropic.ClaudeCode
テキトー教師テキトー教師
WSL2を使っている方は、WSL2の環境内でLinux向けのネイティブインストーラーを実行するのが確実です。Windowsネイティブとは別に管理できます。

npmインストールが非推奨になった理由

npmインストール（非推奨）とネイティブインストーラー（推奨）の比較フロー図

室谷室谷
ここを掘り下げておきたいんですが、なぜAnthropicはnpmインストールを非推奨にしたのか。実はこれ、あのnpmパッケージのソースコード流出事件と関係があって・・・
テキトー教師テキトー教師
ああ、2025年にあったやつですよね。npmパッケージのソースマップ設定ミスで1,900ファイル・51万行超が流出した件。
室谷室谷
そうです。Anthropicは「リリースパッケージングの問題で人的エラー」と声明を出しましたけど、あの件があってnpmパッケージの管理体制を見直したんじゃないかと思っていて。

ネイティブインストーラーに移行することで、より厳密なバイナリ署名と整合性検証ができるようになる。
テキトー教師テキトー教師
確かに、公式ドキュメントにはバイナリの整合性検証（manifest.jsonのSHA256チェックサムとGPG署名）の手順が詳しく書かれるようになりましたよね。npmだとそこまでの署名検証ができなかった。
室谷室谷
ネイティブインストーラーの優位性をまとめるとこうなりますね。
比較項目npmインストールネイティブインストーラー
Node.js依存必要（18以上）不要
インストール速度普通速い
自動更新なしバックグラウンドで自動
バイナリ整合性検証限定的GPG署名による完全検証
公式の推奨Deprecated推奨
特定バージョン指定できるチャンネル設定で可能
テキトー教師テキトー教師
この表を見れば、よほど特別な理由がない限りネイティブ一択ですよね。npmでインストールしても機能は同じですが、今後のサポートや更新体制を考えるとネイティブに移行しておく方が安心です。
室谷室谷
「npmで慣れているから」というだけの理由でnpmを使い続けているなら、移行を検討する価値はありますよね。移行自体は5分かかりません。

npm installのエラーと対処法

テキトー教師テキトー教師
実際にnpmでインストールしようとしたときによく出るエラーも整理しておきましょう。コミュニティのメンバーさんからの質問で一番多いのが「permission denied」です。
室谷室谷
これはsudoを使わずに解決するのが鉄則ですよね。公式ドキュメントでも「sudo npm install -gは使うな」と明記されています。

permission deniedエラーの対処法

テキトー教師テキトー教師
権限エラーが出た場合の対処法は2つあります。
室谷室谷
1つ目はnpmのグローバルディレクトリを変更する方法。ホームディレクトリに新しいディレクトリを作って、そこをnpmのグローバルパスに設定します。
# npmのグローバルディレクトリをホームディレクトリに変更
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

# PATHに追加（~/.bashrcや~/.zshrcに追記）
export PATH=~/.npm-global/bin:$PATH

# 設定を反映してから再インストール
source ~/.bashrc  # または source ~/.zshrc
npm install -g @anthropic-ai/claude-code
テキトー教師テキトー教師
2つ目は、もうネイティブインストーラーに切り替えることですね。これが一番シンプルで確実です。
# macOS/Linux/WSL：ネイティブインストーラー
curl -fsSL https://claude.ai/install.sh | bash
室谷室谷
正直、permission errorが出た時点でネイティブに切り替えた方が早いケースが多い。npmのグローバルパス設定は慣れていないと混乱しやすいので・・・

command not found：claude が見つからない

テキトー教師テキトー教師
インストールは成功したのにclaudeコマンドが見つからない、というケースもよくあります。これはPATHの問題ですね。
室谷室谷
npmのグローバルインストール先がPATHに含まれていない、というケースです。確認コマンドを試してみましょう。
# npmのグローバルディレクトリを確認
npm root -g

# npmのbinディレクトリを確認
npm bin -g

# claudeコマンドの場所を探す
which claude
テキトー教師テキトー教師
npm bin -gで表示されるパスが~/.bashrcや~/.zshrcのPATHに含まれていない場合は、そこに追記してシェルを再起動すれば解決します。

npm install anthropic ai claude code エラー

室谷室谷
「npm install anthropic ai claude code」という書き方でインストールしようとしてエラーになった、という質問もよく来ますよね。
テキトー教師テキトー教師
パッケージ名のタイポが多いんですよね。正しいパッケージ名は@anthropic-ai/claude-codeで、@とスコープ名まで含んだ書き方が必要です。
# NG: パッケージ名の誤り（よくある間違い）
npm install -g anthropic-ai/claude-code   # @ がない
npm install -g anthropic claude code      # スペース区切り
npm install -g claude-code               # スコープなし

# OK: 正しいパッケージ名
npm install -g @anthropic-ai/claude-code
室谷室谷
@anthropic-aiがスコープ名で、/claude-codeがパッケージ名という構造です。npmのスコープ付きパッケージに慣れていない方がよくやるミスですね。

npmからネイティブインストーラーに移行する手順

テキトー教師テキトー教師
「今までnpmで使っていて、ネイティブに移行したい」という方向けに、移行手順を確認しておきましょう。公式ドキュメントに明確な手順が書かれています。
室谷室谷
手順としてはシンプルで、ネイティブをインストールしてからnpmバージョンを削除するだけです。
# ステップ1: ネイティブバイナリをインストール
curl -fsSL https://claude.ai/install.sh | bash

# ステップ2: 古いnpmインストールを削除
npm uninstall -g @anthropic-ai/claude-code
テキトー教師テキトー教師
公式ドキュメントでは、既存のnpmインストール環境からclaude installを実行してネイティブバイナリを追加インストールし、その後npmバージョンを削除する方法も紹介されています。
室谷室谷
設定やCLAUDE.mdはそのまま引き継がれます。移行しても.claudeディレクトリの中身は変わらないので、今まで作ってきた設定は全部残ります。
テキトー教師テキトー教師
MYUUUのエンジニアも数人移行したことがあるそうですが、設定ファイルの引き継ぎ問題は特になかった？
室谷室谷
なかったですね。~/.claude/ディレクトリはそのまま使い続けられます。

唯一、PATHの優先順位が変わることがあるので、which claudeでネイティブバイナリが先に呼ばれていることを確認するのが安心です。
# 移行後の確認
which claude
# /usr/local/bin/claude などネイティブのパスが表示されればOK

claude --version
# バージョンが表示されればネイティブで動いている

npm update claude code：アップデート方法

テキトー教師テキトー教師
npmでインストールした場合のアップデートについても触れておきます。npmインストールの場合は自動更新がないので、手動でアップデートが必要です。
室谷室谷
これがネイティブとの大きな違いの1つですよね。ネイティブはバックグラウンドで自動的にアップデートが走りますが、npmはそれがない。
# npmでClaude Codeをアップデート
npm update -g @anthropic-ai/claude-code

# または再インストール（確実な方法）
npm install -g @anthropic-ai/claude-code@latest
テキトー教師テキトー教師
一方、ネイティブインストーラーの場合はclaude updateコマンドでも手動アップデートできます。
# ネイティブインストールの場合（手動アップデート）
claude update
室谷室谷
Claude Codeは結構な頻度でアップデートが来るんですよ。週に2〜3回リリースがある時期もある。

自動更新があるかどうかは、実は日常的な使用感に結構影響します。
テキトー教師テキトー教師
講座でよく言うんですが、「なんか動きがおかしい」の原因がバージョンの古さだったケースが意外と多い。npmで入れている方は特に、定期的にnpm update -g @anthropic-ai/claude-codeを走らせておくことをおすすめします。

npm uninstall claude code：アンインストール手順

室谷室谷
アンインストールもシンプルです。npmでインストールした場合はnpm uninstall -gで削除できます。
# npmでインストールしたClaude Codeをアンインストール
npm uninstall -g @anthropic-ai/claude-code
テキトー教師テキトー教師
これでClaude Codeのバイナリは削除されますが、設定ファイルは残ります。完全にクリーンにしたい場合は設定ディレクトリも削除します。
室谷室谷
設定ファイルの場所はOSによって違います。
# macOS/Linux の場合
rm -rf ~/.claude

# 設定ファイルの場所（参考）
# ~/.claude/settings.json - 設定
# ~/.claude/CLAUDE.md - プロジェクト横断のルール
# ~/.claude/projects/ - プロジェクト別のデータ
テキトー教師テキトー教師
注意点として、設定ファイルを削除すると「設定・許可ツール・MCPサーバー設定・セッション履歴」が全て削除されます。ネイティブインストーラーに移行する場合は、設定ファイルは消さずにそのまま引き継ぐ方がいいですよね。
室谷室谷
そうですよね。設定を引き継ぎながらバイナリだけ変える、というのが移行の正しい手順なので。

npm install claude code without npm：npmなしで使う方法

テキトー教師テキトー教師
「install claude code without npm」というキーワードで探している方も多い。つまり「npmを使わずにインストールしたい」というニーズですね。
室谷室谷
これはまさにネイティブインストーラーの話ですよね。npm不要でインストールできる方法が複数あります。
インストール方法npm不要コマンド
ネイティブインストーラー（macOS/Linux）不要curl -fsSL https://claude.ai/install.sh | bash
ネイティブインストーラー（Windows）不要irm https://claude.ai/install.ps1 | iex
Homebrew（macOS）不要brew install --cask claude-code
WinGet（Windows）不要winget install Anthropic.ClaudeCode
デスクトップアプリ不要GUIからダウンロード
テキトー教師テキトー教師
Homebrewを使っている方はそちらが馴染みやすいですよね。ただし、HomebrewとWinGetは自動更新がないので、定期的に手動でアップデートが必要です。
室谷室谷
brew upgrade claude-codeを定期的に実行する運用になります。ネイティブインストーラーが自動更新してくれるのとは違う点なので、そこだけ覚えておくといい。
テキトー教師テキトー教師
あと、デスクトップアプリという選択肢もあって。ターミナル操作に慣れていない方はデスクトップアプリからのGUI起動が入りやすいです。

macOSとWindowsで提供されています。

よくある質問（FAQ）

Q. npm install claude codeとnpm install @anthropic-ai/claude-codeは同じ？

室谷室谷
別物です。npm install claude-codeと打つと、別の全く関係ないパッケージが入る可能性があります。

Claude Codeの正しいパッケージ名は@anthropic-ai/claude-codeで、必ずスコープ付きで指定します。
テキトー教師テキトー教師
@anthropic-ai/のスコープがないと、npmレジストリの別のパッケージを誤ってインストールする危険があります。必ず正確なパッケージ名を使ってください。

Q. npmでインストールしたClaude Codeとネイティブで機能の差はある？

室谷室谷
機能自体に差はありません。Claude Codeとしての動作は同じです。

差があるのは「自動更新の有無」「インストール速度」「Node.js依存の有無」です。
テキトー教師テキトー教師
ただし今後、ネイティブインストーラーを前提とした機能が追加される可能性は否定できないですよね。Anthropicが公式にnpmを非推奨にしている以上、長期的にはネイティブに移行しておいた方が安心だと思います。

Q. npm install claude code specific versionで過去バージョンを使いたい

室谷室谷
npmインストールならnpm install -g @anthropic-ai/claude-code@バージョン番号で過去バージョンをインストールできます。ネイティブでもstableチャンネルを使うことで安定バージョンを維持できます。
テキトー教師テキトー教師
ただし、古いバージョンを使い続けることにはセキュリティリスクが伴う場合があります。特定のバージョンに固定する理由がある場合は、そのリスクも念頭に置いてください。

Q. npm musistudio claude code routerとは何か？

室谷室谷
これはMusiStudioという非公式のサードパーティサービスが提供している、Claude Code用のAPIルーターパッケージです。Anthropic公式とは無関係のパッケージで、非公式のルーティングや代替API接続に使うものです。
テキトー教師テキトー教師
公式パッケージと混同しないように注意が必要ですね。Claude Codeの公式インストールには@anthropic-ai/claude-codeを使います。

まとめ

室谷室谷
今回はClaude Codeのnpmインストールについて全部まとめました。結論として言えるのは、「npmインストールは2026年現在、公式に非推奨になっている」ということです。
テキトー教師テキトー教師
ただし、互換性の都合などでどうしてもnpmが必要な場合は、npm install -g @anthropic-ai/claude-codeで問題なく使えます。sudo は使わないこと、Node.js 18以上が必要なこと、この2点だけ守れば動作します。
室谷室谷
今からインストールする方は、ネイティブインストーラーかHomebrewかWinGetの方が間違いないですよ。Node.jsが不要で、自動更新もある。

npmでインストールすべき特別な理由がなければ、ネイティブ一択です。
テキトー教師テキトー教師
既にnpmで使っている方は、移行も5分でできます。ネイティブインストーラーを入れて、npmのを消すだけ。

設定ファイルはそのまま引き継がれるので、今まで作ってきたCLAUDE.mdや設定は全部残ります。
室谷室谷
Claude Codeをこれから使い始める方向けに言うと、今は「まずネイティブで入れて試してみる」が最短ルートですね。詳しいインストール手順はに全部書いてあります。

出典

.AI TIMES一覧に戻る