跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言AI大前端

GitHub Copilot 接入第三方模型 API 实战

通过 OAI Compatible Provider 插件,可在 VS Code 中配置 GitHub Copilot 调用第三方兼容 OpenAI 协议的模型。教程涵盖插件安装、settings.json 配置详解(含模型池定义、重试策略及参数设置),以及聊天界面中切换和管理自定义模型的方法。适合希望利用私有化或第三方大模型增强编码辅助的开发场景。

remedios发布于 2026/3/22更新于 2026/9/974 浏览
GitHub Copilot 接入第三方模型 API 实战

背景与原理

OAI Compatible Provider for Copilot 插件的核心作用,是将 Copilot 或 Copilot Chat 发出的标准 OpenAI 格式请求,转发到指定的兼容服务端。这让我们能灵活使用 ModelScope 推理网关、自建 OneAPI 或其他兼容接口的大模型。

注意:

账号权限方面,建议使用非组织账户开通 Pro 会员以便管理模型,或者直接使用免费账号登录测试。确保 VS Code 中已登录 GitHub 且 Copilot 基础功能正常,这样排查问题时才能分清是插件转发问题还是账号本身的问题。

环境准备

在 VS Code 扩展市场安装以下插件并启用:

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

安装完成后,记得执行 Developer: Reload Window 重载窗口一次,让插件生效。

核心配置

建议将配置文件放在项目根目录下的 .vscode/settings.json 中。这样配置会随项目共享,方便团队协作。

1. 单模型示例

如果你只想用一个特定的模型,配置可以简化如下。这里以 Soraharu 为例,展示了如何定义一个兼容的模型 ID 和对应的基地址。

{
  "oaicopilot.baseUrl": "https://api.soraharu.com/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__soraharu"
,
"owned_by"
:
"soraharu"
,
"baseUrl"
:
"https://api.api.soraharu.com/v1"
,
"apiMode"
:
"openai"
}
,
{
"id"
:
"google/gemini-3-pro-preview"
,
"owned_by"
:
"soraharu"
,
"baseUrl"
:
"https://api.soraharu.com/v1"
,
"context_length"
:
128000
,
"max_tokens"
:
4096
,
"vision"
:
true
,
"apiMode"
:
"openai"
,
"temperature"
:
0
}
]
}

2. 多模型池配置

实际开发中,我们往往需要根据任务类型切换模型。下面是一个包含多个模型的配置示例,支持 Gemini、Claude 等不同系列。

{
  "oaicopilot.baseUrl": "https://api.soraharu.com/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__soraharu",
      "owned_by": "soraharu",
      "baseUrl": "https://api.api.soraharu.com/v1",
      "apiMode": "openai"
    },
    {
      "id": "google/gemini-3-pro-preview",
      "owned_by": "soraharu",
      "baseUrl": "https://api.soraharu.com/v1",
      "context_length": 128000,
      "max_tokens": 4096,
      "vision": true,
      "apiMode": "openai",
      "temperature": 0
    },
    {
      "id": "anthropic/claude-opus-4-5-thinking",
      "owned_by": "soraharu",
      "baseUrl": "https://api.soraharu.com/v1",
      "context_length": 128000,
      "max_tokens": 4096,
      "vision": true,
      "apiMode": "openai",
      "temperature": 0
    },
    {
      "id": "anthropic/claude-sonnet-4-thinking",
      "owned_by": "soraharu",
      "baseUrl": "https://api.soraharu.com/v1",
      "context_length": 128000,
      "max_tokens": 8192,
      "vision": true,
      "apiMode": "openai",
      "temperature": 0
    }
  ]
}

3. 配置项详解

配置主要分为两块:顶层通用设置和模型池定义。

顶层通用项

字段说明
oaicopilot.baseUrl全局 API 基地址,推荐统一维护一处,避免分散。
oaicopilot.delay调用接口的延迟控制,一般设为 0 即可保持默认响应速度。
oaicopilot.readFileLines配合文件分段补全功能,通常设 0 关闭限制。
oaicopilot.retry失败自动重试策略,开启后遇到网络波动会自动重连。
oaicopilot.commitLanguageCommit 信息生成的语言,填 "English" 符合大多数规范。

模型池 oaicopilot.models

这是最关键的部分,决定了你能选哪些模型。

字段说明
id必须与 /v1/models 接口返回的模型 ID 一致,例如 google/gemini-3-pro-preview。
owned_by描述归属,填提供商名称即可,如 soraharu。
baseUrl建议只在顶层写一处,模型对象里不强制,冲突时顶层优先。
apiMode绝大多数情况填 openai,如果是 Anthropic 或 Ollama 等自定义协议才需调整。
context_length最大上下文长度(Token 数),按模型能力填写。
max_tokens单次回应最大输出,官方建议 4096 或 8192 等数值。
vision是否支持多模态,Gemini/Claude 等具备图文能力的模型设为 true。
temperature控制随机性,代码生成建议设为 0,保证结果稳定可复现。

4. 设置 API Key

配置好 JSON 后,还需要在 VS Code 中输入你的 API Key。通过命令面板操作:

  • Windows/Linux:按 Ctrl+Shift+P
  • Mac:按 Cmd+Shift+P

输入命令 Set OAI Compatible Multi-Provider Apikey,然后粘贴你的密钥即可。

启用与管理

配置完成后,就可以开始使用了。操作步骤很简单:

  1. 打开 Copilot 聊天框。
  2. 点击模型选择框。
  3. 进入模型管理(Manage Modules...)。
  4. 找到 OAI Compatible 选项,将左侧的隐藏眼睛图标关闭。

这样,你自己设定的模型就会出现在下拉选择框中了。

文章配图

目录

  1. 背景与原理
  2. 环境准备
  3. 核心配置
  4. 1. 单模型示例
  5. 2. 多模型池配置
  6. 3. 配置项详解
  7. 4. 设置 API Key
  8. 启用与管理

更多推荐文章

查看全部
  • 2026 国内 AI 编程套餐横评:选型指南与额度机制解析
  • VSCode 本地部署 DeepSeek 模型实战指南
  • 写提示词没你想的那么难:从零开始理清核心概念
  • PyCharm 集成 Anaconda 虚拟环境配置教程
  • 前端实现 Word 文档在线编辑与导出:基于 mammoth.js 与 Blob 对象
  • VLM Unlearning 技术路线论文综述
  • 基于快速选择算法:数组第 K 大元素与最小 K 个数
  • 极光推送(JPush)快速上手:Java 后端与全平台适配
  • Python PyModbus 模块详解
  • 手机端运行 Stable Diffusion 的开源 AI 绘画工具
  • 飞算 JavaAI 专业版深度测评:9.9 元月租的真实效能
  • Verilog 零基础入门:语法、仿真与 FPGA 实战
  • Linux 远程连接 Windows 桌面配置指南
  • 详解二叉树展开为链表:从递归到 O(1) 空间优化
  • LeetCode 92 区间反转:递归与哨兵节点解法
  • 把 AI 数学公式稳妥复制到 Word 的几种办法
  • FLUX.1-dev与Stable Diffusion 对比评测:图像质量与生成速度
  • 机器人通讯总线选型:CAN/FD、高速 485 与 EtherCAT 深度对比
  • 腾讯混元 7B 开源:256K 上下文与数学推理升级
  • GitHub Copilot 使用体验与功能场景分析

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online