IDE 扩展

在 VS Code、Cursor 等编辑器中使用 AI 编程扩展,通过 GUI 设置或配置文件接入网关。

通用环境变量

部分 IDE 扩展支持通过环境变量配置 API Key 和 Base URL:

.env
# 所有支持环境变量的工具通用配置
export OPENAI_API_KEY="sk-your-api-key"
export OPENAI_API_BASE="https://api.example.com/v1"

Cursor

AI 代码编辑器(VS Code fork),原生支持 OpenAI 协议的自定义端点,通过 GUI 配置。

GUI 配置OpenAI

安装

从 cursor.com 下载安装。

配置步骤

  1. 1

    安装 Cursor

    从官网下载对应平台的安装包并安装。

    terminal
    # macOS (Homebrew)
    brew install --cask cursor
    
    # 或从官网下载
    # https://cursor.com
  2. 2

    打开模型设置

    在 Cursor 中打开设置面板,导航到 Models → API Keys 页面。

    Cursor 设置
    # 方式一:菜单栏
    Settings → Models → API Keys
    
    # 方式二:快捷键
    macOS: Cmd + ,
    Windows: Ctrl + ,
  3. 3

    配置自定义端点

    在 Models → API Keys 页面中开启 Override OpenAI Base URL,填入网关地址和 API Key。

    Cursor 设置
    操作步骤:
    1. 打开 Settings → Models → API Keys
    2. 打开 "Override OpenAI Base URL" 开关
    3. Base URL 填入:https://api.example.com/v1
    4. OpenAI API Key 填入:sk-your-api-key
    5. 在 Model 下拉框中选择或输入模型名(如 deepseek-v3.2)

    Base URL 开关可能随 API Key 输入自动开启(已知行为),如遇 HTTP/2 连接错误,在 Settings → Network → HTTP Compatibility Mode 中切换为 HTTP/1.1。

  4. 4

    使用模型

    配置完成后,在 Chat 或 Composer 中选择自定义模型即可使用。

    Cursor
    # 在 Cursor 中使用
    # 1. 打开 Chat 面板(Cmd+L / Ctrl+L)
    # 2. 点击模型选择器
    # 3. 选择你配置的模型(如 deepseek-v3.2)
    # 4. 开始对话

注意事项

  • 仅支持 GUI 配置,无配置文件或 CLI 方式
  • 推理模型(o1/o3)可能不兼容自定义端点
  • Base URL 开关可能随 API Key 输入自动开启(已知行为)

Cline

VS Code AI 编程扩展,内置 "OpenAI Compatible" 提供商类型,支持自主创建和编辑文件。

GUI 配置OpenAI

安装

在 VS Code 扩展市场搜索 "Cline" 安装。

配置步骤

  1. 1

    安装 Cline 扩展

    在 VS Code 扩展市场搜索并安装 Cline。

    terminal
    # 方式一:VS Code 扩展市场
    # 搜索 "Cline" 并点击 Install
    
    # 方式二:命令行安装
    code --install-extension saoudrizwan.claude-dev
  2. 2

    打开 Cline 设置

    点击 VS Code 侧边栏的 Cline 图标,然后点击设置齿轮。

    VS Code
    # 操作步骤:
    # 1. 点击 VS Code 侧边栏 Cline 图标
    # 2. 点击设置齿轮 ⚙️
  3. 3

    配置 API Provider

    在设置面板中选择 "OpenAI Compatible" 提供商类型(注意:不是 "OpenAI"),填入网关信息。

    Cline 设置
    配置步骤:
    1. API Provider 选择 "OpenAI Compatible"(不是 "OpenAI")
    2. Base URL 填入:https://api.example.com/v1
    3. API Key 填入:sk-your-api-key
    4. Model ID 输入模型名(如 deepseek-v3.2)或选择 "Use custom"
    5. 点击 "Verify Connection" 测试连接

    必须选择 "OpenAI Compatible" 而非 "OpenAI"——后者没有 Base URL 字段。

  4. 4

    开始使用

    连接成功后,可以在 Cline 面板中对话,让它帮你读取、创建或编辑项目文件。

    Cline
    # 在 Cline 面板中输入指令即可
    # 例如:
    "Read the project structure and suggest improvements"
    "Create a new API endpoint for user registration"

注意事项

  • 必须选择 "OpenAI Compatible" 而非 "OpenAI"(后者无 Base URL 字段)
  • Model 选择 "Use custom" 可输入任意模型 ID
  • 支持配置最大输出 token 和上下文窗口大小

Continue.dev

VS Code / JetBrains 开源 AI 编程扩展,通过 config.yaml 配置,支持 Tab 自动补全和 Chat。

配置文件OpenAI

安装

在 VS Code 扩展市场搜索 "Continue" 安装。

配置步骤

  1. 1

    安装 Continue 扩展

    在 VS Code 或 JetBrains 插件市场搜索 "Continue" 并安装。

    terminal
    # VS Code
    code --install-extension continue.continue
    
    # JetBrains
    # 在 Settings → Plugins 中搜索 "Continue"
  2. 2

    创建配置文件

    创建 ~/.continue/config.yaml(用户级)或项目 .continue/config.yaml(项目级)。

    ~/.continue/config.yaml
    models:
      - title: "千木 - DeepSeek V3.2"
        provider: openai
        model: deepseek-v3.2
        apiKey: sk-your-api-key
        apiBase: https://api.example.com/v1
        contextLength: 128000
    
      - title: "千木 - Claude Sonnet 4"
        provider: openai
        model: claude-sonnet-4-20250514
        apiKey: sk-your-api-key
        apiBase: https://api.example.com/v1
        contextLength: 200000

    使用 "provider: openai" 即可对接任何 OpenAI 兼容端点。API Key 支持 ${ENV_VAR} 环境变量引用。

  3. 3

    使用 Continue

    配置完成后,在 VS Code 侧边栏打开 Continue 面板开始使用。

    VS Code
    # Continue 快捷键(VS Code)
    # 打开 Chat 面板:Cmd+L / Ctrl+L
    # 行内编辑:Cmd+I / Ctrl+I
    # Tab 自动补全:直接在编辑器中按 Tab

注意事项

  • 使用 "provider": "openai" 即可对接任何 OpenAI 兼容端点
  • API Key 支持 ${ENV_VAR} 环境变量引用语法
  • 可分别配置 Tab 自动补全和 Embeddings 的提供者