この記事の目次
Claude Codeをインストールする前に何を確認すべきか
インストール前に確認しておくべきことは、対応OS、npmインストールを選ぶ場合のみ必要になるNode.jsのバージョン、そして自分が契約しているプランがClaude Codeの対象になっているかの3点である。ここを飛ばして進めると、コマンド自体は成功したのに起動できない、認証画面が想定と違うといったつまずきが起きやすい。
| 確認項目 | 内容 | 備考 |
|---|---|---|
| 対応OS | macOS / Windows / Linux | いずれもターミナル操作が前提 |
| Node.js | npmインストールを選ぶ場合のみ必要 | ネイティブインストーラーでは不要 |
| 対象プラン | 執筆時点ではFreeプランは対象外とされている | Pro / Max / Team / Enterpriseの範囲は変更される可能性があるため、契約前に公式のプラン説明ページで最新の記載を確認する |
Node.jsのバージョンはnode -vで確認できる。必要な最低バージョンは公式のインストールページに記載されているため、npmインストールを選ぶ場合は事前にそちらの記載を確認しておくとよい。
プランの対応範囲は料金体系の変更に伴って更新されることがあるため、この記事の内容は執筆時点のものとして扱い、契約を検討している場合は必ず公式情報を直接確認してほしい。プランごとの違いをまとめて比較したい場合はClaude Codeの料金体系を解説した記事も参考になる。
ネイティブインストーラーとnpmインストール、どちらを選ぶべきか
Node.js環境をすでに持っていないなら、依存関係を意識せずに済むネイティブインストーラーを選ぶのが無難である。反対に、nvmなどでNode.jsのバージョンをすでに管理している場合や、CI環境に組み込みたい場合はnpmインストールの方が扱いやすい。
判断に迷ったときのために、比較軸をここで一度だけ整理しておく。以降のOS別手順ではこの比較を繰り返さず、コマンドだけを示す。
| 比較軸 | ネイティブインストーラー | npmインストール |
|---|---|---|
| 前提環境 | Node.js不要 | Node.jsのインストールが必要 |
| セットアップの手間 | 少ない(1コマンドで完結) | Node.js管理の知識が前提になる |
| 向いているケース | 個人利用で環境を最小限にしたい人 | 既存のNode.js/nvm運用がある人、CIに組み込みたい人 |
| バージョン管理の柔軟性 | 限定的 | nvmと組み合わせれば細かく制御できる |
多くの個人利用者には、まずネイティブインストーラーで試してみることを勧める。すでに開発環境としてNode.jsを日常的に使っている人は、npmインストールを選んでも手間は変わらない。
Macでのインストール手順
macOSではネイティブインストーラーとnpmインストールのどちらも利用できる。ここでは「ネイティブインストーラーとnpmインストール、どちらを選ぶべきか」で整理した基準に沿って、それぞれのコマンドだけを示す。
ネイティブインストーラーを使う場合は、ターミナルで次を実行する。
curl -fsSL https://claude.ai/install.sh | bashnpmインストールを使う場合は、先にNode.jsを用意する。Homebrewを使っているならbrew install node、複数バージョンを切り替えたいならnvmで導入してから次を実行する。
npm install -g @anthropic-ai/claude-codeインストール後はclaude --versionでバージョンが表示されることを確認し、表示されない場合は「よくあるインストールエラーとその原因」で扱うエラー対処に進む。
Windowsでのインストール手順は
WindowsではPowerShellからネイティブインストーラーを実行するか、npm経由でインストールするかを選ぶ。どちらもコマンド自体はシンプルだが、実行環境によって注意点が異なる。
ネイティブインストーラーはPowerShellで次を実行する。
irm https://claude.ai/install.ps1 | iexnpmインストールを選ぶ場合は、先にWindows版のNode.jsを導入したうえで次を実行する。
npm install -g @anthropic-ai/claude-code社内のセキュリティポリシーでスクリプト実行が制限されている場合は、PowerShellの実行ポリシー設定を管理者やIT部門に確認してから進めるとよい。また、Linux向けの手順やツールに慣れている場合は、WSL(Windows上でLinux環境を動かす仕組み)を使ってLinux側の手順でインストールする選択肢もある。この場合は次の「Linuxでのインストール手順」の内容がそのまま当てはまる。
Linuxでのインストール手順
Linuxでは、Debian/Ubuntu系のディストリビューションであればネイティブインストーラーの標準的な手順がそのまま使える。
curl -fsSL https://claude.ai/install.sh | bashnpmインストールを選ぶ場合は、ディストリビューションのパッケージマネージャ(apt、dnfなど)でNode.jsを用意してから、Mac・Windowsと同じくnpm install -g @anthropic-ai/claude-codeを実行する。
Fedora/RHEL系やAlpine系(dnf/apkを使う環境)での対応状況は、配布方法の更新によって変わる可能性がある。この記事の内容は執筆時点のものであり、該当環境を使っている場合は公式のインストールページに記載されているスクリプトの中身を確認するか、公式ドキュメントで自分のディストリビューションが明示されているかを優先して確認してから進めてほしい。
WSL上でインストールする場合は、Windows側のファイルシステムとWSL側のファイルシステムが別物である点に注意する。認証情報や設定ファイルをWSL内で作成した場合、Windows側のエディタやターミナルから直接参照できないことがある。
初回起動後、最初に何をすればつまずかないか
インストール直後につまずきやすいのは認証まわりなので、まずターミナルでclaudeと入力して起動し、案内に従って認証を完了させることを最優先にするとよい。
認証が終わったら、次の順序で進めると迷いにくい。
claudeコマンドで起動し、初回の案内(テーマ選択や認証フロー)を完了させる- プロジェクトのルートに
CLAUDE.mdを用意する。これはClaude Codeがプロジェクトの前提や作業ルールを読み込むためのファイルで、書き方の詳細はCLAUDE.mdの書き方をまとめた記事に譲る - ファイル操作やコマンド実行の権限設定を一度確認する。細かいルール設計はClaude Codeの運用ルールについての記事で扱っている
- 必要であればVS CodeなどのエディタとClaude Codeを連携させる拡張機能を導入する
日常的な使い方や応用機能まで含めた全体像は、Claude Codeの使い方ガイドにまとめてあるので、インストールが終わった後はそちらに進むとよい。
よくあるインストールエラーとその原因
インストール時のエラーの多くは、PATHの設定漏れ、権限不足、認証情報の未設定、ネットワーク制限のいずれかに分類できる。原因を切り分けてから対処すれば、無駄な再インストールを避けられる。
| エラー | 主な原因 | 対処の方向性 |
|---|---|---|
| command not found | インストール先がPATHに通っていない | シェルの設定ファイル(.zshrcや.bashrcなど)にインストール先を追加し、ターミナルを再起動する |
| Permission denied / EACCES | npmのグローバルインストール先に書き込み権限がない | sudoで無理に実行するとファイルの所有者が混乱し、後のnpm操作でさらにエラーが増えることがある。nvmでNode.jsを導入し直すか、npmのグローバルインストール先を自分の権限で書き込める場所に変更する方法が根本的な解決になりやすい |
| 認証エラー | ログインが未完了、またはAPIキーの設定に誤りがある | claudeを再起動して認証フローをやり直し、対象プランでClaude Codeが利用可能かをあわせて確認する |
| ネットワーク・プロキシ制限下でのエラー | 社内ネットワークでプロキシ経由の通信が必要になっている | 一般的な確認観点としては、プロキシ環境変数(HTTPS_PROXYなど)が正しく設定されているかをまず見る。具体的な対処は環境ごとに異なり、公式ドキュメントに記載がある範囲を超えて言い切ることは難しいため、社内ネットワーク管理者と合わせて確認するのが確実である |
アップデート・アンインストールはどう行うか
アップデートは導入した方式に対応する方法で行い、アンインストールもその逆の手順を踏むのが基本である。ネイティブインストーラーで入れたものはネイティブインストーラー側の、npmで入れたものはnpm側の手順に従う。
npmインストールの場合、アップデートは次のコマンドで行う。
npm update -g @anthropic-ai/claude-codeアンインストールは次のコマンドである。
npm uninstall -g @anthropic-ai/claude-codeネイティブインストーラーで導入した場合は、公式ドキュメントに記載されているアップデート・アンインストールの案内に従う。バージョンによって手順が変わることがあるため、この記事では特定のコマンドを決め打ちで示さず、claudeコマンドのヘルプや公式ページで最新の案内を確認する運用を勧める。
アンインストール後も、設定ファイルや認証情報がホームディレクトリに残る場合がある。残存ファイルの正確な保存場所はOSやインストール方式によって異なることがあるため、完全に削除したい場合は公式ドキュメントで案内されているパスを確認したうえで手動削除するのが安全である。
特定バージョンに固定したい・古いバージョンに戻したい場合は
バージョンを固定したい、あるいは特定のバージョンに戻したい場合は、npmインストールを選んでおくと柔軟に対応できる。
npmでは、次のようにバージョンを指定してインストールし直せる。
npm install -g @anthropic-ai/claude-code@<バージョン番号>nvmでNode.jsのバージョンごと環境を切り替えている場合は、Node.jsのバージョンとClaude Codeのバージョンを組み合わせて管理できるため、チームで環境を揃えたいときにも扱いやすい。
一方、ネイティブインストーラーで導入した場合は、npm運用ほど細かいバージョン指定ができないことがある。厳密なバージョン管理が必要な用途(検証環境の再現性を担保したい場合など)では、最初からnpmインストールを選んでおく方が後々の手間が少ない。
まとめ
ここまでの内容で、OS・利用環境に合わせてインストールを完了し、初回起動と認証を終え、代表的なエラーが起きたときに原因を切り分けられる状態までは到達できるはずである。
個人での利用を超えて、チームや組織単位でClaude Codeを展開しようとすると、ここで扱った内容とは別の論点が出てくる。複数人分のシート管理、SSO(シングルサインオン)連携、社内ネットワークのセキュリティ要件などは、法人・企業としての導入検討に近い話題であり、Claude Codeの企業・法人導入ガイドやClaude Codeのセキュリティ要件をまとめた記事で扱っている。
インストールが終わった読者は、そのままClaude Codeの使い方ガイドで日常的な使い方に進むとよい。チームでの定着や体系的な学習方法を検討し始めている場合は、研修の選び方を整理した記事も参考になる。一人で学び進める場合は、講座つきの月額コミュニティAI駆動ラボ（月額1,980円から）で、この先の使い方をまとめて追える。