GitHub Copilot 配置
通过 VS Code 扩展 OAI Compatible Provider for Copilot，可以在 GitHub Copilot Chat 的模型选择器中使用 LAYSO AI。本教程只保留这一套与截图对应的配置流程。
一个 Key，访问全平台模型
同一个 LAYSO AI API Key 可以访问平台内的模型。LAYSO AI 按所选模型的当前价格计费；每个成功请求都有独立扣费明细，失败任务不会产生扣费。
使用要求
本扩展需要有效的 GitHub Copilot Individual 订阅，暂不支持 Copilot Business 和 Enterprise 用户。还需要 VS Code 1.104.0 或更高版本。如果没有 Copilot Individual 订阅，建议改用 Cursor、Cline 或其他已提供独立教程的工具。
前提条件
- 已安装或升级到最新稳定版 Visual Studio Code ↗。
- 已启用 GitHub Copilot Chat，并具有有效的 Copilot Individual 订阅。
- 已在 LAYSO AI API Key 页面 ↗ 创建 API Key。
- 已从 LAYSO AI 模型与价格 ↗ 复制需要使用的完整模型 ID。
配置步骤
第 1 步：安装扩展
在 VS Code 扩展市场搜索完整名称 OAI Compatible Provider for Copilot，确认发布者为 Johnny Zhao，然后点击 Install。
也可以在终端安装：
code --install-extension johnny-zhao.oai-compatible-copilot安装完成后重新加载 VS Code。
第 2 步：打开语言模型管理器
扩展安装完成后，打开 VS Code 命令面板，搜索并运行：
Chat: Manage Language Models第 3 步：进入 OAICopilot 配置
在语言模型管理器中找到 OAI Compatible，打开它的配置入口，进入 OAICopilot Configuration 页面。
如果没有看到入口，也可以打开命令面板运行 OAICopilot: Open Configuration UI，或点击 VS Code 底部状态栏中的 OAICopilot。
第 4 步：配置连接并添加 Provider
在 Global Configuration 中填写：
| 字段 | 填写内容 |
|---|---|
| Global Base URL | https://api.layso.ai/v1 |
| Global API Key | 从 LAYSO AI API Key 页面复制的完整密钥 |
其他全局参数保持默认，点击 Save Global Configuration。然后在下方的 Provider Management 中点击 Add Provider：
| 字段 | 填写内容 |
|---|---|
| Provider ID | layso-ai |
| Provider Name | LAYSO AI |
| Base URL | https://api.layso.ai/v1 |
| API Key | 使用全局 API Key |
| API Mode | openai |
填写完成后保存 Provider。
第 5 步：添加模型
保存 Provider 后，在 Model Management 中点击 Add Model：
- Provider 选择
layso-ai。 - Model ID 粘贴模型与价格页面展示的完整 ID。
- 根据模型实际能力设置上下文长度、最大输出、Vision、Tool Calling 和推理参数。
- 保存模型。
不要猜测模型别名或能力参数；以 LAYSO AI 模型页面展示的信息为准。
第 6 步：启用并选择模型
在语言模型管理器中找到 OAI Compatible，启用刚刚添加的模型。返回 Chat，打开模型选择器，在 Other Models 下选择显示为 LAYSO AI (OAICopilot) 的模型。
如果模型没有立即出现，请执行 Developer: Reload Window 或重新启动 VS Code。
验证配置
确认输入框底部显示的是 LAYSO AI 模型，然后发送一条简短消息：
请用一句话介绍自己。请求成功后，到 LAYSO AI 用户端核对模型、Token 和扣费明细，再开始长任务。
能力边界
Chat 与 Agent
扩展会把配置的模型加入 VS Code Chat 模型选择器。Chat 主对话可以使用 LAYSO AI；但代码应用、部分工具调用或辅助任务仍可能由 VS Code / GitHub 的内置能力处理。
内联补全与语义搜索
选择 LAYSO AI 聊天模型不代表所有 Copilot 流量都会切换。内联代码补全、语义搜索和依赖 Embeddings 的功能可能仍使用 GitHub 提供的服务。
订阅与组织账号
本教程使用的扩展面向 Copilot Individual。Business 和 Enterprise 账号不在当前支持范围内，应由组织管理员选择获准的接入方式。
常见问题
| 现象 | 排查方法 |
|---|---|
| 扩展无法使用 | 确认 VS Code 版本满足要求，并确认当前账号是有效的 Copilot Individual 订阅 |
| 模型没有出现在选择器 | 检查 Provider 和模型是否保存，再运行 Chat: Manage Language Models 启用模型并重载窗口 |
401 / 403 | 重新复制 API Key，确认没有空格或换行，并检查全局配置是否已保存 |
404 | Base URL 必须为 https://api.layso.ai/v1，不要重复添加 /v1 或填写完整请求端点 |
| 模型不存在 | 从模型与价格页面复制完整模型 ID，不要使用展示名称或猜测别名 |
| Chat 可用但 Agent 失败 | 确认模型支持工具调用，并检查扩展中的 Tool Calling 配置 |
| 没有 LAYSO AI 扣费明细 | 确认当前选择的是 LAYSO AI (OAICopilot) 模型且请求成功；失败任务不会产生扣费 |
计费与安全
- LAYSO AI 只对实际到达平台并成功完成的请求计费。
- GitHub Copilot 订阅和其内置能力由 GitHub 单独计费。
- 不要在截图、日志、项目文件或 Git 仓库中暴露完整 API Key。
- 此扩展由社区维护，并非 GitHub、Microsoft 或 LAYSO AI 官方产品。