Agent Mode

智能体模式

切换 AI 助手的工作模式，如 Basic（基础）、Advanced（高级）、Custom（自定义），高级模式下 AI 可执行更复杂的多步骤任务（如自动调试、部署）。

Auto-Suggestions

自动建议

控制是否在编码时实时显示 AI 代码补全建议，可设置触发时机（如输入时、暂停时）。

Context Window Size

上下文窗口大小

定义 AI 能读取的代码上下文范围（如当前文件、打开的标签页、整个项目），范围越大，AI 对项目的理解越全面，但响应速度可能变慢。

Max Tokens per Response

单次响应最大 Token 数

限制 AI 单次回复的 Token 数量，避免过长输出，平衡信息完整性与响应效率。

Browser Automation

浏览器自动化

开关：On/Off<br>描述：Browser automation disabled（浏览器自动化已禁用）<br>允许 AI 自动控制浏览器（如 Playwright/Selenium 驱动），用于网页测试、爬虫开发、前端页面自动化验证等场景，默认关闭以保障安全。

Show Localhost Links in Browser

在浏览器中显示本地链接

开关：On/Off<br>描述：Automatically open localhost links in the Browser Tab（自动在浏览器标签页打开 localhost 链接）<br>开启后，当本地服务启动（如 localhost:3000），Cursor 会自动在浏览器或内置标签页打开预览地址，方便开发调试。

Terminal Access

终端访问权限

允许 AI 直接在终端执行命令（如安装依赖、运行脚本、Git 操作），需谨慎开启，避免恶意命令执行风险。

File System Access

文件系统访问

控制 AI 对项目文件的读写权限，可设置为「只读」「仅修改指定目录」或「完全访问」，用于 AI 自动创建/修改代码文件、重构项目结构。

API Access

API 访问

允许 AI 调用外部 API（如代码检查工具、云服务接口），扩展 AI 能力边界。

Enforce Linting

强制代码检查

开启后，AI 生成的代码会自动遵循项目的 ESLint/Prettier 等规范，不符合规则的代码会被标记或修正。

Type Checking

类型检查

针对 TypeScript 等语言，要求 AI 生成的代码符合类型定义，避免类型错误。

Test Generation

测试用例生成

控制 AI 是否自动为代码生成单元测试/集成测试用例，可设置测试覆盖率要求。

Share Code with AI Provider

与 AI 服务商共享代码

开关：On/Off<br>关闭后，Cursor 不会将你的代码上传到第三方 AI 服务，仅在本地处理（部分功能可能受限）。

Sensitive Data Redaction

敏感数据脱敏

自动识别并屏蔽代码中的密钥、Token、密码等敏感信息，避免泄露。

Session Data Retention

会话数据保留

设置 AI 对话历史的保留时长，可选择「仅当前会话」「1天」「7天」或「永久」，用于隐私保护。

Custom Prompts

自定义提示词

允许开发者编写专属系统提示词，定制 AI 的行为风格（如「更简洁的代码」「优先性能优化」）。

Model Selection

模型选择

切换底层 AI 模型（如 GPT-4o、Claude 3），不同模型在代码理解、生成速度、成本上有差异。

Debug Logging

调试日志

开启后，记录 AI 与工具的交互日志，用于排查功能异常或分析 AI 决策过程。