M365 Copilot2API

Microsoft 365 Copilot → OpenAI / Anthropic 兼容 API 网关

M365 Copilot2API 是一个用 Go 编写的自托管网关，把微软 365 Copilot 商业订阅背后的 ChatHub 私有协议（WebSocket）翻译成标准的 OpenAI / Anthropic 兼容 API。Claude Code、OpenCode、Cursor 以及任何 OpenAI 客户端都可以直接用熟悉的格式调用 M365 Copilot。

工作原理概括：ChatHub 私有协议 ⇄ OpenAI / Anthropic 兼容 API。连接握手、心跳保活、事件流解析、工具调用转换全部封装在 internal/chathub 层，对外只暴露 /v1/chat/completions、/v1/messages 等标准端点。

项目自带完整 Web 管理控制台，覆盖账号授权（OAuth/PKCE）、API Key 管理、代理池、云端对话管理、用量统计与模型测试，适合个人自部署、自托管使用。

⚠️ 免责声明（请务必阅读）

• 本项目不是微软官方产品，与 Microsoft、OpenAI、Anthropic 及其关联公司均无任何从属或合作关系。
• 使用第三方账号池、代理转发等方式接入 M365 服务可能违反服务商服务条款，由此产生的一切后果由使用者自行承担。
• 请遵守当地法律法规与目标平台的服务条款（ToS）。
• 本项目仅供个人学习与研究，禁止用于商业转售或规模化运营。
• 账号被封禁、数据丢失等任何损失，本项目维护者与贡献者概不负责。

界面预览

登录	用量统计	账号管理
API Keys	对话管理	代理池
模型测试	设置	更多功能，等你发现

功能特性

架构

┌──────────────┐    OpenAI / Anthropic    ┌──────────────────┐    ChatHub    ┌──────────────┐
│ Claude Code  │ ───────────────────────► │      网关         │ ────────────► │ M365 Copilot │
│ OpenCode     │   /v1/chat/completions   │ (Go, m365-copilot2api) │  WebSocket    │  (云端对话)   │
│ 任意 OpenAI  │   /v1/messages           │  internal/web     │  internal/    │              │
│ 客户端        │   /v1/responses          │                   │  chathub      │              │
└──────────────┘                          └──────────────────┘               └──────────────┘

• 协议层（internal/chathub）：封装 M365 Copilot ChatHub 的 WebSocket 私有协议——连接建立、心跳保活、事件流解析（流式 token、工具调用、多模态输入）。对上层只暴露统一的事件接口。
• 会话解析（internal/web/session_resolver.go）：多账号场景下把每个客户端请求稳定解析到固定账号与云端对话，并实现内容键会话复用（见下文原理）。
• 账号轮询与故障转移：多账号间轮询均衡流量；账号故障（鉴权失效、连接断开等）自动切换到下一个可用账号重试。

快速开始

环境要求

• Go 1.23+（go.mod 声明的最低版本）
• Windows / Linux 均可；Windows 上推荐用仓库自带的 manage.py 管理生命周期

预编译二进制（推荐）

从 GitHub Releases 下载对应平台的二进制：

# Linux / macOS 示例
chmod +x m365-copilot2api-linux-amd64
./m365-copilot2api-linux-amd64

# Windows 示例
.\m365-copilot2api-windows-amd64.exe

源码编译

git clone https://github.com/HEXUXIU/M365-Copilot2API.git
cd M365-Copilot2API

# 设置管理员密码（可选，默认 admin123），生产环境务必设置强密码
$env:M365_ADMIN_PASSWORD = "your_strong_password"

go build -o m365-copilot2api.exe ./cmd/server

# Linux / macOS
export M365_ADMIN_PASSWORD=your_strong_password
go build -o m365-copilot2api ./cmd/server

启动

Windows 上用 manage.py 启动（默认后台上运行，日志写入 server.log / server-error.log）：

python manage.py start    # 后台运行，默认监听 0.0.0.0:4141
python manage.py status   # 查看运行状态
python manage.py logs     # 查看最近日志（可加参数 N 指定行数）
python manage.py err      # 查看错误日志
python manage.py stop     # 停止服务

manage.py 内部硬编码了仓库绝对路径（D:\M365-Copilot2API\m365-copilot2api.exe 等），克隆到其他目录时请先修改脚本顶部的路径常量，并确保先完成编译。

直接运行二进制则默认只监听内网 http://127.0.0.1:4141，可通过环境变量 M365_LISTEN 覆盖。

Docker 部署

官方不提供 Dockerfile。如需容器化部署，可自行基于预编译二进制或源码构建镜像，或在 Discussions 交流社区方案。

初始化与第一次调用

浏览器打开控制台（默认 http://127.0.0.1:4141）：

1. 用管理员密码登录（首次登录强制要求修改密码，默认密码 admin123）。
2. 在「账号」页点击开始授权： - 浏览器会弹出新窗口，跳转到 Microsoft 登录页。 - 用你的 M365 账号完成登录。 - 登录完成后弹出窗口会显示空白页或错误页——这是正常的，因为回调端点不是真正的网站，授权尚未完成。 - 从弹出窗口的地址栏复制完整 URL（包含 code=...&state=... 参数）。 - 回到控制台，将 URL 粘贴到「Callback URL」输入框，点击「Confirm and add」。 - 如果浏览器拦截了弹窗，请允许本站弹窗后重试。
3. 授权成功后，在「API Key」页创建第一个 API Key。
4. 用下面的 API 示例验证调用。

有多个 M365 账号时可以重复授权，网关会以轮询 + 故障转移的方式自动调度全部账号。

配置说明

全部通过环境变量配置，也可以用 .env.example 作为起点。应用启动时会优先读取显式设置的环境变量。

核心

自动清理

云端对话被视为「缓存条目」：会话命中时自动刷新存活时间，长期闲置或超出数量上限的对话由后台循环回收。

工具与推理

代理池与认证

数据文件

使用示例

基础聊天（OpenAI 格式）

curl http://127.0.0.1:4141/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "你好"}]
  }'

流式输出

curl http://127.0.0.1:4141/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "1+1=?"}],
    "stream": true
  }'

显式指定会话（内容键复用 + 增量发送）

携带同一 X-M365-Session-Id 的请求会被绑定到同一条云端对话，命中时网关只把新增历史部分发送给上游：

curl http://127.0.0.1:4141/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-M365-Session-Id: my-project-session" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"继续我们刚才的讨论"}]}'

多模态图片输入（OpenAI 格式）

客户端用标准的 OpenAI image_url 格式传图即可，网关会自动把图片上传到 M365 的 UploadFile 端点，并在 ChatHub 消息里注入文件注解（无需客户端感知上游细节）：

# base64 data URL 方式
curl http://127.0.0.1:4141/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "这张图里是什么颜色？"},
        {"type": "image_url", "image_url": {"url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB..."}}
      ]
    }]
  }'

也可以直接传 https 图片 URL（仅公网地址，带 SSRF 防护；本地图请用 data URL）。Responses 协议的 input_image / input_file 同样支持。

Anthropic 格式（Claude Code / Cursor）

curl http://127.0.0.1:4141/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'

上游返回的推理内容（ChainOfThought）会映射为 Anthropic thinking block，Claude Code 中可正常显示与使用。

对接 Claude Code

在 ~/.claude/settings.json 的 env 中指向网关：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:4141",
    "ANTHROPIC_MODEL": "gpt-5.6-sol",
    "ANTHROPIC_API_KEY": "m365_你的密钥"
  }
}

其他任何支持 OpenAI / Anthropic base_url 配置的客户端（OpenCode、Cursor、Codex 等）同理，把 BASE_URL 指向网关即可。

作者不针对任何第三方 Agent 框架的兼容性提供适配与排查。如有需要，自行适配。

控制台「API Keys」页的「使用 API 密钥」弹窗可直接生成 Claude Code 的 settings.json 配置与终端环境变量，复制即可。

⚠️ 认证冲突提醒：如果系统环境变量残留了 ANTHROPIC_API_KEY，或同时配置了 ANTHROPIC_AUTH_TOKEN，Claude Code 会告警「认证可能不工作」。请二选一：让 settings.json 的 env 覆盖系统级变量，或删除系统级 ANTHROPIC_*。

可用模型

网关默认内置模型映射（可在控制台「设置」页增删与调整默认推理级别）：

• 模型映射把公开模型名翻译成上游 tone；控制台可增删映射、调整默认推理级别。
• 推理强度还可通过请求内的 reasoning_effort 参数调整。
• M365 订阅会上线的新模型名（如 gpt-5.2、gpt-5.4、codex 系）以实际目录为准，可在控制台配置导入。

内容键会话复用原理

多账号场景下，网关会用「内容键（context key）」把请求复用到已有云端对话上，机制对标 DeepSeek 式上下文缓存：同一个对话上下文只维护一条云端会话，命中时只把增量新消息发给上游，不仅省去重建上下文的开销，也更贴近多轮工具的体验。核心实现在 internal/web/session_resolver.go。

客户端请求到达后，.Resolve() 按以下优先级决定重用哪个会话：

1. 显式会话（X-M365-Session-Id）：请求头显式指定的会话 ID 优先级最高，不参与任何身份判定，由调用方主动决定要连接到哪条云端对话。
2. 内容键前缀命中：当请求的消息序列与某条已记录会话的历史完全一致（按最近 3 条消息计算内容指纹）时，直接复用该会话及其云端对话。此时返回的 HistoryLen 表示「云端对话已包含的消息条数」，上层据此只发送 messages[HistoryLen:] 增量。
3. 相似度兜底：若消息不是严格前缀，但与某条最近活跃（M365_CONTEXT_TTL_MINUTES 窗口内）会话的最后消息相似度超过阈值（M365_CONTEXT_SIMILARITY，默认 0.6），仍复用该会话（此时增量边界未知，发送全量）。
4. 兜底新建：都未命中时，按 user 字段 / IP+UA 指纹或轮询绑到合适的账号与轮询逻辑新建会话。

几个特性由此而来：

• 跨 IP / 跨账号复用：内容指纹作为键全局唯一主键，不关心发起方是谁——换一台机器、换一个 M365 账号，只要对话上下文一致就能接上同一条云端会话。
• 只发增量：严格前缀命中时上层只补发新消息，等价于把云端对话当作上下文缓存用。
• 线程与清理联动：会话绑定持久化在 sessions.json（0600），过期时间由 M365_SESSION_TTL_MINUTES 控制；长期无命中的会话会随自动清理按同一窗口（默认 2 小时）被回收。

内容自动清理

云端对话被视作「缓存条目」：会话命中 = 刷新存活时间；空闲 = 过期。后台循环默认每 30 分钟回收：

• 空闲超过 M365_AUTO_CLEANUP_MAX_AGE_HOURS（默认 2 小时）的云端对话；
• 或超出数量上限 M365_AUTO_CLEANUP_KEEP_N（默认 100）的最老对话。

以下对话永不回收：白名单对话、有活跃会话绑定正在引用的对话、最近使用过的用户会话。删除云端对话时会联动清理本地索引与会话绑定，杜绝幽灵会话，防止后续请求复用已删除的对话导致串号或报错。详见 internal/web/auto_cleanup.go。

API 端点参考

对外兼容端点（/v1/*）

管理 API（/api/*，需管理员登录态）

测试

仓库自带完整单元测试（会话解析、自动清理、工具路由、协议兼容、用量统计等），运行：

go test ./...

例如会验证：默认自动清理闲置窗口为 2 小时（internal/web/auto_cleanup_test.go）、内容键前缀命中只发送增量（session_resolver_test.go）、Responses / Anthropic 协议事件序列等。

目录结构

M365-Copilot2API/
├── cmd/server/            # 入口，HTTP 服务启动
├── internal/
│   ├── web/               # HTTP 路由、会话解析器、自动清理、管理 API、用量统计
│   │   ├── session_resolver.go   # 内容键会话复用（四重指纹）
│   │   ├── auto_cleanup.go        # 云端对话自动清理
│   │   ├── usage.go               # usage.jsonl 用量统计
│   │   └── ...                    # 工具调用、协议转换、代理池、密钥管理等
│   ├── chathub/           # M365 Copilot ChatHub WebSocket 客户端
│   ├── auth/              # OAuth / PKCE
│   ├── mcp/               # MCP 工具网关（SSE / JSON-RPC）
│   └── outbound/          # HTTP 代理池
├── web/                   # 管理控制台（纯 HTML / JS 单页）
├── scripts/               # 运维脚本
│   ├── e2e_test.py        # 端到端测试
│   ├── chathub_probe.py   # ChatHub 协议探针
│   ├── genprobe.py        # 图像生成协议探针（原始帧 dump）
│   ├── multimodal_probe.py # 多模态图片输入探针（上传 + 注解流程）
│   ├── test-recorder.ps1  # Windows 测试录制
│   └── m365-upload-forensic-trace.user.js  # 上传取证脚本
├── docs/screenshots/      # 界面截图
├── manage.py              # start / stop / status / logs / err 进程管理
├── docker-compose.yml · Dockerfile
└── data/                  # 运行数据（由 M365_DATA_DIR 指定）

安全说明

• 默认仅监听内网：直接运行二进制默认 M365_LISTEN=127.0.0.1:4141；对外提供服务务必通过 TLS 终泄反向代理（Nginx / Caddy），并为 SSE 与 WebSocket 开启长连接与 proxy_buffering off。
• 首次登录强制改密：使用默认密码或引导密码完成首次登录后必须修改管理员密码。
• 密钥最小暴露：API Key 控制台创建后即可回读，请妥善保护控制台访问权限。
• 数据落盘权限：账号凭据、Token 缓存、会话绑定、API Key 等数据文件以 0600 权限写入，数据目录建议 0700。请定期备份数据目录。

常见问题

Q1：为什么云端对话越来越多？

后台每 30 分钟自动清理一次：回收闲置超过 2 小时（M365_AUTO_CLEANUP_MAX_AGE_HOURS，默认 2）或超出数量上限（M365_AUTO_CLEANUP_KEEP_N，默认 100）的云端对话；被活跃会话引用、白名单中的对话永不回收。调低这两个值可以清理得更激进；彻底关闭用 M365_AUTO_CLEANUP=0（不推荐，云端对话会无限膨胀，可能触发风控）。

Q2：如何切换 M365 账号？

不需要切换。多账号场景下网关自动轮询所有可用账号，单账号故障自动转移到下一个。要增加账号，直接在控制台发起新的 PKCE 授权即可。

Q3：Claude Code 提示「认证可能不工作」怎么办？

通常是系统环境变量残留了 ANTHROPIC_API_KEY，或同时配置了 ANTHROPIC_AUTH_TOKEN 导致两种认证方式冲突。只保留 ~/.claude/settings.json 中的 ANTHROPIC_API_KEY（settings 会覆盖系统级变量），并删除系统级残留或 AUTH_TOKEN。

Q4：X-M365-Session-Id 是什么？

网关默认按内容（上下文前缀 / 相似度）自动复用会话；当你希望在客户端侧显式控制会话与云端对话的对应关系时，携带 X-M365-Session-Id 请求头，网关直接绑定到该 ID（本地内容指纹不再参与优先级判定）。

Q5：对话出现串号 / 上下文错乱？

会话绑定在到期后会自动清除。若本地缓存与云端不同步，可在控制台「对话」页手动删除该云端对话，网关会连同本地绑定一起清理重建。

贡献指南

PRs Welcome！提交前请留意：

1. Fork 仓库并创建独立分支，一个 PR 聚焦一个问题。
2. 切勿提交任何凭据、cookie、账号缓存、日志或构建产物。
3. 改动 Go 文件前先 gofmt -w，提交前跑完 go test ./...、go vet ./... 与 go build ./...。
4. 描述行为变化，涉及新逻辑时附上对应测试。

详见 CONTRIBUTING.md。

许可证

MIT License。