Cursor 使用与设置指南
本文档按 Cursor Settings 左侧菜单顺序（General → Agents → Models → Cloud Agents → Tools & MCP → Rules, Skills, Subagents → Hooks → Indexing & Docs → Network → Beta → Docs）组织各功能说明与场景，再补充配置组合分析；使用、建议、以及遇到的网络问题与解决方案统一放在文档最后，便于先查设置与组合，再按需查阅使用与排错。内容不删减，并参考 Cursor 官方文档 做补充与深化。
文档结构概览
| 章节 | 内容 | 建议阅读顺序 |
|---|---|---|
| 一、按设置目录 | General、Agents、Models、Cloud Agents、Tools & MCP、Rules/Skills/Subagents、Hooks、Indexing & Docs、Network、Beta、Docs（与界面一致） | 对照 Cursor 设置逐项查阅 |
| 二、配置组合分析 | 多种配置组合在一起的使用场景与取舍（稳定性、计费、速度、隐私、团队协作等） | 做整体方案或选型时阅读 |
| 三、使用与建议 | 用途与选型、计费总览、综合对比与问题主次 | 日常「怎么用、怎么选、怎么省」时查阅 |
| 四、遇到的网络问题及解决方案 | 连接不通、Reconnecting、HTTP 模式、Diagnostics | 连不上、慢、断连时排查 |
| 附录 | 订阅与可见性、列表汇总、说明与更新 | 按需查阅 |
一、按设置目录（与 Cursor Settings 左侧一致）
以下顺序与 Cursor Settings 左侧导航一致，每节包含：功能说明、用途、典型场景、选项详解（不删减原有内容，并做必要补充）。
1.1 General
入口：Settings → General
功能：管理账号与计费（Manage Account）、窗口与编辑器偏好（Preferences）、通知与提示（Notifications）、隐私（Privacy）、登出（Log Out）。与 Cursor 官方 Account / Billing、Update Access 等对应。
用途：统一配置账号/账单、布局与编辑体验、是否接收系统通知与完成音、是否开启隐私模式，影响日常使用体验与数据合规。
典型场景：查看或升级 Pro+ Plan、多窗口共享布局、从 VS Code 迁移时一键导入、客户/公司敏感项目时开启 Privacy Mode、长任务时依赖系统通知与 Completion Sound 感知完成。
| 选项 | 说明 | 使用示例与场景 |
|---|---|---|
| Manage Account | 管理账号与账单（订阅、支付方式、用量）。 | 查看本月额度、升级 Pro+、更新支付方式、取消订阅；出现「配额不足」或计费疑问时点 Open 到网页处理。与 Models 选型配合可控制额度消耗。 |
| Sync layouts across windows | 所有 Cursor 窗口共享同一布局。 | 多窗口希望边栏、终端、Chat 位置一致时开启；关掉则各窗口可独立布局。 |
| Editor Settings | 字体、字号、格式化、小地图、主题等。 | 调大字号、关 minimap 提升大文件性能、统一缩进；与「回复速度」无直接关系，但可让操作更顺手。 |
| Keyboard Shortcuts | 查看与自定义快捷键。 | 给「接受补全」「打开 Chat」「触发 Agent」设快捷键，减少鼠标点击，整体操作更快。 |
| Import Settings from VS Code | 从 VS Code 导入设置、扩展与快捷键。 | 从 VS Code 迁到 Cursor 时一键带入，缩短适应时间。 |
| Reset “Don’t Ask Again” Dialogs | 恢复曾被「不再询问」隐藏的提示。 | 想重新看到某条说明时点 Show。 |
| System Notifications | Agent 完成或需操作时系统级通知。 | 长任务提交后切到浏览器，完成时收到通知再切回，提升「感知速度」。 |
| Menu Bar Icon | 是否在系统菜单栏显示 Cursor 图标。 | 需要从菜单栏快速查看状态时开启。 |
| Completion Sound | Agent 回复结束时播放提示音。 | 流式输出时不必一直看屏幕，听到提示音即结束。 |
| Privacy Mode | 代码不会被用于训练；可能被存储以支持 Background Agent 等。 | 客户机密/公司闭源项目时开启；注意部分云端能力可能受限。与 Cloud Agents、Indexing 等能力相关，详见官方说明。 |
| Log Out | 退出当前 Cursor 账号。 | 切换账号或排查登录异常时使用。 |
1.2 Agents
入口：Settings → Agents
功能：配置 Agent 的默认行为（模式、位置、标签数、消息队列、用量显示）、提交后审查（Agent Review）、上下文与联网（Web Search、Web Fetch、.cursorignore）、应用修改方式、Auto-Run 与沙箱、命令/MCP/域名白名单、各类保护（浏览器、MCP、删文件、点文件、工作区外文件）、内联编辑与终端、语音、归属。对应官方 Agent Overview、Modes、Review、Security 等。
用途：决定 Agent 如何被触发、如何获取上下文、能否自动执行命令/搜索/拉取网页、如何应用修改、以及安全与合规边界，是「配置组合」中的核心模块之一。
典型场景：希望每次 commit 后自动审查时开启 Agent Review；需要查文档/API 时开 Web Search 与 Web Fetch；希望少点确认时配置 Command/MCP Allowlist；敏感项目开启 File-Deletion、Dotfile、External-File Protection；团队统一 Commit/PR Attribution。
| 类别 | 选项示例 | 用途与场景简述 |
|---|---|---|
| General Agent behavior | Default Mode、Default Location、Text Size、Auto-Clear Chat、Max Tab Count、Queue Messages、Usage Summary | 新 Agent 默认模式/位置、标签数、消息队列、用量显示；多任务时限制标签数，关心额度时开 Usage Summary。 |
| Agent Review | Start Agent Review on Commit、Include Submodules/Untracked、Default Approach | 每次 commit 后是否自动审查、审查深度与成本；Quick 省时省额度，Thorough 更细但消耗更高。 |
| Context | Web Search Tool、Auto-Accept Web Search、Web Fetch Tool、Hierarchical Cursor Ignore | 是否允许搜索/拉取网页、.cursorignore 作用范围；大仓开 Hierarchical 减少无关文件参与上下文。 |
| Applying Changes | Auto-Accept on Commit、Jump to Next Diff on Accept、Auto Format on Agent Finish | 提交后自动接受、接受后跳下一 diff、改完自动格式化。 |
| Auto-Run | Auto-Run Mode、Auto-Run Network Access、Allow Git Writes Without Approval | 沙箱内自动执行、网络与 Git 写权限；需真实环境时选允许或每次询问。 |
| 白名单 | Command Allowlist、MCP Allowlist、Fetch Domain Allowlist | 可自动执行而不必每次确认的命令/MCP/域名；与 Tools & MCP 配合使用。 |
| 保护 | Browser Protection、MCP Tools Protection、File-Deletion Protection、Dotfile Protection、External-File Protection | 禁止自动运行浏览器/MCP、禁止删文件/改点文件/改工作区外文件；企业/敏感项目建议开启。 |
| 内联与终端 | Toolbar on Selection、Terminal Hint、Preview Box for Terminal ⌘K | 选中代码工具栏、终端 ⌘K 预览；希望先看一眼再应用时开 Preview Box。 |
| Voice | Submit Keywords | 语音模式下自动提交的唤醒词。 |
| Attribution | Commit Attribution、PR Attribution | Git 提交/PR 是否标记与 Cursor 共同创作；团队规范可关。 |
1.3 Tab
入口：Settings → Tab
功能：配置按 Tab 触发的补全与多行建议（Cursor Tab）、部分接受（Partial Accepts）、注释内建议、仅空白建议、TypeScript/Python 自动 import。对应官方 Tab。
用途：决定日常编码时「按 Tab 能得到什么」、是否按词接受、是否在注释里触发补全，直接影响速度感知与额度消耗（若 Tab 使用轻量模型则更省、更快）。
典型场景：快速写重复结构、样板代码时依赖 Cursor Tab；只采纳建议一部分时用 Partial Accepts；写 TS 时开 Imports 减少手写 import；Python 项目可尝试 Auto Import for Python（Beta）。
| 选项 | 功能 | 用途与场景 |
|---|---|---|
| Cursor Tab | 基于上下文的多行建议，围绕光标与近期编辑。 | 按 Tab 接受整段 AI 补全，适合快速写重复结构、样板代码。 |
| Partial Accepts | 用 ⌘→ 按「词」逐步接受建议。 | 只采纳建议的一部分、边接受边改时开启。 |
| Suggestions While Commenting | 在注释区域内是否允许 Tab 触发/接受建议。 | 需要在注释里补全或续写时开启。 |
| Whitespace-Only Suggestions | 是否给出仅修改空白的建议。 | 希望 AI 补全格式、缩进时开启。 |
| Imports | 为 TypeScript 自动补全并插入 import。 | 写 TS 时减少手写 import。 |
| Auto Import for Python (BETA) | 为 Python 自动补全并插入 import。 | Python 项目可尝试；不稳定可关。 |
1.4 Models
入口：Settings → Models
功能：选择对话/Agent 使用的模型（Auto、Composer 1、各厂商前沿模型）；与 General → Manage Account 配合理解计费。官方 Models 提供各模型属性与能力说明。
用途：根据任务难度、对速度与额度的需求选用 Auto 或具体模型；配合计费规则（见本文档第三部分）控制月度消耗。
命名规则速查：Fast（速度优先）、High/Extra High（能力档）、Low（轻量省额度）、Max（顶配）、Codex（代码向）、Mini（小参数量）、MAX Only（仅 Ultra）。
模型相对成本档位（自选时）：
| 成本档 | 典型模型 | 说明 |
|---|---|---|
| 低 | Haiku、GPT-5.2 Low/Low Fast、Codex Mini、Gemini Flash、Composer 1 | 单次消耗少，适合高频、简单任务。 |
| 中 | Sonnet 4/4.5、GPT-5.2 / Fast、Codex Fast、Opus 4.6 Fast（若可用） | 能力与成本折中，日常主力。 |
| 高 | Opus 4.6 / 4.6 Max、GPT-5.2 High/Extra High、Codex High/Extra High、Gemini Pro | 单次消耗多，适合复杂、长上下文任务。 |
| MAX Only | Opus 4.6 Fast、Opus 4.6 Max Fast、Sonnet 4 1M | 仅 Ultra，包含在 Ultra 额度内。 |
成本 × 速度 概览：
按厂商/系列分类与详细使用场景（含计费）（保留完整，不删减）：
Cursor 自带
| 模型名 | 说明 | 详细使用场景 | 是否需要收费 | 计费档位 |
|---|---|---|---|---|
| Composer 1 | Cursor 默认/自带模型 | 不特意选厂商时的默认体验：多轮对话、多文件编辑由系统自动选模型；轻量问答、日常补全与解释。 | Pro 及以上可用；Hobby 可能受限。 | 一般不消耗或仅少量消耗额度 |
xAI（Grok）
| 模型名 | 说明 | 详细使用场景 | 是否需要收费 | 计费档位 |
|---|---|---|---|---|
| Grok Code | xAI 代码向模型 | 克隆 repo 后总结入口和模块；给类写单元测试；贴报错栈定位并修改；同步改 async；非 OpenAI/非 Claude 代码风格备选。 | 需 Pro 及以上；消耗当月额度。 | 中 |
Anthropic（Claude 系）
| 模型名 | 说明 | 详细使用场景 | 是否需要收费 | 计费档位 |
|---|---|---|---|---|
| Opus 4.6 | 能力型 | PRD 拆成接口列表与示例；5～10 个文件统一替换旧 API；安全/合规分析；长文档总结；跨服务调用链梳理。 | 需 Pro；消耗额度。 | 高 |
| Opus 4.6 Max | 顶配版 | 整库级迁移、超长 PRD 拆解、复杂 bug 根因推理、架构评审。 | 需 Pro；消耗额度。 | 高 |
| Opus 4.6 Fast | 速度优化版 | Opus 级能力但首 token 延迟更低；2000 行模块找接口生成 OpenAPI；3～5 文件小范围重构。 | 仅 Ultra（MAX Only） | 见 Ultra 额度 |
| Opus 4.6 Max Fast | Max 速度版 | Max 档复杂任务 + 对响应速度有要求。 | 仅 Ultra（MAX Only） | 见 Ultra 额度 |
| Opus 4.5 | Opus 4.5 | 跨文件重命名、根据设计图生成 Service 层、长文档待办与优先级、代码审查。 | 需 Pro；消耗额度。 | 高 |
| Sonnet 4.5 | 日常主力 | 加 JSDoc/注释；Python 改 TypeScript；根据报错修 bug；2～3 文件重命名；会议纪要抽 checklist；解释正则/SQL。 | 需 Pro；消耗额度。 | 中 |
| Sonnet 4 | Sonnet 4 | 单文件内重构；小工具脚本；mock 或测试用例；简短技术问答。 | 需 Pro；消耗额度。 | 中 |
| Sonnet 4 1M | 长上下文约 1M token | 整仓库作上下文：monorepo 找 payment 调用、100+ 页文档按章回答、超大代码库依赖梳理。 | 仅 Ultra（MAX Only） | 见 Ultra 额度 |
| Haiku 4.5 | 轻量 | 变量名/函数名补全、一行加类型或改参数名、一两句问答、额度紧张时替代 Sonnet。 | 需 Pro；消耗额度。 | 低 |
OpenAI（GPT 系）
| 模型名 | 说明 | 详细使用场景 | 是否需要收费 | 计费档位 |
|---|---|---|---|---|
| GPT-5.2 | 基础档 | 代码问在做什么/更简洁写法；接口文档写 50～100 行示例；英文注释翻译；技术方案背景+概述。 | 需 Pro；消耗额度。 | 中 |
| GPT-5.2 Fast | 日常主力 | fetch 补全整行或整段；if-else 改 switch/三元；1～2 文件常量改配置；延迟敏感时小改与补全。 | 需 Pro；消耗额度。 | 中（单次较低） |
| GPT-5.2 High | 能力高一级 | 3～5 文件老 API 改新 SDK；模块可读性+可维护性审查；表结构生成 CRUD 接口；类拆接口+实现。 | 需 Pro；消耗额度。 | 高 |
| GPT-5.2 High Fast | 高能力+偏快 | 多文件/架构级任务但希望首包更快。 | 需 Pro；消耗额度。 | 高 |
| GPT-5.2 Extra High | 最高能力档 | 跨 10+ 文件重构；长 PRD 拆模块与接口；复杂 bug 根因；legacy 过程式改面向对象。 | 需 Pro；消耗额度。 | 高 |
| GPT-5.2 Extra High Fast | 最高能力+偏快 | 同 Extra High 难度但对响应时间有要求。 | 需 Pro；消耗额度。 | 高 |
| GPT-5.2 Low | 轻量档 | 变量名或一行逻辑补全；console.log 改 logger.debug；额度紧张时首选。 | 需 Pro；消耗额度。 | 低 |
| GPT-5.2 Low Fast | 轻量+快 | 最高频、最省额度：补全、单行小改、一两句问答。 | 需 Pro；消耗额度。 | 低 |
| GPT-5.2 Codex | 代码向基础档 | 根据函数签名和注释写完整实现；贴报错栈定位并修；从 main 入口梳理调用链；补单元测试；写 README 用法与示例。 | 需 Pro；消耗额度。 | 中 |
| GPT-5.2 Codex Fast | Codex 速度版 | 代码日常：补全函数体或循环；重复代码抽成函数；单文件内重命名；回调改 async/await；加类型注解或简单校验。 | 需 Pro；消耗额度。 | 中 |
| GPT-5.2 Codex High | Codex 高能力 | 新模块类/接口划分与骨架；5～8 个文件直接查 DB 改 Service 层；热点代码分析瓶颈与优化；整个类完整单测。 | 需 Pro；消耗额度。 | 高 |
| GPT-5.2 Codex High Fast | Codex 高能力 + 快 | 多文件/设计级任务但希望更快出结果。 | 需 Pro；消耗额度。 | 高 |
| GPT-5.2 Codex Low | Codex 轻量 | 10 行以内工具函数、修 typo 或空指针、简单 mock 数据、省额度时的代码小改。 | 需 Pro；消耗额度。 | 低 |
| GPT-5.2 Codex Low Fast | Codex 轻量 + 快 | 行内补全、单行修 bug、小段生成，延迟低且占用额度少。 | 需 Pro；消耗额度。 | 低 |
| GPT-5.2 Codex Extra High | Codex 最高能力 | 整库级重命名或接口替换；从零设计子系统模块与关键接口；同步迁异步；大型单测补覆盖、修 flaky。 | 需 Pro；消耗额度。 | 高 |
| GPT-5.2 Codex Extra High Fast | Codex 最高能力 + 快 | 同 Extra High 难度，对首包延迟有要求时选用。 | 需 Pro；消耗额度。 | 高 |
| GPT-5.1 Codex Max | 5.1 代码顶配 | 整库迁移、大库核心模块与依赖与重构顺序、遗留巨型类拆分。 | 需 Pro；消耗额度。 | 高 |
| GPT-5.1 Codex Max High/Low/Extra High | Max 不同能力档 | High：多文件重构、模块设计、完整单测；Low：单文件小改；Extra High：整库级设计或迁移。 | 需 Pro；消耗额度。 | 高/低/高 |
| GPT-5.1 Codex Max xxx Fast | Max 各档 + 速度 | 与对应 Max 档相同任务，希望响应更快时选用。 | 需 Pro；消耗额度。 | 同上 |
| GPT-5.1 High | GPT-5.1 高能力档 | API 文档写调用示例加错误处理；SQL 防注入写法与解释；3～5 个文件内日志格式、错误码映射等统一调整。 | 需 Pro；消耗额度。 | 中～高 |
| GPT-5.1 Codex Mini | 5.1 代码小模型 | 5～15 行小函数、条件/循环补全、一行注释生成代码、一句话需求试跑。 | 需 Pro；消耗额度。 | 低 |
| GPT-5.1 Codex Mini High/Low | Mini 高/低 | Mini High：稍复杂小函数或带边界处理；Mini Low：最简单补全与单行修改。 | 需 Pro；消耗额度。 | 低 |
| GPT-5 Mini | GPT-5 小模型 | 变量名/参数名补全、一行小改、极简问答；额度非常紧张时的默认选择。 | 需 Pro；消耗额度。 | 低 |
Google（Gemini）
| 模型名 | 说明 | 详细使用场景 | 是否需要收费 | 计费档位 |
|---|---|---|---|---|
| Gemini 3 Pro | 能力型 | 长技术方案提炼风险与依赖；多轮递进式设计；GCP/Firestore/BigQuery；长文档按章总结。 | 需 Pro；消耗额度。 | 高 |
| Gemini 3 Flash | 日常主力 | 补全下一行或下一段；选中代码问 N+1 查询；JSON 转 TS 类型；秒级响应的补全与小改。 | 需 Pro；消耗额度。 | 中 |
| Gemini 2.5 Flash | 2.5 速度型 | 与 3 Flash 同类型快速补全与问答；偏快、省额度。 | 需 Pro；消耗额度。 | 中 |
其他
| 模型名 | 说明 | 详细使用场景 | 是否需要收费 | 计费档位 |
|---|---|---|---|---|
| Kimi K2 | 月之暗面 | 超长中文文档/合同摘要与问答；长对话多轮需求澄清；中文 PRD 提取待办与优先级；若自配 API Key 按月之暗面计费。 | 通常需 Pro + 自有 API 或 Cursor 集成策略 | 以 Cursor/厂商为准 |
| Add Custom Model | 自定义模型 | 接入国内大模型、自建开源、其他云厂商；自有 API Key 计费走对应账号，不占用 Cursor 月度额度。 | 取决于所接 API 的计费 | 不占用 Cursor 额度 |
脑图标：列表中带脑图标的条目通常表示「智能/高级」模式或 Cursor 深度集成的入口；同一模型名可能出现两次（有/无图标），对应不同配置或接入方式。
1.5 Cloud Agents
入口：Settings → Cloud Agents
功能：在后台运行的 Agent，与当前项目的 Git 仓库绑定，用于代码分析、项目理解与版本结合的建议。官方文档中与「Background Agent」、Privacy Mode 的存储说明相关。
用途：在你不主动发起对话时，Agent 也可在后台结合当前仓库做分析、结合版本历史给建议、持续理解项目结构，为后续 Chat/Agent 对话提供更好项目级上下文。
使用前提与场景：
| 项目 | 说明 |
|---|---|
| 使用前提 | 必须用 File → Open Folder 打开已含 Git 仓库的项目根目录，否则设置页会提示需要 Open a Git repository。 |
| 典型场景 | 日常在 Cursor 中打开项目根目录（含 .git）开发时，Cloud Agents 在该工作区内生效；未打开 Git 仓库则无法使用。 |
| 与 Privacy Mode | General 中 Privacy Mode 说明「Code may be stored to provide features such as Background Agent」；若开启隐私模式，可能影响 Cloud Agents 的存储或能力，以应用内为准。 |
1.6 Tools & MCP
入口：Settings → Tools & MCP
功能：配置浏览器联动（Browser Automation）和 MCP（Model Context Protocol） 服务器，让 Agent 能调用浏览器、地图、API 等外部能力。对应官方 Browser、MCP。
用途：前端调试、自动化操作网页、配合 localhost 开发；扩展 Agent 能力（地图、天气、内部 API 等）；与 Agents → MCP Allowlist 配合决定哪些 MCP 可自动运行。
典型场景：开发本地服务时在 Cursor 关联浏览器里打开 localhost 便于 Agent 配合调试；接入自建或第三方 MCP 后，在 Allowlist 中开放相应 server/tool。
| 选项 | 功能 | 用途与场景 |
|---|---|---|
| Browser Automation | 将 Cursor 与浏览器标签页连接，Agent 可操作或读取该标签页内容。 | 前端调试、自动化操作网页、配合 localhost 开发。 |
| Show Localhost Links in Browser | 是否在已连接浏览器标签中自动打开 localhost 链接。 | 开发本地服务时在 Cursor 关联浏览器里打开便于调试。 |
| 已安装的 MCP 服务器 | 列出已配置的 MCP 服务，每项可单独开关。 | 启用后 Agent 可调用该服务提供的工具（如地图、API）。 |
| Add a Custom MCP Server | 添加自定义 MCP 服务器。 | 接入自建或第三方 MCP，按 Cursor/MCP 文档配置。 |
1.7 Rules, Skills, Subagents
入口：Settings → Rules, Skills, Subagents
功能：通过规则（Rules）、技能（Skills）、子 Agent（Subagents）、命令（Commands） 定制 Agent 行为与能力，支持 User / 当前项目等作用范围。对应官方 Rules、Commands、Skills、Subagents。
用途：统一代码风格与安全策略、固化审查/重构/单测等可复用任务、大任务拆解与并行、团队统一 / 前缀工作流，是配置组合中实现「团队规范」与「复杂工作流」的核心。
典型场景：团队统一代码风格与必须带注释/单测；某目录只用特定框架或禁止改敏感文件；审查、重构、文档、迁移、安全扫描等用 Skills/Commands 标准化；大需求由主 Agent 规划、子 Agent 分模块执行；提交前检查、PR 描述生成、依赖升级等用 Commands 统一流程。
| 类型 | 功能 | 使用场景 |
|---|---|---|
| Rules | 约束 Agent 行为（规范、安全、路径级策略）；可始终/按路径/手动生效。 | 统一代码风格、必须带注释/单测、某目录只用特定框架、禁止改敏感文件、合规与安全。 |
| Skills | 专项能力，Agent 认为相关时自动调用，也可通过 /技能名 手动触发。 | 审查、重构、单测、文档、迁移、安全扫描等可复用任务。 |
| Subagents | 专用子 Agent，主 Agent 按需调用、可并行。 | 大任务拆解、不同专长（测试/文档）、并行多文件/多模块修改。 |
| Commands | / 前缀触发的标准化工作流（如 /review、/refactor）。 | 提交前检查、PR 描述生成、依赖升级、发布清单等团队统一流程。 |
1.8 Hooks
入口：Settings → Hooks
功能：在指定时机（如保存、提交、构建、运行前后）自动执行自定义逻辑或脚本；可查看 Execution Log 执行记录。
用途：在关键节点自动执行检查、格式化、通知；与 CI、钉钉/Slack、看板等衔接；统一团队在相同时机执行相同步骤。
典型场景：提交前 lint/格式化/单测；保存后格式化或同步文档；构建/运行前后拉依赖或发通知。
1.9 Indexing & Docs
入口：Settings → Indexing & Docs
功能：代码库嵌入索引（Codebase Indexing）与自定义文档索引（Docs），提升模型对项目与外部资料的理解与引用能力。对应官方 Semantic Search、@ Mentions 等。
用途：大仓库理解与跨模块修改、依赖框架/API 文档引用、新人上手、用 .cursorignore 排除无关或敏感内容以加快索引并保证安全；与速度和稳定性相关（索引过大或未排除 build/node_modules 会拖慢或超时）。
| 功能 | 说明 | 典型场景 |
|---|---|---|
| Codebase Indexing | 将代码库做嵌入以增强上下文理解；可 Sync/Delete Index；用 .cursorignore 控制排除；Index New Folders 可自动索引新文件夹（通常限制少于 5 万文件）。 | 大仓库理解与跨模块修改；新人上手；排除 node_modules、build、.env 等加快索引并保证安全。 |
| Docs | 爬取并索引自定义资源与开发者文档（官网、API、内部 wiki），在 Chat/编辑时通过 @Add 引用。 | 依赖框架/第三方库时，将官方文档或内部说明添加为 Doc，保证生成代码符合文档与最佳实践。 |
1.10 Network
入口：Settings → Network
功能：配置与后端 AI 服务通信的 HTTP 协议版本（HTTP Compatibility Mode：HTTP/2、HTTP/1.1、HTTP/1.0），以及 Run Diagnostic 检查网络连通性（DNS、SSL、API、Ping、Chat、Agent、Marketplace 等）。
用途：在稳定网络下用 HTTP/2 获得更好流式响应；在代理/VPN/企业网下改为 HTTP/1.1 或 HTTP/1.0 提高连通率；自助排查连不通或流式卡顿时使用。详细现象与解决方案见本文档第四部分「遇到的网络问题及解决方案」。
1.11 Beta
入口：Settings → Beta
功能：体验尚未正式发布或默认关闭的功能，如更新渠道（Update Access）、Agent 输入时的补全（Agent Autocomplete）、扩展性能分析（Extension RPC Tracer）等。对应官方 Update Access。
用途与场景：
| 选项 | 功能 | 用途与典型场景 |
|---|---|---|
| Update Access | 选择 Cursor 更新渠道：Default / Early Access / Nightly。 | Default：稳定版；Early Access：提前体验新功能；Nightly：最新构建，适合参与测试、反馈问题。 |
| Agent Autocomplete | 在向 Agent 输入时提供上下文相关建议（Contextual suggestions while prompting Agent）。 | 写 prompt、改文档时减少重复输入，加快与 Agent 的交互。 |
| Extension RPC Tracer | 将扩展主机 RPC 消息记录到 JSON 文件，可在 Perfetto 中查看以做性能分析。 | 调试或优化 Cursor 扩展、分析 IDE 或自定义工具性能时使用。 |
1.12 Docs（底部链接）
入口：Settings 页面底部的 Docs 链接（带外部链接图标）。
功能：跳转到 Cursor 官方文档站点（cursor.com/docs）。
用途与场景：查阅最新功能说明、Models、Pricing、Agent、Context、Features、Integrations、Configuration、Troubleshooting 等；与本文档配合使用，本文档侧重「按设置目录的功能与场景」与「配置组合、使用、建议、网络问题」，官方 Docs 为权威与更新来源。
二、配置组合与使用场景分析
以下分析多种配置组合在一起时的典型使用场景与取舍，便于在「稳定性、计费、速度、隐私、团队协作」等维度做整体方案选择。内容不删减，仅做归纳与深化。
2.1 组合维度说明
| 维度 | 涉及设置 | 简要说明 |
|---|---|---|
| 隐私与合规 | General（Privacy Mode）、Agents（保护、白名单）、Indexing（.cursorignore） | 敏感/企业项目时优先隐私与保护，可能牺牲部分云端能力。 |
| 计费与额度 | Models（Auto vs 自选、成本档位）、General（Manage Account） | Auto 不占额度；自选 Low/Fast/Flash 单次便宜；High/Opus 单次贵。 |
| 速度与延迟 | Models（Fast/Flash/Haiku）、Tab、Indexing（排除大目录）、Network（HTTP 模式） | 选快模型、减上下文、直连+HTTP/2 有利于速度。 |
| 稳定性与长连接 | Network（HTTP 模式、Diagnostics）（见第四部分） | 稳定网络或代理 + HTTP/1.1、减少 Reconnecting。 |
| 团队规范与流程 | Rules、Skills、Subagents、Commands、Hooks、Agents（Review、Attribution） | 统一风格、审查、提交前检查、PR 描述等。 |
| 复杂任务与架构 | Models（High/Opus）、Rules、Subagents、Indexing（大仓+Docs） | 多文件/整库重构、设计、文档引用。 |
| 前端与联调 | Tools & MCP（Browser、MCP）、Agents（Browser 保护、MCP 白名单） | 本地服务调试、自动化操作网页、调用外部 API。 |
2.2 典型组合场景（深入分析）
组合一：企业/敏感项目（隐私与合规优先）
- 配置要点：General → Privacy Mode 开启；Agents → File-Deletion、Dotfile、External-File Protection 开启，Command/MCP Allowlist 收紧；Indexing → .cursorignore 排除敏感路径；Models → 可用 Auto 或指定厂商以控制数据出口。
- 场景：客户机密或公司闭源项目，代码不能用于训练、且需防止 Agent 误删/误改关键文件或工作区外文件。
- 取舍：部分云端/Background Agent 能力可能受限；需依赖本地或允许的模型与上下文。
组合二：日常快速开发（速度与体验优先）
- 配置要点：Models → Auto 或 Fast/Flash/Haiku；Tab → Cursor Tab 开启、Imports 开启；Indexing → 启用 Codebase Indexing 但用 .cursorignore 排除 node_modules/build；Network → 直连 + HTTP/2（若环境允许）。
- 场景：日常写业务代码、补全、小改、快速问答；希望首 token 快、流式输出顺畅。
- 取舍：Auto 不占额度但无法指定厂商；自选 Fast 占额度但可控。
组合三：省额度（计费优先）
- 配置要点：Models → Auto 为主，必要时自选 Haiku、GPT-5.2 Low Fast、Gemini Flash；Agents → 减少单次 @ 大文件/整文件夹；Indexing → 控制索引范围，减少无关上下文。
- 场景：月度额度紧张或希望尽量不超支；仍要保证基本补全与对话。
- 取舍：复杂任务可能需切到 High/Opus 会单次消耗较多。
组合四：复杂任务/架构（能力优先）
- 配置要点：Models → Opus 4.6 / 4.6 Max、GPT-5.2 High/Extra High、Codex High/Extra High；Rules → 约束架构与命名；Subagents → 大任务拆解、并行多模块；Indexing → 大仓索引 + Docs 引用官方/内部文档。
- 场景：整库迁移、超长 PRD 拆解、多文件重构、架构评审、大型单测与文档生成。
- 取舍：单次消耗高、响应可能较慢；适合偶发重任务而非高频轻量。
组合五：前端/联调（Browser + MCP）
- 配置要点：Tools & MCP → Browser Automation 连接标签页，Show Localhost Links in Browser 开启；添加所需 MCP 服务器；Agents → Browser Protection 按需关闭以允许自动操作，MCP Allowlist 开放相应 server/tool。
- 场景：本地前端服务（如 localhost:3000）开发、自动化操作页面、调用地图/API 等 MCP 工具。
- 取舍：开放 Browser/MCP 自动运行会带来一定风险，建议仅在可信环境使用。
组合六：团队规范与流程统一
- 配置要点：Rules → 统一代码风格、必须注释/单测、某目录只用某框架；Skills + Commands → 审查、重构、提交前检查、PR 描述生成、依赖升级等 / 命令；Hooks → 提交前 lint/格式化/单测；Agents → Agent Review on Commit、Attribution 按团队要求。
- 场景：多人协作、希望 AI 输出符合团队规范、且关键流程（提交、PR）可追溯、可自动化。
- 取舍：规则过多可能限制 Agent 灵活性；需定期维护 Rules/Skills/Commands。
组合七：稳定优先（减少断连与异常）
- 配置要点：Network → HTTP/2 优先（不行再降 HTTP/1.1）；选用稳定网络或代理；Models → 选成熟、文档多的（如 Sonnet、GPT-5.2 系）；Indexing → .cursorignore 排除大目录，减少超时与异常。
- 场景：对长连接稳定性要求高、不希望频繁 Reconnecting；公司网络或代理环境一般。
- 取舍：需根据实际网络环境在协议与节点间权衡。
2.3 组合取舍小结
- 隐私/合规 与 云端能力/便利 往往此消彼长；计费 与 能力/速度 可通过 Auto + 自选档位搭配平衡。
- 速度 受模型、上下文大小、网络与 HTTP 模式共同影响；稳定性 受网络、代理、长连接策略影响最大。
- 团队规范 依赖 Rules/Skills/Commands/Hooks 组合，与 Agents 行为（Review、Attribution）一致配置效果更好。
- 实际使用中可先定「优先维度」（如先省额度、先求稳），再在对应组合上微调（例如在「组合二」基础上加 Rules 做轻度规范）。
三、使用与建议（放在文档后半，便于按需查阅）
以下为使用方式、选型与计费建议、综合对比与问题主次，内容不删减，仅按「使用 → 建议」顺序整理。
3.1 使用（用途、选型、场景）
3.1.1 Cursor 的用途及使用场景
Cursor 是一款 AI 优先的 IDE：在完整开发环境（文件管理、设置、终端）之上，把 AI 深度集成到编写、阅读、调试和文档等环节。
| 界面/能力 | 用途 | 典型使用场景 |
|---|---|---|
| 左侧文件树 / 项目上下文 | 项目管理与导航 | 通过当前打开/选中文件为 AI 提供上下文，做「基于本项目的」问答与修改。 |
| 设置（如 Beta） | 功能与体验配置 | Update Access、Agent Autocomplete、Extension RPC Tracer 等。 |
| 右侧 AI 对话 + 编辑器 | 理解需求并直接改文件 | 根据自然语言整理、追加或重构内容；在长文档中做结构化编辑。 |
| 集成终端 | 命令行与脚本 | 在 IDE 内执行命令，与 AI 辅助编辑配合使用。 |
典型场景小结：智能文档助手、上下文感知的 Agent 补全、完整开发环境、调试与性能分析、前沿功能体验（Early Access / Nightly）。
3.1.2 从需求到选模型（流程示意）
3.1.3 使用场景建议（速查）
| 场景 | 推荐模型类型 |
|---|---|
| 日常写代码、补全、小改 | Sonnet 4.5、GPT-5.2 Fast、Opus 4.6 Fast、Gemini Flash、Haiku 4.5 |
| 代码理解、重构、复杂逻辑 | Opus 4.6 / 4.6 Max、GPT-5.2 High/Extra High、GPT-5.2 Codex High/Extra High |
| 要速度又要一定能力 | GPT-5.2 High Fast、Opus 4.6 Fast、Gemini 3 Flash |
| 专注代码、少用额度 | GPT-5.2 Codex Fast、Grok Code、GPT-5.2 Low Fast |
| 超长上下文（整库/长文档） | Sonnet 4 1M（MAX Only）、Opus 4.6 Max（若可用） |
| 不纠结、用默认 | Composer 1 或当前默认模型 |
| 自定义/自有 API | 通过「Add Custom Model」与「API Keys」配置 |
| 尽量省额度 | Haiku、GPT-5.2 Low/Low Fast、Codex Mini/Low、Gemini Flash、Auto 模式 |
| 额度用完后仍想用 | 改用 Auto（不额外扣费）或设置支出上限按 API 价加购 |
3.2 建议（计费总览、综合对比、问题主次）
3.2.1 计费总览
| 档位 | 月费 | 是否收费 | 模型用量概要 |
|---|---|---|---|
| Hobby | 免费 | 否 | 有限次 Agent 请求、有限 Tab 补全；可试用一周 Pro。 |
| Pro | 约 $20/月 | 是 | 每月约 $20 额度（按 API 价折算），用于自选前沿模型；Tab 补全不限；Auto 模式不限。 |
| Pro+ | 约 $60/月 | 是 | 在 Pro 基础上，用量约为 Pro 的 3 倍。 |
| Ultra | 约 $200/月 | 是 | 用量约为 Pro 的 20 倍；MAX Only 模型仅此档可用；优先新功能。 |
| Teams | 约 $40/人/月 | 是 | 含 Pro 能力 + 团队共享、统一账单、SSO 等。 |
计费规则要点：按实际消耗的 API 成本从当月额度中扣除；Auto 模式在 Pro 及以上不占用前沿模型月度额度；自选模型按该模型 API 价扣减；超出额度后可设置支出上限或改用 Auto。MAX Only 仅 Ultra 可用。
计费决策流程（何时用 Auto / 自选）：
3.2.2 综合对比（稳定性、计费、速度）与典型组合建议
| 维度 | 优先稳定性 | 优先省计费 | 优先速度快 |
|---|---|---|---|
| 订阅 | Pro 及以上 | Hobby 试玩；Pro 够用则不必 Pro+/Ultra | Pro 用 Auto 不占额度且自动平衡速度 |
| 模型选择 | 选成熟、文档多的（如 Sonnet、GPT-5.2 系） | Auto / Haiku / Low / Low Fast / Flash | Fast / Flash / Haiku / Auto |
| 网络 | 直连或稳定代理 + HTTP/1.1 | — | 低延迟节点或直连 + HTTP/2 |
| 长连接 | 直连减少 Reconnecting；必要时 keep-alive-interval | — | 同上 |
| 本机/索引 | .cursorignore 排除大目录 | 减少单次上下文，省额度也省时间 | 关不必要的扩展与标签页 |
| 目标 | 推荐组合（简述） |
|---|---|
| 稳定第一 | Pro 或以上 + 直连（或稳定代理）+ Sonnet 4.5 / GPT-5.2 Fast + HTTP/2（不行再降 1.1）+ .cursorignore 排除无关目录 |
| 省钱第一 | Pro 用 Auto 不扣额度；额度紧张时自选 Haiku、GPT-5.2 Low Fast、Gemini Flash；少贴大文件、少开 High/Opus |
| 速度第一 | 自选 GPT-5.2 Fast / Gemini Flash / Haiku 或 Auto；减少 @ 范围；直连 + HTTP/2；本机 SSD、足够内存、关多余扩展 |
3.2.3 问题主次与查阅顺序
- 能否连上（主）：不能连上则先看 四、遇到的网络问题及解决方案（含 Diagnostics、HTTP 模式）。
- 是否太慢（主）：能连但慢，先看 4.1 如何让 Cursor 回复更快 与上表模型/网络组合。
- 额度/计费（次）：再看 3.2.1 计费总览 与 一、1.4 Models，决定是否多用 Auto 或换低成本模型。
- 具体模型能力（按需）：查 一、1.4 Models 按厂商/系列详细表。
四、遇到的网络问题及解决方案（放在文档最后）
以下集中整理连接不通、Reconnecting、HTTP 模式、Diagnostics 等常见网络问题与处理方式，便于排查时一次性查阅。
4.1 如何让 Cursor 回复更快（与网络无关的优化）
| 方面 | 做法 |
|---|---|
| 选更快的模型 | 选用 Fast / Low / Flash / Haiku（如 GPT-5.2 Fast、Sonnet 4.5、Gemini Flash、Haiku 4.5），少用 High / Extra High / Max。 |
| 用 Auto 模式 | 选择 Auto 时由 Cursor 自动选模型，一般会兼顾速度，且不占自选额度。 |
| 减少单次上下文 | 少贴整份大文件、少「@ 整个文件夹」；只 @ 当前文件或必要片段。 |
| 补全与对话分工 | Tab 补全用默认或轻量模型；需要「长思考」的再单独开对话用强模型。 |
编辑器更流畅：用 .cursorignore 排除 node_modules、vendor、构建产物等；关掉不用的扩展；本机 SSD + 足够内存（如 16GB+）。
4.2 速度/连接问题排查流程
4.3 连接不通 / 无法访问时的排查
| 现象 | 可能原因 | 处理建议 |
|---|---|---|
| 一直转圈、超时 | 网络到 Cursor 服务器不可达或被限制 | 检查本机网络、防火墙与 DNS。 |
| 登录失败、无法验证 | 网络不可达或 DNS 异常 | 换 DNS（如 8.8.8.8 / 1.1.1.1）再试；检查网络环境。 |
| 间歇性断连、请求失败 | 网络不稳定 | 换更稳定的网络；或将 Settings → Network 中 HTTP 兼容模式改为 HTTP/1.1 再试。 |
| 提示配额/订阅错误 | 账号或订阅异常 | 在 Settings → Subscription 检查是否过期、是否欠费；必要时重新登录。 |
可先 ping 或浏览器访问 cursor.com / cursorapi.com，确认本机能否解析和连通；若不能，多半是网络或代理配置问题。
4.4 频繁 Reconnecting 与长连接稳定性
- 原因：并非每次提问都新建长连接，而是之前的连接已断开，Cursor 在重新建连。常见原因包括：空闲超时、代理超时、防火墙/NAT 超时、网络或代理不稳定、代理对 WebSocket/长连接支持差、本机休眠或锁屏后断网。
- 做法：换更稳定的网络；Settings → Network 将 HTTP 兼容模式降为 HTTP/1.1；避免长时间空闲后一次发很多请求；需要长连时暂时避免休眠/锁屏断网。
4.5 网络设置：HTTP 兼容模式（Settings → Network）
| 模式 | 说明 | 如何选择 |
|---|---|---|
| HTTP/2 | 推荐；支持多路复用，低延迟流式响应更好。 | 默认优先选：直连或网络正常时用。 |
| HTTP/1.1 | 兼容性较好，部分代理/VPN 对 HTTP/2 支持不完整。 | 连不通或流式卡顿时：在公司代理或 VPN 环境下，若 HTTP/2 出现超时、断连、一直转圈，可改为 HTTP/1.1 再试。 |
| HTTP/1.0 | 最老、兼容性最好，效率最低。 | 仅在必要时：HTTP/1.1 仍失败（如某些老旧代理只支持 1.0）时再试。 |
若 Network Diagnostics（DNS / SSL / API / Ping / Chat / Agent / Marketplace）中有项失败，可先改为 HTTP/1.1 后点「Show Logs」或重新检测，再视情况决定是否用 HTTP/1.0。
4.6 速度与稳定性小结
- 要回复更快：选 Fast/Flash/Haiku、用 Auto、减上下文、优化本机与索引。
- 连不通：先看网络能否访问 cursor.com；再查账号与订阅；必要时在 Settings → Network 将 HTTP 兼容模式降为 HTTP/1.1 或 HTTP/1.0。
- Reconnecting：换更稳定网络、降低 HTTP 兼容模式、避免长时间空闲或休眠后集中请求。
附录
A. 订阅与可见性
| 标签 | 含义 | 影响 |
|---|---|---|
| 无特殊标签 | Pro/Pro+ 一般可用 | 消耗对应档位额度 |
| MAX Only | 仅 Ultra 订阅 | Pro/Pro+ 无法启用 |
常见 MAX Only 模型：Opus 4.6 Fast、Opus 4.6 Max Fast、Sonnet 4 1M 等。
B. 模型列表汇总（按系列）
Cursor: Composer 1
xAI: Grok Code
Anthropic: Opus 4.6 / 4.6 Max / 4.6 Fast(MAX) / 4.6 Max Fast(MAX), Opus 4.5,
Sonnet 4.5, Sonnet 4, Sonnet 4 1M(MAX), Haiku 4.5
OpenAI: GPT-5.2 全系列 (含 Fast/High/Extra High/Low 及 Codex 线),
GPT-5.1 Codex Max 全系列, GPT-5.1 High, GPT-5.1 Codex Mini, GPT-5 Mini
Google: Gemini 3 Pro/Flash, Gemini 2.5 Flash
其他: Kimi K2, + Add Custom Model
C. 说明与更新
- 计费与订阅：本文档中的价格与额度为公开信息整理（含 2025 年 6 月后按用量计费），是否收费、额度多少、单模型成本均以 Cursor 官网 cursor.com/pricing 及应用内 Settings → Subscription 为准。Composer 1 为 Cursor 自带模型，通常不占用或仅少量占用前沿模型月度额度，最终以应用内用量/说明为准。
- 模型成本档位：「低/中/高」为同一系列内相对比较，便于选型；实际扣费以 Cursor 按 API 价折算为准。
- 列表中同一名称可能出现两次（有/无脑图标）：多为不同入口或配置，以界面实际说明为准。
- 模型列表与命名可能随 Cursor 版本更新，以应用内 Settings → Models 为准。
- 使用 Add Custom Model 与 API Keys 可接入未在列表中的模型；其计费由对应 API 提供方决定，不占用 Cursor 月度额度（或按 Cursor 规则另行计费）。
- 更多功能与排错可参考 Cursor 官方文档 与 Troubleshooting。
（文档完。按设置目录查阅请用第一部分；配置组合与取舍见第二部分；使用与建议见第三部分；网络问题及解决方案见第四部分。）
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
13
0- 0
已为社区贡献24条内容
所有评论(0)