Skip to content

VS Code 如何接入第三方 API

VS Code 原生 GitHub Copilot 使用 GitHub 管理的模型服务,并不提供一个通用输入框让你把任意 API 地址替换进去。想在 VS Code 里接入 ClawSocket,常见做法是安装支持自定义 provider 的 Continue 扩展,再配置 OpenAI 兼容模型。

安装 Continue

  1. 打开 VS Code 扩展面板,搜索 Continue,确认发布者是 Continue 并完成安装。
  2. 打开 Continue 面板,进入配置文件(通常是 config.yaml 或设置中的配置入口)。
  3. 添加一个 OpenAI 兼容模型,保存后在模型下拉菜单中选择它。

配置示例:

yaml
models:
  - name: ClawSocket GPT-5
    provider: openai
    model: gpt-5
    apiBase: https://api.clawsocket.com/v1
    apiKey: ${{ secrets.CLAWSOCKET_API_KEY }}

Continue 的配置字段会随版本从 apiBase 变为 api_base。如果界面提示 schema 错误,使用配置文件顶部自动生成的示例字段,不要照抄不匹配版本的字段名。

安全设置 API Key

优先使用 Continue 的 Secret 管理或系统环境变量,不要把真实 Key 写入 config.yaml。如果扩展支持环境变量引用,可以在启动 VS Code 前执行:

bash
export CLAWSOCKET_API_KEY="你的 ClawSocket Key"
code .

在公开项目中提交配置前,检查文件里没有 Key、请求日志和用户代码。ClawSocket 控制台可以为 VS Code 单独创建 Key,并设置合理额度。

选择适合的模型

代码补全重视延迟,可以优先选择响应快的模型;解释复杂代码或生成测试时,可以切换更强的模型。Continue 允许同时配置多个模型,但模型 ID 必须以 ClawSocket 控制台提供的实际列表为准,例如 gpt-5deepseek-v4kimi-k3glm-5-5 只是示例,实际 ID 可能不同。

连接测试与故障排查

在 Continue 中发送“解释当前文件中最复杂的函数”,确认能返回回答后再启用自动补全。

  • 401:检查 Secret 名称、环境变量继承和 Key 是否有效。
  • 404:确认 apiBasehttps://api.clawsocket.com/v1,不要填完整的 /chat/completions
  • 模型不存在:复制控制台中的 API ID,而不是产品页面的中文名称。
  • 补全很慢:降低上下文范围,排除 node_modules 和构建目录,并换用更快模型。
  • 重复请求:检查 Continue 的自动重试设置,429 时应降低频率并等待退避。

不要混淆 Copilot 和第三方 API

安装 Continue 不会改变 GitHub Copilot 的订阅或权限。你可以继续使用 Copilot,同时把 Continue 指向 ClawSocket;两者在 VS Code 中是独立的扩展和模型通道。想了解统一接口如何减少多供应商改造,可阅读模型选择:速度、价格与效果

获取 ClawSocket API Key

Continue 配置检查表

项目推荐设置说明
Provideropenai使用 OpenAI 兼容请求格式
API Basehttps://api.clawsocket.com/v1不要填完整接口路径
API KeySecret 或环境变量不要硬编码在配置文件
上下文范围当前文件/相关文件避免发送整个依赖目录

FAQ

VS Code 原生 Copilot 能直接换成 ClawSocket 吗?

Copilot 的服务由 GitHub 管理,原生设置通常不能替换为任意 Base URL。使用 Continue、Cline 等支持自定义 provider 的扩展,才能在 VS Code 中配置 ClawSocket。

Continue 报配置字段错误怎么办?

Continue 不同版本的字段可能从 apiBase 变为 api_base。以扩展生成的配置模板和 schema 提示为准,只替换 API 地址、模型 ID 和 Secret。

为什么 VS Code 里模型列表为空?

自定义 provider 通常不会自动拉取模型列表。手动填写 ClawSocket 控制台中的 API ID,例如 gpt-5,再重新加载窗口。

代码补全使用哪个模型更合适?

补全优先考虑延迟和成本,复杂解释、重构和测试生成再切换更强模型。为不同场景配置多个模型,比所有任务都使用最高规格模型更可控。

专注大模型 API 的实用指南