Skip to content

Cursor SOCKS5 Proxy or HTTP Proxy: Which One Works

If your proxy has a username and password, give Cursor the HTTP address (port 2222), not SOCKS5.

Short answer: HTTP

Cursor is built on VS Code, and the VS Code documentation lists authenticated proxies (Basic, Digest, NTLM, Negotiate) as supported while SOCKS5 proxy authentication is not implemented yet. Cursor's documentation does not say anything about SOCKS proxies, so a SOCKS5 address with a login is a bet, and an HTTP address is the documented path.

If your IP is SOCKS5-only, you can run a small local forwarder instead of buying again; that is covered at the end.

What to enter in Cursor, by what you hold

What to enter in Cursor, by what you hold
ItemEnter in CursorWhy
Static ISP IP bought per IP as HTTPhttp://LOGIN:PASSWORD@HOST:2222It is already an HTTP asset.
Static ISP IP bought per IP as SOCKS5The same login on HTTP port 2222Tested 4 November 2026: a per-IP lease also connects over the other protocol on that protocol's port.
Rotating residentialThe same login on HTTP port 2222HTTP on 2222 and SOCKS5 on 3333 both work; enter HTTP in Cursor.
Static ISP billed per GB (Fixed ISP)Newly bought: the same login on HTTP port 2222Newly bought per-GB Fixed ISP works on HTTP 2222 and SOCKS5 3333. An older line the console marks HTTP only also takes HTTP.

Protocols and ports from the Proxy302 product facts file (HTTP 2222, SOCKS5 3333); the tests were run on 4 November 2026 with ipinfo.io through the public entry.

Where the setting goes

In Cursor, open the Settings, search for proxy and fill in the HTTP proxy field (the http.proxy setting) with the address from the table, then restart Cursor. The VS Code page says http.proxy is a legacy setting respected in only two scenarios it does not name, and Cursor does not document it, so do not assume it worked: test it.

Open Cursor Settings > Network and click Run Diagnostics. If the check passes, the proxy is in use for the connection Cursor tested.

Cursor user settings (JSON)

{
  "http.proxy": "http://LOGIN:PASSWORD@HOST:2222"
}

Example only: copy HOST, LOGIN and PASSWORD from My assets; 2222 is the HTTP port.

Test the proxy outside Cursor

# HTTP, port 2222
curl -x http://LOGIN:PASSWORD@HOST:2222 https://ipinfo.io/json

# SOCKS5, port 3333 (DNS also through the proxy)
curl -x socks5h://LOGIN:PASSWORD@HOST:3333 https://ipinfo.io/json

Example only: run the line that matches the protocol you hold.

Check it in 5 steps

  1. Step 1: Read the protocol

    Open My assets and see whether the IP is HTTP or SOCKS5. It decides the table row you are in.

  2. Step 2: Test with curl

    Run the HTTP line from the example. A JSON answer with the exit IP means the proxy works.

    Expected result The country in the answer matches the one you bought.

  3. Step 3: Set http.proxy

    Put http://LOGIN:PASSWORD@HOST:2222 into the Cursor proxy setting and restart Cursor.

  4. Step 4: Run Diagnostics

    Cursor Settings > Network > Run Diagnostics.

  5. Step 5: If chat or the agent hangs

    Set HTTP Compatibility Mode to HTTP/1.1 in the same Network settings and restart Cursor, as the Cursor documentation advises for proxies that block HTTP/2.

If it does not work

Diagnostics fails but curl works

Check Whether Cursor really read the setting: VS Code treats http.proxy as legacy.

Fix Try the system proxy setting instead, or send only Cursor through the proxy with the split-routing guide.

Stop when Both ways fail while curl works: restart Cursor fully, then check the firewall.

Chat or the agent hangs

Check Streaming over HTTP/2 through the proxy.

Fix Set HTTP Compatibility Mode to HTTP/1.1 and restart.

Stop when Still hangs: run Diagnostics and send us the result with the order number.

You entered a SOCKS5 address and nothing works

Check Whether the address has a login. SOCKS5 login is not implemented in VS Code.

Fix Switch to the HTTP row of the table above.

Stop when Do not keep trying a SOCKS5 address in Cursor; use the HTTP line.

407 or a sign-in prompt

Check Username and password, copied in full from My assets.

Fix Copy them again; characters like @ and : in a password may need percent-encoding in the URL.

Stop when Credentials are right and curl also gets 407: open a ticket with the order number.

What a proxy does not change

Model availability follows each provider's terms: the Cursor documentation says models that are not available in your region do not appear, and calls with your own key can fail if the provider blocks the region. Use Cursor from a region it supports and with an account that is yours.

Keep one IP for one account, do not share the account, and complete any verification the service asks for.

Cursor proxy FAQ

Does Cursor support a SOCKS5 proxy?

Its documentation does not mention SOCKS. The VS Code documentation says SOCKS5 proxy authentication is not implemented yet, so choose HTTP when the proxy has a login.

Which port is HTTP on Proxy302?

2222 for HTTP and 3333 for SOCKS5. Copy the host and login from My assets.

Do I have to buy a new IP to switch from SOCKS5 to HTTP?

No. A static ISP IP bought per IP also connects over HTTP on port 2222, and rotating residential and newly bought per-GB Fixed ISP take both ports on the same username and password.

Does it work for VS Code forks like Windsurf?

The same VS Code behaviour is the reason for the HTTP advice, but test each editor with its own diagnostics or a request to ipinfo.io.

Is there a free trial?

No. The smallest purchase is one static ISP IP for one day (US$0.50) or 1 GB of rotating residential traffic.

Reference links

5
  1. Visual Studio Code docs: Network Connections

    Official documentation · Confirmed on:

    Read 16 November 2026: authenticated proxies are supported (Basic, Digest, NTLM, Negotiate); SOCKS5 proxy authentication support is not implemented yet; the http.proxy settings are in a legacy section and respected only in two scenarios the page does not name; proxy settings are otherwise picked up from the system.

    Describes VS Code, on which Cursor is built. Cursor documents neither SOCKS5 nor the http.proxy setting, so test with Run Diagnostics.

  2. Cursor docs: Troubleshooting common issues

    Official documentation · Confirmed on:

    Read 16 November 2026: Cursor Settings > Network > Run Diagnostics; HTTP/2 is used for streaming and some proxies block it, so set HTTP Compatibility Mode to HTTP/1.1 and restart Cursor.

  3. Cursor docs: Network configuration

    Official documentation · Confirmed on:

    Read 16 November 2026: Cursor uses HTTP/2 streaming by default and falls back to HTTP/1.1 Server-Sent Events; the page does not mention SOCKS proxies.

  4. Cursor docs: Regions

    Official documentation · Confirmed on:

    Read 16 November 2026: some model providers have location-based restrictions; models that are not available in your region do not appear in Cursor; calls can fail even with your own key if the provider blocks the region.

  5. Proxy302 product facts and price list

    Product observation · Confirmed on:

    Product facts file of the site, checked 16 November 2026: prices in US$ (1 PTC = US$1), lease terms, protocols and ports (HTTP 2222, SOCKS5 3333), what each product connects over, countries and city targeting, no free trial.

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.