Cursor

开始之前

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

Inferway 账户激活后，从控制台 → API keys 获取 Key。建议为该客户端使用独立 Key，并确认允许的模型和消费上限。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 精确填写 inferway/qwen3.8-27b，启用后在新聊天中明确选择它；验证时不要选择 Auto 或 Cursor 托管模型。

Base URL: https://api.inferway.ai/v1
Model ID: inferway/qwen3.8-27b
API key: <your Inferway API key>

确认接入成功

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

Cursor 的限制

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

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

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

请求失败时

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

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

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

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