直接回答:截至 2026 年 11 月 18 日,使用 MAI Code 2,可先核对 GitHub Copilot 计划和模型入口;Free、Student 用户不能据此认定可手动选择。 微软在发布稿中表示,MAI Code 2 和 MAI Code 2 Flash 两款模型都已在 GitHub Copilot 中提供。如果要接入自建应用,目前能确认的只有 MAI Code 2 Flash 在 Microsoft Foundry 以限量预览(limited-access preview)形式开放,这并不意味着所有渠道已经全面开放。
OpenRouter、Vercel、Hermes、OpenCode、Kilo 等渠道在发布稿中标注为“即将上线(soon)”,目前不能视为已经可用。即便模型已在某个渠道上线,你的账号能否真正看到它,还取决于具体产品入口、配额和管理员策略。
读完本文,你能了解到:
- MAI Code 2 与 MAI Code 2 Flash 的官方定位差异,以及各自适合哪类编程任务;
- 各渠道“已提供 / 限量预览 / 即将上线”的状态对照,避免把“即将上线”误读为“已可用”;
- 模型卡披露的输入输出规格,以及它为什么不等于你在产品里拿到的实际限额;
- 个人试用、企业管理员、开发者申请 Foundry 预览这三条路径分别该做什么;
- 一份开始前的核查清单,以及“找不到模型”时的常见原因。
本文索引: 第一部分是客观事实,依次说明发布信息(1.1)、渠道可用状态(1.2)、模型卡规格(1.3)以及 Foundry 接入条件(1.4),所有内容都以微软公开资料为依据。第二部分是编辑分析,先解释模型卡能力与产品限额的区别(2.1),再分别给出三条接入路径(2.2–2.4),随后提供核查清单与排障表(2.5–2.6),最后讨论第三方平台的核对方法和后续值得关注的点(2.7–2.8)。如果你只关心“现在能不能用”,可以直接阅读 1.2 和 2.5。

To Know:MAI Code 2 相关概念速查
下面这些概念会在后文反复出现,先用一张表统一说明。
| 概念 | 简要解释 |
|---|---|
| MAI Code 2 | 微软 MAI 团队发布的编程模型,官方定位是多文件任务、深度调试和仓库级推理 |
| MAI Code 2 Flash | 同系列的轻量版本,官方定位是代码解释、定点修改、常规修复和高频迭代 |
| GitHub Copilot 模型选择器 | Copilot 中切换底层模型的入口,是否出现某个模型由产品发布进度和账号策略共同决定 |
| Microsoft Foundry | 微软面向开发者的 AI 模型与应用构建平台,原 Azure AI Foundry |
| Limited-access preview | 限量准入预览,需要满足准入条件或通过申请才能使用,并不是对所有用户开放 |
| 模型卡(Model Card) | 厂商发布的模型说明文档,披露输入输出模态、上下文长度等模型层面的能力 |
| 上下文窗口 | 模型单次处理的 token 总上限,由输入和输出两部分共同组成 |
| Responses API | OpenAI 定义的一种接口形式,Foundry 中的 Flash 采用与之兼容的调用方式 |
| 管理员策略 | 企业或组织层面对可用模型、功能所做的启用或限制设置 |
影响速览:MAI Code 2 对不同人群意味着什么
| 人群 | 实际影响 | 建议动作 |
|---|---|---|
| 个人 Copilot 用户 | 付费计划与 Free/Student 的模型权限、选择方式不同 | 检查模型列表,从小任务开始对比 |
| 企业 / 组织管理员 | 成员能否使用取决于组织策略,可能需要管理员评估后启用 | 先评估合规与成本,再决定是否开放 |
| 自建应用的开发者 | 只有 Flash 在 Foundry 限量预览,需要 Azure 身份验证和准入 | 申请预览前确认订阅、配额和区域 |
| 依赖第三方工具链的团队 | OpenRouter、Vercel 等渠道仍是“即将上线” | 不要提前改写生产配置,等官方渠道确认 |
| 使用聚合平台的团队 | 参考资料没有提及任何聚合平台已接入 | 以平台实际模型列表为准,例如在 API易 apiyi.com 后台核对,不要假设已上架 |
一、客观事实:MAI Code 2 发布信息与可用渠道
本部分只陈述微软公开资料中的内容。性能评测数据属于厂商自评,本团队没有运行过这两款模型,因此不转述具体跑分,也不提供实测结论。
1.1 MAI Code 2 发布时间与两款模型定位
2026 年 11 月 17 日,微软 AI 在官网发布了 MAI Code 2 和 MAI Code 2 Flash。两款模型面向不同强度的编程任务:MAI Code 2 处理复杂的跨文件工作,Flash 处理频繁、轻量的日常修改。
按照官方描述,MAI Code 2 的重点是多文件修改、深度调试和仓库级推理,适合需要理解整个代码库结构的任务。MAI Code 2 Flash 的重点是代码解释、定点修改、常规修复和高频迭代,更适合对响应速度要求高的交互场景。发布稿中附带的评测结果来自厂商,读者应把它当作参考信息,而不是独立第三方的验证。
1.2 MAI Code 2 渠道可用状态对照
下表依据 Microsoft AI 发布稿和 GitHub 官方上线公告。第三方渠道的 soon 是发布计划,不保证两款同时上线,也不代表已获得调用权限。
| 渠道 | MAI Code 2 | MAI Code 2 Flash | 状态说明 |
|---|---|---|---|
| GitHub Copilot | 已提供 | 已提供 | 发布稿称两款均已在 Copilot 中提供 |
| Microsoft Foundry | 参考资料未确认 | 限量预览 | Flash 为 limited-access preview,需满足准入条件 |
| OpenRouter | 即将上线 | 即将上线 | 发布稿标注为 soon,不应视为已全量 |
| Vercel | 即将上线 | 即将上线 | 同上 |
| Hermes / OpenCode / Kilo | 即将上线 | 即将上线 | 同上 |
| 其他 API 聚合平台 | 未提及 | 未提及 | 需以各平台实际模型列表为准 |
1.2.1 GitHub Copilot 计划与入口
GitHub 官方公告列明:MAI Code 2 覆盖 Pro、Pro+、Max、Business、Enterprise;Flash 还覆盖 Free 和 Student,符合条件的年付订阅同样适用。入口包括 VS Code、Visual Studio、Copilot CLI、Copilot app、github.com 等。
但GitHub 支持模型文档明确:Free 和 Student 仅通过 Auto 自动选择访问模型,不等于可在选择器中手动指定 Flash。 Business/Enterprise 的管理员可通过模型策略控制访问;默认自动启用也可能被组织关闭。
1.2.2 发布状态不等于账户权限
需要特别注意两点。第一,“已在 GitHub Copilot 提供”是产品层面的表述,不代表每一位用户、每一个计划都能立即看到。第二,Foundry 中目前只确认了 Flash,参考资料没有确认 MAI Code 2 本体在 Foundry 的开放状态。

1.3 MAI Code 2 模型卡披露的输入输出规格
微软发布了两款模型共用的模型卡(PDF)。其中与接入直接相关的规格如下。
| 项目 | 模型卡披露 | 说明 |
|---|---|---|
| 输入模态 | 文字、图片 | 可以把截图、示意图等作为上下文输入 |
| 输出模态 | 文字 | 不生成图片 |
| 模型上下文窗口 | 约 1.05M tokens | 模型层面的总上限 |
| 最大输入 | 约 922k tokens | 单次请求可携带的输入上限 |
| 最大输出 | 约 128k tokens | 单次生成的输出上限 |
本文不引用模型参数量。更重要的是,上表描述的是模型本身的能力,具体产品(例如 Copilot 中的某个客户端,或 Foundry 中的某个预览部署)实际提供的上下文和输出限制可能更小。
1.4 Foundry 中 MAI Code 2 Flash 的接入条件
根据官方模型卡第 2.4 节,MAI Code 2 Flash 在 Foundry 中通过 与 OpenAI 兼容的 Responses API 调用。“兼容”指的是请求格式相近,但鉴权和准入体系仍然属于 Azure。
具体来说,调用前需要完成 Azure 身份验证,并受到订阅配额、内容过滤策略和预览准入条件的约束。不能把 OpenAI 的 API Key 直接拿来使用。端点、部署名称及凭据应从你的 Foundry 部署获取,不能把模型展示名、他人的示例地址或 OpenAI 密钥当作 Azure 部署配置。
二、分析判断:MAI Code 2 接入边界与三条路径
以下内容是编辑团队基于上述事实做出的分析和建议,不是亲测教程。步骤只描述应当核查的环节,不涉及具体界面截图或按钮名称,因为这些会随产品更新而变化。
2.1 MAI Code 2 模型卡能力 ≠ 产品实际限额
很多人看到“1.05M 上下文”,就会默认在 Copilot 里也能一次塞进整个大型仓库,这是最常见的误读。模型卡说明的是模型能处理多少内容,产品则会根据成本、延迟和体验另行设定上限。
两者的差别会直接影响使用策略。如果你计划依赖超长上下文做仓库级分析,应先在具体产品中确认实际可用长度,不要直接拿模型卡数字做容量规划。对 Foundry 预览来说,配额同样可能低于模型上限,生产环境的吞吐评估要以分配到的配额为准。
| 维度 | 模型卡(模型能力) | 具体产品(实际限额) |
|---|---|---|
| 上下文长度 | 约 1.05M tokens | 可能更短,由产品设定 |
| 单次输出 | 约 128k tokens | 可能受客户端或配额限制 |
| 可用对象 | 不涉及 | 受计划、区域、管理员策略影响 |
| 调用频率 | 不涉及 | 受配额与限流影响 |
| 信息来源 | 模型卡 PDF | 产品文档与账号后台 |
2.2 路径一:个人开发者在 GitHub Copilot 中试用 MAI Code 2
对已有合适 Copilot 计划的个人用户来说,这是无需部署 API 的尝试路径。思路很简单:先确认能不能看到,再用自己熟悉的任务做对比。
- 更新客户端:确保 IDE 插件或 Copilot 客户端为较新版本,旧版本可能还没有新的模型条目。
- 检查计划与入口:有手动选择权限的计划在模型选择器中核对;Free/Student 使用 Auto,不应把没有手动条目当成故障。
- 按定位分配任务:跨文件重构、疑难 bug 定位交给 MAI Code 2;解释代码、小范围修复交给 Flash。
- 保留对照组:同一任务用你原来常用的模型再跑一次,自己判断差异,不要直接照搬厂商评测结论。
如果暂时看不到,先检查计划是否允许手动选择,再检查客户端版本及组织策略,可以对照 2.6 的排障表逐项排查。
2.3 路径二:企业管理员如何评估 MAI Code 2 的开放
对使用组织账号的成员来说,“Copilot 已提供”和“我能用”之间隔着一层管理员策略。管理员需要回答的不是“能不能开”,而是“该不该开、给谁开”。
建议管理员重点核查三件事:组织策略中是否需要单独启用新模型;新模型的数据处理和合规条款是否与现有模型一致;对计费方式和用量是否有影响。比较稳妥的做法是先对一个小组开放试点,收集反馈后再决定是否扩大范围。在策略层面,也应明确告知成员哪些代码仓库允许使用新模型。
2.4 路径三:开发者申请 Foundry 中的 MAI Code 2 Flash 预览
如果你要把模型接入自己的应用或内部工具,本文核实到的托管 API 路径是 Foundry 中的 Flash 限量预览。先确认准入条件,再安排接入测试。

需要提前确认的几个关键点:
- 身份体系:用的是 Azure 身份验证,不是 OpenAI 账号体系;
- 准入资格:限量预览意味着可能需要申请并等待审批;
- 配额与区域:核对你所选区域的可部署性和实际分配配额,本文未验证全区域覆盖;
- 调用方式:采用与 Responses API 兼容的形式,原本基于 Chat Completions 的代码可能需要调整;
- 生产风险:预览阶段的条款、能力和限额都可能变化,不建议直接承载核心生产流量。
2.5 MAI Code 2 开始前核查清单
无论走哪条路径,建议先对照下面的清单逐项确认,可以省去大量“为什么看不到”的排查时间。
- 我要用的是 MAI Code 2 还是 Flash?这个渠道是否确实提供该版本?(参见 1.2)
- 该渠道目前的状态是“已提供”、“限量预览”还是“即将上线”?
- 我的账号或计划是否在覆盖范围内?组织策略是否允许?
- 我需要的上下文长度,在这个具体产品中是否真的可用?
- Foundry 路径下,Azure 订阅、准入、区域和配额是否都已就绪?
- 如果打算通过第三方或聚合平台调用,是否已在平台的模型列表中核实过(例如 API易 apiyi.com 的模型列表),而不是根据新闻推测?
2.6 MAI Code 2 常见不可用原因与对策
| 现象 | 可能原因 | 对策 |
|---|---|---|
| Copilot 模型选择器里没有 | Free/Student 仅支持 Auto;也可能是客户端或组织策略限制 | 先核对计划,再检查客户端与管理员策略 |
| 组织账号看不到,个人账号能看到 | 管理员策略尚未启用 | 联系组织管理员评估开放 |
| Foundry 中找不到 Flash | 未获得预览准入或所在区域不支持 | 提交准入申请,确认支持区域 |
| Foundry 调用鉴权失败 | 使用了 OpenAI Key 或身份配置有误 | 改用 Azure 身份验证方式 |
| 请求被拒绝或被截断 | 配额不足、触发内容过滤或超出产品限额 | 检查配额与过滤日志,缩短输入 |
| 在 OpenRouter 等平台搜不到 | 发布稿中标注为“即将上线” | 以平台官方上线公告为准 |
| 在找 MAI Code 2 的 Foundry 部署 | 参考资料仅确认 Flash 在 Foundry 预览 | 关注官方后续公告 |
2.7 第三方与聚合平台:如何核对 MAI Code 2 是否真的可用
新模型发布后,社交媒体上经常出现“某某平台已经可以调用”的说法。对 MAI Code 2 来说,发布稿明确列出的第三方渠道都还处在“即将上线”阶段,其他平台的说法都需要逐一核实。
平台模型列表只能作为核查起点,不能单凭名称证明模型身份、账户权限或实际可调用性。应同时核对该平台官方公告、精确模型 ID、兼容接口、价格、数据处理条款,并用不含敏感数据的小请求验证。
本文没有核实 API易 apiyi.com 已接入 MAI Code 2 或 Flash,也没有验证其模型查询接口,因此不提供暗示已支持的调用代码。 如选择第三方服务,应只使用该服务签发的专用密钥,不要将 OpenAI 或 Azure 凭据发往第三方地址。
2.8 MAI Code 2 后续值得关注的信号
以下属于预测性质的观察点,并非既定事实。第一,MAI Code 2 本体何时进入 Foundry,以及 Flash 何时从限量预览转为更广泛开放,会直接影响自建应用的可行性。第二,OpenRouter、Vercel 等标注为“即将上线”的渠道,实际上线时提供的上下文和限额是否接近模型卡数值,值得逐一确认。
第三,厂商评测之外,社区和独立评测对两款模型在真实仓库中的表现会给出更多参考,在此之前不宜仅凭发布稿做出替换决策。对需要多模型并行验证的团队,可以持续关注 API易 apiyi.com 等平台的模型列表变化,在新模型确实可用之后再纳入评估。
总的来说,MAI Code 2 目前最确定的入口是 GitHub Copilot,本文确认的托管 API 路径是 Foundry 中的 Flash 限量预览,其余渠道都应等待正式确认。模型卡上的能力指标看起来很亮眼,但能否真正发挥出来,取决于你所在的渠道和账号条件。
纸上得来终觉浅,绝知此事要躬行。——陆游《冬夜读书示子聿》
📚 参考资料
-
Microsoft AI:Introducing MAI Code 2 and MAI Code 2 Flash:官方发布稿
- 链接:官方资料
- 说明: 两款模型的定位、GitHub Copilot 可用状态,以及“即将上线”渠道列表
-
GitHub 官方公告:MAI Code 2 and MAI Code 2 Flash in GitHub Copilot
- 链接:上线公告
- 说明:计划覆盖、客户端入口与管理员策略
-
MAI Code 2 与 MAI Code 2 Flash 模型卡:官方模型卡 PDF
- 链接:官方资料
- 说明: 输入输出规格,以及第 2.4 节 Foundry Responses API、Azure 鉴权和配额要求
-
GitHub 支持模型文档
- 链接:支持模型与计划限制
- 说明:Free/Student 仅支持 Auto,具体客户端与模型限额以产品文档为准
作者: API易 技术团队
技术交流: 欢迎在 API易 apiyi.com 网站首页联系我们,更多接入资料可访问 docs.apiyi.com 文档中心。
