Os arquivos que a Expo escreveu para o Claude

Abra a pasta do projeto num explorador de arquivos e ligue a exibição de arquivos ocultos. Ao lado das coisas que você esperaria — app, package.json, app.json — há três que você não pediu.

O create-expo-app escreve esses arquivos por padrão, e isso muda o que este curso é: dirigir um agente para construir um app mobile agora é o fluxo suportado pelo fornecedor, e não um truque esperto. Se um dia você quiser um projeto sem eles, npx create-expo-app@latest --no-agents-md pula os três.

Para que serve cada um

O AGENTS.md aponta o agente para a documentação da Expo que corresponde à versão do SDK do seu projeto. Essa frase vale mais do que parece: os modelos foram treinados em Expo mais antigo, e boa parte do código Expo escrito por IA está duas, três ou quatro versões de SDK desatualizado e confiantemente errado. Este arquivo é a correção.

O CLAUDE.md contém uma linha: @AGENTS.md. Isso importa o AGENTS.md para o contexto do Claude Code.

O .claude/settings.json já deixa habilitado o plugin oficial da Expo do marketplace de plugins do Claude Code.

Três arquivos em vez de um porque cada um mira uma convenção de agente diferente, então o mesmo projeto funciona com Claude Code, Codex ou Cursor sem configuração por agente.

Por que o CLAUDE.md existe se ele guarda um import só? Porque o Claude Code lê CLAUDE.md, não AGENTS.md. A documentação da Anthropic recomenda exatamente esse padrão: se um repositório já usa AGENTS.md para outros agentes, crie um CLAUDE.md que o importe, para que as duas ferramentas leiam as mesmas instruções sem duplicá-las. Um symlink também funcionaria, mas no Windows um symlink exige direitos de Administrador ou o Modo de Desenvolvedor. O import não.

Então a regra para o resto deste curso, e ela é a orientação da própria Expo:

Coloque as instruções do projeto no AGENTS.md, não no CLAUDE.md. Um lugar só, todos os agentes, sem duplicação.

A sua primeira edição

O AGENTS.md como veio escrito sabe sobre a Expo. Ele não sabe sobre você: que você está no Windows, que não há emulador nesta máquina, que o dispositivo de teste é um celular na sua mesa.

Abra o AGENTS.md em qualquer editor de texto — o Bloco de Notas serve — e adicione estas quatro regras no fim.

## A máquina deste projeto
 
- Rode num dispositivo Android físico via `npx expo start`. Nunca presuma
  que há um emulador ou simulador disponível.
- Instale pacotes com `npx expo install <pacote>`, nunca com `npm install`,
  para que as versões batam com o SDK.
- Este projeto é desenvolvido no Windows. Nunca sugira Xcode, CocoaPods
  ou `npx expo run:ios`.
- Não rode `npx expo prebuild` sem me perguntar antes.

Cada linha evita algo específico. A primeira interrompe o desvio de quatro horas do emulador, da aula 2. A segunda importa mais do que parece: o npx expo install escolhe a versão do pacote que combina com o seu SDK, o npm install escolhe a mais nova, e esse descompasso é a causa mais comum de um build Expo falhar por motivos que ninguém consegue explicar. A terceira te poupa de ouvirem que você abra o Xcode numa máquina que não consegue rodá-lo. A quarta é uma proteção — a partir do SDK 57, o expo prebuild limpa e regenera as pastas nativas por padrão.

Mantenha o arquivo curto. A orientação da Anthropic é abaixo de 200 linhas — arquivos mais longos consomem mais contexto e reduzem a aderência, que é o motivo nada glamouroso pelo qual um agente às vezes ignora uma instrução que você definitivamente escreveu.

O módulo 4 adiciona mais uma regra aqui, aquela que impede o Claude de gastar o seu dinheiro em builds que você não autorizou. Ela pode esperar até haver dinheiro para gastar.

Inicie o Claude dentro do projeto

É aqui que a conta da aula 1 começa a importar: daqui em diante o Claude precisa rodar na pasta e ler e escrever os seus arquivos, e isso exige uma assinatura ou créditos do Console.

claude

O Claude Code lê o CLAUDE.md da pasta em que você o inicia e de todas as pastas acima, então iniciá-lo aqui é o que carrega o @AGENTS.md e as suas quatro regras. Um diretório acima não carrega nada, e você fica com um agente confiante que não faz ideia de em que máquina está.

Faça a ele uma pergunta com resposta verificável:

Leia o AGENTS.md e me diga, em uma frase cada, as quatro regras que eu adicionei sobre esta máquina.

Se ele voltar com as suas quatro regras, a corrente funciona. Se voltar com algo genérico sobre a Expo, você iniciou na pasta errada.

O plugin e o servidor MCP

Existem mais duas peças de primeira parte, e as duas ficam realmente úteis no módulo 4.

O plugin oficial do Claude Code instala as skills da Expo e registra o servidor MCP da Expo num passo só. Rode de dentro de uma sessão com /plugin install expo@claude-plugins-official. As skills são descobertas a partir da conversa em vez de invocadas como slash commands, então não há lista para decorar.

O servidor MCP da Expo fica em https://mcp.expo.dev/mcp e dá ao agente acesso ao vivo à documentação atual da Expo, ao seu histórico de builds e — a parte que importa mais adiante — à capacidade de tirar print do seu app rodando e tocar nele. Essa é a aula-assinatura do módulo 4, e a resposta à queixa mais antiga sobre construir apps com IA: a de que o modelo não consegue ver o celular.