接続・認証エラー

Claude Codeの接続・認証エラーとは｜このカテゴリで分かること

Claude Code の接続・認証エラーは、「Unable to connect to API」「Request timed out」のように API に届かない、または応答が時間内に返らないエラーと、「Login expired」「Invalid API key」のようにサインインの状態が合わないエラーに大きく分かれます。このカテゴリでは、画面に出た文言から原因を絞り込み、公式の手順で直せるように整理します。

対象は、起動した直後にエラーで止まった人、ログインのためのブラウザが開かない人、会社のプロキシや VPN の中で使っている人です。ゴールは、文言とコードから「手元のネットワークの問題か、サインインの問題か」を切り分け、次に何を確認するかが分かることです。障害やサーバー側の問題が疑わしいときの確認は、Claudeの障害確認とAPI Error 5xx｜待つか直すかの判断 と合わせて読んでください。

はじめにおすすめの3本

迷ったら、まずこの3本から読んでください。残りの記事は、このページ下の項目一覧から選べます。

1. 「Unable to connect to API」が出た時の原因と直し方
   接続エラーの代表である「Unable to connect to API」を、curl での確認から順に切り分けます。
2. 「Login expired」「OAuth token expired」の直し方
   「Login expired」「OAuth token has expired」が出たときの意味と、再ログインの手順です。
3. ログインでブラウザが開かない・戻れない時の対処法
   ログインのブラウザが開かない、ログイン後に戻れないときの対処です。

押さえておきたいポイント（リサーチ）

公式ドキュメント（2026年10月に確認）で確認できた、切り分けの土台です。

エラー文言や版による見え方の違いは更新されます。最新は公式で確認してください。

よくある疑問

Q. ブラウザでは Claude が使えるのに、Claude Code だけ繋がりません。
A. ブラウザとターミナルでは、通信の経路や設定が同じとは限りません。まず同じターミナルから curl で確認する方法を 「Unable to connect to API」が出た時の原因と直し方 にまとめています。

Q. 「Request timed out」と出ました。待てば直りますか。
A. この表示が出た時点で、自動の再試行は済んでいます。公式の最初の対処は、もう一度送り直すことです。続く場合の見方は 「Request timed out」「No response from API」の対処法 にあります。

Q. 会社のネットワークで繋がりません。
A. プロキシや TLS 証明書の設定が必要な場合があります。設定の見方は 社内ネットワーク・VPNでClaude Codeが繋がらないとき｜プロキシとCA証明書 を参照してください。

Q. ログインしたはずなのに、認証のエラーが出ます。
A. 環境変数の API キーが優先されている場合があります。原因別の整理は Claude Codeの認証エラー｜Invalid API key・OAuth token revokedの直し方 にあります。