Claude Codeのインストール：Nativeとnpmの選択、PATH修復、初回起動

Claude Codeのネイティブインストール（Native Install）では、Node.jsのランタイム環境は一切不要です。現在、npmインストーラーはNode.js 22以上を必要としますが、インストールされるバイナリ自体はNodeランタイムから完全に独立して動作します。Anthropicの公式ドキュメントでは、Native Installの利用が明示的に推奨されています（詳細はインストールガイドを参照）。ターミナルでコーディングエージェントを利用するには、インストール方法を選択し、対応するシェルで適切なコマンドを実行し、実行可能ファイルがOSに正しく認識されていることを確認する必要があります。コマンド呼び出しエラーが発生した際には、スタンドアロンのネイティブ配布とパッケージマネージャーによるインストールの違いを正しく見極めることが、根本原因を特定する鍵となります。

Nativeとnpm：アーキテクチャの境界とNode.jsの役割

Anthropicの公式ドキュメントでは、Native Installが推奨されています（インストールガイド）。この構成ではNode.jsランタイムは不要です。インストーラーがコンパイル済みのスタンドアロンバイナリをダウンロードし、実行中もNodeと通信することは一切ありません。

グローバルなnpmパッケージを介したインストールも、引き続き利用可能な代替手段です。現在、npmインストーラーにはNode.js 22以上が必要です。それ以前のバージョンのNode.jsでインストールを実行すると、npmはEBADENGINE警告を出力しますが、処理自体は通常完了します。パッケージはプラットフォーム固有の事前コンパイル済みバイナリを取得し、そこへのシンボリックリンクを作成します。インストールされたClaude Codeバイナリは、実行時にNode.js内部で動作するわけではありません。

したがって、「Claude Codeの実行には常にNode.jsが必要である」という主張は技術的に誤りです。Node.jsのバージョン確認が必要となるのは、意図的にnpm経由でのインストールを選択した場合のみです。

サポート対象OS向けのインストールコマンド

適切な環境構築を行うため、お使いのOSおよびシェル環境に対応した公式スクリプトを実行してください。

macOS、Linux、WSL（Bash / Zsh）

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows コマンドプロンプト（CMD）

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

npmによる代替インストール

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

重要： このコマンドを sudo npm install -g で実行しないでください。スーパーユーザー権限でパッケージをインストールすると、ホームディレクトリ内のファイル権限に不整合が生じ、セキュリティリスクを招く原因になります。

Windowsネイティブ環境では、Git for Windowsの導入は任意（オプショナル）となりました。Git for Windowsが存在する場合、エージェントはGit Bashを介してBashコマンドを実行できます。インストールされていない場合、Claude Codeは組み込みのPowerShellツールへとフォールバックします。

インストールの動作確認

スクリプトの実行が完了したら、現在の環境でバイナリが正しく認識されているか確認します。

claude --version

バージョン情報が正しく出力されれば、バイナリがダウンロード・展開され、環境に登録されたことが確認できます。ただし、バージョンの正常な表示はバイナリ自体の稼働を確認したにすぎず、クライアントが認証済みであることや、モデルへのリクエスト実行が可能であることを意味するわけではない点に注意してください。

環境全体の詳細な監査を行うには、次の診断コマンドを実行します。

claude doctor

claude doctor コマンドはローカル環境のセットアップを監査します。対話型のコーディングセッションを開始することなく、設定ファイルの状態、ファイルシステムのパーミッション、システムの依存関係をチェックし、構成上の潜在的な問題を検出します。

トラブルシューティング：`command not found` エラーの解決

ターミナルで claude コマンドが見つからないと報告された場合（またはWindowsで内部コマンドまたは外部コマンドとして認識されない旨のメッセージが表示された場合）、次の診断フローに沿って順に対処してください。

[Ошибка вызова: claude не найден]
         │
         ▼
[Шаг 1: Открыть новый сеанс терминала]
         │
    Помогло? ──Да──> Завершено
         │ Нет
         ▼
[Шаг 2: Проверить физическое наличие бинарного файла на диске]
         │
    Файл найден? ──Нет──> Ошибка загрузки/прав; повторить установку
         │ Да
         ▼
[Шаг 3: Проверить тип установки и PATH]
         │
 ┌───────┴────────────────────────┐
 ▼                                ▼
[Native Install]                [npm Install]
Проверить PATH:                 Проверить PATH через npm prefix -g:
- Unix: ~/.local/bin            - Unix: <prefix>/bin
- Win: %USERPROFILE%\.local\bin - Win: <prefix>
(Не переустанавливать только из-за PATH)

上記のディシジョンツリーは、診断の進め方をフローチャートとして整理したものです。各ステップのロシア語表記の日本語対訳と内容は以下のとおりです：

起点（エラー発生）： [Ошибка вызова: claude не найден]（呼び出しエラー：claudeが見つからない）
ステップ1： [Шаг 1: Открыть новый сеанс терминала]（ステップ1：新しいターミナルセッションを開く）。問題が解決したか（Помогло? ──Да──> Завершено / 解決した？──はい──> 完了）を確認します。解決しなかった場合（Нет / いいえ）はステップ2へ進みます。
ステップ2： [Шаг 2: Проверить физическое наличие бинарного файла на диске]（ステップ2：ディスク上にバイナリファイルが物理的に存在するか確認する）。ファイルが見つからない場合（Файл найден? ──Нет──> Ошибка загрузки/прав; повторить установку / ファイルあり？──いいえ──> ダウンロードまたは権限のエラー、再インストールを実行）、スクリプトを再実行します。存在する場合（Да / はい）はステップ3へ進みます。
ステップ3： [Шаг 3: Проверить тип установки и PATH]（ステップ3：インストールの種類とPATHを確認する）：
- Native Install の場合：PATHを確認（Проверить PATH:）。Unix系は ~/.local/bin、Windowsは %USERPROFILE%\.local\bin。
- npm Install の場合：npm prefix -g を通じてPATHを確認（Проверить PATH через npm prefix -g:）。Unix系は <prefix>/bin、Windowsは <prefix>。
- 下部の注記：(Не переустанавливать только из-за PATH)（PATHの問題だけで安易に再インストールしないこと）。

1. 新しいターミナルセッションを開く

インストールスクリプトは、シェルの設定ファイル（.bashrc、.zshrc）やWindowsのユーザー環境変数を変更します。すでに開いているターミナルウィンドウでは、これらの変更が即座に反映されません。現在のターミナルセッションを完全に閉じ、新しいウィンドウを開いてください。

2. バイナリの物理パスを確認する

Native Installの場合、実行ファイルはカスタム環境変数によるオーバーライドがない限り、以下のデフォルトディレクトリに配置されます：

macOS、Linux、WSL：~/.local/bin/claude（バージョン管理されたパッケージ本体は ~/.local/share/claude に保存されます）
Windows：%USERPROFILE%\.local\bin\claude.exe

これらのパスは標準のデフォルト値であり、ユーザーによる環境設定の変更がある場合は固定ではありません。指定ディレクトリにファイルが存在しない場合は、ネットワークの切断や書き込み権限の不足により、インストール処理が異常終了した可能性があります。

3. シェルの診断コマンドを実行する

シェルが実行可能ファイルを認識しているか、またどのように解決しているかを調べるには、各OS標準のコマンドを使用します：

Zsh / Bash：command -v claude または type -a claude を実行します。
PowerShell：Get-Command claude および where.exe claude を実行します。
CMD：where claude を実行します。

4. NativeとnpmでPATH解決を明確に区別する

よくあるトラブルシューティングの誤りは、Native Installの不具合を解消しようとしてNode.jsのパスを調整してしまうことです。

Native Install を使用した場合、Node.jsのパスや npm prefix -g は一切関係ありません。確認して PATH に追加すべきなのは、Unix系システムでは ~/.local/bin、Windowsでは %USERPROFILE%\.local\bin です。
npm install -g でインストールした場合、グローバル実行ファイルの配置ディレクトリは npm prefix -g によって決定されます：
- Unix系システム（macOS、Linux、WSL）では、実行ファイルは <prefix>/bin に配置されます。
- Windowsでは、実行ファイルは <prefix> のルート直下に配置されます。なお、npm bin -g や npm root -g などのコマンドは、正しい実行ファイルのパスを示しません。

ディスク上にバイナリが存在するにもかかわらずコマンドが見つからない場合は、まずPATHとシェルの名前解決を調査してください。バイナリのフルパスを直接指定して実行しても失敗する場合は、表示された正確なエラーメッセージを確認し、公式のトラブルシューティングガイドを参照してください。パーミッション、プラットフォームとのバイナリ互換性、または不完全なダウンロードが原因である可能性があります。command not found エラーが出たからといって、原因を切り分けずにやみくもに再インストールを繰り返すのは避けてください。

初回起動と安全な操作手順

コマンドが正常に認識されたら、小さなテスト用プロジェクトのディレクトリに移動してセッションを開始します。

cd /path/to/test-project
claude

初回起動時には、ブラウザを介した標準的な認証プロセスを完了するよう求められます。アクティブなセッション内では、/status コマンドを実行して、現在の作業ディレクトリ、アカウント識別子、および設定されているモデルを確認できます。

最初の動作確認として、破壊的な変更を行わない以下の導入プロンプトを実行してみてください。

Объясни назначение основных файлов в проекте. Не изменяй файлы, не устанавливай зависимости и не выполняй команды в терминале.

(テスト用プロンプトの日本語訳：「プロジェクト内の主要なファイルの役割を説明してください。ファイルの変更、依存関係のインストール、ターミナルでのコマンド実行は行わないでください。」)

期待される動作として、エージェントはコードのdiffを生成したりファイルシステムを変更したりすることなく、主要なファイルをリストアップしてその役割を説明します。処理が完了したら、別のシェルウィンドウで git diff を実行し、リポジトリに変更が一切加えられていないことを確認してください。

ここで理解しておくべき重要な点は、プロンプトによる指示はモデルに対する自然言語でのガイダンスにすぎず、強制力のある実行モード（enforced mode）やOSレベルのサンドボックスではないということです。リポジトリに対する自動ファイル編集を確実に制限したい場合は、planモードを使用してください。

claude --permission-mode plan

plan モードでは、エージェントはデフォルトでファイルの読み取りと読み取り専用のシェルコマンド実行のみを行い、ソースコードの編集は行いません。ただし、このモードもOSレベルで完全に隔離されたサンドボックスではありません。自動実行が許可されている場合、分類器（classifier）によって承認されたコマンドが実行される可能性があります（厳格なシステムレベルの隔離があると過信しないでください。2026年9月15日時点の公式ドキュメントで確認されています）。

アクションの承認ポリシーに関する詳細な仕様は、権限ガイドを参照してください。対話型セッションを終了するには、Ctrl+D を入力します。

独立したAPIプロバイダーの接続

CLIクライアントのインストールと、その後のモデルプロバイダーの設定は、独立した2つの運用ステップです。標準のアカウント認証の代わりに、サードパーティのAnthropic互換ゲートウェイを利用する場合は、CLIのローカル動作を確認した後に別途接続設定を行います。

具体例として、独立系APIプロバイダーであるBetterTokenは、開発者向けに専用のAPI Keyを提供しており、モデルへのリクエスト統計、トークン消費量、課金状況をダッシュボード上で一元管理できます。必要な環境変数のエクスポート方法やAPIベースアドレスの設定手順については、Claude Codeに関するBetterToken公式ドキュメントで詳しく解説されています。ローカルバイナリ自体のダウンロード、アップデート、実行は、本ガイドで解説した標準CLIの仕組みをそのまま利用します。