跳到主要内容

VSCode + Cline

VSCode 本身不内置 AI 编程能力,需要通过插件接入模型服务。Cline 是常见的开源 AI 编程插件,支持 OpenAI Compatible Provider,因此可以接入鼎惠API。

准备 API Key

打开 鼎惠API 控制台,创建 API Key,并在 模型广场 选择要使用的模型 ID。

已安装 VSCode 和 Cline

如果 VSCode 与 Cline 插件已经安装:

  1. 打开 VSCode。
  2. 点击左侧活动栏中的 Cline 图标。
  3. 打开 Cline 设置。
  4. 在 API Provider 中选择 OpenAI Compatible
  5. 填写 Base URL、API Key 和 Model ID。

推荐配置:

配置项
API ProviderOpenAI Compatible
Base URLhttps://www.tophdd.cn/v1
API Key鼎惠API 控制台创建的 Key
Model ID模型广场中的模型 ID

Custom Headers 可以留空。Azure API version、Azure Identity Authentication 这类选项只用于 Azure OpenAI,不需要开启。

从零安装

安装 VSCode

VSCode 官网 下载并安装:

  • macOS:下载 .dmg,或使用 brew install --cask visual-studio-code
  • Windows:下载安装程序并按提示安装
  • Linux:按发行版选择 .deb.rpm 或压缩包

安装 Cline 插件

在 VSCode 中打开 Extensions:

  • macOS:Command + Shift + X
  • Windows / Linux:Ctrl + Shift + X

搜索 Cline 并安装。首次打开时选择自带 API Key 的方式,然后按上面的 OpenAI Compatible 配置填写鼎惠API 信息。

模型选择建议

由于 Cline 的自定义 Provider 通常走 OpenAI 兼容协议,建议优先选择在 OpenAI Compatible 下稳定工作的模型。需要 Claude 原生缓存或 Anthropic 特性时,建议改用 Claude Code 或支持 Anthropic 协议的客户端。

验证

创建一个新任务,例如:

帮我阅读当前项目结构,并总结主要模块。

如果 Cline 可以正常读取项目并返回结果,同时鼎惠API 控制台出现请求日志,说明配置成功。

排查

401 或 Unauthorized

API Key 无效、复制不完整或填错 Provider 时会出现这类问题。确认 Provider 是 OpenAI Compatible,Base URL 是 https://www.tophdd.cn/v1

404 或 Model Not Found

检查 Model ID 是否与模型广场完全一致。不要把模型展示名当成模型 ID。

请求很慢或超时

先降低上下文规模,关闭不必要的文件读取,再重试。大项目首次分析会消耗更多 Token 和时间。