代码编辑器

Cursor 官网

需要 Cursor Pro 订阅。

1. 打开 Cursor → Cmd+, (macOS) / Ctrl+, (Win) → Models
2. 填入 OpenAI API Key，展开 "Override OpenAI Base URL" 并开启
3. 在模型搜索框中输入模型名（如 deepseek-v4-flash），点击 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	deepseek-v4-flash / 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": "deepseek-v4-flash"
    }
  }
}

提示

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	deepseek-v4-flash

提示

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

ZCode（智谱 Z.ai） 官网

智谱 GLM 官方桌面 Agent 开发环境（ADE，Windows / macOS / Linux）。ZCode 走界面配置，不读取终端环境变量。

1. 打开 ZCode → 设置 → 模型供应商 → 添加供应商
2. 名称填 Novalink，接口类型选 OpenAI 兼容，填入：

字段	值
Base URL	https://novalinkchina.com/v1
API Key	你的key（Novalink 后台创建）

3. 保存后在「添加模型」中手动填入模型 ID（区分大小写）：deepseek-v4-flash、claude-sonnet-5、hy4-preview 等
4. 在模型选择器中选中 Novalink 通道与模型，发一句指令验证

提示

ZCode 界面配置与终端环境变量是两套独立体系，改配置请走界面（配置落盘 ~/.zcode/v2/config.json）；模型 ID 需手动添加、原样使用 Novalink 侧的模型名。