代码编辑器

Cursor 官网

需要 Cursor Pro 订阅。

1. 打开 Cursor → Cmd+, (macOS) / Ctrl+, (Win) → Models
2. 填入 OpenAI API Key，展开 "Override OpenAI Base URL" 并开启
3. 在模型搜索框中输入模型名（如 hy3），点击 Add model 添加

字段	值
OpenAI API Key	your-key-here
Override OpenAI Base URL	https://novalinkchina.com/v1

提示

提示：Tab 代码补全始终使用 Cursor 自有模型，自定义 API 仅对 Chat/Composer 生效。

注意

已知 Bug：Overide Base URL 为全局设置，切换到 Claude 模型时可能返回 422 错误。如遇此问题，暂时关闭 Override 使用 Cursor 原生模型。

Windsurf (Codeium) 官网

1. 打开 Windsurf 编辑器 → Settings → AI Models → Custom Providers
2. 点击 Add Provider → 选择 OpenAI Compatible

字段	值
Base URL	https://novalinkchina.com/v1
API Key	your-key-here

提示

注意：以上为编辑器内设置方式。网页版 BYOK（windsurf.com/subscription/provider-api-keys）不支持自定义 Base URL，仅支持填入官方 API Key。

Trae（字节跳动） 官网

Trae CN 国内版需要 Pro 或企业版才能使用自定义 API。

1. Trae v3.3.51+ → 设置 → 模型 → 添加模型 → 自定义配置
2. API 格式选择 "OpenAI Chat Completions"

字段	值
请求地址	https://novalinkchina.com/v1/chat/completions
API Key	your-key-here
模型 ID	hy3 / deepseek-v4-pro / claude-sonnet-5

提示

注意：Base URL 必须包含完整路径到 /chat/completions，不是只到 /v1。在 SOLO 窗口下需先关闭 AUTO 选择框。

GitHub Copilot 官网

需要 GitHub Copilot Pro / Business / Enterprise 订阅。

JetBrains IDE

1. Settings → Tools → AI Assistant → AI Providers
2. 点击 Add Provider 选择 OpenAI Compatible

字段	值
Base URL	https://novalinkchina.com/v1
API Key	your-key-here

VS Code

1. 搜索 "GitHub Copilot" 扩展安装
2. Settings → Extensions → GitHub Copilot → Custom API Configuration

提示

注意：不同 IDE 的 Copilot 配置入口不同，请参考 GitHub 官方文档。

Zed 官网

1. 打开 Zed → Cmd+Shift+P (macOS) / Ctrl+Shift+P (Win)
2. 输入 "Agent: Open Settings" → 打开配置文件
3. 添加 OpenAI Compatible Provider

{
  "assistant": {
    "provider": {
      "name": "novalink",
      "type": "openai_compatible",
      "api_url": "https://novalinkchina.com/v1",
      "api_key": "your-key-here",
      "model": "hy3"
    }
  }
}

提示

注意：API Key 会存储在系统凭据中，配置文件仅保存引用。

JetBrains AI Assistant 官网

无需 AI Pro 订阅，BYOK 模式直接使用自定义 API。

1. Settings → Tools → AI Assistant → Providers & API keys
2. 添加 OpenAI-compatible Provider

字段	值
Base URL	https://novalinkchina.com/v1
API Key	your-key-here
Model	hy3

提示

提示：JetBrains AI Assistant 支持多模型配置，可在不同场景使用不同模型。