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 -fsSL https://claude.ai/install.sh | bash）を使用するか、npm config set prefix ~/.npm-globalでnpmのプレフィックスを修正し、そのbinディレクトリをPATHに追加してください。

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

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

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://proxy.example.com:portでプロキシを設定してから、インストーラーを再実行してください。それが不可能な場合は、ITチームにオフラインパッケージを依頼してください。

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

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

7. /loginがブラウザを開きますが、ターミナルが終了しません（"Waiting for authentication…"）。

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

8. `ANTHROPIC_API_KEY`を設定したのに"Not authenticated"と表示される。

3つの一般的な原因があります：キーが別のシェルでエクスポートされた（echo $ANTHROPIC_API_KEYで確認）、Claude Codeがこのキーを信頼するように指示されていない（初回使用時に1回プロンプトが表示されます。承認するまで、ANTHROPIC_API_KEYはOAuthセッションより優先されます。その承認後のみ）、またはキーはConsoleキーですが、組織がSSO loginを要求しています。

9. Bedrock / Vertex: "Could not load credentials."

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

10. インストールと認証は完了しましたが、すべてのリクエストが403 / "model not available."エラーで失敗します。

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