Anthropic APIキー Claude Code CLIツール Node.js npm WSL2 インストール

Claude Codeのインストール手順をOS別に解説

Claude Codeのインストール前に確認すべき動作環境と前提条件

Claude CodeはNode.js上で動作するCLIツールです。インストール前に環境要件とAnthropicアカウントの2点を押さえておけば、後のつまずきは大きく減らせます。特にNode.jsのバージョンとOSの対応状況は必ず事前に確認しましょう。

Node.jsのバージョン要件とnpm・npx環境の確認

Claude Codeの実行にはNode.js 18以降が必要です。まずは現在のバージョンを確認します。

node -v
npm -v

18未満だったり、コマンド自体が見つからない場合は、公式サイトのLTS版を入れるかnvmでバージョンを切り替えてください。古いNode.jsのまま進めると起動時に依存関係のエラーが出て、原因の特定に手間取ります。

公式の推奨環境とAnthropicアカウントの準備

利用にはAnthropicのアカウントが前提です。認証はClaudeのProプランやMaxプランの契約、またはAnthropic Console経由のAPIキーのいずれかで行います。開発案件なら、トークン従量で料金が読みやすいConsoleのAPIキー方式が管理しやすいでしょう。アカウント登録と支払い設定を先に済ませておくと、初回起動から認証までがスムーズに進みます。

OS別のClaude Codeインストール手順

基本はnpmでのグローバルインストールですが、手順はOSで分かれます。macOSとLinuxは素直に入る一方、Windowsは一手間必要なので、それぞれ分けて解説します。

macOS・LinuxでのnpmインストールとパスNaN設定

macOSとLinuxは、次のコマンド一発で導入できます。

npm install -g @anthropic-ai/claude-code

インストール後にclaudeコマンドが見つからないなら、npmのグローバルbinがPATHに含まれていない可能性が高いです。npm bin -gで出力されるパスを.zshrcや.bashrcに追記し、シェルを再読み込みしてください。sudoでの実行は権限問題を招きやすいので避けましょう。

WindowsではWSL2経由でインストールする理由と具体的手順

Claude CodeはWindowsネイティブ環境を正式サポートしておらず、WSL2上のLinux環境が推奨です。ネイティブではパスの扱いやシェル依存の挙動で不具合が起きやすいためです。

PowerShellを管理者権限で開いてwsl --installを実行し、Ubuntuを導入します。あとはそのWSL上でNode.jsを入れ、前述のnpmコマンドでインストールするだけです。プロジェクトも極力WSL側のファイルシステムに置くと、動作が安定します。

インストール後の初回起動と認証・APIキー設定

インストールが終わったら、プロジェクトのディレクトリに移動して起動し、認証を通せば準備完了です。ここまで来れば、実際にClaudeとの対話を始められます。

claudeコマンドでの初回ログインと認証フロー

作業したいディレクトリでclaudeと入力すると、初回はブラウザが開いてAnthropicアカウントでのログインを求められます。認証を許可するとトークンがローカルに保存され、次回以降はログイン状態が自動で引き継がれます。

Console経由のAPIキーを使うなら、環境変数ANTHROPIC_API_KEYにキーを設定する方法もあります。CIやチーム共有の環境では、こちらのほうが扱いやすいでしょう。

インストールで失敗しやすいエラーと対処法

導入時のトラブルはほぼパターンが決まっています。権限とパスという2大原因を理解しておけば、大半は自力で解決できます。

権限エラー・コマンド未検出時のトラブルシューティング

よく遭遇するのは次の2つです。

  • EACCESなどの権限エラー：グローバルインストール先の権限不足が原因。nvmでNode.jsを管理すれば根本的に回避できます。
  • claude: command not found：PATH未設定が原因。前述のグローバルbinパスを通せば解決します。

sudoで無理に通すと権限が混在し、後のアップデートで別のエラーを招きます。極力使わないのが賢明です。

アップデートとアンインストールの正しい手順

Claude Codeは更新が頻繁なので、定期的なアップデートを心がけましょう。インストール同様、npmで管理します。

npm update -g @anthropic-ai/claude-code
npm uninstall -g @anthropic-ai/claude-code

不具合が解消しないときは、一度アンインストールしてから再インストールすると依存関係がクリーンになり、直ることが多いです。認証情報が残っていても、再ログインで上書きできます。