Cursor

Cursor 是我个人平时写代码最常用的客户端,把它配成 HyperAI Relay 的 provider 是我做这个 relay 的第一个验证场景。

适合谁

  • 日常在 IDE 里写代码,希望 Cmd+K / Composer 都走 Opus 4.6
  • 不想被 Cursor 内置的模型路由策略(有时会悄悄降级到 Sonnet/Haiku)影响出厂体验
  • 想用同一张 API Key 串起 IDE + CLI + Desktop 多个客户端

配置步骤

  1. 打开 Cursor,进入 Settings → Models(或 Cmd+, 搜索 "model")
  2. 往下滚到 Override OpenAI Base URL / Add Custom Provider 区域,选 "Anthropic" 作为协议类型
  3. 填这三项:
  4. Base URL:https://api.hyper-ailab.com
  5. API Key:我在 /app/keys 生成的 sk-relay-xxx
  6. Model:claude-opus-4-6(我默认推荐,想省钱可以换 claude-sonnet-4-6)
  7. 点 Save,重启 Cursor
  8. 在一个代码文件里 Cmd+K,问一句简单的"解释这个函数",看返回里有没有 Opus 的签名特征(长 CoT + 分段说明)

如果你嫌手配麻烦,直接访问 /app/connect,Cursor 卡片里有一键复制的 Base URL + 自动生成的 API Key,粘过去就完事。

常见问题

Q:Cursor 里能用 Memory 吗? A:Cursor 目前不支持在对话里声明 tools 数组,所以 Memory Tool 在 Cursor 上不会被 Claude 主动触发。我建议的搭配是:用 Cursor 写代码,用 Claude Code / API 直连来维护 Memory。两边共用一个 API Key,Memory 存一次,所有客户端都能看。

Q:流式响应卡顿、半天没第一个字符? A:先看 /app/usage 有没有请求记录。如果 relay 已经收到请求但 Cursor 没显示,通常是 Cursor 自己的 SSE buffer 问题,换成 Sonnet(体积小、首 token 更快)能明显缓解。

Q:Cursor 显示 401? A:90% 是 API Key 粘错了(少了前缀 sk-relay- 或多了空格),10% 是上个月的 key 已经被我在 /app/keys 吊销。重新生成一个贴进去即可。

Q:能不能只让 Composer 走 Opus,Cmd+K 走 Sonnet? A:可以,Cursor 支持给不同场景指定不同 model。配两个 Custom Provider,一个填 claude-opus-4-6,一个填 claude-sonnet-4-6,场景里分别挂。

下一步