Grátis8 min de leituraAula 4 de Seu app no seu celular hoje à noite
Ao final desta aula você sabe o que são os três arquivos de agente no seu projeto novo, em qual deles escrever, e por quê. Você vai ter adicionado quatro regras ao AGENTS.md que descrevem a sua máquina de verdade — sem emulador, Windows, celular físico — e iniciado o Claude Code dentro do projeto para que ele as leia.
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.
Três arquivos, escritos para você pelo create-expo-app. Ninguém ensina isso ainda, porque eles não existiam quando a safra atual de cursos foi gravada.
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 para outros agentes, crie um 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.
Prática
Abra o Claude Cowork no seu computador e experimente em arquivos reais. Cada módulo termina com um checkpoint onde você envia o que criou.
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.
A seção da Expo fica onde está. A sua vai embaixo. Quatro frases curtas e verificáveis ganham de uma página de boas intenções.
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.
Rode de dentro da pasta do projeto, não da sua pasta Documentos. Deixe o dev server rodando na janela dele.
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.
Confira
Você consegue achar AGENTS.md, CLAUDE.md e .claude/settings.json no seu projeto
O CLAUDE.md contém um import do AGENTS.md em vez de uma cópia dele
As suas quatro regras de máquina estão no AGENTS.md, não no CLAUDE.md
O claude inicia de dentro da pasta do projeto
Perguntado sobre o AGENTS.md, ele te lista as suas quatro regras de volta
Se você vir o Claude parece não saber das minhas regras
Duas causas, em ordem de probabilidade. Você iniciou o Claude Code numa pasta acima do projeto, então ele nunca leu o CLAUDE.md do projeto — saia, dê cd no projeto, inicie de novo. Ou você colocou as regras no CLAUDE.md e algo o sobrescreveu; mova-as para o AGENTS.md, que é onde elas pertencem de qualquer jeito.
Se você vir toda mensagem dispara um login que falha com 401
Relatado em junho de 2026: dentro de um diretório de projeto Expo, cada mensagem disparava um /login automático que falhava e deixava o Claude Code sem resposta, enquanto a mesma sessão funcionava normalmente fora do projeto. Apagar o .claude e esvaziar a lista de plugins habilitados não resolveu para a pessoa que relatou. Se acontecer com você, não foi você que fez algo errado — confira se o relato ainda está aberto antes de perder uma noite com isso.
O que você acabou de aprender
O create-expo-app escreve AGENTS.md, CLAUDE.md e .claude/settings.json por padrão; o --no-agents-md recusa.
O AGENTS.md aponta o agente para docs da Expo casados com o SDK, que é a correção para um modelo treinado em Expo mais antigo.
O Claude Code lê o CLAUDE.md, então o CLAUDE.md importa o AGENTS.md com @AGENTS.md — um import e não um symlink, porque symlinks exigem direitos de Administrador no Windows.
As instruções do projeto vão no AGENTS.md, mantidas abaixo de umas 200 linhas, porque arquivos longos reduzem a aderência.
O Claude Code carrega essa corrente a partir da pasta em que você o inicia, então inicie dentro do projeto.