Claude Codeのインストールと認証のトラブルシューティング

これら10の問題は、Claude Codeに関連するインストールと認証のサポートチケットの大多数を占めています。各項目には最も信頼性の高い解決方法が含まれています。

1. claude: command not foundインストール直後に表示される。

インストーラーがclaudeをPATHに追加しましたが、現在のシェルがまだそれを認識していません。新しいターミナルを開くか、source ~/.zshrc（または~/.bashrc）を実行してください。Windowsの場合は、PowerShellを閉じて再度開いてください。

2. npm installが`EACCES` / パーミッション拒否エラーで失敗する。

これは通常、インストールがsudoで実行されたか、グローバルnpmディレクトリがrootによって所有されていることを意味します。sudoを使用しないでください。代わりに、curlインストーラーを使用するか、npm config set prefix ~/.npm-globalでnpmのプレフィックスを修正し、そのbinディレクトリをPATHに追加してください。

3. 「Node version not supported」またはlaunch時のサイレントクラッシュ。

Claude CodeはNode 18以降が必要です。node -vでバージョンを確認してください。古い場合は、nvm install --ltsで現在のバージョンをインストールするか、curlインストーラーを使用してください。curlインストーラーは独自のランタイムをバンドルしており、この問題を完全に回避できます。

4. WSL: claudeがLinux NodeではなくWindows Nodeを実行する。

Windows PATHがWSLに漏れてnvmをオーバーライドします。~/.bashrcでLinux nodeをPATHの先頭に追加してください：export PATH="$HOME/.nvm/versions/node/$(nvm current)/bin:$PATH"

5. インストーラーが企業ネットワークの背後でハングまたは失敗する。

ダウンロードホスト（storage.googleapis.com）がブロックされている可能性があります。まずプロキシをexport HTTPS_PROXY=http://your-proxy:portで設定してから、インストーラーを再実行してください。それが不可能な場合は、ITチームにオフラインパッケージを依頼してください。

6. SELF_SIGNED_CERT_IN_CHAINまたはその他のTLSエラー。

会社が独自の証明書を挿入しています。Nodeを企業CAバンドルに指定してください：export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pemシェルプロファイルに追加して永続化してください。

7. /loginがブラウザを開きますが、ターミナルが終了しません（「認証を待機中…」）。

これは通常、localhostコールバックがブロックされていることを意味します。これはリモートSSH、devcontainers、または厳密なファイアウォールの背後で一般的です。代わりに手動フローを使用してください：ターミナルに出力されたURLをコピーし、任意のブラウザでログインを完了してから、返されたコードをターミナルに貼り付けてください。

8. `ANTHROPIC_API_KEY`を設定したにもかかわらず「認証されていません」。

3つの一般的な原因があります：キーが別のシェルでエクスポートされた（echo $ANTHROPIC_API_KEYで確認）、以前に/loginを実行してOAuthセッションが優先されている（最初に/logoutを実行）、またはキーはConsoleキーですが組織がSSO loginを要求しています。

9. Bedrock / Vertex: 「認証情報を読み込めませんでした。」

Claude Codeは標準プロバイダーSDKを使用するため、修正はAWS/GCP CLIツールと同じです。Bedrockの場合、aws sts get-caller-identityが機能し、AWS_REGIONがモデルが有効になっているリージョンに設定されていることを確認してください。Vertexの場合、gcloud auth application-default loginが実行され、GOOGLE_CLOUD_PROJECTが設定されていることを確認してください。

10. インストールと認証は完了しましたが、すべてのリクエストが403 / 「モデルが利用できません」エラーになります。

アカウントは存在しますが、Claude Codeが要求しているモデルへのアクセス権がありません。Enterpriseシートの場合、シートが組織の管理者設定でアクティブになっていることを確認してください。BedrockまたはVertexの場合、特定のClaudeモデルがそのリージョンまたはプロジェクトで有効になっていることを確認してください。クイックワークアラウンドとして、/modelを実行し、アクセス権があることがわかっているモデルを選択してください。