一、项目简介
项目背景
Cursor AI 是一款强大的 AI 开发工具,但其免费试用版本存在请求限制,例如 “达到试用请求限制” 或 “本机使用的免费试用账户过多” 等问题,导致用户无法持续体验 Pro 功能。cursor-free-vip
项目旨在通过技术手段解决这些限制,帮助用户免费使用 Cursor Pro 功能,支持 Windows、macOS 和 Linux 多平台,适用于学习和研究场景。
核心优势
- 重置机器 ID:解决 “Too many free trial accounts used on this machine” 问题,突破单机器试用账户限制。
- 绕过令牌限制:解除 “You've reached your trial request limit” 限制,提升 API 调用额度。
- 多语言支持:支持英文、简体中文、繁体中文、越南语,适配不同用户习惯。
- 合法合规:仅用于学习研究,不生成虚假邮箱或 OAuth 访问,遵守软件使用条款。
二、核心功能详解
功能模块 | 功能说明 |
---|---|
机器 ID 重置 | 自动清除 Cursor 存储的机器标识,绕过 “本机试用账户过多” 限制,支持手动 / 自动两种重置模式。 |
令牌限制绕过 | 提升 API 调用配额,突破免费版请求次数限制,支持自定义令牌刷新策略。 |
版本检查绕过 | 强制使用指定版本的 Cursor,避免因自动更新导致的兼容性问题。 |
自动更新禁用 | 阻止 Cursor 自动升级,确保工具稳定性,支持一键恢复默认更新设置。 |
多平台适配 | 支持 Windows、macOS、Linux(包括 x86、ARM64 架构),提供统一的脚本化安装流程。 |
三、安装步骤(附全平台脚本)
准备工作
- 关闭所有 Cursor 进程(包括后台服务)。
- 使用管理员权限运行脚本(Windows 需右键 “以管理员身份运行”,Linux/macOS 需
sudo
)。
自动化安装(推荐)
Windows
powershell
irm https://raw.githubusercontent.com/yeongpin/cursor-free-vip/main/scripts/install.ps1 | iex
macOS/Linux
curl -fsSL https://raw.githubusercontent.com/yeongpin/cursor-free-vip/main/scripts/install.sh -o install.sh && chmod +x install.sh && ./install.sh
ArchLinux(AUR)
yay -S cursor-free-vip-git
手动安装(适用于高级用户)
- 克隆项目:
git clone https://github.com/yeongpin/cursor-free-vip.git
- 进入目录:
cd cursor-free-vip
- 安装依赖:
pip install -r requirements.txt
(需提前安装 Python 3.8+)
四、使用指南:核心功能操作步骤
启动工具
- Windows:双击
main.exe
(或通过命令行python main.py
) - macOS/Linux:终端运行
python3 main.py
主界面功能选项
选项 | 功能说明 | 操作示例 |
---|---|---|
0 | 退出程序 | 输入0 并回车,关闭工具。 |
1 | Reset Machine ID | 重置机器 ID,解决 “本机试用账户过多” 问题,输入1 后按提示操作。 |
3 | Bypass Cursor Version Check | 绕过版本检查,强制使用当前版本,输入3 后选择目标版本号。 |
4 | Disable Cursor Auto-Update | 禁用自动更新,输入4 后确认禁用,避免工具因更新失效。 |
5 | Check User Authorized | 检查账户权限,输入5 查看当前账户是否被封禁或授权。 |
10 | Totally Reset Cursor | 完全重置 Cursor 配置,输入10 清除所有本地数据,恢复初始状态。 |
高级功能:自定义配置(修改config.ini
)
配置文件路径:
- Windows:
C:\Users\<用户名>\Documents\.cursor-free-vip\config.ini
- macOS:
/Users/<用户名>/Library/Application Support/cursor-free-vip/config.ini
- Linux:
~/.config/cursor-free-vip/config.ini
常用配置项
[Chrome]
chromepath = C:\Program Files\Google/Chrome/Application/chrome.exe # 自定义Chrome路径
[Turnstile]
handle_turnstile_time = 2 # 人机验证等待时间(秒)
[WindowsPaths]
machine_id_path = C:\Users\yeongpin\AppData\Roaming\Cursor\machineId # 机器ID存储路径
五、注意事项与常见问题
必备条件
- 关闭 Cursor:运行脚本前确保 Cursor 完全退出(包括任务管理器中的后台进程)。
- 管理员权限:Windows 需以管理员身份运行 PowerShell,Linux/macOS 需使用
sudo
获取权限。 - 邮箱合规:避免使用临时邮箱(Disposable Email)注册 Cursor,降低账户被封禁风险。
常见问题解决方案
问题描述 | 解决方案 |
---|---|
权限不足(Permission Denied) | 1. 确认以管理员身份运行脚本; 2. Linux/macOS 执行 sudo chmod +x <脚本名> 赋予执行权限。 |
Error: User is not authorized | 1. 检查是否使用临时邮箱注册 Cursor; 2. 尝试通过 5. Check User Authorized 功能修复授权状态。 |
脚本运行后无效果 | 1. 手动删除machineId 文件(路径见config.ini );2. 重启 Cursor 并重新登录账户。 |
浏览器驱动异常 | 1. 确保config.ini 中chrome_driver_path 指向正确的 Chromedriver 路径;2. 下载对应浏览器版本的驱动程序(Chromedriver 下载)。 |
法律声明
- 本工具仅用于学习和研究,禁止商业用途或违反 Cursor 服务条款的行为。
- 请支持 Cursor 官方版本,合理使用免费功能,避免滥用导致账户封禁。
六、进阶技巧:提升使用稳定性
- 定时重置计划(Windows 为例):
- 创建任务计划:每周自动运行
reset_machine_manual.py
脚本,保持账户可用。
- 创建任务计划:每周自动运行
- 自定义浏览器:
- 在
config.ini
中配置default_browser
为opera
/brave
等,支持 Opera GX、Brave 等小众浏览器。
- 在
- 监控使用配额:
- 通过主界面查看 “Premium Usage” 剩余配额,接近上限时手动触发
10. Totally Reset Cursor
。
- 通过主界面查看 “Premium Usage” 剩余配额,接近上限时手动触发
七、总结
cursor-free-vip
为 Cursor 用户提供了一套高效的试用限制解决方案,通过简单的脚本操作即可突破机器 ID 和令牌限制,畅享 Pro 功能。无论是开发新手还是资深用户,只需按照步骤操作,即可轻松绕过限制,专注于 AI 开发。请务必遵守软件使用条款,合理利用工具提升效率,支持正版软件生态。
项目地址
- GitHub:https://github.com/yeongpin/cursor-free-vip
- 反馈 Issue:在 GitHub 仓库提交问题或建议,获取最新更新。
通过以上指南,用户可快速掌握cursor-free-vip
的安装与核心功能使用,有效解决 Cursor 试用限制问题,提升开发效率。