---
title: "Cursor 国内注册与代理设置"
description: "Cursor 是目前最热门的 AI 编辑器，但国内使用需要解决注册和代理问题。本文详解 Cursor 国内注册流程、代理配置方法和常见问题，附带可复制的命令与配置。"
category: agents
tags: [Cursor, AI编辑器, 代理, 国内配置]
difficulty: easy
time_estimate: "10 分钟"
prerequisites: []
last_updated: "2026-07-24"
---

# 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](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）。
- 改用邮箱注册。

---

## 相关教程
- [Clash 代理客户端配置与全局模式设置](/tools/clash-setup.md)
- [VS Code / Cursor 常用快捷键与插件管理](/editors/vscode-basics.md)
- [AI 编程工具代理环境通用配置](/agents/proxy-guide.md)