GitHub Copilot for VSCode 配置指南

115 阅读3分钟

前置要求

  • 有效的 UniVibe API 密钥

注册UniVibe API 密钥 点击注册 注册即可获得 6000积分

安装步骤

1. 安装 Visual Studio Code

如果您还没有安装 VSCode,请先完成安装:

  1. 打开浏览器访问 VSCode 官网
  2. 根据您的操作系统选择对应版本下载
  3. 下载完成后运行安装程序
  4. 按照安装向导完成安装

2. 安装 OAI Compatible Provider for Copilot 插件

这个插件让 GitHub Copilot 能够连接到 UniVibe 服务。

安装方法

  1. 打开 VSCode
  2. 点击左侧活动栏的 扩展 图标(或按 Ctrl+Shift+X / Cmd+Shift+X
  3. 在搜索框中输入:OAI Compatible Provider for Copilot
  4. 找到插件后点击 安装 按钮

安装 OAI Compatible Provider

3. 配置 BaseUrl

安装完插件后,需要配置 UniVibe 的 API 端点。

打开设置

Windows/Linux:

  • 按快捷键 Ctrl + , 打开设置
  • 或点击菜单 文件 → 首选项 → 设置

macOS:

  • 按快捷键 Cmd + , 打开设置
  • 或点击菜单 Code → 设置 → 设置

设置 Base URL

  1. 在设置搜索框中输入 oai
  2. 找到 Oaicopilot: Base Url 配置项
  3. 将值设置为:https://api.univibe.cc/openai/v1

配置 OAI 设置

4. 获取 API 密钥

登录 UniVibe 控制台,在 API密钥 页面创建一个新的密钥。

💡 请妥善保管您的 API 密钥,不要泄露给他人。

5. 配置密钥和模型

现在需要在 GitHub Copilot 中配置使用 UniVibe 的模型。

打开模型管理

  1. 点击 VSCode 右侧活动栏的 GitHub Copilot 图标
  2. 点击顶部的模型选择下拉菜单
  3. 点击 Manage Models... (管理模型)

打开管理模型

选择 OAI Compatible Provider

在弹出的提供商列表中,选择 OAI Compatible

选择 OAI Provider

输入 API 密钥

在弹出的输入框中,填入您在步骤 4 中获取的 UniVibe API 密钥:

输入 UniVibe Key

选择可用模型

  1. 在弹出的模型列表中,勾选您想使用的模型
  2. 建议全部勾选,以便在不同场景下灵活切换
  3. 点击 OK 确认

选择模型

6. 开始使用

配置完成!现在您可以在 VSCode 中使用 GitHub Copilot 了。

选择模型

在 GitHub Copilot 面板中,选择带有 via OAI Compatible 后缀的模型即可使用 UniVibe 服务:
Copilot 的全部功能都可以正常使用

使用模型

常见问题解决

插件安装失败

如果插件安装失败,尝试以下方法:

  • 检查网络连接是否正常
  • 重启 VSCode 后重试
  • 手动从 VSCode 市场 下载插件

无法连接到 UniVibe 服务

确保:

  • Base URL 配置正确:https://api.univibe.cc/openai/v1
  • API 密钥有效且未过期
  • 网络连接正常,可以访问 UniVibe 服务

模型列表为空或无法选择

这可能是因为:

  • API 密钥配置不正确,请重新输入
  • 网络连接问题,检查防火墙设置
  • 重启 VSCode 后重试

Copilot 没有响应

如果 Copilot 没有提供建议:

  • 确认已选择 via OAI Compatible 后缀的模型
  • 检查 API 密钥是否有足够的积分
  • 查看 VSCode 输出面板的错误信息