主流 AI 开发工具登录问题排障索引

这里是 AI 开发工具登录问题的排查索引。找到你用的工具，直接进入对应文章。

各工具排查入口

通用排查思路：三步快速定位

大多数 AI 工具登录问题都能用这三步快速定位根因，不需要一上来就重装或清缓存：

第一步：先确认代理节点是否正常

这些 AI 工具的服务域名基本都在国内无法直连，代理是前置必要条件。如果登录失败，先做这个测试：

1. 换一个不同的代理节点（换地区或换线路）重试
2. 确认代理是 TUN 模式（全局流量），不是只代理浏览器

• 换节点后成功：原出口 IP 被标记或质量差，换节点即可
• 换节点也失败：问题在账号状态、客户端或系统环境，继续下一步

不要尝试”关闭代理用手机热点测试”——国内宽带和移动数据（4G/5G）同样无法直连这些服务，脱离代理只会看到连接超时，无法排查任何问题。

第二步：用无痕窗口 + 原版 Chrome 测试

把系统默认浏览器临时切换为 Chrome，用无痕窗口重试登录。

• 无痕下成功：问题在浏览器缓存、Cookie 或某个扩展插件
• 无痕下也失败：问题不在浏览器，继续往下排查

第三步：确认账号在产品端是否正常

用同一个账号登录该工具的网页端或控制台（需代理），看账号状态是否正常：套餐是否有效、有没有收到封禁邮件、席位是否分配。

• 网页端也无法访问：账号本身有问题，先解决账号，再排查客户端
• 网页端正常但客户端失败：问题在 OAuth 回调或本地环境

各类报错速查

登录后 IDE 没有反应

这类问题几乎所有工具都会遇到，根因几乎都是 OAuth 回调链路断了：浏览器拿到了授权结果，但没有传回桌面端。

优先检查：

1. 系统默认浏览器是否支持 deep link 回调（换 Chrome 或 Firefox）
2. Linux 系统上 xdg-open 和 URL scheme 是否注册
3. 代理是否只接管了浏览器，没有接管桌面端进程（开启 TUN 模式）

登录成功，但每次重启都要重新登录

这类问题根因是 token 无法持久化，常见于 Linux / WSL2 环境。

优先检查：

1. 密钥环服务是否在运行（gnome-keyring-daemon 或 kwallet）
2. 系统时钟是否准确（时钟偏差导致 token 被判为过期）

代理相关的统一建议

所有工具都面临同一个核心问题：浏览器走了代理，但桌面端 / CLI 进程没走。

最彻底的解决方案是让代理客户端开启 TUN 模式（或全局流量接管），确保所有进程走同一条出口。这对 Cursor、Windsurf、Claude Code 等都适用。

关于文章的判断标准

这一系列文章的信息优先级：官方文档 / 官方支持 > 官方 GitHub Issue > 社区高频 workaround > 个人测试。

社区 workaround（换浏览器、www. 前缀、清密钥环等）标注了来源，它们有效但不保证对所有版本持续有效。版本更新后建议重新验证。