oai-compatible-copilot是什么?在GitHub Copilot Chat中接入任意大模型API的终极指南
oai-compatible-copilot是什么?在GitHub Copilot Chat中接入任意大模型API的终极指南
oai-compatible-copilot 是一款 VS Code 扩展,让你直接在 GitHub Copilot Chat 中接入 OpenAI、Ollama、Anthropic、Gemini 等任意大模型 API,实现"自带密钥"(BYOK)的 AI 对话编程。无论你想用 ModelScope、SiliconFlow、DeepSeek 等 OpenAI 兼容服务,还是本地的 Ollama 模型,只需几步配置,即可在 Copilot Chat 中自由切换模型。🚀
一、为什么需要 oai-compatible-copilot?
GitHub Copilot Chat 默认只能使用官方提供的模型,而 oai-compatible-copilot 通过 VS Code 的 LanguageModelChatProvider 接口,向编辑器注册了一个名为 "OAI Compatible" 的模型供应商(vendor id 为 oaicopilot),从而把任何兼容 API 的大模型"注入"到 Copilot Chat 的模型选择器中。
核心实现非常清晰:
- 入口:src/extension.ts —— 扩展激活时注册模型供应商
- 核心 Provider:src/provider.ts —— 实现
LanguageModelChatProvider接口 - API 适配层:src/openai/openaiApi.ts、src/anthropic/anthropicApi.ts、src/gemini/geminiApi.ts、src/ollama/ollamaApi.ts
二、核心功能一览 📊
| 功能 | 说明 |
|---|---|
| 多 API 协议支持 | 支持 openai、openai-responses、ollama、anthropic、gemini 五种协议 |
| 视觉模型 | 完整支持图像理解能力 |
| 多供应商管理 | 同时配置多个供应商,API 密钥自动分组管理 |
| 同模型多配置 | 同一模型可定义 thinking / no-thinking 等不同参数 |
| 可视化配置界面 | 无需手写 JSON 即可管理供应商和模型 |
| 自动重试 | 遇到 429、500、502、503、504 时指数退避重试 |
| Token 统计 | 状态栏实时显示 token 用量 |
| Git 集成 | 在源代码管理面板直接生成提交信息 |
| 导入/导出 | 轻松分享和备份配置 |
三、快速上手:3步接入任意大模型 ⚡
环境要求:VS Code 1.104.0 或更高版本,以及一个 OpenAI 兼容供应商的 API Key。
第 1 步:安装扩展
在 VS Code 扩展市场中搜索 OAI Compatible Provider for Copilot 并安装。
第 2 步:配置 API 地址与模型
打开 VS Code 设置(或 settings.json),配置 oaicopilot.baseUrl 和 oaicopilot.models:
"oaicopilot.baseUrl": "https://api-inference.modelscope.cn/v1",
"oaicopilot.models": [
{
"id": "Qwen/Qwen3-Coder-480B-A35B-Instruct",
"owned_by": "modelscope",
"context_length": 256000,
"max_tokens": 8192,
"temperature": 0,
"top_p": 1
}
]
第 3 步:在 Copilot Chat 中选择模型
- 打开 GitHub Copilot Chat 界面(
Ctrl+Shift+I/Cmd+Shift+I); - 点击模型选择器,选择 Manage Models...;
- 选择 OAI Compatible 供应商,输入 API Key(保存在本地);
- 勾选要启用的模型,即可开始对话。🎉
四、5 种 API 模式:主流大模型一网打尽
通过每个模型的 apiMode 参数,扩展可自动适配不同的协议格式(请求头、端点、消息转换逻辑):
| apiMode | 端点 | 适用场景 |
|---|---|---|
openai(默认) |
/chat/completions |
ModelScope、SiliconFlow 等 OpenAI 兼容服务 |
openai-responses |
/responses |
OpenAI 官方 Responses API 及兼容网关 |
ollama |
/api/chat |
本地 Ollama 实例(可免 API Key) |
anthropic |
/v1/messages |
Anthropic Claude 模型 |
gemini |
/v1beta/models/{model}:streamGenerateContent |
Google Gemini 模型 |
不同协议的请求头格式差异(如 Bearer 与 x-api-key)由 src/commonApi.ts 统一处理,用户无需关心底层细节。
五、可视化配置界面:告别手写 JSON
除了改配置,扩展还提供直观的图形化管理面板:
- 命令面板打开:按
Ctrl+Shift+P,执行 OAICopilot: Open Configuration UI; - 状态栏打开:点击 VS Code 右下角的 OAICopilot 状态栏项。
在面板中你可以添加供应商(Provider ID、Base URL、API Key、API 模式)、添加模型、调整参数,所有更改会立即写入 VS Code 设置。相关实现见 src/views/configView.ts 及 assets/configView/。
💡 注意:一旦使用配置界面,全局的
baseUrl和 API Key 将失效,请统一在界面中维护。
六、进阶玩法 🔑
多供应商 API 密钥自动管理
模型配置中的 owned_by 字段用于按供应商分组密钥(存储键为 oaicopilot.apiKey.<供应商名>)。执行命令 OAICopilot: Set OAI Compatible Multi-Provider API Key 即可分别为每个供应商配置密钥,实现"多模型共存、密钥互不干扰"。
同模型多配置:thinking 与 no-thinking
通过 configId 字段,同一模型可以出现多个配置条目,在模型选择器中显示为独立选项,例如:
"oaicopilot.models": [
{ "id": "glm-4.6", "configId": "thinking", "owned_by": "zai",
"temperature": 0.7, "thinking": { "type": "enabled" } },
{ "id": "glm-4.6", "configId": "no-thinking", "owned_by": "zai",
"temperature": 0, "thinking": { "type": "disabled" } }
]
这样你在 Copilot Chat 中可以直接选择 glm-4.6::thinking(开启思维链)或 glm-4.6::no-thinking(快速模式)。
Git 提交信息一键生成
在源代码管理面板点击魔术棒图标,即可用你配置的模型生成 commit message,支持 14 种语言(通过 oaicopilot.commitLanguage 设置),相关逻辑在 src/gitCommit/commitMessageGenerator.ts。
Token 用量与自动重试
状态栏实时显示当前模型的 token 消耗进度条(src/statusBar.ts);遇到 API 限流或服务器错误时,oaicopilot.retry 会按指数退避自动重试,默认最多 3 次,详见 package.json 中的配置定义。
七、新手常见问题
Q:API Key 安全吗?
A:密钥通过 VS Code 的 SecretStorage 加密保存在本地,不会写入明文配置文件。
Q:本地 Ollama 模型需要 API Key 吗?
A:不需要。使用 apiMode: "ollama" 并设置 baseUrl 为 http://localhost:11434,即可免密钥直连。
Q:收到 429 错误怎么办?
A:这是 API 限流。扩展默认开启自动重试(指数退避);也可以调大 oaicopilot.delay 为连续请求增加延迟,降低触发限流的概率。
Q:如何排查请求问题?
A:将 oaicopilot.logLevel 设为 debug,日志会写入 ~/.copilot/oaicopilot/logs/ 目录。
八、总结:谁适合使用 oai-compatible-copilot?
如果你想在 GitHub Copilot Chat 中使用自己的大模型 API——无论是云端 OpenAI 兼容服务、Anthropic Claude、Gemini,还是本地 Ollama——oai-compatible-copilot 都是目前最简洁的选择:5 种 API 协议全覆盖、可视化配置、多供应商密钥管理、思维链控制、Git 提交生成一应俱全。
📚 更多细节请参考中文文档 README.zh-CN.md、完整配置说明 README.md 及版本演进记录 CHANGELOG.md。