cursor-agent-api-proxy

把你的 Cursor 订阅变成 OpenAI 兼容的 API 接口。

本项目将 Cursor CLI（agent 命令）包装为标准的 HTTP API 服务，让 OpenClaw、Continue.dev 等任何支持 OpenAI 格式的工具都能直接调用你的 Cursor 订阅额度。

支持 macOS、Linux、Windows。

快速开始

1. 安装 Cursor CLI

macOS / Linux / WSL：

curl https://cursor.com/install -fsS | bash
export CURSOR_API_KEY=your_key_here

Windows (PowerShell)：

irm 'https://cursor.com/install?win32=true' | iex
$env:CURSOR_API_KEY="your_key_here"

2. 安装本项目

方式 A — npm 全局安装（推荐）：

npm install -g cursor-agent-api-proxy
cursor-agent-api

方式 B — 从源码：

git clone https://github.com/tageecc/cursor-agent-api-proxy.git
cd cursor-agent-api-proxy
pnpm install && pnpm run build
pnpm start

服务默认运行在 http://localhost:4646。

试一下

macOS / Linux / WSL：

# 非流式
curl -X POST http://localhost:4646/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"cursor/auto","messages":[{"role":"user","content":"Hello!"}]}'

# 流式
curl -N -X POST http://localhost:4646/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"cursor/auto","messages":[{"role":"user","content":"Hello!"}],"stream":true}'

Windows (PowerShell)：

# 非流式
Invoke-RestMethod -Method POST -Uri http://localhost:4646/v1/chat/completions `
  -ContentType "application/json" `
  -Body '{"model":"cursor/auto","messages":[{"role":"user","content":"Hello!"}]}' | ConvertTo-Json -Depth 10

# 流式 (curl.exe 在 Windows 10+ 内置)
curl.exe -N -X POST http://localhost:4646/v1/chat/completions `
  -H "Content-Type: application/json" `
  -d '{\"model\":\"cursor/auto\",\"messages\":[{\"role\":\"user\",\"content\":\"Hello!\"}],\"stream\":true}'

配置 OpenClaw

{
  env: {
    // 填你的 Cursor API Key，会透传给 Cursor CLI
    OPENAI_API_KEY: "your_cursor_api_key",
    OPENAI_BASE_URL: "http://localhost:4646/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/cursor/auto" },
    },
  },
}

OPENAI_API_KEY 可以直接填你的 Cursor API Key。代理会从 Authorization header 提取并透传给 Cursor CLI。如果你已经在系统环境变量里设置了 CURSOR_API_KEY，这里填 "not-needed" 也行。

支持的模型

通过 cursor/ 前缀指定模型：

也支持 cursor-auto、cursor-opus-4.6 等 dash 格式（兼容不支持 / 的客户端）。

完整列表调 GET /v1/models 查看。

API

环境变量

端口也可以通过命令行参数指定：cursor-agent-api 8080

原理

你的客户端 (OpenClaw / Python / curl ...)
    │
    │  POST /v1/chat/completions  (OpenAI 格式)
    ▼
cursor-agent-api-proxy (本项目)
    │
    │  spawn("agent", ["-p", "--output-format", "stream-json", ...])
    │  prompt 通过 stdin 传入
    ▼
Cursor CLI (agent)
    │
    │  使用你的 Cursor 订阅额度
    ▼
AI 模型响应 → 转为 OpenAI 格式 → 返回客户端

其他客户端配置

Python (openai SDK)

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:4646/v1",
    api_key="your_cursor_api_key",  # 或 "not-needed"
)

resp = client.chat.completions.create(
    model="cursor/auto",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

Continue.dev

{
  "models": [{
    "title": "Cursor",
    "provider": "openai",
    "model": "cursor/auto",
    "apiBase": "http://localhost:4646/v1",
    "apiKey": "your_cursor_api_key"
  }]
}

开机自启

macOS (LaunchAgent)

cat > ~/Library/LaunchAgents/com.cursor-agent-api.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.cursor-agent-api</string>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/node</string>
    <string>/usr/local/lib/node_modules/cursor-agent-api-proxy/dist/server/standalone.js</string>
  </array>
  <key>EnvironmentVariables</key>
  <dict>
    <key>PATH</key>
    <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
    <key>CURSOR_API_KEY</key>
    <string>your_key_here</string>
  </dict>
</dict>
</plist>
EOF

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.cursor-agent-api.plist

Windows (Task Scheduler)

打开 PowerShell（管理员），运行：

$action = New-ScheduledTaskAction `
  -Execute "node.exe" `
  -Argument "C:\Users\$env:USERNAME\AppData\Roaming\npm\node_modules\cursor-agent-api-proxy\dist\server\standalone.js"

$trigger = New-ScheduledTaskTrigger -AtLogon

$settings = New-ScheduledTaskSettingsSet `
  -AllowStartIfOnBatteries `
  -DontStopIfGoingOnBatteries `
  -RestartCount 3 `
  -RestartInterval (New-TimeSpan -Minutes 1)

Register-ScheduledTask `
  -TaskName "CursorAgentAPI" `
  -Action $action `
  -Trigger $trigger `
  -Settings $settings `
  -Description "Cursor Agent API Proxy" `
  -RunLevel Highest

路径可能因安装方式不同而变化。运行 npm root -g 查看全局 node_modules 路径。 如需设置 CURSOR_API_KEY，在系统环境变量中添加即可（设置 → 系统 → 高级系统设置 → 环境变量）。

卸载自启：

Unregister-ScheduledTask -TaskName "CursorAgentAPI" -Confirm:$false

Linux (systemd)

sudo tee /etc/systemd/system/cursor-agent-api.service << 'EOF'
[Unit]
Description=Cursor Agent API Proxy
After=network.target

[Service]
Type=simple
User=YOUR_USERNAME
Environment=CURSOR_API_KEY=your_key_here
Environment=PATH=/usr/local/bin:/usr/bin:/bin
ExecStart=/usr/local/bin/node /usr/local/lib/node_modules/cursor-agent-api-proxy/dist/server/standalone.js
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now cursor-agent-api

查看状态：sudo systemctl status cursor-agent-api

项目结构

src/
├── index.ts               # 包导出
├── types/
│   ├── cursor-cli.ts      # Cursor CLI stream-json 输出类型
│   └── openai.ts          # OpenAI API 类型
├── adapter/
│   ├── openai-to-cli.ts   # OpenAI 请求 → CLI prompt
│   └── cli-to-openai.ts   # CLI 输出 → OpenAI 响应
├── subprocess/
│   └── manager.ts         # agent 子进程管理
└── server/
    ├── index.ts           # Express 服务
    ├── routes.ts          # API 路由
    └── standalone.ts      # CLI 入口

License

MIT