前置要求
- 有效的 UniVibe API 密钥
注册UniVibe API 密钥 点击注册 注册即可获得 6000积分
安装步骤
1. 安装 Visual Studio Code
如果您还没有安装 VSCode,请先完成安装:
- 打开浏览器访问 VSCode 官网
- 根据您的操作系统选择对应版本下载
- 下载完成后运行安装程序
- 按照安装向导完成安装
2. 安装 OAI Compatible Provider for Copilot 插件
这个插件让 GitHub Copilot 能够连接到 UniVibe 服务。
安装方法
- 打开 VSCode
- 点击左侧活动栏的 扩展 图标(或按
Ctrl+Shift+X/Cmd+Shift+X) - 在搜索框中输入:OAI Compatible Provider for Copilot
- 找到插件后点击 安装 按钮
3. 配置 BaseUrl
安装完插件后,需要配置 UniVibe 的 API 端点。
打开设置
Windows/Linux:
- 按快捷键
Ctrl + ,打开设置 - 或点击菜单 文件 → 首选项 → 设置
macOS:
- 按快捷键
Cmd + ,打开设置 - 或点击菜单 Code → 设置 → 设置
设置 Base URL
- 在设置搜索框中输入 oai
- 找到 Oaicopilot: Base Url 配置项
- 将值设置为:
https://api.univibe.cc/openai/v1
4. 获取 API 密钥
登录 UniVibe 控制台,在 API密钥 页面创建一个新的密钥。
💡 请妥善保管您的 API 密钥,不要泄露给他人。
5. 配置密钥和模型
现在需要在 GitHub Copilot 中配置使用 UniVibe 的模型。
打开模型管理
- 点击 VSCode 右侧活动栏的 GitHub Copilot 图标
- 点击顶部的模型选择下拉菜单
- 点击 Manage Models... (管理模型)
选择 OAI Compatible Provider
在弹出的提供商列表中,选择 OAI Compatible:
输入 API 密钥
在弹出的输入框中,填入您在步骤 4 中获取的 UniVibe API 密钥:
选择可用模型
- 在弹出的模型列表中,勾选您想使用的模型
- 建议全部勾选,以便在不同场景下灵活切换
- 点击 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 输出面板的错误信息