Skip to content

Updated

Using Cursor from China:
One-click boost plus http.proxy, so chat and Agent stop spinning

  1. To use Cursor from China, buy an overseas static IP (for example the US Static ISP), install the Proxy302 client on your computer, sign in and turn on One-click boost.
  2. In My IPs click More on that IP → Use as system proxy → Turn on, then click Set as this computer's system proxy.
  3. Then add "http.proxy": "http://127.0.0.1:17890" to Cursor's settings.json, quit Cursor completely and open it again. If chat or Agent keeps spinning, change HTTP Compatibility Mode to HTTP/1.1 under Cursor Settings → Network. To sign in to cursor.com and manage your subscription, use the window opened by Open browser.

Check it right after buyingExample output

curl -x http://USER:PASS@HOST:PORT https://ipinfo.io/json

ip
203.0.113.24
country
US
Matches the country you picked
Day 15
203.0.113.24
Same address for the whole term
Example addresses (203.0.113.0/24), not real exits
01 / 12Two legs have to work

One Cursor account, one fixed overseas static IP; the China leg is handled by the client's One-click boost.

Two legs have to work

Leg one runs from China to overseas. Connecting from a mainland network straight to an overseas proxy address is often unstable: the switch is on but the page keeps spinning. The Proxy302 client's One-click boost keeps this leg stable for you.

Leg two is the fixed overseas exit. Cursor sees the static IP you bought, not your local network. Keep one account on one IP and use that same IP in the browser and in the editor.

So the order is: buy the IP → install the client and turn on One-click boost → connect the way you use Cursor → check on ipinfo.io.

Before you start: the IP and the client

  1. Step 1: buy an overseas static IP

    For Cursor, choose the Static ISP: dedicated to you, and a renewal usually keeps the same IP. Pick a country Cursor supports (the US is the common choice) and keep the protocol on HTTP (command-line tools only accept HTTP). If you already have a static IP, use that one.

    Expected result The IP appears under My proxies in the console.

  2. Step 2: install the client and turn on One-click boost

    Download the Windows or Mac client and sign in with your Proxy302 account. Click Relay on the left, then turn on One-click boost; when the computer asks for confirmation, click Yes (on a Mac, enter your login password). Keep the client running while you use Cursor.

    Expected result You see One-click boost is on, and My IPs lists your IP.

    Before continuing If antivirus software blocks it, allow the hosts change, restore any quarantined files and add the client's install folder to the trusted list.

Relay page: the switch is on and connected, with One-click boost turned on below
Step 2: Relay connected and One-click boost on (Windows client in Chinese, some details masked)
Open full-size figure

① cursor.com in the browser (sign-in and subscription)

  1. Click Open browser in My IPs

    Find the IP and click Open browser. The client opens a new Chrome window that uses the IP you bought. Sign in from this window from now on.

    Expected result ipinfo.io in this window shows your IP and country.

  2. Open cursor.com and sign in

    Open cursor.com in the same window and sign up or sign in. Do not sign in to the same account from another browser.

    Expected result Cursor opens normally.

② Cursor editor

  1. Make this IP the system proxy

    In My IPs click More on the IP → Use as system proxy → Turn on, then click Set as this computer's system proxy. Set this IP as the system proxy first, then enter the same address in Cursor.

    Expected result The client shows the system proxy is on at 127.0.0.1:17890 (use what your client shows).

    Before continuing Once it is the system proxy, every app that follows the system proxy uses this IP; turning the system proxy off or quitting the client restores the old setting.

  2. Enter http.proxy in Cursor

    Open Cursor's settings.json and add the line below; save, quit Cursor completely and open it again. If chat or Agent keeps spinning, go to Cursor Settings → Network, change HTTP Compatibility Mode to HTTP/1.1 and restart.

    Expected result Cursor Settings → Network → Run Diagnostics all pass, and chat returns results.

System proxy on at 127.0.0.1:17890, with notes on desktop apps, the terminal and other apps
Using the system proxy with desktop apps and the terminal (Windows client in Chinese, some details masked; newer versions word the notes slightly differently)
Open full-size figure

Cursor settings.json

{
  "http.proxy": "http://127.0.0.1:17890"
}

Use the port your client's system proxy shows; the local address needs no username or password.

Keep Chinese sites on your local network

In the client's Settings turn on Chinese sites direct: Chinese sites use your local network while overseas sites such as Cursor keep using the static IP. It applies to windows opened afterwards; if you use the system proxy, turn it off and on once.

The Chinese sites direct switch in the client's Settings
Settings: Chinese sites direct (Windows client in Chinese)
Open full-size figure

If it doesn't connect

cursor.com keeps spinning or won't load

Check Does Relay show connected? Are you in the window opened by Open browser?

Fix Turn on One-click boost again and click Yes; open a new window with Open browser. Close any other acceleration software first.

Cursor says it isn't available in your region

Check Does ipinfo.io in the same window show the country you bought?

Fix If not, the traffic isn't using the IP: use the Open browser window on the web, and for desktop apps confirm the system proxy is set and restart them.

Authentication failed or HTTP 407

Check Has the IP expired? Did you copy an extra space with the username or password?

Fix Check the status and credentials under My proxies; if it still fails, open a ticket in the console with a screenshot.

FAQ

Can I use Cursor with One-click boost alone, without buying an IP?

No. One-click boost only stabilises the China-to-overseas leg; the exit Cursor sees comes from the static IP you bought.

Can Cursor use SOCKS5?

For a proxy with a username and password, HTTP is the safer choice. What you enter here is the client's local HTTP address 127.0.0.1:17890, which needs no username or password.

Will Chinese sites get slower?

With Chinese sites direct on, Chinese sites use your local network at their usual speed.

Further reading

Setup guides Proxy302 publishes on GitHub on the same topic:

Reference links

2
  1. Proxy302 client UI (checked against 3.5.5 by the client team)

    Product observation · Confirmed on:

    Checked by the client team on 22 November against the 3.5.5 interface: Relay, One-click boost, One-click boost is on, My IPs, Open browser, More → Use as system proxy → Turn on → Set as this computer's system proxy; the system proxy defaults to 127.0.0.1:17890 (another port is used if it is taken; follow the client); manual set-up, the option that lets phones and other computers on the local network use it, Settings → Chinese sites direct. Screenshots are the Windows client (3.5.1) on a test computer.

  2. Proxy302 guide: Cursor proxy setup

    Product observation · Confirmed on:

    Facts checked in the on-site Cursor guide: Cursor is built on VS Code and uses http.proxy in settings.json; Cursor Settings → Network has Run Diagnostics and HTTP Compatibility Mode (which can be switched to HTTP/1.1).

Ready to try it?

Create an account, top up once, then pick rotating residential, static ISP or datacenter IPs and have one running in your browser within minutes.