0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Claude Code】ブラウザ認証でlocalhostエラーになったときの対処法

0
Last updated at Posted at 2026-07-03

はじめに

Claude Codeのサインイン時に、メールに届いたリンクをクリックしたら「このサイトにアクセスできません(localhost で接続が拒否されました)」というエラーが出て困った経験はありませんか?

本記事では、なぜそのエラーが起きるのかと、手動コードで認証を完了させる方法を解説します。


そもそもなぜlocalhostが出てくるのか

Claude Codeのサインインには、OAuthというしくみが使われています。以下の図のような流れです。

OAuth認証フロー図

流れをざっくり説明すると:

  1. Claude Codeが localhost上に小さな待ち受けサーバーを起動する(例: localhost:54321
  2. ブラウザでclaude.aiにログイン・許可する
  3. Anthropicのサーバーがブラウザに「localhost:54321/callback?code=XXXX へ移動せよ」と指示を返す
  4. ブラウザ自身が同じPC内のlocalhost:54321にアクセスし、URLに含まれる認証コードをClaude Codeに届ける
  5. 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では、新たなメンバーを募集しています。
日本一のアウトプットコミュニティでキャリアアップしませんか?
興味のある方は、ぜひホームページをのぞいてみてください!
▼▼▼

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?