接入 VSCode + Cline

将 VSCode 的 Cline 扩展接入 PilotAIHub，通过 OpenAI 兼容方式调用模型。

简介

Cline 是一款开源的 VSCode AI 编程助手扩展，支持「OpenAI Compatible」自定义 provider。通过该 provider 将 Cline 指向 PilotAIHub 网关，即可在 VSCode 中使用 PilotAIHub 托管模型，并保留 Key 治理与调用审计。

前置条件

已注册 PilotAIHub 账号并创建虚拟 Key；已安装 VSCode。

安装 Cline

在 VSCode 扩展市场搜索「Cline」并安装；或访问 Cline 市场页面。

配置 base_url

将 Cline 的 OpenAI 兼容接口地址指向 PilotAIHub 网关：

配置位置

在 VSCode 中打开 Cline 侧边栏 → 点击右上角设置（齿轮）→ API Provider 选择「OpenAI Compatible」→ Base URL 填入下方地址、API Key 填入 PilotAIHub Key、Model ID 填入 model_code。

base_url

https://api.pilotaihub.com

配置 API Key

在 PilotAIHub 控制台创建虚拟 API Key（以 pk- 开头），填入 Cline 的 API Key / Secret 字段：

api_key

sk-p-xxxxxxxxxxxxxxxx

Key 安全

API Key 是账户凭证，请勿提交到代码仓库或公开分享。Cline 的配置仅保存在本地，不会上传 PilotAIHub 之外。

选择模型

在 Cline 的模型选择处填写 PilotAIHub 支持的 model_code，例如 gpt-4o。完整模型列表见控制台「模型」页或模型市场。

验证调用

配置完成后，用以下请求验证连通性。成功时应返回模型回复：

curl 验证

curl https://api.pilotaihub.com/chat/completions \
  -H "Authorization: Bearer sk-p-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己"}
    ]
  }'

期望响应

HTTP 200 + 一条 assistant 角色的回复。若返回 401 请检查 Key 是否正确；若返回 429 请降低请求频率或联系管理员提升限额。

进阶用法

Cline 支持 MCP 工具与文件编辑，建议选用具备 function-calling 能力的模型。
为不同工作区配置不同 PilotAIHub Key，便于按项目核算。
Cline 的流式输出与 PilotAIHub 网关兼容，无需额外配置。

常见问题

Provider 选择

必须选择「OpenAI Compatible」而非「OpenAI」provider，后者会强制走 OpenAI 官方端点，无法覆盖 base_url。

401/429 排查与其他 agent 一致，见 Cursor 接入末尾。