Aula 23Claude Code em qualquer lugar

🖥️ Versão Desktop. Nesta aula, tudo acontece no celular, na aba Code do app Claude Desktop e no navegador, em claude.ai/code e no GitHub. Você não digita nenhum comando: o Remote Control liga por um interruptor, e o envio para o GitHub aparece num pedido de licença, que você aprova. Os comandos do Git aparecem só em "Para ir além", para quem já programa.

Objetivos

Ao final desta aula você vai saber:

• Continuar pelo celular uma conversa que está rodando no seu computador, com o Remote Control, e aprovar os pedidos de licença de lá
• Saber o que precisa ficar ligado para a conversa seguir com você longe da mesa
• Mandar uma tarefa para uma sessão na nuvem, que trabalha com o seu computador desligado, a partir do repositório do GitHub
• Levar o que a nuvem fez até a página: a linha paralela, o pedido para juntar e a linha principal de volta no computador

Até aqui, a conversa com o Claude acontecia na sua mesa: ele rodava no seu computador, e você escrevia no app. Nesta aula, ela sai da mesa de dois jeitos. Primeiro, pelo celular: a conversa continua rodando no seu computador, e você manda pedidos e aprova de onde estiver. Depois, pela nuvem: a tarefa roda num computador da Anthropic e segue mesmo com o seu desligado.

O que você precisa:

• O app do Claude no celular (iPhone ou Android), com a mesma conta que você usa no app Claude Desktop. Ainda não tem? Baixe o Claude na loja de apps do celular.
• Um plano Pro, Max, Team ou Enterprise, com o login da assinatura. No Team e no Enterprise, quem administra a conta da empresa (o Owner) precisa liberar antes o Remote Control e, para a nuvem, o GitHub.
• Para a nuvem, a Aula 19: o repositório confeitaria no GitHub. A nuvem vale nos planos Pro, Max e Team e, no Enterprise, nos assentos premium ou Chat + Claude Code. Pulou a Aula 19? Faça a parte do celular, que não precisa do GitHub, e leia a da nuvem para saber que existe.

Tudo isso conta no uso do seu plano, como qualquer conversa (Aula 08).

O celular: o Remote Control

Com o Remote Control (controle remoto), a conversa continua rodando no seu computador, com a sua pasta e tudo o que está nela. O app do Claude no celular vira uma janela para essa conversa: o que você escreve no celular chega ao computador, e o que o Claude faz aparece nos dois.

Ligue no computador

Na aba Code, clique em + New. Na linha abaixo da caixa de mensagem, escolha Local e a pasta da sua página. Antes da primeira mensagem, escolha Manual no seletor de modo, na mesma linha.

O interruptor fica num painel que aparece depois que a conversa começa. Comece com um pedido que só lê:

Mostre os preços do cardápio.

No Manual, ler a pasta não pede licença: o Claude responde com a lista. Agora, no painel de detalhes da sessão, ao lado da conversa, procure o cartão Environment (ambiente) e ligue o interruptor Remote Control. Não vê o painel? Clique em Show session rail (mostrar o painel da sessão), na barra de título da conversa. Também dá para digitar /remote-control na caixa de mensagem: faz o mesmo.

Conecte o celular

1. Abra o app do Claude no celular e toque em Code.
2. Na lista, encontre a conversa da sua página. A do Remote Control tem um ícone de computador, com uma bolinha verde quando está no ar, e o nome costuma vir da própria conversa.

Peça e aprove pelo celular

Para testar, nem precisa sair de casa: deixe o computador na mesa, com o app aberto, e vá para outro cômodo com o celular. Como se estivesse no ônibus, escreva no celular:

No cardápio, troque o preço do brigadeiro para R$ 3,50.

O que acontece:

• A mensagem aparece também no app do computador, e o Claude trabalha ali, na sua pasta.
• A conversa continua no Manual. Antes de mudar o arquivo, o Claude pede licença, e o pedido aparece no celular: leia e aprove ali, como faria no computador.
• Dá para mandar foto. Lembra do print da Aula 22? Pelo app do celular, você anexa o print direto na conversa, sem mandar para o computador.

Quer que a mudança vá para o site? Peça, do celular mesmo: "guarde uma versão com uma mensagem em português explicando o que mudou e envie para o GitHub". A trava da Aula 10 pede licença antes do envio, e você aprova no celular.

Critério de pronto: a mensagem que você mandou do celular aparece também no app do computador, e, em até 10 minutos, a página no ar mostra o brigadeiro a R$ 3,50, no celular.

Pulou a Aula 19? Guarde a versão e pule o envio. De volta ao computador, abra a página no painel Browser: o brigadeiro está a R$ 3,50.

O que precisa ficar ligado

O Claude continua rodando no seu computador, então ele precisa ficar ligado, com o app aberto e a conversa nele.

• Fechou o app? A conversa sai do ar até você abrir de novo.
• O computador dormiu, ou a internet caiu? A conversa espera e volta sozinha quando ele acordar ou a internet voltar. Mas, enquanto ele dorme, nada anda. Para ele não dormir sozinho, ligue Keep computer awake (manter o computador acordado), em Settings → This computer → System. Fechar a tampa do notebook ainda põe o computador para dormir: antes de sair, deixe-o na tomada e aberto.
• Para desligar, desligue o interruptor Remote Control, no cartão Environment.

💡 Quer o Remote Control em toda conversa nova? Em Settings → Claude Code, ligue Connect new sessions to Remote Control (ligar as conversas novas ao Remote Control). O aviso no celular quando o Claude precisa de você também existe, e como ligar está em "Para ir além".

ℹ️ E o Dispatch? O app também tem o Dispatch, nos planos Pro e Max: você manda uma tarefa pelo celular, e ele abre sozinho uma conversa na aba Code, no seu computador. Hoje, a central de ajuda do Claude diz que ele não está disponível para quem ainda não usa. O resto está em "Para ir além".

A nuvem: uma sessão que segue sem você

Esta parte vem depois da Aula 19. Com o Remote Control, o trabalho ainda acontece no seu computador. Numa sessão na nuvem (cloud session), não: a conversa roda num computador da Anthropic, numa cópia do seu repositório do GitHub, e segue mesmo com o seu computador desligado. Você acompanha pela barra lateral do app, pelo navegador, em claude.ai/code, ou pelo celular, na mesma aba Code.

⚠️ A nuvem só vê o que está no GitHub. Ela começa de uma cópia do repositório, não da sua pasta. O que você mudou no computador e ainda não enviou não está lá, nem as versões guardadas que ainda não foram enviadas. E o .env também não, de propósito: o .gitignore deixa ele de fora das versões (Aulas 05 e 06). Antes de mandar uma tarefa, pergunte numa conversa Local: "tem alguma mudança que ainda não foi enviada para o GitHub?"

Ligue o GitHub (uma vez)

Isso se faz no navegador, uma vez só:

1. Abra claude.ai/code e entre com a sua conta do Claude.
2. O claude.ai/code pede para conectar o GitHub: siga o pedido. O GitHub abre uma página de autorização: confira se é a sua conta e aprove. Você volta para o claude.ai/code.
3. Se ele pedir para instalar o Claude GitHub App (o app do Claude no GitHub), instale só no repositório da página: escolha Only select repositories (só os repositórios escolhidos), em Select repositories marque o confeitaria e clique em Install (instalar).
4. O ambiente. Nos planos Pro e Max, o claude.ai/code cria sozinho um ambiente chamado Default (padrão), com as configurações da nuvem. No Team e no Enterprise, aparece o formulário Create your first cloud environment (crie o seu primeiro ambiente na nuvem): deixe como está e clique em Create & finish (criar e terminar).

Mande a tarefa

1. No app, na aba Code, clique em + New. Na linha abaixo da caixa de mensagem, abra o seletor de ambiente (o primeiro controle, que mostra Local) e escolha, no grupo Cloud, o ambiente Default. No lugar da pasta, escolha o repositório confeitaria.
2. No seletor de modo, na mesma linha, escolha Plan. Na nuvem, não existe o Manual (o seletor mostra Accept edits no lugar dele): as mudanças nos arquivos já vêm liberadas, porque são feitas numa cópia, longe da sua pasta, e só chegam à página depois de um pedido para juntar que você revisa. No Plan, o Claude mostra o plano e espera o seu sim antes de mexer.
3. Escreva e envie:

Acrescente ao cardápio a torta de banana, por R$ 9,00, na categoria Tortas.

4. A nuvem copia o repositório e prepara o computador dela. Quando o plano estiver pronto, o Claude pergunta como seguir: leia e aprove.

Agora, feche o app, ou até o notebook: a sessão segue na nuvem. No celular, abra o app do Claude, toque em Code e encontre a conversa da torta. Dá para acompanhar e responder de lá.

A volta: a linha paralela e o pedido para juntar

A nuvem não mexe na linha principal. Ela trabalha numa linha paralela própria, como a dos depoimentos da Aula 19, e, quando termina, envia essa linha para o GitHub. Se aparecer um pedido de licença para enviar, é a trava da Aula 10, que também vale na nuvem: aprove. O site no ar continua sem a torta até você juntar.

1. Veja o que mudou. Na barra lateral do app, abra a sessão da torta. Quando o Claude terminar, o cartão Changes mostra um contador de linhas, como +12 -1: clique nele para ver as mudanças, arquivo por arquivo.
2. Peça o pedido para juntar, na conversa da nuvem:

Abra um pedido para juntar (pull request) para a main, com uma descrição em português do que mudou.

No fim, o Claude mostra o endereço do pedido. Se ele disser que não consegue, abra a sessão em claude.ai/code, no navegador, clique no contador de linhas e, no alto da tela das mudanças, em Create PR (criar o pedido para juntar). Se ele disser que não conseguiu enviar a linha paralela para o GitHub, instale o Claude GitHub App como no passo 3 de "Ligue o GitHub", pelo endereço github.com/apps/claude/installations/new, e peça de novo.

3. Revise e junte no GitHub, como na Aula 19: em Pull requests (pedidos para juntar), abra o pedido e confira em Files changed (arquivos alterados) se só o arquivo da página mudou, com a torta. Depois, clique em Merge pull request (juntar o pedido), em Confirm merge (confirmar) e, se aparecer, em Delete branch (apagar a linha paralela).
4. Em até 10 minutos, a torta aparece no site. Confira no celular.
5. Traga a linha principal de volta para o computador. O pedido foi juntado no GitHub, não na sua pasta. Na aba Code, clique em + New; na linha abaixo da caixa de mensagem, escolha Local e a pasta da sua página, e o Manual no seletor de modo. Peça, como na Aula 19:

Volte para a linha principal e traga do GitHub as versões novas dela.

Aprove os comandos.

Critério de pronto: no celular, na página no ar, o filtro Tortas mostra três tortas, com a torta de banana a R$ 9,00. E, no computador, depois do passo 5, a página no painel Browser mostra a mesma coisa.

E o que não foi enviado?

Fica onde estava: no seu computador. A nuvem não vê, não apaga e não muda nada na sua pasta. Duas coisas para lembrar:

• Para a nuvem ver, envie antes. Guarde uma versão, envie para o GitHub e só então mande a tarefa. O brigadeiro, você já enviou pelo celular: a nuvem começa com ele.
• Na hora de trazer a linha principal, o que estava pela metade pode atrapalhar. Se o Claude avisar que tem mudança sem versão guardada no caminho, peça: "guarde uma versão do que eu mudei antes de trazer". Se as duas mudanças mexeram no mesmo trecho, o Git pede uma escolha. Peça: "explique em português simples o que aconteceu e me pergunte o que fica".

Celular ou nuvem?

Para ir além (opcional): a nuvem, o Remote Control e o app desktop por inteiro

🔧 Para ir além (para quem já programa; pode pular): esta parte mostra o que um projeto de programação faz com tudo isso: trazer a sessão da nuvem para o computador, com o git fetch, o checkout e o stash, levar uma sessão em andamento para a nuvem, os ambientes na nuvem, o Remote Control por inteiro, as configurações de times, o Dispatch e o app desktop por dentro. Se você nunca programou, pule direto para o Na prática: tudo o que ele pede já foi explicado acima.

Da nuvem para o computador

Na sessão da nuvem, clique no nome do branch e escolha Copy branch name. Numa sessão Local na pasta do mesmo repositório, abra o terminal integrado (Terminal, na barra de título, ou Ctrl + `) e rode:

git fetch origin <nome-do-branch>
git checkout <nome-do-branch>

• A conversa não vem junto: ela continua na sessão da nuvem, que você segue pela barra lateral, por claude.ai/code ou pelo celular. Para levar o contexto, peça à sessão da nuvem um resumo do que foi feito e use no primeiro pedido da sessão local.
• O stash: se o checkout recusar por causa de mudanças não commitadas, o git stash tira as mudanças da pasta e guarda numa pilha, e o git stash pop traz de volta depois. Pode dar conflito, se o branch mexeu nos mesmos trechos.
• Com a conversa: o claude --teleport, da versão do terminal, numa cópia do mesmo repositório (não num fork), com o Git limpo e o mesmo login do claude.ai, busca o branch, faz o checkout e carrega a conversa inteira; com mudanças não commitadas, ele oferece o stash. Em claude.ai/code, o menu da sessão tem Open in → Terminal, que copia o comando pronto.
• O seu computador fica com uma cópia: o que você fizer na sessão local não aparece na sessão da nuvem. Para seguir pelo celular, ligue o Remote Control na sessão local.

Uma sessão em andamento para a nuvem

Numa sessão Local em andamento, abra o menu da sessão (a setinha ao lado do título, ou a linha dela na barra lateral) e escolha Open in → Cloud. A conversa vai junto, como um resumo. Antes de confirmar, o diálogo diz se os seus arquivos vão também e se esta sessão será arquivada quando a da nuvem estiver pronta. Não vale para sessões SSH nem WSL.

Repositório fora do GitHub? Uma sessão nova na nuvem precisa dele. Mandar uma cópia do repositório local, sem GitHub, é recurso do claude --cloud, da versão do terminal.

Os ambientes na nuvem

• Vários repositórios: depois de escolher o ambiente na nuvem, escolha os repositórios na linha abaixo da caixa de mensagem.
• Ambiente novo: no seletor de ambiente, New environment, aba Cloud, e Add environment. O formulário tem o nome, o acesso à rede (Trusted, o padrão, com os registros de pacotes e o GitHub; None; Full; Custom, com a sua lista), as variáveis de ambiente e o script de setup. Para editar ou arquivar um ambiente seu, passe o mouse sobre ele e clique na engrenagem; numa sessão na nuvem já rodando, a setinha ao lado do título tem Edit cloud environment.
• Nada de segredo nas variáveis: quem usa o ambiente lê as variáveis e o script.
• O que a sessão carrega do repositório: o CLAUDE.md, as regras de permissão e as ações automáticas do .claude/settings.json e o .mcp.json (numa sessão com um repositório só), e as pastas .claude/skills/ e .claude/agents/. O que mora só no seu computador, como o ~/.claude/ e os plugins, não vai.

O Remote Control por inteiro

• Ligado sozinho: com Connect new sessions to Remote Control desligado e nunca mexido, o app segue o remoteControlAtStartup dos seus settings e o padrão da organização. Numa conversa que conectou sozinha, o /remote-control mostra Remote Control is already on. This session connected automatically when it started., com Turn off para desconectar.
• Notificações no celular: com o app instalado, o mesmo login e as notificações permitidas, ligue as chaves agentPushNotifEnabled (o Claude escolhe quando avisar, como no fim de uma tarefa longa) e inputNeededNotifEnabled (licenças e perguntas) no ~/.claude/settings.json; as duas vêm desligadas. São as opções Push when Claude decides e Push when actions required do /config da versão do terminal. Também dá para pedir: "me avise quando terminar".

{
  "agentPushNotifEnabled": true,
  "inputNeededNotifEnabled": true
}

• Tirar dos outros aparelhos: arquive a sessão no app, e a cópia do Remote Control é arquivada junto. Para impedir o Remote Control em qualquer sessão deste computador, inclusive as do terminal, "disableRemoteControl": true no ~/.claude/settings.json.
• O que o aparelho vê: a conversa ao vivo, com os servidores MCP e as ferramentas do seu computador disponíveis, os subagentes e workflows em segundo plano, o diff (num repositório Git) e o modelo e o esforço escolhidos de lá. Pedidos de licença e perguntas ficam abertos até você responder. Comandos que só rodam na interface do terminal, como /plugin e /resume, não funcionam de lá.
• Rede e segurança: só conexões HTTPS de saída, nenhuma porta aberta no computador. Enquanto conectada, a transcrição fica nos servidores da Anthropic. Organizações com Zero Data Retention ou com a configuração HIPAA não podem ligar.
• Os modos do terminal: o claude --remote-control e o modo servidor, claude remote-control, são da versão do terminal.

Times: Team e Enterprise

• Remote Control: um Owner liga a opção em Claude Code admin settings. Com Require trusted devices (beta), cada aparelho precisa se registrar, e o login precisa ter menos de 18 horas, renovado por Face ID, Touch ID, Windows Hello ou passkey.
• Nuvem: o login com o GitHub só funciona depois que um Owner liga o conector do GitHub em Organization settings → Connectors. O Quick setup, em Organization settings → Claude Code, pula o pedido do Claude GitHub App, cria o Default para os membros e libera o /web-setup, da versão do terminal.
• Compartilhar uma sessão na nuvem: no Team e no Enterprise, Private ou Team; no Pro e no Max, Private ou Public (confira antes: a sessão pode ter código e credenciais). Em Settings → Claude Code → Sharing settings, dá para exigir acesso ao repositório e esconder o seu nome.
• O Dispatch não existe no Team nem no Enterprise.

O Dispatch

É uma conversa contínua que fica na aba Cowork do app. Você manda uma tarefa pelo app do celular, e ele decide como resolver: trabalho de código (corrigir um bug, atualizar dependências, rodar testes, abrir um PR) vira uma sessão na aba Code, com o selo Dispatch; pesquisa, documentos e planilhas ficam no Cowork. Também dá para pedir direto: "abra uma sessão do Claude Code e corrija o bug do login". Chega uma notificação no celular quando a sessão termina ou precisa de aprovação. Com o uso do computador ligado (Aula 22), essas sessões também usam, e a licença de cada app vence em 30 minutos. Só nos planos Pro e Max, com o celular pareado com o app; o passo a passo fica na central de ajuda, que hoje avisa que ele não está disponível para quem ainda não usa.

O app desktop por dentro

• Painéis: chat, diff, browser, terminal, arquivo, plano, tarefas e subagente. Arraste pelo cabeçalho para mudar de lugar, ou pela borda para mudar o tamanho; Terminal, Changes e Browser, na barra de título, abrem os mais usados, e o menu ⋮ ao lado tem outros, como Files. Um painel pode sair para uma janela própria, num segundo monitor.
• Atalhos (no Windows, Ctrl no lugar de Cmd): Cmd + N abre uma sessão nova, Ctrl + Tab vai para a próxima, Ctrl + ` abre o terminal, Cmd + Shift + D abre o diff, Cmd + \ fecha o painel em foco e Cmd + / mostra todos.
• Arquivos: um clique no caminho abre o painel de arquivo. As suas edições se salvam sozinhas (o Auto save, no menu ⋮ do painel); nas sessões na nuvem, SSH e WSL, o painel só mostra.
• Em paralelo: + New (ou Cmd + N). Num repositório Git, ligue Worktree no controle da pasta antes de começar, e cada sessão ganha a sua cópia (Aula 20). Cmd + clique numa sessão da barra lateral mostra duas lado a lado.
• O diff: clique no +12 -1 do cartão Changes, ou em Changes, na barra de título. Clique numa linha, comente, aperte Enter e mande tudo com Cmd + Enter. O /code-review chega num cartão Code review, com Walk through in diff e Apply fixes.
• O pull request: aberto o PR, ele aparece no cartão Changes, com o estado dos checks. No menu ⋮ ao lado do título, Auto-fix corrige os checks que falham (numa sessão local, trata também os comentários de revisão de outras pessoas) e Merge when ready liga o auto-merge do GitHub. Precisa do gh com login. Auto-archive after PR merge or close, em Settings → Claude Code, arquiva a sessão sozinha, menos as da nuvem.
• Do terminal para o app (se você também usa o terminal): o /desktop (macOS e Windows x64) leva a sessão do terminal para o app, e o claude --desktop abre o app direto. No app, o /resume numa sessão local lista as sessões do terminal (feche antes no terminal).

Na documentação oficial, em inglês: Remote Control, Claude Code na nuvem, os primeiros passos na nuvem, os ambientes na nuvem e o app desktop.

Na prática

Use a pasta da sua página (a confeitaria, ou a da sua ideia).

1. No celular, instale o app do Claude e entre com a mesma conta do app Claude Desktop.
2. Na aba Code, clique em + New. Na linha abaixo da caixa de mensagem, escolha Local e a pasta da sua página. Antes da primeira mensagem, escolha Manual no seletor de modo, na mesma linha.
3. Peça: "Mostre os preços do cardápio." Depois, no cartão Environment, ligue o interruptor Remote Control (ou digite /remote-control).
4. No celular, toque em Code e abra a conversa com o ícone de computador. Escreva: "No cardápio, troque o preço do brigadeiro para R$ 3,50." Aprove pelo celular e confira que a mensagem aparece também no app do computador.
5. Ainda pelo celular, peça: "guarde uma versão com uma mensagem em português explicando o que mudou e envie para o GitHub", e aprove o envio. Em até 10 minutos, confira o preço no celular. (Pulou a Aula 19? Só guarde a versão, e pare aqui.)
6. No navegador, em claude.ai/code, conecte o GitHub (uma vez). No app, clique em + New, escolha Cloud (o Default), o repositório confeitaria e o modo Plan, e peça: "Acrescente ao cardápio a torta de banana, por R$ 9,00, na categoria Tortas." Aprove o plano e feche o app.
7. Acompanhe pelo celular, na aba Code. Quando terminar, peça na conversa da nuvem: "Abra um pedido para juntar (pull request) para a main, com uma descrição em português do que mudou." Junte o pedido no GitHub, como na Aula 19.
8. Em até 10 minutos, confira no celular: o filtro Tortas mostra três tortas. Numa conversa Local na pasta da página, peça: "Volte para a linha principal e traga do GitHub as versões novas dela."

Resumo

• O Remote Control (o interruptor no cartão Environment, ou o /remote-control) deixa você continuar pelo celular, no app do Claude (aba Code), uma conversa que roda no seu computador. Ela continua no Manual, e os pedidos de licença aparecem no celular.
• O computador precisa ficar ligado e acordado, com o app aberto. Fechou o app? A conversa sai do ar.
• A sessão na nuvem (+ New, com um ambiente do grupo Cloud) roda num computador da Anthropic, numa cópia do repositório do GitHub, e segue com o seu computador desligado. Ela só vê o que foi enviado, e o .env fica de fora.
• Na nuvem, não há Manual: use o Plan. A mudança volta numa linha paralela e chega à página pelo pedido para juntar, que você revisa e junta no GitHub. Depois, traga a linha principal de volta, numa conversa Local.
• O que não foi enviado fica no seu computador, sem a nuvem ver nem mexer.

Na próxima aula: o que fazer quando algo dá errado.