---
title: "Cursor"
description: "Cursor 通过 OpenAI API Key 加 Override OpenAI Base URL 调用 pirouter：base URL 填 https://api.pirouter.ai/v1，再手动添加完整模型 ID；只有聊天类功能走 pirouter，Agent 模式建议用 Claude 或 Gemini。"
canonical: "https://pirouter.ai/zh/docs/integrations/cursor"
last-updated: "2026-10-18"
lang: "zh"
source: "content/docs/zh/integrations/cursor.mdx"
---

# Cursor

Cursor 通过 OpenAI API Key 加 Override OpenAI Base URL 调用 pirouter：base URL 填 https://api.pirouter.ai/v1，再手动添加完整模型 ID；只有聊天类功能走 pirouter，Agent 模式建议用 Claude 或 Gemini。

[Cursor](https://cursor.com) 在 **Settings → Models** 里打开 OpenAI API Key，填 pirouter 的 key，再把 Override OpenAI Base URL 设成 `https://api.pirouter.ai/v1`，然后手动添加 pirouter 的模型 ID，就能在聊天里用 pirouter 的模型。

> **注意：** 本页按 Cursor 官方文档与官方论坛的答复编写，尚未用真实的 Cursor 账号验证。

## 前提

- 一个 pirouter API key。还没有的话，按[快速开始](https://pirouter.ai/zh/docs/quickstart.md)创建一个。
- 支持自带 API key 的 Cursor 付费档：个人的 Premium、Super、Ultra（或旧版 Pro 及以上），或者 Teams、Enterprise。Free 和 Plus 不能用自带 key。

* 了解两件事：
  - 只有聊天类模型走你自己的 key，Tab 补全始终用 Cursor 自己的模型。
  - 请求先经过 Cursor 的服务器组装提示词，再从 Cursor 的服务器发往 pirouter，不是从你的电脑直接发出。

## 配置

Cursor 只有 OpenAI 这一项能改 base URL，所以经 pirouter 的请求都走 OpenAI 协议，发到 `POST /v1/chat/completions`。

1. 打开 **Cursor Settings → Models**。
2. 打开 **OpenAI API Key**，粘贴你的 pirouter key。
3. 打开 **Override OpenAI Base URL**，填 `https://api.pirouter.ai/v1`（带 `/v1`，不要填到 `/chat/completions`）。
4. 在模型列表里点 **Add Custom Model**，填完整模型 ID，例如 `anthropic/claude-sonnet-5.5`、`openai/gpt-6.1-sol`。能用哪些模型，见[模型与协议](https://pirouter.ai/zh/docs/models.md#每个模型接受哪些协议)的协议表里 OpenAI 一列。

![示意图：Cursor 的 Models 设置，OpenAI API Key 已打开并填入遮罩后的 key，Override OpenAI Base URL 为 https://api.pirouter.ai/v1，下方添加了 anthropic/claude-sonnet-5.5 与 openai/gpt-6.1-sol 两个模型](/docs/shots/cursor-settings.zh.svg)

模型 ID 要写带厂商前缀的全名。以 `claude-` 开头的裸名会被 Cursor 当成 Anthropic 的模型，改用 Anthropic 那一项的 key 发出。

### Agent 模式用 Claude 或 Gemini

在 Agent 模式下，Cursor 会把 GPT 系列模型的请求按 Responses 格式组装，却发到 Chat Completions 端点。这是官方论坛确认的已知问题，pirouter 不做格式转换，这类请求会失败（论坛里报告的是 `400`）。Agent 模式建议选 Claude 或 Gemini 的模型 ID；GPT 系列模型在 Ask 模式下使用。

## 验证

新开一个聊天，切到 Ask 模式，选 `anthropic/claude-sonnet-5.5`，发一句 `Reply with exactly: pong`。

你应该看到模型回复 `pong`。

在控制台[日志](https://pirouter.ai/zh/docs/guides/logs.md)里能看到这次请求，**端点** 一栏是 `/v1/chat/completions`。

## 排障

### Agent 模式下 GPT 模型返回 400

报错类似 `Missing required parameter: 'messages'`：这是上面说的 Responses 格式问题。换成 Claude 或 Gemini 的模型 ID，或者改用 Ask 模式。

### Cursor 自己的模型报错

开着 Override OpenAI Base URL 时，Cursor 自家的模型会报 `This model does not support custom API keys`。这个设置对所有非 Claude、非 Gemini 的模型都生效。要用 Cursor 自己的模型时，先关掉 OpenAI API Key。

### 连接不上

提示连不上模型服务时，先确认 base URL 是 `https://api.pirouter.ai/v1`。仍然不行，在 **Settings → Network** 里把 HTTP Compatibility Mode 改成 HTTP/1.1。

## 目前没有验证的用法

本页的所有步骤都还没有用真实账号验证，尤其是这几点：

- 带斜杠的模型 ID（如 `anthropic/claude-sonnet-5.5`）能否添加并原样发出。
- Agent 模式下用 Claude 或 Gemini 时，工具调用能否正常完成。
- 设置页里验证 key 的按钮会请求哪个端点。

## 相关链接

- [Cursor 自带 API key](https://cursor.com/help/models-and-usage/api-keys)：官方帮助文档
- [Cursor 模型与价格](https://cursor.com/docs/models-and-pricing)：各付费档能否用自带 key