直接回答:微軟把 MAI Code 2 系列分成了“複雜任務檔”和“高頻簡單任務檔”。 2026 年 11 月 17 日,微軟發佈 MAI Code 2 和 MAI Code 2 Flash。MAI Code 2 面向多文件修改、深度調試和倉庫級推理;MAI Code 2 Flash 面向代碼解釋、定點修改、常規修復和高頻迭代。對多數開發者和小團隊,我們的建議是默認先用 Flash 處理日常小任務,遇到跨文件依賴或難以定位的 Bug 時再換用 Code 2。
您讀完此文能瞭解到什麼?
- 兩檔模型的官方定位,以及它們各自對應哪類編程任務。
- 模型卡公開的輸入輸出模態和上下文規格,以及這些數字該怎麼看。
- 目前能在哪些入口使用,哪些渠道只是“即將上線”,Copilot 促銷價何時結束。
- 一套從 Flash 起步、按信號升級到 Code 2 的實用判斷方法。
索引: 先看 To Know 概念表和影響速覽,快速瞭解與自己相關的部分。第一部分「客觀事實」按發佈信息、兩檔定位、模型卡規格、可用入口、評測性質與促銷費率依次整理,只寫有來源的內容。第二部分「分析判斷」是編輯觀點,討論分檔的意義、選型建議、長上下文的實際邊界,以及 API 接入前應覈對的事項。

MAI Code 2 與 Flash 需要先知道的概念(To Know)
| 概念 | 簡要解釋 |
|---|---|
| 倉庫級推理 | 模型需要理解整個代碼倉庫的結構和跨文件依賴,而不只看當前文件或片段 |
| 定點修改 | 在已知位置做小範圍改動,例如改一個函數、修一處報錯 |
| 上下文窗口 | 模型單次能處理的最大 token 總量,包括輸入和輸出 |
| 模型卡(Model Card) | 廠商發佈的模型說明文檔,記錄能力範圍、規格、評測和限制 |
| Microsoft Foundry | 微軟面向企業的 AI 模型與應用構建平臺,原 Azure AI Foundry 體系 |
| limited-access preview | 受限訪問預覽,需要申請或滿足條件才能使用,不是全面開放 |
| 廠商評測 | 模型發佈方自己公佈的測試結果,不等於第三方或用戶的獨立實測 |
MAI Code 2 和 Flash 發佈影響速覽
| 人羣 | 主要影響 |
|---|---|
| GitHub Copilot 用戶 | 兩款模型已在 Copilot 提供,但支持套餐不同;需覈對套餐、組織策略和當前額度 |
| 個人開發者、小團隊 | 多了一個按任務難度分檔選模型的選項,日常小改動不必都交給重型模型 |
| Azure / Foundry 企業用戶 | Flash 處於受限訪問預覽,需要按申請流程獲取;正式開放時間以官方爲準 |
| 通過第三方平臺調用的開發者 | OpenRouter、Vercel 等渠道在發佈稿中標爲“即將上線”,目前不能假設已可調用 |
一、客觀事實:MAI Code 2 和 Flash 發佈了什麼
1.1 MAI Code 2 發佈時間與信息來源
微軟於 2026 年 11 月 17 日通過 microsoft.ai 官方新聞頁發佈 MAI Code 2 和 MAI Code 2 Flash。同期,微軟在 Azure AI Foundry 技術社區博客中說明了 Foundry 側的提供方式,並公開了兩款模型共用的一份模型卡 PDF。本文同時覈對 GitHub 官方更新日誌和計費文檔,截止時間爲 2026 年 11 月 18 日。
1.2 MAI Code 2 與 Flash 的兩檔定位
官方對兩款模型的分工描述很明確:一款負責複雜、需要全局理解的任務,另一款負責頻繁、範圍小的任務。
| 維度 | MAI Code 2 | MAI Code 2 Flash |
|---|---|---|
| 官方定位 | 複雜編程任務 | 高頻、常規編程任務 |
| 典型任務 | 多文件修改、深度調試、倉庫級推理 | 代碼解釋、定點修改、常規修復、高頻迭代 |
| 任務範圍 | 跨文件、跨模塊 | 單點、局部 |
| GitHub Copilot | 已提供 | 已提供 |
| Foundry | 參考資料未說明 | 受限訪問預覽 |

1.3 MAI Code 2 模型卡公開規格
模型卡給出了模態和上下文相關數字。需要注意的是,模型卡也說明了產品中的實際限制可能與這些數字不同。
| 項目 | 模型卡數據 |
|---|---|
| 輸入模態 | 文字、圖片 |
| 輸出模態 | 文字 |
| 模型上下文 | 1.05M tokens |
| 最大輸入 | 922k tokens |
| 最大輸出 | 128k tokens |
關於總參數量,現有資料存在版本不一致的情況,本文不引用具體數字,後續以官方更新爲準。
1.4 MAI Code 2 與 Flash 的可用入口
GitHub 官方更新日誌列明:Code 2 面向 Copilot Pro、Pro+、Max、Business、Enterprise;Flash 還覆蓋 Free 與 Student。符合條件的年度訂閱也可使用。企業或組織管理員可通過模型策略控制訪問,不能把“已上線”理解爲每個賬號都無條件可用。Foundry 側,發佈稿只確認 Code 2 Flash 爲 limited-access preview(受限訪問預覽),並未宣告 Code 2 在 Foundry 全面開放。
發佈稿還提到 OpenRouter、Vercel、Hermes、OpenCode、Kilo 等渠道,但狀態是“即將上線”(soon)。也就是說,截至本文寫作時,不能把這些渠道當作已經全面可用。

1.5 MAI Code 2 評測數據的性質
本文沒有獨立實測。微軟彙總的比較混合了內部評測和外部數據:DeepSWE 1.1、TerminalBench 2.1、SWE Atlas 在微軟 MSBench 上通過 Copilot CLI 運行且未用子代理;FrontierCode 1.1 的分數與成本來自 Artificial Analysis。相關模型均設爲 max 推理強度,MAI 成本使用 50% 促銷價。不能把這些特定任務、配置和價格條件下的結果當作所有代碼庫的通用結論。微軟還明確表示,這兩款模型尚未針對基礎科學研究和極長流程的代理任務調優。
1.6 Copilot 促銷價:要同時看費率和生效日期
GitHub 計費文檔列出的當前促銷價如下,單位爲美元/百萬 token;這些是 Copilot 的計費口徑,不能直接當作 Foundry 或第三方 API 報價。
| 模型 | 輸入 | 緩存輸入 | 輸出 | 2027 年 5 月 17 日起的輸入/緩存輸入/輸出 |
|---|---|---|---|---|
| MAI Code 2 | $0.50 | $0.025 | $2.50 | $1.00/$0.05/$5.00 |
| MAI Code 2 Flash | $0.05 | $0.005 | $0.25 | $0.10/$0.01/$0.50 |
官方腳註寫明促銷截至 2027 年 5 月 17 日,並從該日開始採用右列價格,後續以實時文檔爲準。日常計量會折算成 GitHub AI Credits;套餐內額度、額外用量預算及年度訂閱的舊計費安排需分別覈對。這不是不限量免費使用,也不能把促銷期的成本比例寫成永久折扣。GitHub 官方計費文檔
二、分析判斷:MAI Code 2 和 Flash 雙檔對開發者意味着什麼
以下爲編輯分析,基於第一部分事實推導,不代表微軟官方表態。涉及未來走勢的內容均爲預測。
2.1 爲什麼 MAI Code 2 要分成兩檔
編程場景裏,大部分請求其實很“小”:解釋一段代碼、改一個參數、修一個明顯的報錯。這類任務對模型的全局理解要求不高,更在意響應快、能頻繁調用。相反,跨模塊重構、追查深層 Bug 這類任務數量不多,但單次難度大,需要模型理解倉庫整體結構。
把兩類需求拆給兩款模型,是讓用戶“按任務難度付出代價”。GitHub 官方將 Flash 定位爲輕量、成本友好的日常開發模型;當前計費文檔也列出了兩款模型不同的 token 單價(見 1.6)。但單價差不等於任務成本差,響應速度、token 消耗與返工次數仍應在自己的任務中驗證。
2.2 編輯建議:從 Flash 起步,按信號升級到 MAI Code 2
對開發者和小團隊,我們建議把 Flash 作爲默認檔,只在出現明確信號時再換用 Code 2。這是待驗證的路由策略,不保證 Flash 更快或 Code 2 必然修復問題;應同時記錄任務通過率、人工複覈時間和實際費用。
以下閾值只是編輯建議,屬於便於試行的起點,不是官方限制或已驗證的最優規則:
- 改動涉及至少 3 個文件,或需要同步修改接口定義與調用方。
- Flash 連續兩次給出的修復都沒有解決問題,說明問題可能不在局部。
- Bug 的根因在別的模塊,例如配置、依賴版本或數據流上游。
- 需要理解項目整體架構,如梳理模塊關係、規劃重構方案。
- 你自己也說不清問題在哪,需要模型先做全局排查。
反過來,代碼解釋、寫單元測試樣例、改命名、補註釋、修復編譯報錯這類任務,可以優先試用 Flash,再以測試和人工複覈結果決定是否保留。

2.3 1.05M 上下文不等於工具裏能用滿
模型卡寫明上下文爲 1.05M、最大輸入 922k、最大輸出 128k,但同時說明產品實際限制可能不同。我們的判斷是:在 GitHub Copilot 等產品中,實際可用的上下文長度、單次輸出上限可能會受到產品策略影響。
所以不要指望“把整個倉庫塞進去”就能解決問題。更穩妥的做法仍是先讓模型看相關目錄和關鍵文件,再逐步擴大範圍。這也是 Code 2 主打“倉庫級推理”的價值所在:它要能在大量代碼中找到關鍵關係,而不只是能裝下更多文本。
2.4 想通過 API 調用 MAI Code 2:先覈對,再試用
目前 MAI Code 2 系列的確認入口是 GitHub Copilot 和 Foundry(Flash 受限預覽),第三方聚合渠道尚未全面上線。如果你計劃通過 API 集成,第一步不是寫業務代碼,而是確認目標平臺是否真的提供這兩款模型,以及模型 ID 是什麼。
以下代碼僅展示接入思路,本文未運行,亦未覈實 API易已提供這兩款模型。名稱含有“mai”只表示候選項,不能替代官方模型名稱、接口能力和權限覈對。示例先列出模型,再篩選可能相關的條目:
import openai
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1" # API易 OpenAI 兼容接口,模型可用性以實時列表爲準
)
# 列出當前可用模型,篩選可能與 MAI Code 2 相關的條目
models = client.models.list()
mai_models = [m.id for m in models.data if "mai" in m.id.lower()]
print(mai_models or "當前列表中未找到 MAI 相關模型")
如果列表中確實出現了對應模型,可以按 2.2 節的思路寫一個簡單的分檔路由。模型 ID 請以平臺列表爲準,下面用佔位符表示:
查看按任務難度分檔調用的示例代碼
import openai
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1" # 使用 API易 統一接口
)
# 佔位符:請替換爲模型列表中確認存在的真實 ID
FLASH_MODEL = "YOUR_FLASH_MODEL_ID"
CODE2_MODEL = "YOUR_CODE2_MODEL_ID"
def pick_model(files_touched: int, failed_attempts: int, cross_module: bool) -> str:
"""按 2.2 節的信號選擇模型:默認 Flash,滿足任一條件升級到 Code 2"""
if files_touched >= 3 or failed_attempts >= 2 or cross_module:
return CODE2_MODEL
return FLASH_MODEL
def ask(prompt: str, files_touched=1, failed_attempts=0, cross_module=False) -> str:
model = pick_model(files_touched, failed_attempts, cross_module)
resp = client.chat.completions.create(
model=model,
messages=[
{"role": "system", "content": "你是資深工程師,先說明改動範圍,再給出代碼。"},
{"role": "user", "content": prompt},
],
)
return f"[{model}]\n" + resp.choices[0].message.content
print(ask("解釋這個函數的作用:def add(a, b): return a + b"))
🎯 接入建議:MAI Code 2 系列的第三方渠道仍在陸續上線,建議先在 API易 apiyi.com 的模型列表或文檔中核對實際支持情況和模型 ID,再決定是否接入。若暫未提供,可以先用同一套 OpenAI 兼容代碼在平臺已支持的編程模型上搭好分檔路由,後續還需覈對接口參數、工具調用支持、費用和迴歸測試,不能保證只改模型 ID 就兼容。
2.5 MAI Code 2 後續值得關注的變化
以下爲預測性判斷,需要後續事實驗證:
- 第三方渠道上線節奏:OpenRouter、Vercel 等標註“即將上線”的渠道何時開放,會直接影響非 Copilot 用戶的使用門檻。
- Foundry 訪問範圍:Flash 是否從受限預覽轉爲公開可用,Code 2 是否進入 Foundry。
- 獨立實測結果:社區和第三方在真實倉庫上的表現,比廠商評測更能說明兩檔的實際差距。
- 產品內實際限額:Copilot 等產品中上下文和輸出的真實上限,決定了“倉庫級推理”能發揮到什麼程度。
想在同一套代碼裏橫向比較不同編程模型,聚合平臺會更方便。API易 apiyi.com 提供 OpenAI 兼容的統一接口,一個 Key 即可切換 OpenAI、Claude、Gemini 等模型,適合在新模型上線前先把對比流程準備好。
兩檔模型的出現,說到底是在承認一個樸素的道理:沒有一款模型適合所有編程任務,按任務輕重分配工具,纔是更經濟的用法。正如《楚辭·卜居》所言:
“夫尺有所短,寸有所長。”
📚 參考資料
- GitHub 官方上線說明:套餐與管理員策略。
-
GitHub 官方價格及促銷腳註:費率、促銷結束日期與計費規則。
-
微軟官方發佈:Introducing MAI Code 2 and MAI Code 2 Flash:發佈公告與定位說明
- 鏈接:
microsoft.ai/news/introducing-mai-code-2-and-mai-code-2-flash/ - 說明: 兩款模型的任務定位、GitHub Copilot 提供情況及第三方渠道“即將上線”信息
- 鏈接:
-
Azure AI Foundry 技術社區博客:From model choice to your durable advantage
- 鏈接:
techcommunity.microsoft.com/blog/azure-ai-foundry-blog/from-model-choice-to-your-durable-advantage-build-ai-that-keeps-improving/4573609 - 說明: Foundry 側提供方式,MAI Code 2 Flash 受限訪問預覽說明
- 鏈接:
-
MAI Code 2 與 MAI Code 2 Flash 模型卡(PDF):模型規格與評測說明
- 鏈接:
microsoft.ai/pdf/MAI-Code-2-And-MAI-Code-2-Flash-Model-Card.pdf - 說明: 輸入輸出模態、上下文長度、最大輸入與輸出,以及產品限制可能不同的說明
- 鏈接:
作者:APIYI 技術團隊
技術交流:如需瞭解模型接入與支持情況,歡迎通過 API易 apiyi.com 首頁聯繫我們,更多接入文檔可訪問 docs.apiyi.com 文檔中心
