跳到正文

Claude Code 登录回调失败:代理下的排查

代理下登录失败,多数是 SOCKS 代理不被支持、浏览器开在另一台机器上,或残留了 API Key;粘贴代码的办法在这几种情况下都能完成登录。

最常见的三个原因

最常见的三个原因
项目表现解决办法
SOCKS5 代理,或代理地址没写 http://启动报错并点名代理变量,或登录一直连不上改用 HTTP 代理,写完整地址 http://LOGIN:PASSWORD@HOST:PORT
浏览器在另一台机器上(WSL2、SSH、容器)浏览器登录后显示 localhost 地址的连接错误用终端打印的登录链接登录,把代码粘贴到「Paste code here」处
残留的 ANTHROPIC_API_KEY登录成功后仍报「This organization has been disabled」或 403unset ANTHROPIC_API_KEY,从 shell 配置里删掉,用 /status 确认

来源:Claude Code 官方文档(排障、认证、网络配置三页),2026 年 11 月 19 日读取。

正常的登录流程

首次启动时 Claude Code 会打开浏览器窗口。登录后,浏览器要么跳回命令行,要么显示一个登录代码。显示代码时,把它粘贴到「Paste code here if prompted」处,终端最后显示「Login successful」。

浏览器没打开时,按 c 复制登录链接,自己在浏览器里打开。终端很窄或在 SSH 里链接被折行点不了时,同样适用。

你导出的代理变量是 Claude Code 启动时读取的。浏览器有它自己的代理设置,所以浏览器能正常用,并不能说明 Claude Code 的流量走的是你以为的那条路。

按顺序检查

  1. 第 1 步

    重置登录:输入 /logout,关闭 Claude Code,再运行 claude。浏览器没打开就按 c,自己打开链接。

    预期结果 终端显示「Login successful」,提示按 Enter 继续。

  2. 第 2 步

    浏览器显示 localhost 错误或一个代码时,走粘贴代码的办法:复制链接,在你自己的电脑上登录,把代码粘贴到「Paste code here」处。粘贴没反应时,换终端的另一个粘贴快捷键,或直接运行 claude auth login。

    继续前请注意 看到「OAuth error: Invalid code」说明代码过期或复制时被截断,按 Enter 重来,浏览器打开后尽快完成。

  3. 第 3 步

    检查代理类型和地址:Claude Code 不支持 SOCKS,地址要带 http://。启动 Claude Code,运行 /status,看 Proxy 一行;它会把无法解析的值标成无效。

  4. 第 4 步

    查有没有残留的 Key:运行 unset ANTHROPIC_API_KEY,把 ~/.zshrc、~/.bashrc 或 ~/.profile 里的 export 行删掉,再用 /status 确认当前的登录方式。

  5. 第 5 步

    读日志:用 claude --debug 启动,打开 ~/.claude/debug/ 里最新的文件,看是哪个域名或端口失败。

Claude Code 的代理变量

# set before launching Claude Code; it reads them once at startup
export HTTPS_PROXY="http://LOGIN:PASSWORD@HOST:PORT"
export HTTP_PROXY="http://LOGIN:PASSWORD@HOST:PORT"
export NO_PROXY="localhost,127.0.0.1"

# sign in, then check the Proxy row
claude
# inside Claude Code: /status

# fallback when the browser cannot return to localhost
claude auth login

# check what exit IP the proxy gives (outside Claude Code)
curl -x "http://LOGIN:PASSWORD@HOST:PORT" https://ipinfo.io/json

仅为示例:把占位符换成你自己的值。NO_PROXY 里写 localhost 只是无害的预防,文档并没有把它列为回调问题的解法。

要放行的域名与出口国家

登录需要放行 claude.ai 和 platform.claude.com(OAuth 令牌交换走后者);登录时会打开一个 claude.com 页面再跳转到 claude.ai;使用 SSO 的组织还要放行 sso.claude.com;模型流量走 api.anthropic.com。如果你和代理之间的过滤规则拦了其中一个,即使代理本身没问题,登录也会失败。

出口 IP 所在的国家同样重要。Anthropic 公布了它支持的国家名单,文档里说安装域名返回 403 通常是代理或过滤器造成的,或者所在地区不受支持。先用上面的 curl 看一眼出口,再动别的。

常见现象

批准后浏览器说连不上 localhost

检查 你是不是在 WSL2、SSH 或容器里,浏览器和 Claude Code 不在同一台机器上?

处理 在你自己的电脑上打开终端打印的登录链接,把代码粘贴到「Paste code here」处,或运行 claude auth login。

停止条件 一旦提示「Login successful」,就不要再改代理设置了。

不走代理能登录,走代理就不行

检查 运行 /status 看 Proxy 一行;检查协议头,以及代理是 HTTP 而不是 SOCKS5。

处理 换成 HTTP 代理并写完整地址,重启 Claude Code——变量只在启动时读取。

停止条件 如果 /status 显示的代理正确,日志仍卡在某个域名,请让管理过滤规则的人放行上一节列的域名。

登录后立刻 403,或提示 organization has been disabled

检查 shell 配置里是否设了 ANTHROPIC_API_KEY,订阅是否有效?

处理 unset ANTHROPIC_API_KEY,从配置文件里删掉,用 /status 确认。

停止条件 订阅本身失效的话,换代理解决不了。

用 Proxy302 配一个固定的 HTTP 出口

  1. 第 1 步

    打开静态住宅代理页,选你工作所在、且 Claude 支持的国家,协议选 HTTP。1 天租期 US$0.50,30 天 US$7.99;没有免费试用。

  2. 第 2 步

    进入「我的资产」,复制主机、端口、用户名和密码。HTTP 用 2222 端口。

  3. 第 3 步

    把 HTTPS_PROXY 和 HTTP_PROXY 导出为 http://用户名:密码@主机:端口,启动 claude,运行 /status,再用上面的 curl 检查出口。

常见问题

Claude Code 能用 SOCKS5 代理吗?

不能。网络配置页写明 Claude Code 不支持 SOCKS 代理,请用 HTTP 或 HTTPS 代理。

登录后浏览器没法跳回 localhost 怎么办?

用终端显示的链接登录,把浏览器显示的代码粘贴到「Paste code here」处。claude auth login 也能读取这个代码。

为什么改了代理 Claude Code 没反应?

它只在启动时读取一次代理变量,改完要重启。/status 会显示它当前用的代理。

代理会改变我的 Claude 订阅权限吗?

不会。它只改变网络路径,套餐额度和账号规则不变。

延伸阅读

Proxy302 在 GitHub 上公开的同主题配置指南:

参考资料

5
  1. Claude Code 文档:Troubleshoot installation and login(英文)

    官方文档 · 确认日期:

    2026 年 11 月 19 日读取。登录部分列出:重置登录(/logout、关闭、重新运行 claude);浏览器没打开时按 c 复制登录链接;「OAuth error: Invalid code. Please make sure the full code was copied」;登录后出现 403 Forbidden(检查订阅和代理);残留的 ANTHROPIC_API_KEY 导致「This organization has been disabled」;WSL2、SSH、容器里通过终端打印的登录链接登录,并在「Paste code here」提示处粘贴代码,或运行 claude auth login。下载域名返回 403,文档写的是通常由代理或过滤器造成,或者所在地区不受支持。

  2. Claude Code 文档:Authentication(英文)

    官方文档 · 确认日期:

    2026 年 11 月 19 日读取。首次启动时 Claude Code 会打开浏览器登录;浏览器没打开就按 c 复制登录链接;浏览器显示登录代码而不是跳回时,把代码粘贴到「Paste code here if prompted」处;成功后显示「Login successful」;/logout 退出登录;设置了 ANTHROPIC_API_KEY 并确认使用后,会用它代替订阅登录,unset 后回到订阅;/status 显示当前用的是哪种方式。

  3. Claude Code 文档:Enterprise network configuration(英文)

    官方文档 · 确认日期:

    2026 年 11 月 19 日读取。Claude Code 读取 HTTPS_PROXY、HTTP_PROXY(小写同样有效)和 NO_PROXY,要在启动前设好,只在启动时读取一次;账号密码写进代理地址:http://username:password@host:port;原文写明「Claude Code does not support SOCKS proxies」;代理地址缺少协议头可能让启动报错并点名变量;/status 有 Proxy 一行,claude --debug 会把日志写到 ~/.claude/debug/;需要放行的域名包括 api.anthropic.com、claude.ai、claude.com、platform.claude.com(OAuth 令牌交换也走它)以及 SSO 用的 sso.claude.com。

  4. Anthropic 支持的国家和地区(英文)

    官方文档 · 确认日期:

    2026 年 11 月 19 日读取:页面列出 Anthropic 能提供访问的国家、地区和领土(乌克兰不含克里米亚、顿涅茨克和卢甘斯克)。

  5. Proxy302 产品事实与价格表

    产品观察 · 确认日期:

    站点的产品事实表(数值已于 2026 年 10 月 18-19 日对照控制台、后端和价格表核对):产品、美元价格(1 PTC = 1 美元)、租期、协议与端口、国家数、数量上限、没有免费试用。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。