跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言VScodeAI

Cursor 的代理配置:填一次就生效

Cursor 基于 VS Code,可通过修改用户设置 JSON 或在图形界面搜索 proxy 填入代理地址,让模型调用、更新等走指定通道。关键配置项包括 http.proxy、禁用 HTTP/2 和重启后切换至 HTTP/1.1。验证时直接用 Agent 对话测试需代理的模型,不要依赖诊断工具。

BackendPro发布于 2026/6/28更新于 2026/10/985 浏览

Cursor 的代理配置:填一次就生效

Cursor 跑模型、调 API 都靠网络,碰上网络受限或者需要梯子的环境,代理就是刚需。它基于 Electron,代理设置藏在 VS Code 那套体系里——要么动 settings.json,要么在界面上搜 proxy 直接填。两种方法本质是一样的,选顺手的那条就行。

直接改用户设置 JSON

如果你习惯手写配置,这是最快的方式:

  1. 打开命令面板:Cmd + Shift + P(Mac)或 Ctrl + Shift + P(Windows)。
  2. 搜 User,选 Open User Settings (JSON)。
  3. 把下面这段贴进文件(改之前最好备份,万一写岔了还能恢复默认):
{
  "http.proxy": "http://127.0.0.1:7890",
  "http.proxySupport": "override",
  "http.proxyStrictSSL": false,
  "http.noProxy": [],
  "git.enableSmartCommit": true,
  "explorer.confirmDelete": false,
  "cursor.composer.shouldChimeAfterChatFinishes": true,
  "workbench.colorTheme": "Solarized Light",
  "cursor.general.disableHttp2": 

true
}
  1. 重启 Cursor。
  2. 进 首选项 → Cursor 首选项配置 → Network,把 HTTP 协议改成 HTTP1.1。

cursor.general.disableHttp2 这一项是关键,很多代理工具在 HTTP/2 下会出问题,关掉省心。代理地址 http://127.0.0.1:7890 按你本地软件的实际端口来,socks5 也是支持的,写成 socks5://... 就行。

在设置界面里填

不想碰 JSON 的话,走图形界面也完全够用:

  1. 用 Cmd + ,(Mac)或 Ctrl + ,(Windows)打开设置。
  2. 搜索 proxy。
  3. 在 Http: Proxy 栏输入你的代理地址,例如 http://127.0.0.1:7890 或 socks5://127.0.0.1:7890(代理工具得先开着,并允许局域网连接)。
  4. 如果你需要校验 HTTPS 证书,可以勾选 Http: Proxy Strict SSL;通常关闭就行,内网代理一般用不着。
  5. 重启 Cursor。
  6. 同样,去 Network 页面把 HTTP 协议切到 HTTP1.1。

两种方法做完后,设置里的 http.proxy 就指向同一个值,效果一样。

怎么才算配成功了?

别光靠 Cursor 自带的网络诊断——它偶尔会报成功但请求根本没走代理。最靠谱的办法是直接和 Agent 聊几句:手动切到一个需要代理才能用的模型(比如 Claude 系列、GPT 系列、Gemini 系列),发一条消息,能正常回复就是通了。

背后的逻辑

Cursor 内部就是一个 Electron 套壳,所以和 VS Code 共用那套 http.proxy 机制。你填的地址会被用在模型拉取、API 调用、更新检查这些地方。另外,如果你习惯在终端里用环境变量 HTTP_PROXY / HTTPS_PROXY,Cursor 也能识别——但前提是启动前设好。系统代理(System Proxy)则只对部分请求生效,不稳定的时候还是老老实实在设置里显式填写最稳。

常见地址无非就是 http://127.0.0.1:端口 或者 socks5://127.0.0.1:端口,端口号看你的 Clash、V2Ray 或者其它工具怎么配的。

参考

  • Cursor 官方文档

目录

  1. Cursor 的代理配置:填一次就生效
  2. 直接改用户设置 JSON
  3. 在设置界面里填
  4. 怎么才算配成功了?
  5. 背后的逻辑
  6. 参考

更多推荐文章

查看全部
  • 本地 Ubuntu 服务器部署 OpenClaw 完整教程
  • C++伸展树介绍与红黑树实现
  • C++11 新特性详解:Lambda 表达式、可变参数模板与包装器
  • 本地 Git 向 Gitee 推送项目全流程及命令解析
  • 微信小程序 WebView 与内嵌网页双向通信指南
  • 本地部署 AI 大模型的硬件配置指南
  • 本地快速安装运行开源 LLaMa3 大模型
  • 基于 GraphRAG+LangChain+Ollama 的 Llama 3.1 与 Neo4j 集成实战
  • 大数据岗位面试英文自我介绍实战指南
  • SpringBoot 强制使用 Jedis 替代默认 Lettuce 客户端的配置方案
  • 基于 OpenClaw 与 Open WebUI 搭建企业多部门 AI 平台
  • 深度解析 LayerNorm 与 RMSNorm:大模型为何转向 RMSNorm
  • OpenClaw 飞书机器人配置指南:实现群消息免@自动回复
  • C++入门:输入输出、缺省参数与函数重载
  • 本地服务秒变公网地址:内网穿透演示实战
  • 本地多模型切换工具 Llama-Swap 使用指南
  • 大数据 OLAP 中的近似聚合算法
  • 本地 Docker 部署开源低代码平台 Appsmith 及远程访问配置
  • cann-recipes-train 实战:昇腾 DeepSeek-R1 与 Qwen2.5 强化学习优化
  • Java AOP 技术详解

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online