はじめに
Claude Codeのサインイン時に、メールに届いたリンクをクリックしたら「このサイトにアクセスできません(localhost で接続が拒否されました)」というエラーが出て困った経験はありませんか?
本記事では、なぜそのエラーが起きるのかと、手動コードで認証を完了させる方法を解説します。
そもそもなぜlocalhostが出てくるのか
Claude Codeのサインインには、OAuthというしくみが使われています。以下の図のような流れです。
流れをざっくり説明すると:
- Claude Codeが localhost上に小さな待ち受けサーバーを起動する(例:
localhost:54321) - ブラウザでclaude.aiにログイン・許可する
- Anthropicのサーバーがブラウザに「
localhost:54321/callback?code=XXXXへ移動せよ」と指示を返す - ブラウザ自身が同じPC内のlocalhost:54321にアクセスし、URLに含まれる認証コードをClaude Codeに届ける
- Claude CodeがそのコードでAnthropicのAPIにアクセストークンを取得し、
~/.claude/に保存する
ポイントは「Anthropicのサーバーが直接localhostに接続してくるわけではない」という点です。ブラウザが橋渡し役になっています。
なぜエラーが起きたのか
今回の失敗はステップ4で発生しました。
メールに届いたリンクをクリックするまでに時間がかかり、その間にステップ1で起動した待ち受けサーバーがタイムアウトして終了してしまいました。
リンクをクリックした時点では、接続先のlocalhost:54321にもう誰もいない状態だったため、「接続が拒否されました」というエラーになりました。
このサイトにアクセスできません
localhost で接続が拒否されました。
ERR_CONNECTION_REFUSED
解決方法:手動コードで認証する
ブラウザが自動で開かなかったり、localhostへのリダイレクトが失敗する場合は、手動フローで認証を完了させることができます。
ステップ1:ターミナルで claude login を実行する
claude login
以下のような選択肢が表示されます。「1」を選択してください。
Select login method:
> 1. Claude account with subscription · Pro, Max, Team, or Enterprise
2. Anthropic Console account · API usage billing
3. 3rd-party platform · Amazon Bedrock, Microsoft Foundry, or Vertex AI
ステップ2:表示されたURLをコピーする
ブラウザが自動で開かない場合、以下のような画面が表示されます。
Browser didn't open? Use the url below to sign in (c to copy)
https://claude.com/cai/oauth/authorize?code=true&client_id=...
Paste code here if prompted >
c キーを押すとURLがクリップボードにコピーされます。
ステップ3:ブラウザで手動ログインする
コピーしたURLをブラウザのアドレスバーに貼り付けてEnterを押します。
claude.aiのログイン画面が表示されるので、サインインして許可します。
ログインが完了すると、localhostへリダイレクトする代わりに、画面にコードが表示されます。
ステップ4:コードをターミナルに貼り付ける
表示されたコードをコピーし、ターミナルの以下のプロンプトに貼り付けてEnterを押します。
Paste code here if prompted >
これで認証完了です。
ステップ5:認証を確認する
claude /status
Auth method: Claude AI と表示されれば成功です。
まとめ
| 項目 | 内容 |
|---|---|
| エラーの原因 | メール認証を待っている間に、localhost待ち受けサーバーがタイムアウトした |
| なぜlocalhostが出てくるのか | ブラウザがOAuth認証コードをClaude Codeに届けるための中継地点として使われるため |
| 解決策 |
claude login → URLを手動でブラウザに貼り付け → 表示されたコードをターミナルに貼り付け |
localhostへのリダイレクトが失敗しても、コードの手動貼り付けという代替手段があるので安心してください。
JISOUのメンバー募集中!
プログラミングコーチングJISOUでは、新たなメンバーを募集しています。
日本一のアウトプットコミュニティでキャリアアップしませんか?
興味のある方は、ぜひホームページをのぞいてみてください!
▼▼▼
