Claude Codeエラーコードのトラブルシューティング

よくある原因： インストール先のディレクトリがPATHに追加されていないか、現在のシェルが設定を再読み込みしていません。

対処法： 新しいターミナルを開くか、Claude CodeのインストールディレクトリをPATHに追加してから、シェルの設定を再読み込みしてください。

export PATH="$PATH:$HOME/.local/bin"
source ~/.zshrc

よくある原因： Nodeのバージョンが公式の要件を下回っているか、WSLがWindows側のNodeを呼び出しています。

対処法： Nodeをアップグレードするか、公式のネイティブインストーラーを使用してください。WSLでは、which node / which npmでパスを確認し、Linux環境のものであることを確かめてください。

node -v
which node
which npm

よくある原因： グローバルのnpmディレクトリの所有者がrootになっているか、以前にsudoでインストールしたことで権限がおかしくなっています。

対処法： Claude Codeをsudoでインストールしないでください。npmのプレフィックスをユーザーディレクトリに変更するか、ネイティブインストーラーを使用してください。

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

よくある原因： ブラウザーのOAuthコールバックがローカルのCLIに届いていません。リモートSSH、devcontainer、厳しいファイアウォール環境、localhostへのコールバックがブロックされている場合によく発生します。

対処法： ブラウザーとCLIが同じマシン上で相互に通信できるか確認してください。必要に応じてログアウトし、Claude Codeを再起動してから、もう一度認証を完了してください。

/logout
# 关闭 Claude Code 后重新运行
claude

よくある原因： 企業のプロキシやセキュリティゲートウェイが自己署名のCAを挿入しており、Nodeはデフォルトではその証明書を信頼しません。

対処法： IT部門に企業のCAバンドルを提供してもらい、NODE_EXTRA_CA_CERTSで指定してください。

export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem

よくある原因： プロキシの環境変数が間違っている、プロキシのプロトコルに対応していない、NO_PROXYが対象ドメインを除外している、または企業のファイアウォールがアクセスをブロックしています。

対処法： Claude Codeは標準のHTTP/HTTPSプロキシ環境変数を使用します。ドキュメントではSOCKSプロキシは非対応とされています。まずHTTPS_PROXYで再テストしてください。

export HTTPS_PROXY=http://proxy.example.com:8080
echo $HTTPS_PROXY
echo $NO_PROXY

よくある原因： 組織でClaude Codeが有効になっていない、企業の許可リストに現在の出口が含まれていない、アカウント / 地域 / ポリシーによる制限がある、またはプロキシが拒否されています。

対処法： 個人アカウントの場合は、まず対応地域とアカウントの状態を確認してください。企業アカウントの場合は、管理者にClaude Codeの権限、SSO、IP許可リスト、ファイアウォールのルールを確認してもらってください。

よくある原因： リクエストの頻度や同時実行数が多すぎるか、アカウントのプランまたは組織がレート制限に達しています。

対処法： 外側の同時実行数を減らし、再試行のループを止めて、制限が解除されるまで待ってください。複数のワーカーでClaude Codeをラップして無理に高速化しないでください。

よくある原因： APIキーが別のシェルで設定されたものである、ConsoleのキーとOAuthセッションが競合している、または組織がSSOログインを必須にしています。

対処法： 現在のシェルでANTHROPIC_API_KEYが設定されているか確認してください。企業アカウントでは、管理者が指定するConsole/SSOのログイン手順に従ってください。

echo $ANTHROPIC_API_KEY