Cursor | MaiToken

适合已经使用 Cursor，并希望将 Chat、Composer 或 Agent 的模型请求切换到 MaiToken 的用户。

Cursor 的 Tab 补全、Auto 和部分内置能力可能仍然使用 Cursor 自己的服务。本节主要介绍如何配置 OpenAI API Key 和 Base URL。

打开 Cursor 设置： 启动 Cursor，按下 Cmd/Ctrl + ,，或直接打开 Cursor Settings。
进入模型页面： 找到 Models、Models & API Keys 或 API Keys。
填写 OpenAI API Key： 在 OpenAI API Key 一栏中粘贴您自己的 MaiToken Key。
覆盖 Base URL： 打开 Override OpenAI Base URL（when using key），填写 https://api.maitoken.com/v1 。
验证配置： 单击 Verify。如果验证失败，但接口自检成功，请检查 Cursor 是否自动使用了不在当前 API Key 权限范围内的默认模型。
添加模型： 如果页面提供 Add Custom Model，请在模型 ID 中填写 <模型ID>。如果没有该入口，则只能选择 Cursor 当前允许绑定到自定义 OpenAI Key 的模型。
选择模型： 回到 Chat 或 Composer，关闭 Auto，然后从模型选择器中选择刚刚配置的模型。

字段	填写内容
OpenAI API Key	`<你的 MaiToken Key>`
Override Base URL	https://api.maitoken.com/v1
Model	`<模型ID>`，以当前 Cursor 界面允许添加或选择的模型为准

测试普通对话： 在聊天框中输入“只回复 OK”。如果收到正常回复，说明 API Key、API 地址和模型 ID 基本正确。
测试项目读取： 打开一个测试项目，输入“请读取当前项目目录，只列出一级文件名，不要修改任何文件。”
测试 Agent： 让模型新建一个名为 test-maitoken.txt 的文件并写入 hello，然后确认文件已经生成。请勿使用真实生产项目进行测试。

问题	处理建议
Verify 失败	确认 Base URL 只填写到 `/v1`，并检查 Cursor 验证时使用的模型是否在 API Key 的模型限制列表中。
Chat 可用但 Agent 不可用	模型可能不支持 `tool_calls`，或者 Cursor 限制了该自定义模型的 Agent 能力。
费用仍然由 Cursor 收取	检查是否仍然选择了 Auto 或 Cursor 内置模型。自定义 API Key 不会替换 Cursor 的全部功能。