Grátis8 min de leituraAula 3 de Seu app no seu celular hoje à noite
Ao final desta aula existe um app rodando no seu próprio celular que você fez nos últimos quinze minutos, escaneado de um QR code na tela do seu notebook. Não é um vídeo de um app nem uma foto de um. Você pode passar o celular para quem estiver sentado do seu lado.
Três comandos. É a aula inteira.
Tudo que você instalou na aula 2 existe para que estas três linhas funcionem, e você pode rodar todas elas sem uma conta paga do Claude. Digite você mesmo.
Crie o projeto
Abra um terminal numa pasta que você consiga encontrar de novo — a sua pasta Documentos serve — e rode:
O @latest importa. Sem ele o npm pode reaproveitar uma cópia antiga em cache da ferramenta.
npx create-expo-app@latest
Você deve ver
Ele pergunta: What is your app named?
Digite o nome que você escolheu na aula 1. Minúsculas com hífens é o mais seguro, porque isso vira um nome de pasta — pocket-ledger, não Pocket Ledger. Os exemplos no resto deste módulo usam pocket-ledger; troque pelo seu em todo lugar.
Ele então baixa algumas centenas de pacotes, o que leva de um a três minutos dependendo da sua conexão. Isso é normal e só acontece uma vez.
Versão fixada, verificada em 2026-09-04. O template padrão te dá Expo SDK 57.0.0 (lançado em 30 de junho de 2026), React Native 0.86 e React 19.2. O SDK 57 é uma release deliberadamente pequena, sem breaking changes em relação à anterior.
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.
Use o nome da sua própria pasta. Todo comando daqui em diante roda dentro do projeto.
cd pocket-ledger
Suba o dev server
npx expo start
Você deve ver
Um QR code desenhado no terminal, e uma linha dizendo Metro waiting on exp://192.168.1.24:8081 com o seu próprio endereço.
O Metro é o que transforma os seus arquivos em algo que o celular consegue rodar. Deixe esta janela aberta — ela fica rodando a sessão inteira e reconstrói toda vez que você salva.
Duas coisas sobre esta janela. Ela não termina, e isso está certo — um dev server roda até você parar. E as teclas listadas embaixo funcionam enquanto ele roda: a abre num dispositivo Android conectado, w abre no navegador, r força um reload. Você vai usar o r na próxima aula.
Coloque no celular
O seu notebook e o seu celular precisam estar na mesma rede Wi-Fi. Não a mesma operadora — a mesma rede. Um celular no dado móvel não vai achar o notebook.
Abra o Expo Go no celular e use o scanner dele para ler o QR code na tela do notebook. O app baixa o seu projeto pelo Wi-Fi e o inicia.
O app inicial, num celular de verdade, cerca de quinze minutos depois de uma pasta vazia. O que ele diz na tela ainda não importa — que é o seu celular, rodando o seu projeto, é o ponto inteiro.
O que você está olhando é o template inicial: umas telas de espaço reservado e uma barra de abas. Ele é deliberadamente sem graça. Na aula 5 você o muda pedindo, e no módulo 2 ele vira as três abas do seu app de verdade.
Tire uma foto do celular. Mande para alguém. Esta é a parte do curso em que as pessoas não acreditam até fazerem.
Quando o QR code não conecta
Este é de longe o lugar mais provável de desistir, então ele ganha uma seção em vez de uma nota de rodapé.
A documentação da própria Expo nomeia a causa sem rodeios: condições de rede restritivas, comuns em Wi-Fi público, e firewalls, comuns para usuários de Windows, podem impedir o celular de alcançar o dev server pela rede local. Se o Windows Defender abrir uma caixa de diálogo na primeira vez que você rodar npx expo start, marque Redes privadas e permita o acesso. Se você dispensou a caixa, ou está numa rede de café, ou o celular simplesmente fica ali sem conseguir conectar, use o tunnel:
Roteia a conexão por uma URL pública em vez da sua rede local. Mais lento, e funciona em quase todo lugar.
npx expo start --tunnel
Você deve ver
Uma URL como https://xxxxxxx.bacon.19000.exp.direct:80 no lugar do endereço exp://. Escaneie o novo QR code.
Permita o acesso à rede privada se você vir a caixa de diálogo. Se não viu, ou se não ajudou, o --tunnel contorna o problema inteiro — ao custo de um reload mais lento.
Uma ressalva: uma URL de tunnel é pública. Qualquer pessoa com o endereço alcança o seu dev server enquanto ele estiver rodando. Para um projeto inicial isso não é um risco de verdade, mas é um motivo para usar o npx expo start simples quando ele funciona e guardar o tunnel como plano B.
O tutorial que a gente não vai fingir que não existe
A Expo publica um tutorial gratuito chamado Build with AI, em docs.expo.dev/tutorial/build-with-ai/. Ele ensina quem não programa a construir um app mobile pedindo ao Claude Code, dura cerca de uma hora, o Windows é um caminho de primeira classe nele, e ele é genuinamente bom. Ele cobre mais ou menos o terreno que você acabou de andar, com mais detalhe, de graça.
Vá fazer se você tem a hora — vai te deixar melhor no resto deste curso. Duas coisas que ele não faz: ele nunca publica nada numa loja, e nunca menciona que o Claude Code exige um plano pago do Claude. Essas duas omissões são mais ou menos o motivo de este curso existir. Nós somos as horas depois daquela hora: a loja, o dinheiro, o muro dos doze testadores, e as formas específicas pelas quais isso dá errado.
Confira
Existe uma pasta com o nome do seu app e você consegue dar cd nela
npx expo start mostra um QR code e uma linha Metro waiting on exp://
O seu celular está no mesmo Wi-Fi que o notebook
O app inicial está no seu celular, aberto pelo Expo Go, e você consegue rolar a tela
Você sabe qual comando rodar quando o QR code não conecta
Se você vir Something went wrong. Could not connect to the server.
O celular achou o QR code mas não o seu notebook. Nesta ordem: confira que os dois aparelhos estão no mesmo Wi-Fi; procure um aviso do Windows Defender escondido atrás de outra janela e libere o acesso à rede privada; depois pare o servidor com Ctrl+C e suba de novo com npx expo start --tunnel. O caminho do tunnel funciona em Wi-Fi de hotel, em rede de escritório e atrás de firewall, que é por que ele existe.
Se você vir o app Expo Go diz que o projeto usa uma versão diferente do SDK
Cada build do Expo Go suporta exatamente uma versão do Expo SDK, e o projeto e o app têm que bater. Atualize o Expo Go pela Play Store — a versão Android acompanha os SDKs atuais de forma confiável. No iOS o build do Expo Go na App Store pode ficar uma release atrás, o que é um dos motivos de este curso ser escrito com o Android em primeiro lugar.
O que você acabou de aprender
npx create-expo-app@latest e depois npx expo start é a distância inteira de uma pasta vazia até um app rodando.
O dev server continua rodando. O Metro reconstrói a cada save, e r naquela janela força um reload.
O celular e o notebook precisam estar no mesmo Wi-Fi para a conexão padrão por QR code funcionar.
npx expo start --tunnel contorna firewalls do Windows e redes restritivas, ao custo de velocidade, e a URL dele é pública.
O tutorial gratuito Build with AI da própria Expo cobre bem esta primeira hora; este curso começa onde ele para.