前言
本文是 Windows Copilot API 本地部署教程 的文字版，主要整理如何在本地运行 Windows-Copilot-API 项目，并把 Copilot 能力整理成 OpenAI 兼容接口，方便在 Cherry Studio、Open WebUI 或其他支持 OpenAI API 的工具中做个人学习和测试。
最后更新时间：2026 年 6 月 23 日。开源项目、Microsoft Copilot 登录方式和客户端界面可能会变化，操作时请以项目 GitHub 页面和你当前终端输出为准。
合规提醒：本文仅用于个人学习、接口调试和本地工具连接测试。请遵守 Microsoft Copilot 的服务条款、开源项目协议以及当地法律法规，不要用于批量滥用、绕过限制或商业违规用途。
视频教程
本篇为小鲁解说 YouTube 视频教程的文字版，适合边看视频边对照操作。视频发布后，可以把 YouTube 嵌入链接补到这里；文字版先保留完整命令、配置项、排错方法和客户端连接说明。
目录
- 准备清单
- 第一步：了解 Windows-Copilot-API 项目
- 第二步：准备 Python、Git 和浏览器环境
- 第三步：下载项目并安装依赖
- 第四步：登录 Copilot 并保存会话
- 第五步：启动本地 OpenAI 兼容接口
- 第六步：连接 Cherry Studio 等客户端
- 常见错误排查
- 常见问题
准备清单
开始操作前，请先准备好以下内容。本文默认你会复制命令、打开终端，并能根据提示完成 Microsoft 账号登录。
- 一台电脑：Windows 用户最适合按本文操作，macOS/Linux 用户也可以参考 Python 项目流程。
- Python 3.10 以上：建议安装 3.10、3.11 或 3.12，并勾选 Add Python to PATH。
- Git：用于拉取 GitHub 项目源码。
- Microsoft 账号：用于登录 Copilot。不同地区和账号状态可能影响可用性。
- AI 客户端：例如 Cherry Studio、Open WebUI，或其他支持 OpenAI 兼容 API 的工具。
第一步：了解 Windows-Copilot-API 项目
Windows-Copilot-API 是一个开源项目，目标是把 Microsoft Copilot 会话封装成本地可调用的接口。为了减少信息过期，建议优先查看项目原始页面：
项目地址：https://github.com/sums001/Windows-Copilot-API
这类项目通常依赖浏览器登录状态和本地服务转发，不等同于 Microsoft 官方公开 API。文章里的配置仅建议用于个人学习、测试和本地工具连接。
第二步：准备 Python、Git 和浏览器环境
先确认本机已经安装 Python 和 Git。在终端中执行以下命令检查版本：
python --version
git --version如果 Windows 终端无法识别 python，可以尝试：
py --version如果仍然无法识别，说明 Python 没有安装好，或没有加入系统 PATH，需要重新安装并勾选环境变量选项。
第三步：下载项目并安装依赖
选择一个你容易找到的目录，例如桌面或 D 盘工具目录，然后执行以下命令拉取项目：
git clone https://github.com/sums001/Windows-Copilot-API.git
cd Windows-Copilot-API建议创建虚拟环境，避免和电脑上其他 Python 项目互相影响。Windows PowerShell 可执行：
python -m venv venv
.\venv\Scripts\Activate.ps1如果 PowerShell 提示脚本执行策略限制，可以临时允许当前用户执行本地脚本：
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned进入虚拟环境后，安装项目依赖：
pip install -r requirements.txt如果项目依赖 Playwright 浏览器组件，再按项目提示安装 Chromium：
playwright install chromium第四步：登录 Copilot 并保存会话
首次使用通常需要启动登录流程，让项目打开浏览器并完成 Microsoft 账号登录。具体命令请以项目 README 为准，常见形式如下：
python -m copilot login登录时请使用你自己的 Microsoft 账号。完成登录后，不要随意删除项目目录中的会话文件，否则可能需要重新登录。
如果项目 README 中的登录命令和本文不同，请优先使用 GitHub 项目页当前给出的最新命令。
第五步：启动本地 OpenAI 兼容接口
登录完成后，启动本地接口服务。常见启动命令如下，具体文件名同样以项目当前说明为准：
python app.py启动成功后，终端通常会显示本地服务地址，例如：
http://127.0.0.1:8000/v1这个地址就是后面客户端要填写的 API Base URL。只要终端窗口关闭，本地服务通常也会停止，所以使用时需要保持服务运行。
第六步：连接 Cherry Studio 等客户端
以 Cherry Studio 为例，可以添加一个 OpenAI 兼容服务，填写以下信息：
| 项目 | 填写示例 | 说明 |
|---|---|---|
| 接口类型 | OpenAI Compatible | 选择 OpenAI 兼容接口 |
| API Base URL | http://127.0.0.1:8000/v1 | 以终端实际输出为准 |
| API Key | 任意占位字符 | 部分客户端要求必填，可按项目说明填写 |
| 模型名称 | copilot | 优先以项目接口返回的模型名为准 |
配置完成后，先发送一句简单测试，例如“你好，请用一句话介绍你自己”。如果能正常返回内容，说明本地接口和客户端已经连通。
常见错误排查
问题一：pip install 安装依赖失败
可能原因：Python 版本过低、网络无法访问依赖源，或虚拟环境没有激活。
解决方法：先确认 Python 版本，再确认命令行前面是否出现 (venv)。如果网络慢，可以更换 pip 镜像源后重试。
问题二：登录 Copilot 时浏览器打不开
可能原因：Playwright 浏览器组件未安装，或系统阻止脚本启动浏览器。
解决方法：先执行 playwright install chromium，再重新运行登录命令。如果仍然失败，查看项目 GitHub Issues 是否有同类问题。
问题三：客户端提示 401 或无法连接
可能原因：本地服务没有启动、Base URL 填写错误，或客户端强制要求 API Key。
解决方法：保持运行接口服务的终端窗口不要关闭；确认地址包含 /v1；如果客户端要求 API Key，可以先填一个占位字符串，再按项目说明调整。
常见问题
这是 Microsoft 官方 API 吗？
不是。本文介绍的是开源项目封装的本地接口，主要用于个人学习和测试。正式生产环境或商业项目应优先使用官方提供的 API 和服务。
模型名称可以随便填吗？
不建议随便填。客户端里的模型名称应以项目接口实际返回为准。如果项目说明推荐使用 copilot，就优先填写 copilot。
为什么我这里不能用？
可能和账号状态、地区、网络环境、项目更新或依赖版本有关。建议先确认你能正常访问 Copilot 官网，再按照项目 README 重新执行登录和启动步骤。
总结和下一步
通过这篇 Windows Copilot API 本地部署教程，你已经了解了环境准备、项目下载、依赖安装、Copilot 登录、本地 OpenAI 兼容接口启动，以及 Cherry Studio 等客户端连接方式。
后续如果你发布了对应 YouTube 视频，可以把视频链接补到“视频教程”区；如果项目命令发生变化，也建议及时更新本文中的命令和截图。
更多 AI 工具和本地部署教程，可以查看 小鲁解说首页。