Resposta direta: a Microsoft dividiu a linha MAI Code 2 em uma “versão para tarefas complexas” e uma “versão para tarefas simples de alta frequência”. Em 17 de novembro de 2026, a Microsoft lançou o MAI Code 2 e o MAI Code 2 Flash. O MAI Code 2 é voltado para modificações em múltiplos arquivos, depuração profunda e raciocínio em nível de repositório; o MAI Code 2 Flash é voltado para explicação de código, alterações pontuais, correções de rotina e iterações de alta frequência. Para a maioria dos desenvolvedores e equipes pequenas, nossa recomendação é usar o Flash por padrão para tarefas cotidianas pequenas e trocar para o Code 2 quando houver dependências entre arquivos ou bugs difíceis de localizar.
O que você vai encontrar neste artigo?
- O posicionamento oficial das duas versões e o tipo de tarefa de programação que cada uma atende.
- As modalidades de entrada e saída e as especificações de janela de contexto divulgadas no model card, e como interpretar esses números.
- Onde já é possível usar, quais canais estão apenas “em breve” e quando termina o preço promocional do Copilot.
- Um método prático de decisão para começar pelo Flash e fazer upgrade para o Code 2 conforme os sinais.
Índice: comece pela tabela de conceitos To Know e pela visão rápida dos impactos para entender rapidamente o que é relevante para você. A primeira parte, “Fatos objetivos”, organiza, nesta ordem, informações de lançamento, posicionamento das duas versões, especificações do model card, canais de acesso disponíveis, natureza das avaliações e tarifas promocionais; inclui apenas conteúdo com fontes. A segunda parte, “Análise e opinião”, traz a visão editorial e discute o significado da segmentação, recomendações de escolha, os limites reais da janela de contexto longa e os itens que devem ser verificados antes de integrar a API.

Conceitos que você precisa saber sobre MAI Code 2 e Flash (To Know)
| Conceito | Explicação breve |
|---|---|
| Raciocínio em nível de repositório | O modelo precisa entender a estrutura de todo o repositório de código e as dependências entre arquivos, não apenas o arquivo ou o trecho atual |
| Alteração localizada | Fazer pequenas mudanças em locais já conhecidos, como alterar uma função ou corrigir um erro |
| Janela de contexto | Quantidade máxima de tokens que o modelo consegue processar de uma vez, incluindo entrada e saída |
| Model Card (ficha do modelo) | Documento descritivo publicado pelo fornecedor, que registra escopo de capacidade, especificações, avaliações e limitações |
| Microsoft Foundry | Plataforma da Microsoft para empresas criarem modelos de IA e aplicações, originada do antigo ecossistema Azure AI Foundry |
| Prévia de acesso limitado (limited-access preview) | Prévia com acesso restrito: é necessário solicitar ou atender a critérios para usar; não é totalmente aberta |
| Avaliação do fornecedor | Resultados de testes divulgados pelo próprio fornecedor do modelo; não equivalem a testes independentes de terceiros nem a medições reais de usuários |
Resumo dos impactos do lançamento do MAI Code 2 e Flash
| Público | Principais impactos |
|---|---|
| Usuários do GitHub Copilot | Os dois modelos já estão disponíveis no Copilot, mas o suporte varia conforme o plano; é preciso verificar o plano, as políticas da organização e a cota atual |
| Desenvolvedores individuais e pequenas equipes | Agora há mais uma opção para escolher modelos conforme a dificuldade da tarefa; pequenas alterações do dia a dia não precisam ir todas para o modelo mais pesado |
| Usuários corporativos do Azure / Foundry | O Flash está em prévia de acesso limitado e exige seguir o processo de solicitação; a data de disponibilidade geral deve ser confirmada nos canais oficiais |
| Desenvolvedores que fazem chamadas por plataformas de terceiros | Canais como OpenRouter e Vercel foram marcados no comunicado como “em breve”; por enquanto, não dá para presumir que já estejam disponíveis para chamada |
1. Fatos objetivos: o que o MAI Code 2 e o Flash lançaram
1.1 Data de lançamento e fontes de informação do MAI Code 2
A Microsoft lançou o MAI Code 2 e o MAI Code 2 Flash em 17 de novembro de 2026, por meio da página oficial de notícias da microsoft.ai. No mesmo período, a Microsoft explicou no blog da comunidade técnica do Azure AI Foundry como os modelos são disponibilizados pelo lado do Foundry, e publicou um PDF de model card compartilhado pelos dois modelos. Este artigo também verificou o changelog oficial do GitHub e a documentação de cobrança, com data de corte em 18 de novembro de 2026.
1.2 As duas categorias de posicionamento do MAI Code 2 e do Flash
A descrição oficial da divisão de trabalho entre os dois modelos é bem clara: um fica responsável por tarefas complexas, que exigem compreensão global; o outro cuida de tarefas frequentes e de escopo pequeno.
| Dimensão | MAI Code 2 | MAI Code 2 Flash |
|---|---|---|
| Posicionamento oficial | Tarefas de programação complexas | Tarefas de programação de alta frequência e rotineiras |
| Tarefas típicas | Modificação de múltiplos arquivos, depuração profunda, raciocínio em nível de repositório | Explicação de código, modificações pontuais, correções rotineiras, iterações de alta frequência |
| Escopo da tarefa | Entre arquivos, entre módulos | Ponto único, local |
| GitHub Copilot | Já disponível | Já disponível |
| Foundry | Não especificado nos materiais de referência | Prévia com acesso restrito |

1.3 Especificações públicas do model card do MAI Code 2
O model card traz os números relacionados a modalidade e janela de contexto. Vale notar que ele também esclarece que os limites reais no produto podem ser diferentes desses números.
| Item | Dados do model card |
|---|---|
| Modalidade de entrada | Texto, imagem |
| Modalidade de saída | Texto |
| Contexto do modelo | 1.05M tokens |
| Entrada máxima | 922k tokens |
| Saída máxima | 128k tokens |
Quanto ao número total de parâmetros, os materiais existentes apresentam versões inconsistentes; este artigo não cita números específicos e deixa a definição para atualizações oficiais posteriores.
1.4 Pontos de acesso disponíveis para MAI Code 2 e Flash
O changelog oficial do GitHub especifica: Code 2 está disponível para Copilot Pro, Pro+, Max, Business e Enterprise; Flash também cobre Free e Student. Assinaturas anuais elegíveis também podem usar. Administradores corporativos ou de organização podem controlar o acesso por meio de políticas de modelo, e não se deve entender “já lançado” como disponível incondicionalmente para todas as contas. Do lado do Foundry, a nota de lançamento confirma apenas que Code 2 Flash é um limited-access preview (prévia de acesso limitado), e não anuncia que Code 2 esteja totalmente aberto no Foundry.
A nota de lançamento também menciona canais como OpenRouter, Vercel, Hermes, OpenCode e Kilo, mas o status é “em breve” (soon). Ou seja, até o momento da redação deste artigo, não se pode considerar esses canais como totalmente disponíveis.

1.5 Natureza dos dados de avaliação do MAI Code 2
Este artigo não traz testes independentes. As comparações compiladas pela Microsoft misturam avaliações internas e dados externos: DeepSWE 1.1, TerminalBench 2.1 e SWE Atlas foram executados no MSBench da Microsoft via Copilot CLI e sem uso de subagentes; as pontuações e custos do FrontierCode 1.1 vêm da Artificial Analysis. Os modelos relacionados foram configurados com intensidade máxima de raciocínio, e o custo do MAI usa o preço promocional de 50%. Não se pode tomar os resultados sob essas tarefas, configurações e condições de preço específicas como conclusão geral válida para todos os repositórios de código. A Microsoft também declarou explicitamente que esses dois modelos ainda não foram ajustados para pesquisa científica básica e tarefas agênticas de fluxos extremamente longos.
1.6 Preço promocional do Copilot: é preciso observar ao mesmo tempo a tarifa e a data de vigência
A documentação de cobrança do GitHub lista os preços promocionais atuais abaixo, em dólares por milhão de tokens; esses valores seguem o critério de cobrança do Copilot e não podem ser tomados diretamente como cotação do Foundry ou de APIs de terceiros.
| Modelo | Entrada | Entrada em cache | Saída | Entrada / entrada em cache / saída a partir de 17 de maio de 2027 |
|---|---|---|---|---|
| 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 |
A nota de rodapé oficial informa que a promoção vai até 17 de maio de 2027 e que, a partir dessa data, passam a valer os preços da coluna da direita, com a documentação atualizada em tempo real servindo de referência daí em diante. A medição do uso diário é convertida em GitHub AI Credits; a cota incluída no plano, o orçamento de uso adicional e o antigo esquema de cobrança das assinaturas anuais precisam ser verificados separadamente. Isso não é uso gratuito e ilimitado, e também não dá para tratar a proporção de custo do período promocional como um desconto permanente. Documentação oficial de cobrança do GitHub
2. Análise e julgamento: o que as duas faixas MAI Code 2 e Flash significam para os desenvolvedores
O texto a seguir é uma análise editorial, baseada nos fatos da primeira parte, e não representa a posição oficial da Microsoft. Todos os trechos sobre tendências futuras são previsões.
2.1 Por que o MAI Code 2 é dividido em dois níveis
No cenário de programação, a maioria das requisições é bastante “pequena”: explicar um trecho de código, alterar um parâmetro, corrigir um erro óbvio. Esse tipo de tarefa não exige tanta compreensão global do modelo; o mais importante é responder rápido e poder ser chamado com frequência. Por outro lado, tarefas como refatoração entre módulos e investigação de bugs profundos são menos numerosas, mas cada uma é mais difícil e exige que o modelo entenda a estrutura geral do repositório.
Dividir os dois tipos de necessidade entre dois modelos permite que o usuário “pague conforme a dificuldade da tarefa”. O GitHub posiciona oficialmente o Flash como um modelo leve e econômico para o desenvolvimento diário; a documentação atual de cobrança também lista preços por token diferentes para os dois modelos (ver 1.6). Mas a diferença de preço por token não equivale a uma diferença de custo por tarefa; velocidade de resposta, consumo de tokens e número de retrabalhos ainda devem ser validados nas próprias tarefas.
2.2 Recomendação editorial: comece pelo Flash e suba para o MAI Code 2 conforme os sinais
Para desenvolvedores e equipes pequenas, recomendamos usar o Flash como opção padrão e só trocar para o Code 2 quando houver sinais claros. Essa é uma estratégia de roteamento a ser validada, que não garante que o Flash seja mais rápido nem que o Code 2 necessariamente corrija o problema; registre também a taxa de sucesso das tarefas, o tempo de revisão manual e o custo real.
Os limiares abaixo são apenas recomendações editoriais, um ponto de partida conveniente para testes, e não restrições oficiais nem regras ótimas já validadas:
- A alteração envolve pelo menos 3 arquivos, ou exige modificar simultaneamente a definição da interface e os chamadores.
- O Flash apresentou duas correções consecutivas que não resolveram o problema, o que sugere que a causa pode não estar só naquele trecho.
- A causa raiz do bug está em outro módulo, por exemplo, configuração, versão de dependência ou a etapa anterior do fluxo de dados.
- É preciso entender a arquitetura geral do projeto, como mapear as relações entre módulos e planejar uma refatoração.
- Você mesmo não consegue explicar onde está o problema e precisa que o modelo faça uma investigação global primeiro.
Por outro lado, tarefas como explicar código, escrever exemplos de testes unitários, renomear coisas, adicionar comentários e corrigir erros de compilação podem começar pelo Flash; depois, os resultados dos testes e da revisão manual decidem se vale mantê-lo.

2.3 Contexto de 1,05M não significa que você consiga usar tudo na ferramenta
O model card informa que o contexto é de 1,05M, com entrada máxima de 922k e saída máxima de 128k, mas ao mesmo tempo observa que os limites reais do produto podem ser diferentes. Nossa avaliação é que, em produtos como o GitHub Copilot, o comprimento de contexto efetivamente disponível e o limite de saída por requisição podem ser afetados pelas políticas do produto.
Portanto, não conte com a ideia de “enfiar o repositório inteiro no contexto” para resolver o problema. A abordagem mais segura continua sendo mostrar primeiro ao modelo os diretórios relevantes e os arquivos-chave, e depois ampliar o escopo aos poucos. É justamente aí que está o valor do Code 2 com seu foco em “raciocínio em nível de repositório”: ele precisa encontrar as relações-chave em meio a uma grande quantidade de código, e não apenas conseguir acomodar mais texto.
2.4 Quer invocar o MAI Code 2 via API: verifique primeiro, depois experimente
Hoje, os pontos de entrada confirmados para a série MAI Code 2 são o GitHub Copilot e o Foundry (Flash, em pré-visualização limitada); os canais de agregação de terceiros ainda não foram disponibilizados de forma abrangente. Se você pretende integrar via API, o primeiro passo não é escrever código de negócio, mas confirmar se a plataforma de destino realmente oferece esses dois modelos e quais são os IDs dos modelos.
O código abaixo mostra apenas a ideia de integração; este artigo não o executou, nem verificou que o APIYI já disponibiliza esses dois modelos. Um nome que contenha “mai” indica apenas um candidato, e não substitui a verificação dos nomes oficiais dos modelos, das capacidades da interface e das permissões. O exemplo列表 primeiro lista os modelos e depois filtra as entradas que possam ser relevantes:
import openai
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1" # Interface compatível com OpenAI do APIYI; a disponibilidade dos modelos deve ser consultada na lista em tempo real
)
# Lista os modelos disponíveis no momento e filtra as entradas possivelmente relacionadas ao 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 相关模型")
Se o modelo correspondente realmente aparecer na lista, você pode escrever uma rotação simples em tiers seguindo a ideia da seção 2.2. Consulte sempre a lista da plataforma para obter os IDs dos modelos; abaixo usamos placeholders:
Ver o código de exemplo para invocar em tiers conforme a dificuldade da tarefa
import openai
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1" # Usa a interface unificada do APIYI
)
# Placeholders: substitua pelos IDs reais confirmados na lista de modelos
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:
"""Seleciona o modelo conforme os sinais da seção 2.2: Flash por padrão; se qualquer condição for atendida, escala para 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"))
🎯 Sugestão de integração: os canais de terceiros para a série MAI Code 2 ainda estão sendo disponibilizados aos poucos. Recomendamos verificar primeiro na lista de modelos ou na documentação do APIYI apiyi.com o suporte real e os IDs dos modelos, e só então decidir se vale integrar. Se ainda não estiverem disponíveis, você pode usar o mesmo conjunto de código compatível com OpenAI para montar a rotação em tiers nos modelos de programação já suportados pela plataforma. Depois, ainda será necessário verificar os parâmetros da interface, o suporte a chamadas de ferramentas, os custos e os testes de regressão — não há garantia de compatibilidade apenas trocando o ID do modelo.
2.5 Mudanças futuras que merecem atenção no MAI Code 2
As avaliações a seguir são preditivas e precisam ser confirmadas por fatos futuros:
- Ritmo de lançamento dos canais de terceiros: quando os canais marcados como “em breve”, como OpenRouter e Vercel, serão liberados afeta diretamente a barreira de uso para quem não é usuário do Copilot.
- Escopo de acesso ao Foundry: se o Flash vai passar de prévia restrita para disponibilidade pública e se o Code 2 entrará no Foundry.
- Resultados de testes independentes: o desempenho da comunidade e de terceiros em repositórios reais diz mais sobre a diferença prática entre os dois níveis do que as avaliações dos fabricantes.
- Limites reais dentro dos produtos: os limites reais de contexto e saída em produtos como o Copilot determinam até onde a “inferência em nível de repositório” pode ir.
Para comparar diferentes modelos de programação lado a lado em um mesmo conjunto de código, plataformas agregadoras são mais práticas. A APIYI apiyi.com oferece uma interface unificada compatível com OpenAI; com uma única chave, é possível alternar entre modelos como OpenAI, Claude e Gemini, o que ajuda a preparar o fluxo de comparação antes do lançamento de novos modelos.
O surgimento de modelos em dois níveis, no fim das contas, reconhece uma verdade simples: não existe um modelo que sirva para todas as tarefas de programação; distribuir as ferramentas conforme o peso da tarefa é a forma mais econômica de usá-las. Como diz o Chu Ci · Bu Ju:
“O grande tem suas limitações; o pequeno tem seus pontos fortes.”
📚 Referências
- Anúncio oficial do GitHub: planos e políticas de administrador.
-
Preços oficiais e nota de rodapé da promoção do GitHub: tarifas, datas de término das promoções e regras de cobrança.
-
Comunicado oficial da Microsoft: Introducing MAI Code 2 and MAI Code 2 Flash: anúncio de lançamento e descrição do posicionamento
- Link:
microsoft.ai/news/introducing-mai-code-2-and-mai-code-2-flash/ - Descrição: o posicionamento das tarefas dos dois modelos, a disponibilidade no GitHub Copilot e a informação de “em breve” nos canais de terceiros
- Link:
-
Blog da comunidade técnica do Azure AI Foundry: From model choice to your durable advantage
- Link:
techcommunity.microsoft.com/blog/azure-ai-foundry-blog/from-model-choice-to-your-durable-advantage-build-ai-that-keeps-improving/4573609 - Descrição: a forma de disponibilização pelo lado do Foundry e a explicação da prévia de acesso restrito do MAI Code 2 Flash
- Link:
-
Model card do MAI Code 2 e do MAI Code 2 Flash (PDF): especificações do modelo e descrição da avaliação
- Link:
microsoft.ai/pdf/MAI-Code-2-And-MAI-Code-2-Flash-Model-Card.pdf - Descrição: modalidades de entrada e saída, comprimento da janela de contexto, entrada e saída máximas, além da observação de que as limitações do produto podem variar
- Link:
Autor: Equipe técnica da APIYI
Comunicação técnica: Se você quiser saber mais sobre a integração e o suporte dos modelos, fale conosco pela página inicial da APIYI em apiyi.com. Há mais documentação de integração disponível no centro de documentação docs.apiyi.com
