# GitHub Copilot 接入 OfoxAI 配置指南

Source: https://ofox.ai/zh/docs/integrations/copilot

通过 VS Code 扩展 **OAI Compatible Provider for Copilot**，可以将 OfoxAI 接入 GitHub Copilot Chat，在熟悉的编辑器中使用 Claude、GPT、Gemini 等 100+ 模型。

本扩展需要 **GitHub Copilot 个人版（Individual）订阅**，暂不支持 Copilot Business 和 Enterprise 用户。若无 Copilot 订阅，建议改用 [Cursor](https://ofox.ai/zh/docs/integrations/cursor) 或 [Cherry Studio](https://ofox.ai/zh/docs/integrations/cherry-studio)。

## 前提条件

- 已注册 OfoxAI 账号并获取 API Key（[前往获取](https://app.ofox.ai)）
- 已安装 [VS Code](https://code.visualstudio.com/)
- 已有有效的 **GitHub Copilot 个人版（Individual）** 订阅（不支持 Business / Enterprise）

## 配置步骤

### 第 1 步：安装扩展

在 VS Code 扩展市场搜索 **OAI Compatible Provider for Copilot**（作者：Johnny Zhao），点击 **Install** 安装。

![安装 OAI Compatible Provider for Copilot 扩展](https://ofox.ai/screenshots/copilot/step-1.png)

### 第 2 步：打开配置界面

按 `Cmd+Shift+P`（macOS）/ `Ctrl+Shift+P`（Windows/Linux）打开命令面板，输入并执行：

```
OAICopilot: Open Configuration UI
```

![通过命令面板打开配置界面](https://ofox.ai/screenshots/copilot/step-2.png)

### 第 3 步：填写全局配置

在 **Global Configuration** 区域填写以下内容，然后点击 **Save Global Configuration** 保存：

| 配置项 | 值 |
|--------|-----|
| **Global Base URL** | `https://api.ofox.ai/v1` |
| **Global API Key** | 你的 OfoxAI API Key |

![填写 Global Base URL 和 API Key 并保存](https://ofox.ai/screenshots/copilot/step-3.png)

### 第 4 步：添加 Provider

在 **Provider Management** 区域，点击 **Add Provider**（标注 ①），在新建行中填写以下字段，然后点击 **Save**（标注 ⑥）：

| 字段 | 值 |
|------|-----|
| **Provider ID**（标注 ②） | `ofox` |
| **Base URL**（标注 ③） | `https://api.ofox.ai` |
| **API Key**（标注 ④） | 你的 OfoxAI API Key |
| **API Mode**（标注 ⑤） | `Anthropic` |

![添加 OfoxAI Provider](https://ofox.ai/screenshots/copilot/step-4.png)

### 第 5 步：添加模型

在 **Model Management** 区域，点击 **Add Model**（标注 ①），填写以下字段，然后点击 **Save Model**（标注 ④）：

| 字段 | 值 |
|------|-----|
| **Provider ID**（标注 ②） | `ofox` |
| **Model ID**（标注 ③） | 模型名称，如 `anthropic/claude-sonnet-5.5` |

![添加自定义模型](https://ofox.ai/screenshots/copilot/step-5.png)

可重复此步骤添加多个模型，模型 ID 请参考 [OfoxAI 模型广场](https://ofox.ai/zh/models)。

### 第 6 步：在聊天面板选择模型

打开 Copilot Chat 面板，点击模型选择区域，关闭 **Auto** 模式，在 **Other Models** 下找到刚添加的 OfoxAI 模型并选中。

若看不到模型，点击 **Manage Models...** 进入模型列表页面。

![在聊天面板切换到 OfoxAI 模型](https://ofox.ai/screenshots/copilot/step-6.png)

### 第 7 步：确认模型并开始使用

在 Language Models 面板中，**OAI Compatible** 分组下会显示已添加的 OfoxAI 模型。在右下角聊天框选中模型后即可开始对话。

![确认模型出现在 OAI Compatible 分组下](https://ofox.ai/screenshots/copilot/step-7.png)

## 推荐模型

推荐模型请参考 [模型广场](https://ofox.ai/zh/models)。

## 常见问题

**Q: 扩展市场搜不到该扩展**

搜索完整名称 `OAI Compatible Provider for Copilot`，或直接搜索作者名 `Johnny Zhao`。

**Q: 命令面板找不到 `OAICopilot: Open Configuration UI`**

确认扩展已安装并启用，安装后可能需要重新加载 VS Code 窗口（`Cmd+Shift+P` → `Reload Window`）。

**Q: 添加的模型在聊天面板看不到**

在模型选择下拉中关闭 **Auto** 模式，切换到 **Other Models** 分类下查找，或点击 **Manage Models...** 检查模型是否已正确添加。

**Q: 提示「Invalid API Key」或请求失败**

检查以下几点：
1. Global Base URL 是否为 `https://api.ofox.ai/v1`（末尾不加斜杠）
2. API Key 是否从 [OfoxAI 控制台](https://app.ofox.ai) 完整复制（无前后空格）
3. Provider 的 API Mode 是否选择了 `Anthropic`

**Q: 代码补全（Tab 补全）仍使用 Copilot 官方模型**

这是预期行为。OAI Compatible Provider 目前仅影响 **Copilot Chat** 对话功能，Tab 代码补全由 GitHub Copilot 官方控制。

**Q: 我是 Copilot Business / Enterprise 用户，能用吗？**

暂不支持。该扩展目前仅适用于 **GitHub Copilot 个人版（Individual）** 用户，Business 和 Enterprise 用户需等待后续版本支持。