Cursor

开始之前

先按官方说明安装客户端。本文的 Pi 指 pi-mono coding agent；Hermes 指 Nous Research 的 Hermes Agent。

账户开通后，在控制台的「API 密钥」页创建密钥。建议给这个客户端单独建一把；花费上限可以用项目的月度预算来控制。live 和 test 两种前缀走的是同一套推理和计费流程，test 只是环境标签，不代表免费，也不是模拟推理。

Inferway 地址需要 Inferway Key；OpenRouter Key 用于 OpenRouter，不能直接用于此地址。

将 Key 保存在客户端凭证存储或本机环境中，不要粘贴到提示词、截图或提交到仓库的配置文件。终端示例适用于 macOS / Linux 的 bash、zsh。

配置 Cursor

1. 打开 Cursor Settings → Models，在 OpenAI API key 字段填入 Inferway Key 并保存或启用。这里需要实际凭证，不要填写 INFERWAY_API_KEY 这段文字。
2. 启用 Override OpenAI Base URL，填写 https://api.inferway.ai/v1。如果当前版本没有该选项，先核对 Cursor 最新说明。
3. 添加自定义模型，ID 精确填写 xiaomi/mimo-v2.6-flash，启用后在新聊天中明确选择它；验证时不要选择 Auto 或 Cursor 托管模型。

Base URL: https://api.inferway.ai/v1
Model ID: xiaomi/mimo-v2.6-flash
API key: <your Inferway API key>

确认接入成功

1. 使用配置的服务商和模型开启新会话，发送“只回复：连接成功”，确认收到文本且没有 API 错误。
2. 打开控制台的「请求」页，查看请求状态和 Token 用量。
3. 处理代码任务时，让客户端读取一个非敏感文件。应用修改前，请先检查它提出的改动。

Cursor 的限制

Cursor 官方 BYOK 文档覆盖聊天模型，并将 OpenAI 支持描述为普通、非推理聊天模型。Tab 补全使用 Cursor 自带模型；Agent、Composer、编辑、后台请求及 Responses 请求均需单独验证。

Base URL 覆盖也可能影响内置聊天模型。切回 Cursor 托管聊天模型时请关闭该覆盖。若 Inferway 直接请求成功但 Cursor 校验失败，先检查 Cursor 请求的模型和接口，不要反复轮换 Key。

Cursor 的 BYOK 请求会经过其后端构建提示词。Inferway 的留存政策不能代表 Cursor 对代码和提示词的处理方式，请同时了解两端政策。

常见问题

自定义 Base URL 是否对 Tab 代码补全生效？不生效。Cursor 的 Base URL 覆盖只对聊天（Chat）和 Composer 生效。Tab 代码补全继续使用 Cursor 内置模型和独立网络链路。

如何切回 Cursor 默认端点？打开 Cursor 的 Settings -> Models，关闭「Override OpenAI Base URL」开关或清空该输入框，即可恢复使用默认服务。

流式回复与工具调用支持情况如何？未验证。Cursor 通过 OpenAI 兼容接口交互，但由于 Cursor 无法在无图形界面的自动化环境中独立测试，其流式回复、Composer 多文件编辑及工具调用在本仓库中均无自动化测试回执，标注为「未验证」。

若 Cursor 提示模型校验失败怎么办？先用 curl 直接测试 API Key 和地址是否可用。若直接测试成功但 Cursor 校验失败，请检查填写的模型 ID 是否与 /models 页显示的 ID 完全一致，且 Base URL 不要重复包含 /v1。

请求失败时

认证失败：检查 Key 是否存在、有效且获准使用该模型，并从设置变量的终端重新打开客户端。排错时不要输出完整 Key。

地址或模型错误：检查是否重复添加 /v1，使用公布的完整模型 ID，并确认客户端选择 Chat Completions。请求发往 /responses 或 /completions 时，换 Key 无法解决。

额度或超时：检查钱包余额和 Key 限额，按 Retry-After 等待，并缩短输入或降低输出上限。长输出保持流式传输，排错期间避免 Agent 连续重试。

联系支持时提供客户端版本、模型 ID、请求时间和可用的 request ID；请遮盖凭证和源码。