Cursor

Cursor 是一款基于 VS Code 构建的 AI 代码编辑器。它支持通过 OpenAI 兼容 API 接入自定义 AI 模型服务商，让你可以在编辑器内直接使用 Token101 的任意模型。

前置条件

Token101 API Key — 订阅用户可直接创建；Free 用户需先在 token.ppthub.shop/settings/apikeys 完成 API 激活
已安装 Cursor — 从 cursor.com 下载

步骤一 — 打开 Cursor 设置

打开 Cursor
按 Cmd + Shift + J（macOS）或 Ctrl + Shift + J（Windows/Linux）打开设置
导航到 Models 模块

或从菜单进入：Cursor → Settings → Cursor Settings → Models

步骤二 — 添加自定义模型

在 Models 设置页面：

找到 OpenAI API Key 部分
在 API Key 输入框中填入你的 Token101 API Key
点击 Override OpenAI Base URL，填入：

https://token.ppthub.shop/api/v1

在模型列表中点击 Add Model，输入模型名称，如 gpt-5.2

Cursor 使用 OpenAI 兼容格式。Base URL 必须以 /v1 结尾 — 不要使用 https://token.ppthub.shop/api（该地址仅供 Anthropic SDK 客户端使用）。

步骤三 — 验证连接

在 Cursor 中打开任意文件
按 Cmd + K（macOS）或 Ctrl + K（Windows/Linux）打开行内对话
输入简单消息，例如：请回复：TOKEN101_OK
按回车

如果看到 TOKEN101_OK 输出，说明配置成功。

可用模型

在 Cursor 的模型列表中，可以添加以下模型名称：

模型	输入的模型名称
GPT-5.4	`gpt-5.4`
GPT-5.2	`gpt-5.2`
GPT-5.3 Codex	`gpt-5.3-codex`
Claude Opus 4.6	`claude-opus-4-6`
Claude Sonnet 4.5	`claude-sonnet-4-5`
Claude Haiku 4.5	`claude-haiku-4-5`
Qwen Max	`qwen-max`

完整列表请参阅支持的模型。

支持的 Cursor 功能

行内编辑（Cmd/Ctrl + K）

选中代码后按 Cmd + K 进行行内修改，Token101 会直接在编辑器中应用变更。

对话面板（Cmd/Ctrl + L）

打开对话面板，与 AI 讨论你的代码库。Cursor 会自动索引项目文件并提供上下文。

Composer（Cmd/Ctrl + I）

使用 Composer 进行跨文件修改。用自然语言描述需求，Cursor 会提出并应用多文件变更方案。

Tab 代码补全

Cursor 的 Tab 补全默认使用其内置模型。若需用 Token101 提供补全，请在 Settings → Models → Autocomplete 中进行配置。

通过 settings.json 配置

也可以通过编辑设置文件来配置 Cursor。按 Cmd + Shift + P，搜索"Open User Settings (JSON)"，添加：

{
  "cursor.general.openAIAPIKey": "your-token101-api-key",
  "cursor.general.openAIBaseURL": "https://token.ppthub.shop/api/v1",
  "cursor.general.openAIModel": "gpt-5.2"
}

Cursor 的设置文件可能以明文存储。请避免将其同步到公开代码仓库。建议优先使用 Cursor 内置设置界面，凭证存储更安全。

Chat Completions API 参考要点

Cursor 通过与 OpenAI 兼容的 Chat Completions 端点接入 Token101。同一个端点也适用于任意 OpenAI SDK 或 HTTP 客户端：

端点：POST https://token.ppthub.shop/api/v1/chat/completions
鉴权：Authorization: Bearer sk-...
OpenAI SDK：将 base_url 设为 https://token.ppthub.shop/api/v1
参数透传：对 OpenAI 系模型，本文未声明的字段（如 response_format、seed、logprobs 等）会原样转发给模型服务商
深入示例：见流式响应与工具调用的 OpenAI Chat Completions 小节

常见问题

显示"Invalid API key"

在设置 → API Keys 核对 API Key 是否正确
确认粘贴时没有多余空格
确认 Base URL 为 https://token.ppthub.shop/api/v1（含 /v1）

显示"Model not found"

输入的模型名称不在支持列表中。请参照支持的模型页面确认准确的模型 ID。

响应中途截断

在生成较长内容时可能因超时而中断。建议：

请求更简短的回复
在高级设置中适当调大请求超时时间

对话面板无响应

查看 Cursor 输出面板（View → Output → Cursor）获取详细错误
在 token.ppthub.shop/settings/billing 确认 Token101 积分余额
用 curl 直接测试端点是否可达：

curl https://token.ppthub.shop/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN101_API_KEY" \
  -d '{"model": "gpt-5.2", "messages": [{"role": "user", "content": "你好"}]}'

下一步

支持的模型 — 查看所有可用模型
流式输出 — 了解 API 流式传输的工作方式
Claude Code 接入 — 使用 Claude 的终端编程工具
API 参考 — 完整端点文档

Cursor

Cursor 是一款基于 VS Code 构建的 AI 代码编辑器。它支持通过 OpenAI 兼容 API 接入自定义 AI 模型服务商，让你可以在编辑器内直接使用 Token101 的任意模型。

前置条件

Token101 API Key — 订阅用户可直接创建；Free 用户需先在 token.ppthub.shop/settings/apikeys 完成 API 激活
已安装 Cursor — 从 cursor.com 下载

步骤一 — 打开 Cursor 设置

打开 Cursor
按 Cmd + Shift + J（macOS）或 Ctrl + Shift + J（Windows/Linux）打开设置
导航到 Models 模块

或从菜单进入：Cursor → Settings → Cursor Settings → Models

步骤二 — 添加自定义模型

在 Models 设置页面：

找到 OpenAI API Key 部分
在 API Key 输入框中填入你的 Token101 API Key
点击 Override OpenAI Base URL，填入：

https://token.ppthub.shop/api/v1

在模型列表中点击 Add Model，输入模型名称，如 gpt-5.2

Cursor 使用 OpenAI 兼容格式。Base URL 必须以 /v1 结尾 — 不要使用 https://token.ppthub.shop/api（该地址仅供 Anthropic SDK 客户端使用）。

步骤三 — 验证连接

在 Cursor 中打开任意文件
按 Cmd + K（macOS）或 Ctrl + K（Windows/Linux）打开行内对话
输入简单消息，例如：请回复：TOKEN101_OK
按回车

如果看到 TOKEN101_OK 输出，说明配置成功。

可用模型

在 Cursor 的模型列表中，可以添加以下模型名称：

模型	输入的模型名称
GPT-5.4	`gpt-5.4`
GPT-5.2	`gpt-5.2`
GPT-5.3 Codex	`gpt-5.3-codex`
Claude Opus 4.6	`claude-opus-4-6`
Claude Sonnet 4.5	`claude-sonnet-4-5`
Claude Haiku 4.5	`claude-haiku-4-5`
Qwen Max	`qwen-max`

完整列表请参阅支持的模型。

支持的 Cursor 功能

行内编辑（Cmd/Ctrl + K）

选中代码后按 Cmd + K 进行行内修改，Token101 会直接在编辑器中应用变更。

对话面板（Cmd/Ctrl + L）

打开对话面板，与 AI 讨论你的代码库。Cursor 会自动索引项目文件并提供上下文。

Composer（Cmd/Ctrl + I）

使用 Composer 进行跨文件修改。用自然语言描述需求，Cursor 会提出并应用多文件变更方案。

Tab 代码补全

Cursor 的 Tab 补全默认使用其内置模型。若需用 Token101 提供补全，请在 Settings → Models → Autocomplete 中进行配置。

通过 settings.json 配置

也可以通过编辑设置文件来配置 Cursor。按 Cmd + Shift + P，搜索"Open User Settings (JSON)"，添加：

{
  "cursor.general.openAIAPIKey": "your-token101-api-key",
  "cursor.general.openAIBaseURL": "https://token.ppthub.shop/api/v1",
  "cursor.general.openAIModel": "gpt-5.2"
}

Cursor 的设置文件可能以明文存储。请避免将其同步到公开代码仓库。建议优先使用 Cursor 内置设置界面，凭证存储更安全。

Chat Completions API 参考要点

Cursor 通过与 OpenAI 兼容的 Chat Completions 端点接入 Token101。同一个端点也适用于任意 OpenAI SDK 或 HTTP 客户端：

端点：POST https://token.ppthub.shop/api/v1/chat/completions
鉴权：Authorization: Bearer sk-...
OpenAI SDK：将 base_url 设为 https://token.ppthub.shop/api/v1
参数透传：对 OpenAI 系模型，本文未声明的字段（如 response_format、seed、logprobs 等）会原样转发给模型服务商
深入示例：见流式响应与工具调用的 OpenAI Chat Completions 小节

常见问题

显示"Invalid API key"

在设置 → API Keys 核对 API Key 是否正确
确认粘贴时没有多余空格
确认 Base URL 为 https://token.ppthub.shop/api/v1（含 /v1）

显示"Model not found"

输入的模型名称不在支持列表中。请参照支持的模型页面确认准确的模型 ID。

响应中途截断

在生成较长内容时可能因超时而中断。建议：

请求更简短的回复
在高级设置中适当调大请求超时时间

对话面板无响应

查看 Cursor 输出面板（View → Output → Cursor）获取详细错误
在 token.ppthub.shop/settings/billing 确认 Token101 积分余额
用 curl 直接测试端点是否可达：

curl https://token.ppthub.shop/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN101_API_KEY" \
  -d '{"model": "gpt-5.2", "messages": [{"role": "user", "content": "你好"}]}'

下一步

支持的模型 — 查看所有可用模型
流式输出 — 了解 API 流式传输的工作方式
Claude Code 接入 — 使用 Claude 的终端编程工具
API 参考 — 完整端点文档

Cursor

目录

Cursor

目录