O Xcode 27 ficou agêntico

As novidades de frameworks da WWDC26 tomaram as manchetes: os containers de reordenação do SwiftUI, os novos protocolos de documentos, a execução em segundo plano do App Intents. A mudança mais silenciosa é a que mais altera o dia a dia de trabalho. O Xcode 27 tem agentes de programação integrados à IDE, e a Apple dedicou cinco sessões a explicar como o botão da barra de ferramentas, o comando de planejamento, o painel de artefatos e a distribuição entre sub-agents devem se encaixar em uma forma de trabalhar.

O próprio enquadramento da Apple deixa a intenção clara. “Você conduz a visão do seu código, e o Xcode ajuda você a chegar lá mais rápido e com confiança”, abre a equipe do Xcode Intelligence, antes de acrescentar que o objetivo de design é “manter você focado no trabalho de que você gosta”.¹ A parte interessante não é que um LLM agora escreve Swift. A parte interessante é que a Apple conectou o agente às mesmas ferramentas que você usa à mão: o build, o renderizador de previews, o executor de testes, o String Catalog e o Xcode Cloud. O agente não adivinha se o seu código compila. Ele faz o build, lê o erro e tenta de novo.

TL;DR / Principais conclusões

• Os agentes de programação chegaram no Xcode 26.3; o Xcode 27 amplia o conjunto de ferramentas e redesenha a interação, dividindo a tela em uma transcrição à esquerda (conversa, chamadas de ferramentas, sub-agents) e um painel de artefatos à direita (arquivos, diffs, previews).¹
• Um comando de barra /plan coloca o agente no plan mode, então você aprova uma arquitetura em markdown antes de qualquer código ser escrito, e mensagens enfileiradas permitem que você direcione o trabalho no meio da tarefa.¹
• O agente executa as ferramentas reais de validação do Xcode, o build, a renderização de previews e o executor de testes, então ele se autoverifica conforme avança; na demonstração ele escreveu e executou 12 casos de teste aprovados para a nova funcionalidade.¹
• A prototipagem de UI se apoia em um ciclo de “abrir o leque, remixar, repetir”: peça várias previews nomeadas de Swift de uma só vez, depois combine as partes de que você gostou. Anotações inline e anexos de imagem delimitam mudanças a uma linha exata.²
• A localização passa pelo String Catalog e pelos guias de estilo por idioma da Apple; a conversa principal distribui o trabalho entre sub-agents, e um glossário em TRANSLATION.md mantém a terminologia consistente.³⁴
• A configuração do Xcode Cloud ficou mais curta (conectar um repositório, iniciar o primeiro build) e agora aciona webhooks e builds de múltiplos repositórios, a metade de CI de um fluxo de trabalho intenso em agentes que escreve mais código do que antes.⁵

O agente agora vive no editor

Comece pela tela, porque o layout codifica o modelo mental. No Xcode 27, a transcrição do agente é um painel do editor, não uma gaveta de chat presa na lateral. “A transcrição se mudou para o painel do editor, então você pode compô-la com outros editores usando abas, divisões ou o que melhor servir ao seu fluxo de trabalho”, explica a equipe.⁶ Você inicia uma conversa a partir de um botão no centro da barra de ferramentas, e clicar nele com option-shift abre essa conversa como um painel separado, para que você possa ler arquivos enquanto o agente trabalha.¹

A Apple divide o workspace em uma transcrição à esquerda e um painel de artefatos à direita; o agente pode ver o código-fonte, as configurações de build, os arquivos abertos e a sua seleção ativa.

A divisão importa. “À esquerda, há a transcrição … incluindo comentários sobre o progresso, chamadas de ferramentas, sub-agents em execução e muito mais. À direita, temos os artefatos. São as coisas que são criadas: arquivos, edições e previews.”¹ Cada diff, cada arquivo novo, cada preview renderizada aparece como um artefato que você revisa antes que ele se torne parte estrutural. O agente opera de forma aberta, com as mudanças dispostas para inspeção.

O que o agente consegue enxergar é mais amplo do que uma janela de contexto típica. “Quando você usa agentes no Xcode para explorar, eles podem ver o seu projeto inteiro. A partir do seu código-fonte, das configurações de build e até dos arquivos abertos e das seleções ativas.”¹ Na demonstração, o desenvolvedor pede um passo a passo dos modelos de dados e da hierarquia de views, depois faz o agente escrever dois documentos de arquitetura no repositório para que o trabalho de descoberta sobreviva à conversa, “uma base de conhecimento documentada no seu projeto” que “pode ser dinâmica e evoluir junto com a base de código”.¹ Se você já reexplicou uma base de código a uma sessão nova de um agente, o instinto de persistir o mapa vai fazer sentido.

Um detalhe que vale destacar para quem já usou agentes externos: a Apple adicionou uma ferramenta de Busca em Documentos da Apple que o agente invoca automaticamente. “Dependendo do agente que você está usando, o conhecimento de base dele pode não incluir as informações mais recentes de frameworks. Com a Busca em Documentos da Apple, o seu agente pode acessar documentação de alta qualidade.”¹ Isso resolve o modo de falha mais comum dos agentes de programação em APIs recém-lançadas, chamar com confiança um símbolo que não existe, dando ao agente um caminho para a documentação atual no momento em que ele precisa dela.

O plan mode faz de você o arquiteto

A metade de construção do fluxo de trabalho passa pelo plan mode, acessado com o comando de barra /plan. O enquadramento é deliberado: “O plan mode permite que você seja o arquiteto, esboçando a sua abordagem antes de qualquer código ser escrito.”¹ O agente reúne contexto, pode acionar sub-agents para explorar em paralelo e produz um plano em markdown que você lê, edita inline e aprova antes de a implementação começar.⁶

O plan mode transforma a implementação em uma etapa revisada. Mensagens enfileiradas e perguntas de esclarecimento do agente criam o que a Apple chama de “um ciclo de comunicação apertado” antes de o código entrar.

A Apple é franca sobre por que o planejamento ganha mais peso em um fluxo agêntico. “Quando você constrói com agentes no Xcode, você consegue transformar ideias em funcionalidades tão rapidamente … garantir que você tenha o plano certo … se torna uma etapa mais importante.” O retorno: “o refinamento é gasto polindo a funcionalidade que você quer em vez de consertar uma fundação mal construída.”¹ Quando o custo de gerar código cai em direção a zero, o custo de gerar o código errado cai também, e a única defesa é um plano que você de fato revisou.

Dois detalhes de interação fazem o ciclo funcionar. Mensagens enfileiradas permitem que você adicione um requisito sem interromper o agente (“Enfileirar mensagens assim me permite expressar minhas ideias no momento em vez de esperar o agente terminar o que está fazendo no momento”).¹ E o agente faz perguntas de esclarecimento de volta, então na demonstração o desenvolvedor escolhe quais métricas de insight expor a partir de uma lista que o agente propõe. O resultado é um plano que o desenvolvedor coescreveu, não um que ele apenas carimbou.

Depois vem a validação. O agente usa a ferramenta de build do Xcode, encontra erros de compilação e itera porque “os erros de build são comunicados diretamente ao agente.”¹ Ele renderiza previews como artefatos no destino de execução atual, roda o app em um simulador de iPad através do Device Hub e escreve testes unitários contra o conjunto existente. “O agente escreveu um conjunto inteiro de testes para validar as novas mudanças, e foi capaz de executar e verificar que todos os doze novos casos de teste passaram.”¹ Essa é a distinção estrutural em relação a um chatbot genérico: o agente fecha o próprio ciclo de feedback com os mesmos instrumentos que você buscaria.

Prototipar é um ciclo de abrir o leque

A sessão de prototipagem de UI é a que mais resiste à ideia de entregar o trabalho à máquina, o que é justamente o que a torna a mais útil. Sam, um prototipador da Apple Design Team, enuncia a regra duas vezes: “Não delegue o pensamento crítico a essas ferramentas” e “Pense nos agentes de programação como colaboradores no seu processo de prototipagem, para ajudar você a descobrir qual é a melhor experiência. Lembre-se, você sempre tem a palavra final.”²

A sessão contrasta um prompt vago, que ancora você em um layout arbitrário, com um específico, que pede 10 variações nomeadas de preview de Swift para avaliar lado a lado.

A técnica é “abrir o leque, remixar, repetir”.² Um prompt vago como “crie uma UI para gerenciar um clube do livro” produz um layout arbitrário ao qual você fica ancorado. Um prompt melhor pede múltiplas variações, nomeia funcionalidades explicitamente, dá pistas estilísticas (a aconchego de uma cafeteria, a sensação de papel e tipografia) e dá a cada variação a sua própria preview nomeada de Swift. Na demonstração, isso gera 10 direções distintas entre as quais você clica, e depois você diz ao agente quais elementos combinar.² Como as previews renderizam no canvas sem um rebuild, o ciclo é apertado o suficiente para tratar os designs como descartáveis.

Duas ferramentas de refinamento se estendem ao fluxo de trabalho principal do agente. Anexos de imagem permitem que você comunique a intenção além do texto, e na sessão principal um desenvolvedor esboça um gráfico no Freeform no iPad, envia, e o agente traduz o esboço em um gráfico de linhas correspondente em Swift Charts, renderizando uma preview ao longo do caminho para se autoverificar.¹ As anotações inline são o instrumento mais preciso: “a anotação não diz só o que mudar, ela mostra onde, então o resultado é preciso e delimitado exatamente ao que você pretendia.”¹ Você aponta para a linha de uma animação de fade-in e para a linha da cor de tendência, e o código ao redor vira o contexto. Para animação especificamente, Sam recomenda pedir ao agente que construa um painel de ajuste lado a lado com a animação dividida em fases nomeadas, para que você possa ajustar a rigidez da mola e o escalonamento do tempo sem trocar de contexto.²

A localização passa pelo String Catalog

A localização é onde a história de orquestração fica concreta, e onde a vantagem de integração da Apple é mais difícil de replicar de fora. A base se constrói sobre anos de trabalho no String Catalog: os catálogos começaram rastreando onde as strings são usadas, depois como são usadas para autogerar comentários, e o Xcode 27 leva esse contexto ao agente. “A partir do Xcode 27, você agora pode traduzir as suas strings diretamente no Xcode usando agentes de programação.”³

O agente prepara o projeto, faz o build de cada target para descobrir as strings localizáveis, cria os String Catalogs, depois distribui a tradução entre sub-agents que carregam, cada um, o contexto por string.

O fluxo é preciso. O agente diz ao Xcode para preparar o projeto, o Xcode adiciona o idioma e faz o build de todos os targets para que cada string localizável seja descoberta, e quaisquer String Catalogs ausentes são criados automaticamente.³ Depois o agente divide as strings em lotes e “delega o trabalho de tradução a sub-agents individuais”, cada um recebendo contexto sobre onde a string é usada, strings de terminologia parecida e como a mesma string foi traduzida em outros idiomas.³ O tratamento de plurais é um bom exemplo da integração compensando: para %lld items, o sub-agent produz as variações corretas em francês (“un élément”, “deux éléments”) porque “o Xcode garante que os sub-agents sempre saibam quais variações são necessárias, não importa o idioma.”³

O problema de desambiguação é o que merece atenção. Avery, da equipe de Localização, abre com a palavra “book”, que é algo para ler em uma frase e uma reserva de hotel em outra, com traduções separadas na maioria dos idiomas. “Sem mais contexto, a tradução errada poderia ser escolhida.”³ O String Catalog fornece esse contexto, e a Apple adiciona por cima guias de estilo por idioma além de qualquer orientação que você escreva. O padrão recomendado é um arquivo TRANSLATION.md contendo um glossário, termos que não devem ser traduzidos e notas de tom, mantido separado do AGENTS.md para que o agente só o carregue em tarefas de tradução.³ Na demonstração o desenvolvedor sobrescreve o padrão “lieux d’intérêt” para “landmarks” pelo mais canadense “attraits”, e uma funcionalidade posterior, não relacionada, adota “attraits” automaticamente através da memória entre strings do catálogo, “uma tradução que ele não teria escolhido por padrão.”³

A honestidade sobre os limites é a parte que vale guardar. A Apple observa que alguns idiomas aparecem menos nos dados de treinamento do modelo e podem traduzir pior, recomenda um modelo de contexto grande para o trabalho de consistência de longa duração, e é direta ao dizer que a sua vantagem de leitura de código evapora para idiomas que você não fala: “Essa vantagem desaparece quando se usa um agente para traduzir strings para idiomas que não falamos fluentemente.”³ A resposta é feedback do TestFlight vindo de falantes nativos, além de renderizar a UI localizada em uma preview para pegar truncamentos cedo, já que as frases em francês ficam mais longas do que em inglês. Um botão Gerar Traduções por idioma fica no próprio String Catalog para trabalho focado.⁴

O Xcode Cloud é a metade de CI de um fluxo de trabalho com agentes

Se os agentes fazem você escrever mais código mais rápido, algo tem que pegar as regressões, e a resposta da Apple é o Xcode Cloud, que ficou bem mais curto de configurar. A equipe do Xcode Cloud traça a linha explicitamente: “Com o suporte a agentes chegando ao Xcode, muitos desenvolvedores estão escrevendo mais código do que nunca … Mas como você escala e acompanha o ritmo acelerado de código, novas funcionalidades, e garante que consegue pegar bugs e problemas de performance antes que cheguem aos dispositivos dos clientes? O Xcode Cloud é o seu companheiro para qualidade.”⁵

A integração inicial agora é conectar um repositório, aceitar o fluxo de trabalho padrão e iniciar o primeiro build; o código-fonte roda em VMs efêmeras e nunca é armazenado.

A configuração é um botão Começar, uma equipe de desenvolvimento que é preenchida automaticamente a partir das suas configurações de assinatura, uma conexão de repositório e um primeiro build, com a Apple enfatizando que “os builds do Xcode Cloud rodam em máquinas virtuais efêmeras … Nenhum código-fonte é armazenado e a Apple não tem como acessá-lo.”⁵ A distribuição para o TestFlight interno vem através de um fluxo de trabalho gerado, e o mesmo fluxo integra um segundo app (macOS) no mesmo workspace sem reautorizar o repositório.⁵

A camada de automação é onde isso deixa de ser CI comum. Os webhooks disparam ao longo de um ciclo de vida do build, criado, iniciado e concluído, postando um payload em um endpoint de sua escolha, que é como a demonstração conecta os builds a um dashboard personalizado.⁵ E o suporte a múltiplos repositórios lida com o caso realista em que você separa um framework compartilhado no seu próprio repositório: adicione o remote Git adicional e “o Xcode Cloud agora consegue fazer o build do projeto com todas as dependências certas no lugar.”⁵ A sessão “novidades do Xcode 27” enquadra o ponto central como pegar regressões que de outra forma você perderia: “lançar atualizações sem saber se uma regressão se infiltrou é uma manobra de avião acrobático que ninguém quer tentar.”⁷

O ACP traz o seu agente de preferência para dentro do Xcode

A história da Busca em Documentos da Apple e das ferramentas personalizadas acima é o lado MCP da imagem: chamadas de ferramentas que o próprio agente do Xcode faz dentro da IDE. O ciclo do 27 adiciona um segundo mecanismo, distinto. No State of the Union, a Apple anunciou que “Hoje, o Xcode adiciona suporte ao Agent Client Protocol, então você pode trazer qualquer agente compatível para o Xcode. O suporte a ACP e a integração com Gemini estão sendo lançados em uma atualização do Xcode 26 disponível hoje. E há mais por vir no Xcode 27.”⁸ A precisão importa: o ACP não espera pelo Xcode 27. Ele é lançado em uma atualização do Xcode 26 liberada durante a semana da WWDC, com a integração mais profunda chegando no 27.

A distinção em relação ao MCP é a parte estrutural. O MCP dá ao agente do Xcode ferramentas para chamar; o ACP traz o próprio agente. A Apple enquadra isso através do sistema de plugins: “Com o Agent Client Protocol, um plugin pode trazer um agente da sua escolha.”⁸ A instalação é uma invocação de linha de comando ou uma URL git colada direto no Xcode, e parceiros como o Figma e o GitHub oferecem configuração em um clique.⁸ Então o mesmo formato de plugin que carrega agent skills e ferramentas MCP agora também carrega agentes inteiros.

Um painel sobre inteligência de programação preencheu por que esse segundo caminho vale a pena. Parafraseado de uma gravação transcrita localmente do Coding Intelligence, Machine Learning & AI Group Lab da WWDC 2026, o painel descreveu o ACP como a forma de plugar agentes que se comunicam com modelos hospedados localmente através de provedores como o LM Studio ou runtimes no estilo do Ollama, de modo que um modelo rodando na sua própria máquina possa conduzir o Xcode.¹⁰ Eles traçaram a mesma linha entre MCP e ACP, enquadrando um agente ACP como mais capaz do que o caminho mais antigo de provedor de chat de transcrição única: o provedor de chat é uma conversa, enquanto um agente ACP traz sub-agents, gerenciamento de estado, I/O de arquivos e loops agênticos que rodam por muito mais tempo do que uma única troca.¹⁰ Um laboratório separado, voltado a iniciantes, colocou números aproximados nessa diferença de capacidade. O painel estimou a contagem de ferramentas do modo de chat em cerca de 10 a 15, contra cerca de 60 ferramentas disponíveis no modo de agente no Xcode, de modo que o caminho do agente alcança uma parcela muito maior da superfície da IDE.¹¹ O mesmo painel esboçou os horizontes de tempo em que os três modos operam: o autocompletar preditivo economiza segundos, o chat roda por dezenas de segundos, e agentes que rodavam cerca de 30 minutos um ano atrás agora rodam uma hora ou mais, com o alcance do agente crescendo à medida que ele ganha mais tempo para trabalhar.¹¹

A interação com o simulador é a peça que chega nova com o Xcode 27. O mesmo painel descreveu o agente conduzindo o simulador diretamente, tocando, deslizando e digitando, depois lendo de volta a árvore de acessibilidade e capturas de tela para descobrir o que está na tela.¹⁰ O agente transforma essas interações aprendidas em testes de UI repetíveis, então um fluxo que ele descobriu à mão vira um teste que você executa sem ele. O painel descreveu deixar o agente rodar por algumas horas caçando bugs e relatando quais áreas precisavam de mais atenção.¹⁰ Isso fecha o mesmo ciclo de autoverificação que o agente dentro da IDE já executa contra as ferramentas de build e teste, estendido agora ao app em execução.

Ken Orr, Diretor do Xcode, ofereceu uma técnica pessoal na entrevista do Dub Dub Daily do Dia 4 que enquadra como trabalhar bem dessa forma. Ele pede “ao agente que basicamente escreva uma especificação do que vai fazer antes de fazê-lo. Então ele escreve a especificação, depois escreve o código e então eu faço com que ele acompanhe e crie um conjunto de testes que validam o que ele escreveu, mas que também garantem que ele está testando tudo o que está naquela especificação.”⁹ O retorno que ele aponta é duradouro: “você tem esse tipo de definição viva, que respira, do que o seu app faz.”⁹ Isso ecoa o argumento do plan mode de antes, especificação primeiro, depois código, depois testes que amarram o código de volta à especificação. Sobre a mudança que os agentes criam, Orr colocou de forma simples: “Você consegue se elevar um nível quando está interagindo com agentes… então você chega ao resultado final muito mais rapidamente.”⁹

Onde isso se posiciona ao lado do Claude Code

A pergunta óbvia, se você já roda um agente de programação externo, é se o agente dentro da IDE o substitui. A resposta fundamentada é que eles resolvem problemas diferentes, e a costura entre eles é o território interessante.

O agente do Xcode 27 vence nas coisas que só a Apple consegue conectar: as ferramentas de build, preview e teste contra as quais o agente se autoverifica; a Busca em Documentos da Apple para símbolos atuais de frameworks; e o contexto de localização por string acumulado no String Catalog que uma ferramenta externa não consegue ver.¹³ Essas são integrações, não modelos, e são a vantagem duradoura. Um agente externo como o Claude Code vence fora da toolchain da Apple: o shell, refatorações que abrangem todo o repositório atravessando Swift e o seu backend, as ferramentas MCP personalizadas que você já construiu e um fluxo de trabalho que é o mesmo em todos os projetos.

Os dois coexistem ao longo do mesmo limite ao qual eu sempre volto no artigo App Intents vs. ferramentas MCP. O agente da Apple é fluente dentro do app e do seu grafo de build; o agente geral é fluente em toda a sua máquina. A Apple não trancou a porta: o agente do Xcode suporta adicionar as suas próprias ferramentas (“Algumas são integradas ao Xcode, algumas são fornecidas pelas equipes de frameworks da Apple, e você pode até adicionar as suas próprias”),¹ e a Apple padronizou a convenção AGENTS.md,³ o mesmo arquivo que os agentes externos leem. Se você conectou o Xcode a um agente externo via MCP, como na configuração Xcode + Claude Code, o modelo certo é em camadas, não um ou outro: o agente da IDE para o trabalho apertado no ciclo de build, o agente externo para tudo que cruza as bordas da IDE.

Mais uma observação. A Apple é transparente ao dizer que a qualidade do modelo varia, especialmente entre idiomas, e recomenda modelos de contexto grande para tarefas longas e intensas em consistência.³ Isso se encaixa nos trade-offs do fluxo de trabalho agêntico com Foundation Models: modelos on-device para os turnos baratos, privados e rápidos e um modelo maior para o trabalho que precisa da janela de contexto. O mesmo cálculo que você faz ao escolher um modelo para o código do seu próprio agente se aplica dentro do Xcode.

FAQ

Como eu inicio um agente de programação no Xcode 27?

Use o botão no centro da barra de ferramentas do Xcode para iniciar uma conversa ou tarefa; ele abre como um painel do editor que funciona com abas e divisões. Clicar com option-shift o abre como um painel separado, para que você possa ler arquivos ao lado. A barra lateral do assistente de programação lista as conversas paralelas e sinaliza as que precisam de entrada.¹⁶

O que é o plan mode e quando eu devo usá-lo?

O plan mode, acionado com o comando de barra /plan, faz o agente reunir contexto e produzir uma arquitetura em markdown antes de escrever código. Você o revisa, dá feedback inline ou enfileira mensagens, e o aprova para implementar. Use-o para qualquer funcionalidade não trivial: quando a geração de código é rápida, acertar o plano é o que evita que você fique polindo uma fundação mal construída.¹

Como a localização do Xcode 27 difere de uma tradução genérica por LLM?

O agente traduz através do String Catalog, que rastreia onde e como cada string é usada, e adiciona por cima os guias de estilo por idioma da Apple. Ele distribui o trabalho entre sub-agents que recebem, cada um, contexto por string, incluindo como uma string foi traduzida em outros idiomas. Você pode adicionar um glossário em TRANSLATION.md para sobrescrições. Esse contexto permite que ele desambigue palavras como “book”, que um modelo sem contexto erra.³

O agente dentro da IDE substitui o Claude Code ou outros agentes externos?

Não. O agente do Xcode é mais forte no trabalho apertado no ciclo de build, autoverificando-se contra as ferramentas de build, preview e teste do Xcode e lendo a documentação atual da Apple. Os agentes externos são mais fortes no shell, em refatorações multilinguagem por todo o repositório e em ferramentas MCP personalizadas. A Apple suporta adicionar as suas próprias ferramentas e usa a convenção compartilhada AGENTS.md, então a configuração é em camadas e não um ou outro.¹³

Por que a Apple recomenda o Xcode Cloud junto com os agentes?

Porque os agentes fazem os desenvolvedores escreverem mais código mais rápido, o que eleva o risco de regressão. O Xcode Cloud faz build e testa em paralelo entre dispositivos e versões de SO em VMs efêmeras que nunca armazenam o seu código-fonte, roda a cada commit nas branches escolhidas⁷ e agora suporta webhooks e builds de múltiplos repositórios. É a rede de proteção para a maior velocidade de código.⁵

O cluster completo do Apple Ecosystem: a configuração de MCP do Xcode + Claude Code para conduzir o Xcode a partir de um agente externo; os hooks para desenvolvimento Apple para impor portões de qualidade em torno do código gerado; o fluxo de trabalho agêntico com Foundation Models para a escolha entre modelo on-device e modelo grande; e a fronteira entre App Intents e ferramentas MCP para onde a superfície de ferramentas da Apple encontra o ecossistema aberto de agentes. O hub está na Série Apple Ecosystem. Para o panorama mais amplo de construir iOS com agentes, veja o guia de Desenvolvimento de Agentes para iOS.

Referências