← 返回文档首页

Cursor

在 Cursor 里把 BeansAI 添加为自定义 OpenAI 兼容 provider。

概览

Cursor 通过 Settings → Models → OpenAI API Key → Custom Base URL 支持任意 OpenAI 兼容端点。填 BeansAI 之后,所有 chat / edit / composer 请求都会走我们。

配置

  1. 打开 Cursor SettingsCmd/Ctrl + ,) → Models
  2. 展开 OpenAI API Key,勾上 Override OpenAI Base URL
  3. 填入下方值,点 Verify,保存。
Cursor settings
OpenAI API Key:  sk-beans-...
OpenAI Base URL: https://api.beansai.dev/v1

Models (custom):
  - claude-opus-4-7
  - claude-sonnet-4-6
  - gpt-5.4
  - gemini-2.5-pro

基础用法

在聊天面板的下拉里选任意模型。Cursor 会调用 BeansAI 的 /v1/chat/completions;服务端做了归一化, 所以 claude-opus-4-7 这类非 OpenAI 模型 ID 也能用。

使用技巧

  • 即使设了自定义 URL,OpenAI API Key 开关也要保持开启 —— Cursor 把它当作 Bearer token。
  • 下拉里没有的模型 ID 可以手动填;BeansAI 接受目录里任何 ID。
  • Composer 和 Agent 模式都会遵守这份自定义 provider 配置,无需额外设置。