Terminal, IDE, desktop, web ou Remote Control

Field Note

Sexta-feira, 18h. Você deixou uma tarefa longa rodando e precisa sair. No celular, você abre o app do Claude e encontra uma sessão. Só que surge a dúvida: isso está rodando no meu notebook, que vai dormir na mochila, ou numa máquina na nuvem que segue trabalhando? A resposta muda tudo: se a tarefa termina, se ela enxerga o seu .env local, se ela consegue rodar o banco que só existe na sua máquina.

Conceito

O motor é o mesmo em todo lugar. A doc oficial diz que o loop agêntico, as ferramentas e as capacidades são idênticos em todas as superfícies. O que muda são duas coisas: onde o código roda e como você interage com ele.

Onde roda (ambientes de execução):

• Local: na sua máquina. É o padrão. Acesso total aos seus arquivos, ferramentas e ambiente.
• Cloud: numa VM gerenciada pela Anthropic (ou em ambiente self-hosted da sua organização). O repositório é clonado numa máquina isolada e a sessão continua mesmo se você desconectar.
• Remote Control: roda na sua máquina, mas você controla pelo navegador ou pelo celular. Execução e arquivos ficam locais.

Como você interage (superfícies):

• CLI (terminal): a superfície mais completa. Scripting e o Agent SDK são exclusivos dela.
• Desktop app: interface gráfica com visualizador de diff, várias sessões lado a lado, worktrees (cópias isoladas do projeto via git) e escolha entre sessão Local, Cloud ou SSH. O app já inclui o Claude Code, sem instalar a CLI à parte. A doc indica que exige assinatura paga.
• VS Code (e Cursor): extensão com diff inline, menção a arquivos com @, revisão de plano e histórico. Pede VS Code 1.94.0 ou mais novo. A extensão traz uma cópia própria da CLI para o painel de chat, mas não coloca claude no seu PATH: para rodar no terminal integrado, instale a CLI também.
• JetBrains (IntelliJ, PyCharm, WebStorm, GoLand e outras): plugin em beta, que roda a CLI no terminal da IDE e abre diffs no visualizador nativo. Aqui a CLI é obrigatória, instalada separadamente.
• Web (claude.ai/code): sessões na nuvem, sem setup local. Exige GitHub conectado. Disponível nos planos Pro, Max e Team, e no Enterprise para assentos premium ou Chat + Claude Code.
• Mobile: cliente leve para acompanhar sessões cloud ou controlar uma sessão local via Remote Control.

Continuidade entre superfícies. Dá para mudar de lugar no meio do trabalho, e a doc lista os caminhos:

• claude --cloud "tarefa" cria uma sessão na nuvem a partir do terminal.
• claude --teleport (ou /teleport dentro da sessão) puxa uma sessão cloud para o seu terminal. Exige assinatura claude.ai.
• /desktop continua a sessão atual do terminal no app Desktop. Exige assinatura e funciona em macOS e Windows x64.
• claude remote-control, claude --remote-control ou /remote-control deixam a sessão local acessível pelo navegador e pelo celular.

Configuração, memória do projeto e servidores MCP são compartilhados entre as superfícies locais. A sessão cloud usa só o que está no repositório. Seu setup local fica de fora.

Quando usar

• CLI: você vive no terminal, quer o conjunto completo de recursos, scripts, claude -p em pipeline, servidor remoto via SSH.
• Desktop: você prefere revisar diff visualmente, rodar sessões em paralelo ou não quer abrir terminal.
• VS Code / JetBrains: você quer o agente sem sair do editor, com seleção de código virando contexto automático.
• Web / cloud: tarefa bem definida que não precisa de muita condução, repositório que você não tem clonado, várias tarefas paralelas cada uma no seu branch.
• Remote Control: a tarefa precisa do seu ambiente local (banco local, variável de ambiente, ferramenta instalada), mas você quer acompanhar de longe.

Quando não usar

• Cloud para tarefa que depende de configuração, credencial ou serviço que só existe na sua máquina. A VM não tem nada disso.
• Remote Control se o computador vai desligar ou dormir sem rede. A doc avisa: a interface web é só uma janela para a sessão local, então a máquina precisa ficar ligada e o processo claude rodando. Também não funciona com API key, Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry nem com ANTHROPIC_BASE_URL apontando para gateway.
• Extensão de IDE quando você precisa de recurso exclusivo da CLI. Nesse caso, rode claude no terminal integrado.
• Desktop ou web em plano que não dá acesso (o plano gratuito não inclui Claude Code).

Faça agora

A prática é rodar a mesma tarefa exploratória em duas superfícies e decidir seu ambiente padrão.

1. Escolha o mesmo projeto da lição anterior e uma tarefa só de leitura, por exemplo:

Mapeie como os dados entram e saem deste projeto: ponto de entrada, principais módulos e dependências externas. Não altere arquivos.

2. Superfície A: rode no terminal.

cd caminho/do/projeto
claude --permission-mode plan

3. Superfície B: escolha uma entre Desktop, VS Code, JetBrains ou web. Se for web, o repositório precisa estar no GitHub. Se for JetBrains, confirme antes que claude --version funciona no terminal da IDE.
4. Compare cinco critérios: onde o código rodou, quanto do seu setup local estava disponível, facilidade de revisar o que ele fez, facilidade de interromper e corrigir, e se a sessão sobreviveria a você fechar a tampa do notebook.
5. Escreva a Decisão de ambiente padrão: uma superfície para o dia a dia e uma para exceções, com o motivo de cada.

Armadilhas

• Não saber onde está rodando. É a armadilha central. Antes de pedir algo que toca serviço, credencial ou dado, confirme se é local ou cloud.
• Instalar a extensão do VS Code e achar que a CLI veio junto. Não veio para o PATH. claude: command not found no terminal integrado é isso.
• Instalar o plugin JetBrains sem a CLI. O plugin mostra "Cannot launch Claude Code" quando não encontra claude no PATH.
• Fechar o notebook com Remote Control ativo e esperar que a tarefa termine. Ela pausa junto. A doc diz que reconecta quando a máquina volta.
• Esperar que a sessão cloud conheça seus atalhos. Ela não vê seu ~/.claude local, só o repositório. Instrução que importa vai para o CLAUDE.md versionado.
• Tratar superfície como questão de gosto e pronto. É também questão de segurança: onde roda define o que o agente alcança.

Material para levar

Mapa rápido de decisão:

Preciso do meu ambiente local?
  Sim, e estou na frente do computador  → CLI, Desktop (Local) ou IDE
  Sim, mas vou sair                     → Remote Control (máquina ligada)
  Não, só o repositório basta           → Web / cloud (segue rodando offline)

Quero revisar diff visualmente?         → Desktop ou IDE
Quero script, pipeline, claude -p?      → CLI
Repositório não está clonado aqui?      → Web / cloud

Comandos de continuidade:

claude --cloud "descrição da tarefa"   # terminal para nuvem
claude --teleport                      # nuvem para terminal
claude --remote-control                # sessão local acessível pelo celular

Dentro da sessão: /desktop (terminal para Desktop), /remote-control, /teleport.