GitHub Copilot 接入#

GitHub Copilot 是微软推出的 AI 编程助手，集成在 VS Code 编辑器中，能够在编写代码时提供智能建议、自动补全和代码生成功能。通过 OAI Compatible Provider 插件将 GitHub Copilot 接入 UniGateway，你可以使用自己的 API 密钥驱动 Copilot，享受更灵活、更经济的 AI 编程体验。

兼容性说明#

UniGateway 完全支持 OpenAI Chat Completions 协议，可以通过 OAI Compatible Provider for Copilot 扩展无缝接入 GitHub Copilot。配置时将 oaicopilot.baseUrl 设置为 UniGateway 端点，并在 settings.json 中声明可用模型。

注意 Base URL 必须以 /v1 结尾 — 完整 URL 为 https://api.unigateway.ai/v1。Copilot 会自动拼接后续路径（如 /chat/completions），因此请不要省略 /v1 后缀，也不要重复添加。

GitHub Copilot 依赖工具调用（function calling）完成多步编程工作流。请确保所选模型支持工具使用 — UniGateway 上大多数模型都支持，详情参见 接口兼容矩阵。

配置#

第一步：安装所需扩展#

在 VS Code 中安装以下两个扩展：

1. GitHub Copilot Chat — 在扩展商店搜索 "GitHub Copilot Chat"，点击安装。

2. OAI Compatible Provider for Copilot — 在扩展商店搜索 "OAI Compatible Provider for Copilot"，点击安装。

两个扩展缺一不可。OAI Compatible Provider 负责将自定义 OpenAI 兼容端点桥接到 Copilot Chat 中。

第二步：配置 OAI Compatible Provider#

安装完成后，打开 VS Code 设置：

• 点击左侧活动栏的齿轮图标（或使用快捷键 Cmd+, / Ctrl+,）
• 搜索 oaicopilot

找到以下两项并配置：

设置 Base URL

将 oaicopilot.baseUrl 设置为：

https://api.unigateway.ai/v1

配置可用模型

在 VS Code 的 settings.json 中添加模型列表。打开命令面板（Cmd+Shift+P / Ctrl+Shift+P），输入 "Open User Settings (JSON)"，然后在 JSON 中添加：

"oaicopilot.models": ["gpt-5.5"]

重要： 列表中的模型 ID 应与 GET /v1/models 返回的模型 ID 一致 — 参见 模型列表。你可以随时增删模型。

模型推荐

建议添加不同能力和价格梯度的模型以适应各种使用场景：

• 高复杂度任务（多文件重构、调试、复杂逻辑）：claude-sonnet-4-6、gpt-5.2
• 均衡任务（通用编程、解释）：gemini-2.5-pro、gpt-4.1
• 快速迭代（简单编辑、问答）：gpt-4.1-mini、deepseek-chat

第三步：在 Copilot Chat 中添加模型#

1. 打开 VS Code 侧边栏的 Copilot Chat 界面（或使用快捷键 Cmd+Shift+I / Ctrl+Shift+I）。

2. 点击聊天输入框上方的 模型选择器，在下拉菜单中选择 "Manage Models..."（管理模型）。

3. 点击 "Add Models"（添加模型）。

4. 在提供商列表中选择 "OAI Compatible"。

5. 输入你的 UniGateway API Key（密钥将安全地保存在本地）。

6. 勾选你希望在模型选择器中使用的模型。

获取 API Key

你可以在 UniGateway 控制台 中获取或创建你的 API Key。

重要： 你必须选择 "OAI Compatible" 提供商（而非其他预列出的提供商）。

第四步：开始使用#

配置完成后，你可以：

• 在模型选择器中切换不同的 UniGateway 模型
• 在编辑器中输入代码时获得智能补全建议
• 使用 Chat 界面与 AI 对话，获取编程帮助

验证清单

快捷键#

某些快捷键可能与系统或其他软件的快捷键冲突，如遇冲突可在 VS Code 设置中自定义快捷键。

故障排除#

扩展未找到#

问题： 在扩展商店中找不到 "OAI Compatible Provider for Copilot"。

解决方案：

• 确认 VS Code 版本在 1.104.0 或以上 — 通过 code --version 或菜单栏 帮助 > 关于 查看
• 检查扩展市场是否正常连接
• 尝试直接访问扩展页面安装

Base URL 无效#

问题： Copilot 报告连接错误或 Base URL 无效。

解决方案：

• 确认 oaicopilot.baseUrl 设置为 https://api.unigateway.ai/v1（注意 /v1 后缀）
• 检查是否有代理或防火墙拦截请求
• 在终端中运行 curl https://api.unigateway.ai/v1/models 验证端点可达

模型不出现在选择器中#

问题： 配置了模型但在模型选择器中看不到。

解决方案：

• 确认 settings.json 中 oaicopilot.models 的模型 ID 与 GET /v1/models 返回的完全一致
• 确保在 "Manage Models" 中选择了 "OAI Compatible" 提供商
• 重新加载 VS Code 窗口（Cmd+Shift+P / Ctrl+Shift+P → "Reload Window"）

API Key 认证失败#

问题： 输入 API Key 后 Copilot 提示 401 或 403 错误。

解决方案：

• 检查 API Key 是否复制正确，避免多余空格或换行
• 确认 API Key 已激活且账户余额充足
• 重新进入 "Manage Models" → "Add Models" 重新输入 API Key

工具调用不工作#

问题： Copilot 能返回文本，但无法执行工具操作（文件读取、命令运行等）。

解决方案：

• 确认模型支持工具使用 — 并非所有模型都支持函数调用
• 切换到已知支持工具调用的模型（如 claude-sonnet-4-6、gpt-4.1）
• 参见 接口兼容矩阵 查看支持工具的模型列表

参见#

• 聊天补全 — Copilot 使用的核心端点
• 模型列表 — 查询可用模型及其能力
• 流式响应 — 配置流式响应以获得实时输出
• 认证 — 管理 API 密钥及排查鉴权错误
• 接口兼容矩阵 — 确认可用端点和功能
• 编程工具与多步工作流 — 通用编程工具集成