Cursor

Cursor 是面向开发者的 AI IDE，可以在聊天、编辑和 Agent 工作流中调用模型。新手如果主要想在代码编辑器里使用 AIDMX 辅助写代码，可以选择 Cursor；如果只是验证 Token、Base URL 和模型名称是否能请求成功，请先用 Apifox 或 Postman。

下载和官方入口

入口	地址	说明
官方下载	https://cursor.com/download	Windows、macOS、Linux 桌面端优先从这里下载。
官方文档	https://docs.cursor.com	查看模型、设置、账号和 IDE 功能说明。
官方网站	https://cursor.com	了解 Cursor 产品和账号入口。

平台支持

平台	支持状态	推荐方式	注意事项
Windows	支持	官方下载页安装包	安装后在 IDE Settings 配置模型。
macOS	支持	官方下载页安装包	Apple Silicon / Intel 以下载页标注为准。
Linux	支持	官方下载页安装包	包类型和更新方式以当前官方说明为准。
Web / Docker	不适用	使用桌面 IDE	Cursor 的 AIDMX 配置入口在 IDE 设置里。

安装后检查

• 打开 Cursor，确认能进入 IDE Settings。
• 确认当前版本支持自定义 OpenAI Base URL 或 OpenAI Compatible Provider。
• 在 AIDMX 令牌管理 创建一个 API Token。
• 在 AIDMX 控制台复制要用于代码任务的完整模型名称。

配置 AIDMX

Cursor 的配置入口在 IDE 设置里。不同版本字段名称可能变化，请以当前界面为准，按下面的关系填写：

1. 打开 Cursor Settings 中的 Models、AI Provider 或 API Key 相关页面。
2. 新增 OpenAI Compatible Provider。
3. Base URL 填写 https://ai.aidmx.xyz/v1。
4. API Key 填写你的 AIDMX API Token。
5. 模型名称填写 AIDMX 控制台可用模型名称。
6. 保存后，在 Cursor Chat、编辑或 Agent 入口选择刚添加的 AIDMX 模型。

如果 Cursor 当前版本的界面字段名称不同，可以按下图的通用映射处理：API 请求地址对应 https://ai.aidmx.xyz/v1，API Key 对应 AIDMX Token，模型名称以控制台可用模型为准。

成功验证

• Cursor Chat 能返回模型回复。
• 代码编辑或 Agent 功能能使用所选模型。
• AIDMX 使用日志 中出现 Cursor 请求，能看到 Token、模型名称和消耗记录。

常见失败

• Cursor 自动拉取模型列表失败：手动填写模型名称。
• Base URL 报错：确认是否需要填写到 /v1，不要重复拼接 /v1/v1。
• 请求很慢或中断：降低上下文规模，或选择更适合代码任务的 AIDMX 模型。
• 设置没有生效：重启 Cursor，并确认当前 workspace 没有覆盖配置。
• 使用日志没有记录：请求可能没有发到 AIDMX，重新检查 Provider、Base URL 和当前选中的模型。

下一步

• 阅读 OpenAI 兼容工具 获取通用排查方式。
• 到 使用日志 查看 Cursor 的实际消耗。
• 使用 Playground 先调好模型参数。