ClaudeHub

Appearance

Cursor 配置教程 ​

Cursor 是一款集成 AI 能力的代码编辑器，基于 VS Code 打造，支持 Claude、GPT、Gemini 等多种模型。

前置要求 ​

配置步骤 ​

步骤一：打开模型设置 ​

  1. 打开 Cursor
  2. 按 Ctrl+Shift+J（Windows）或 Cmd+Shift+J（macOS）打开设置
  3. 或点击右上角齿轮图标 → Cursor Settings → Models

步骤二：配置 OpenAI API（推荐） ​

为什么用 OpenAI 配置？

Cursor 只有 OpenAI 支持自定义 API 地址（Override Base URL）。Anthropic 和 Google 只能填写官方 API Key，无法修改地址。因此使用 ClaudeHub 需要通过 OpenAI 兼容接口。

在 Models 设置页面找到 OpenAI 配置区域：

配置项值
OpenAI API Keysk-你的APIKey
Override OpenAI Base URLhttps://api.qinzhiai.com/v1

注意

Base URL 必须包含 /v1 后缀！

配置完成后点击 Verify 验证。

步骤三：使用 Claude 模型 ​

配置好 OpenAI 后，可以通过 OpenAI 兼容格式调用 Claude 模型：

  1. 在聊天或代码编辑中选择模型
  2. 输入 Claude 模型名称，如：
    • claude-sonnet-4-20250514
    • claude-3-5-sonnet-20241022
    • claude-3-5-haiku-20241022

提示

ClaudeHub 的 OpenAI 兼容接口支持所有 Claude 模型，只需在模型选择器中输入正确的模型名称即可。

关于其他提供商 ​

提供商支持自定义地址说明
OpenAI✅ 支持可配置 Override Base URL
Anthropic❌ 不支持只能填写官方 API Key
Google❌ 不支持只能填写官方 API Key
Azure✅ 支持需要 Azure 订阅

因此，使用 ClaudeHub 请统一通过 OpenAI 配置。

推荐模型 ​

用途模型名称
日常编程gpt-4o
复杂任务claude-sonnet-4-20250514
快速响应gpt-4o-mini
长上下文claude-3-5-sonnet-20241022

功能使用 ​

Cmd+K 内联编辑 ​

  1. 选中代码块
  2. 按 Cmd+K（macOS）或 Ctrl+K（Windows）
  3. 输入修改指令

Cmd+L 对话模式 ​

  1. 按 Cmd+L（macOS）或 Ctrl+L（Windows）
  2. 在侧边栏与 AI 对话
  3. 可以引用代码文件

Tab 自动补全 ​

Cursor 会根据上下文自动提供代码补全建议。

注意

Tab 自动补全功能需要 Cursor 专用模型，无法使用自定义 API Key。

常见问题 ​

验证失败 ​

检查以下几点：

  1. API Key 是否正确填写
  2. Base URL 是否包含 /v1 后缀
  3. 网络是否正常

为什么不能配置 Anthropic Base URL？ ​

Cursor 目前只有 OpenAI 支持 Override Base URL 功能，Anthropic 和 Google 只能使用官方 API。如需使用第三方服务，请通过 OpenAI 兼容接口。

Claude 模型无法使用 ​

确保：

  1. 使用的是 OpenAI 配置（不是 Anthropic 配置）
  2. Base URL 设置为 https://api.qinzhiai.com/v1
  3. 模型名称正确（如 claude-sonnet-4-20250514）

响应速度慢 ​

尝试切换到更快的模型如 gpt-4o-mini 或 claude-3-5-haiku-20241022。

报错 401 Unauthorized ​

API Key 无效或已过期，请重新获取。

更多资源 ​