AI 部署指南

Appearance

Cursor 国内注册与代理设置 ​

一句话 ​

Cursor 编辑器国内用户需通过代理完成注册和登录，本文提供从下载、配置代理到注册成功的完整步骤，所有命令均可直接复制使用。

🤖 AI Agent 快速入口

以下内容为结构化 Markdown，AI Agent 可直接解析执行。

curl -H "Accept: text/markdown" https://doc.k4b.cn/agents/cursor-setup.md

快速部署（AI 版） ​

前置条件 ​

  • [ ] 已安装 Clash / V2Ray 等代理工具（示例：本地 HTTP 代理 127.0.0.1:7890）
  • [ ] 可正常访问 https://cursor.com（通过代理测试）
  • [ ] 一个可用的邮箱或 GitHub 账号

步骤 ​

bash
# 1. 设置终端代理（以 HTTP 代理 127.0.0.1:7890 为例）
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

# 2. 下载 Cursor（Linux/macOS 使用 curl，Windows 手动下载官网安装包）
curl -L -o cursor.AppImage https://cursor.com/downloads/linux  # Linux
# macOS 用户：curl -L -o cursor.dmg https://cursor.com/downloads/mac
# 或直接从官网下载后安装

# 3. 安装后打开 Cursor → 设置代理（以下为 VS Code 兼容方式）
# 在 Cursor 内按 Ctrl+Shift+P → 输入 "Preferences: Open Settings (JSON)"
# 添加或修改：
# "http.proxy": "http://127.0.0.1:7890",
# "http.proxyStrictSSL": false

# 4. 注册：点击右上角 Sign in → 选择 Email 或 GitHub → 按提示操作
# 注意：整个注册过程必须保持代理开启

验证 ​

bash
# 检查代理是否生效
curl -x http://127.0.0.1:7890 -s -o /dev/null -w "%{http_code}" https://cursor.com
# 返回 200 即代表代理正常
# 打开 Cursor → 查看右下角是否出现 “Connected” 标识

详细教程（人类版） ​

背景 ​

Cursor 是一款基于 VS Code 的 AI 编程编辑器，内置强大的代码补全和对话功能。由于服务器位于海外，国内用户在下载安装、注册登录以及使用 AI 功能时均需通过 HTTP/HTTPS 代理。本教程以最常见的 Clash 客户端（端口 7890）为例，适用于所有支持系统/应用级代理的工具。

第一步：确认代理可用 ​

  1. 确保你的代理客户端已开启，并且 HTTP 代理端口（如 7890）正常监听。
  2. 在终端测试代理能否访问 Cursor 官网：
    bash
    curl -x http://127.0.0.1:7890 -I https://cursor.com
    看到 HTTP/2 200 说明代理通道正常。如果失败，请检查代理配置或更换端口（如 10809 等）。

第二步：下载并安装 Cursor ​

方式一：官网直接下载（推荐）

  • 打开浏览器，访问 https://cursor.com/downloads
  • 根据系统选择 Windows / macOS / Linux 版本
  • 注意：下载过程仍需要代理，建议保持代理客户端“全局模式”或为浏览器单独配置代理。

方式二：使用镜像（备用）
如果官网下载缓慢，可在 GitHub 搜索 cursor mirror（非官方，注意安全），或使用国内 CDN 加速（如 ghproxy.com 代理 GitHub Release，但 Cursor 不通过 GitHub 分发，此方法无效）。因此强烈建议始终保持代理下载。

安装过程与普通软件一致：Windows 双击 .exe，macOS 拖入 Applications，Linux 执行 .AppImage。

第三步：配置 Cursor 代理 ​

Cursor 继承 VS Code 的代理设置，有两种配置方式：

方法 A：通过图形界面（推荐新手） ​

  1. 打开 Cursor，点击左下角齿轮图标 → Settings（或按 Ctrl+,）
  2. 在搜索框输入 proxy
  3. 找到 Http: Proxy 项，填入 http://127.0.0.1:7890
  4. （可选）将 Http: Proxy Strict SSL 取消勾选，避免证书错误

方法 B：直接编辑 settings.json（适合批量部署） ​

json
{
  "http.proxy": "http://127.0.0.1:7890",
  "http.proxyStrictSSL": false,
  "window.titleBarStyle": "custom"
}

如何打开 settings.json：按 Ctrl+Shift+P 输入 Preferences: Open Settings (JSON) 并回车。

第四步：注册 Cursor 账号 ​

  1. 点击 Cursor 右上角 Sign in 按钮
  2. 选择 Sign up with Email 或 Continue with GitHub
    • 若选邮箱：输入常用邮箱 → 点击 “Continue” → 查收验证码（6 位数字） → 填写验证码 → 设置密码
    • 若选 GitHub：浏览器会弹出 GitHub 登录授权页（需代理访问 github.com）
  3. 登录后，右上角会显示你的头像，同时 AI 功能图标变为绿色可用状态

常见问题：

  • 验证码收不到：检查邮箱垃圾箱，或换用 Gmail / Outlook 等国际邮箱（QQ/163 邮箱有时延迟）
  • GitHub 登录失败：确保浏览器也开启了代理，或使用“应用内浏览器”的代理设置与 Cursor 一致

第五步：验证代理与 AI 功能 ​

  1. 在 Cursor 内按 Ctrl+Shift+P，输入 AI: Check Connection（或直接观察右下角状态栏）
  2. 如果显示 Connected 或 ![连接成功图标] 说明正常
  3. 尝试写几行代码，按 Ctrl+K 唤起 AI 对话，发送一条消息（如“写一个二分查找”），AI 应在 1-2 秒内回复
  4. 终端验证：
    bash
    # 查看 Cursor 的代理是否被全局环境变量影响（可选）
env | grep -i proxy

常见问题 ​

Q1: 下载速度极慢 ​

  • 确认代理模式为全局（Rule 模式可能不匹配 Cursor 域名），或在代理客户端中添加规则：cursor.com、cursor.sh 走代理。
  • 尝试更换代理节点（线路不同速度差异大）。

Q2: 设置了代理但 Cursor 仍然无法连接 ​

  • 检查 Cursor 是否继承了系统代理：在 settings.json 中明确设置 "http.proxy" 优先级最高。
  • 部分代理工具（如 Clash TUN 模式）会接管全部流量，此时无需单独配置 Cursor。
  • 重启 Cursor 使设置生效。

Q3: AI 回复为空或报错 “Network Error” ​

  • 代理未覆盖 Cursor 的 AI 推理请求地址（api.cursor.com、delta.cursor.com 等）。请在代理客户端的规则/配置中显式添加这些域名。
  • 如果使用 PAC 模式，可将 https://*.cursor.com/* 加入代理列表。

Q4: 使用 GitHub 登录时一直转圈 ​

  • GitHub 授权页面可能在 Cursor 内置浏览器中加载，而内置浏览器未使用代理。解决方法：在 Cursor 设置中搜索 proxy，确认已填。或在代理客户端开启“UWP 回环代理”选项（Windows）。
  • 改用邮箱注册。

相关教程 ​