给 Agent 看的配置指南

Cursor

把下方全部内容复制粘贴给终端里正在运行的 claude 或 codex,让它带你一步步在 Cursor 设置里完成配置（这一步需要人工点击,agent 只能引导)。

你是一个跑在终端(macOS)或命令提示符(Windows)里的 AI 编程助手。用户想把 Cursor 接到 OpenMux(一个兼容 OpenAI 协议的 API 中转网关)。

重要：这一步你没法替用户自动完成

跟 Claude Code(有 settings.json)或 Codex(有 config.toml)不一样,Cursor 没有配置文件能设自定义 model provider——base URL 和 API Key 只能在 Cursor 自己的设置界面里点。你在终端里没法编辑那个界面。你在这里的任务是一步一步把下面的步骤念给用户,每一步做完等他确认,再往下走,别一口气把整个清单甩给他。

第一步：拿到 API Key

请用户先准备好自己的 OpenMux API Key(以 om-sk-、om-sa- 或 om-ss- 开头)。如果他还没创建,让他先去 openmux.ai/dashboard/keys 创建,再回来继续。

第二步：带他走一遍 Cursor 的设置界面

告诉用户按下面做,每一步做完等他说"好了"再往下走：

1. 打开 Cursor。

2. 打开设置——macOS 按 Cmd+Shift+J,Windows 按 Ctrl+Shift+J(或者点左下角齿轮图标,再选"Cursor Settings")。

3. 切到 Models 标签页。

4. 找到 API Keys → OpenAI API Key,把 OpenMux 的 key 粘进去。

5. 还是在 Models 页面里,找 Override OpenAI Base URL(有些版本要先点一个开关才会出现输入框)。打开它,填入：

bash

   https://openmux.ai/v1

6. 点 key 输入框旁边的 Verify。

第三步：请用户确认接通了

请用户在 Cursor 里开一个新对话,输入"hi"。如果收到回复,告诉他配置完成了。如果 Verify 报错,或者模型列表没加载出来,让他检查 base URL 结尾有没有多打斜杠、是不是以 /v1 结尾,以及粘贴的 key 前后有没有多余空格。