接入指南

接入 Cline

在 Cline VS Code 插件中使用 OpenAI Compatible Provider 接入 UWCode。

接入 Cline

Cline 支持 OpenAI Compatible Provider，适合直接接入 UWCode 的统一模型入口。员工只需要在插件设置中配置 Base URL、API Key 和模型 ID，即可让 VS Code 内的 AI 编程请求进入企业统一网关。

前提条件

  1. 已在 VS Code 中安装 Cline。
  2. UWCode 管理员已为员工或项目创建 Key。
  3. 该 Key 已授权需要使用的模型，例如 gpt-4o-mini、deepseek-v3、qwen-max 或企业自有模型别名。

配置步骤

  1. 打开 VS Code 侧边栏中的 Cline。
  2. 点击设置图标进入 Provider 配置。
  3. 在 API Provider 中选择 OpenAI Compatible。
  4. 填写以下信息：
字段值
Base URLhttps://api.uwcode.com/v1
API Keyuwc-xxxxxxxx
Model ID使用 UWCode 控制台展示的模型 ID
  1. 根据模型能力补充上下文窗口、最大输出 Token、视觉能力或工具调用能力。
  2. 点击验证或保存配置。

推荐模型配置

不同企业的模型别名可能不同，以下仅作为配置结构示例：

Base URL: https://api.uwcode.com/v1
API Key: uwc-xxxxxxxx
Model ID: gpt-4o-mini
Context Window: 128000
Max Output Tokens: 8192

如果企业通过 UWCode 将 DeepSeek、Qwen、Kimi 或私有模型统一映射为 OpenAI-compatible 模型 ID，请直接填写控制台中的模型 ID。

验证接入

  1. 在 Cline 中发起一次简单任务，例如“解释当前文件的主要逻辑”。
  2. 在 UWCode 控制台进入 调用日志。
  3. 按员工 Key 或项目筛选，确认请求、模型、耗时和 Token 消耗均已记录。

常见问题

  • Model Not Found：模型 ID 必须与 UWCode 控制台模型列表一致。
  • Invalid API Key：确认 Key 未过期、未禁用，并且已复制完整。
  • Connection Errors：确认企业网络可访问 https://api.uwcode.com/v1 或私有化部署地址。
  • 工具调用异常：确认所选模型是否支持 Cline 需要的工具调用能力。

官方依据