Docker Sandboxes

本页介绍的是本地沙箱。有关云端行为及其限制，请参阅对比本地沙箱与云沙箱。

本指南介绍在沙箱环境中对 Cursor 进行身份验证、配置和使用的方法。

官方文档：Cursor CLI

快速开始 ​

创建沙箱，并为项目目录运行 Cursor：

console
$ sbx run cursor ~/my-project

sbx run 默认把工作区设为当前目录：

console
$ cd ~/my-project
$ sbx run cursor

要创建无挂载沙箱，使用不带工作区路径的 sbx create，然后按名称连接。

身份验证 ​

Cursor 支持两种身份验证方式：API 密钥或 OAuth。

API 密钥：用存储的密钥保存你的 Cursor API 密钥：

console
$ sbx secret set cursor

OAuth：如果未设置 API 密钥，Cursor 会在首次运行时提示你交互式登录。代理会拦截 与 api2.cursor.sh/auth/poll 的令牌交换，因此凭据由宿主机管理，不会存储在沙箱 内部。

配置 ​

沙箱不会读取宿主机的用户级配置，例如 ~/.cursor。沙箱内只有工作目录中的项目级 配置可用。变通方法请参阅 沙箱为什么不用我的用户级智能体配置？。

Cursor 会从工作区读取 AGENTS.md，获取针对具体智能体的指令。

默认启动命令 ​

不带额外参数时，沙箱运行：

text
cursor-agent --yolo

当 -- 后的第一个参数本身是标志（以 - 开头）时，其余参数会追加到默认标志之后， 因此 --yolo 会被保留：

console
$ sbx run --name <sandbox-name> -- -p "refactor this"   # 运行 cursor-agent --yolo -p "refactor this"

有关提示词和子命令，请参阅 向智能体传递参数。

基础镜像 ​

模板：docker/sandbox-templates:cursor-agent-docker

已预先配置为对智能体流量使用 HTTP/1.1 和服务器推送事件，使请求经由宿主机代理 转发。身份验证状态在沙箱重启后依然保留。

有关预装工具或自定义此环境，请参阅自定义。