GitHub Copilot 接入第三方模型 API 指南

接入说明

OAI Compatible Provider 插件的核心作用是将 Copilot 发出的标准 OpenAI 格式请求，转发到指定的兼容服务端（如 ModelScope 推理网关或自建服务）。

⚠️ 注意 登录账号建议使用个人 Pro 会员或免费账号，组织账号可能无法管理模型权限。

插件安装

在 VS Code 扩展市场搜索并启用以下组件：

• GitHub Copilot
• GitHub Copilot Chat
• OAI Compatible Provider for Copilot (ID: johnny-zhao.oai-compatible-copilot)

安装完成后，执行 Developer: Reload Window 重载窗口以确保插件生效。

提示：确保 VS Code 中已正确登录 GitHub 且 Copilot 基础功能可用，避免排查时混淆问题来源。

配置文件编写

建议将配置写入项目根目录下的 .vscode/settings.json 文件中。

基础配置结构

{
  "oaicopilot.baseUrl": "https://<你的 API 地址>/v1",
  "oaicopilot.delay": 0,
  "oaicopilot.readFileLines": 0,
  "oaicopilot.retry": {
    "enabled": true,
    "max_attempts": 3,
    "interval_ms": 1000,
    "status_codes": []
  },
  "oaicopilot.commitLanguage": "English",
  "oaicopilot.models": [
    {
      "id": "__provider__custom",
      "owned_by": "custom_provider",
      "baseUrl": "https://<你的 API 地址>/v1",
      "apiMode": "openai"
    }
  ]
}

核心字段解析

字段	说明
baseUrl	通用 API 基地址，顶层配置即可，模型对象内通常继承
delay	接口调用延迟控制，默认 0 即可
retry	失败重试策略，包含最大尝试次数和间隔
commitLanguage	Commit 信息生成语言，设为 English 兼容性更好
models	模型列表数组，定义可选的大模型实例

模型池配置细节

在 models 数组中，每个模型对象需包含以下关键属性：

• id: 必须与 /v1/models 接口返回的模型 ID 一致
• owned_by: 归属标识，填写提供商名称
• apiMode: 绝大多数情况填 openai，特定模型如 Anthropic 或 Ollama 需调整
• context_length: 上下文长度限制，按模型能力填写
• max_tokens: 单次最大输出 Token 数，建议参考官方文档
• vision: 支持多模态（图文）时设为 true
• temperature: 随机性参数，代码任务建议设为 0 以保证稳定性

密钥设置

在 VS Code 中按下快捷键唤起命令面板：

• Windows/Linux: Ctrl + Shift + P
• macOS: Cmd + Shift + P

输入 Set OAI Compatible Multi-Provider Apikey 并填入对应的 API Key。

模型切换使用

配置完成后，进入 Copilot 聊天界面即可看到新增的模型选项。

1. 点击聊天框顶部的模型选择器
2. 选择 Manage Modules（管理模块）
3. 找到 OAI Compatible 分类，关闭左侧隐藏图标
4. 此时自定义模型将显示在下拉列表中供选择

这样就能灵活地在不同第三方模型间切换了。