Cursor 连接 GitHub 授权一直转圈通常是本地网络无法完成 OAuth 回调导致的，适合所有操作系统用户排查。修改系统代理设置可能影响其他软件联网，操作前请记录原始配置。

快速处理思路

图形界面操作为主，重点检查网络通路和认证方式，无需复杂命令。

为什么会这样

OAuth 授权流程需要浏览器与 Cursor 客户端之间完成回调通信，网络阻断会导致握手失败。

Cursor 点击登录后会唤起默认浏览器访问 GitHub 授权页，授权成功后浏览器需将结果回传给 Cursor 本地监听端口。如果本地防火墙、代理软件或网络环境阻断了 localhost 回调或 GitHub API 请求，客户端收不到回调信号，就会一直显示加载中。此外，浏览器缓存的旧授权信息也可能导致跳转循环。

分步处理

按顺序执行以下步骤，每步完成后尝试重新登录。

步骤 1：检查网络代理配置

打开系统网络设置，查看是否开启了全局代理。如果开启了代理，尝试暂时关闭代理或使用直连模式再次点击登录。部分代理软件会拦截本地回环地址，需在代理软件设置中将 localhost 或 127.0.0.1 加入白名单。

步骤 2：改用 Personal Access Token 登录

如果 OAuth 跳转持续失败，可绕过浏览器回调流程。访问 GitHub 官网开发者设置页面，生成一个新的 Personal Access Token，权限勾选 repo 和 user 范围。在 Cursor 登录界面选择使用 Token 登录选项，将生成的字符串粘贴进去。

步骤 3：清除客户端缓存

关闭 Cursor，找到本地配置目录。Windows 系统通常位于 %APPDATA%\Cursor，macOS 位于 ~/Library/Application Support/Cursor。删除 Storage 或 Cache 文件夹后重启 Cursor。注意备份关键配置后再执行删除操作。

怎么验证是否生效

打开 Cursor 设置页面，进入 Account 或 User 选项卡，查看是否显示 GitHub 用户名且状态为已登录。尝试点击同步设置按钮，如果能成功拉取云端配置且无报错提示，说明授权连接已恢复正常。

常见坑

1. 代理软件规则冲突：某些代理规则会误伤本地回调请求，导致授权成功但客户端无感知。

2. Token 权限不足：手动填写 Token 时如果未勾选 repo 权限，可能导致后续代码同步功能不可用。

3. 多账号缓存干扰：浏览器中登录了多个 GitHub 账号，可能导致授权回调到错误的账号身份。

常见问题

OAuth 一直转圈能强制刷新吗？

不能直接刷新登录框，需关闭登录弹窗后重新点击登录按钮触发新会话。

使用 Token 登录和 OAuth 有什么区别？

Token 登录跳过浏览器回调环节，更适合网络环境复杂的场景，但需手动管理权限。

重装 Cursor 能解决授权问题吗？

仅重装软件通常无效，因为配置缓存保留在用户目录下，需同时清除配置文件夹。