DEV Community

Diego de Sousa Brandão
Diego de Sousa Brandão

Posted on

Série: Claude Code CLI: guia técnico — Parte 3: remoto, limites e boas práticas

#ai #claude #cli #tutorial

Versão do conteúdo: outubro de 2026
Fontes: exclusivamente a documentação oficial da Anthropic (code.claude.com/docs e support.claude.com). A lista completa está em Fontes oficiais.
Aviso: o Claude Code é atualizado com frequência. Antes de usar este material como referência, confira as mudanças com /release-notes e a referência oficial do CLI. O claude --help não lista todas as flags.

📑 Índice da série

  1. 🧠 O que é o Claude Code CLI (Parte 1)
  2. 📦 Instalação e autenticação (Parte 1)
  3. 🚪 Comandos de entrada (Parte 1)
  4. ⌨️ Atalhos de teclado e prefixos (Parte 1)
  5. ⚡ Slash commands essenciais (Parte 1)
  6. 🔐 Modos de permissão (Parte 1)
  7. 📄 Memória: CLAUDE.md e auto memory (Parte 1)
  8. ⚖️ Configuração: settings.json (Parte 1)
  9. 🪝 Hooks (Parte 2)
  10. 👥 Subagents (Parte 2)
  11. 🧩 Skills, comandos e plugins (Parte 2)
  12. 🔌 MCP no terminal (Parte 2)
  13. ⏪ Checkpoints e gestão de contexto (Parte 2)
  14. 🤖 Modo não interativo (-p) e CI (Parte 2)
  15. 🔀 Sessões em paralelo (Parte 2)
  16. ⏰ Automação agendada (Parte 2)
  17. 📱 Trabalho remoto e entre dispositivos
  18. ✅ O que só o CLI faz
  19. ❌ O que o CLI não faz
  20. 🤫 Recursos pouco conhecidos
  21. 🏆 Fluxo de trabalho recomendado
  22. ⚠️ Cuidados e limitações
  23. 📚 Fontes oficiais

17. 📱 Trabalho remoto e entre dispositivos

Remote Control: controlar a sessão local de outro aparelho 

claude --remote-control   # ou --rc: sessão interativa com Remote Control ligado
claude remote-control     # modo servidor
Enter fullscreen mode Exit fullscreen mode
  • Dentro de uma sessão: /remote-control ou /rc.
  • A sessão continua rodando na sua máquina; você acompanha e responde pelo navegador ou pelo app mobile.
  • Exige Pro, Max, Team ou Enterprise com login no claude.ai. Não funciona com API key nem com Bedrock, Agent Platform ou Foundry. Em Team e Enterprise, um Owner precisa habilitar.
  • Para ligar em toda sessão: /config → Enable Remote Control for all sessions.

Sessões na nuvem (claude.ai/code) 

claude --cloud "corrija o teste flaky em auth.spec.ts"  # cria sessão na nuvem
claude --teleport                                       # puxa uma sessão da nuvem para o terminal
Enter fullscreen mode Exit fullscreen mode
  • --remote é um apelido antigo (deprecated) de --cloud.
  • Dentro da sessão, /teleport (ou /tp) também puxa uma sessão da nuvem.
  • O teleport exige git limpo, o mesmo repositório, a branch publicada e a mesma conta do claude.ai.
  • Sem remoto no GitHub, --cloud envia um bundle do git (até 100 MB, sem arquivos não rastreados).
  • --teleport é diferente de --resume: este último só lê o histórico local.
  • /autofix-pr cria uma sessão na nuvem que acompanha o PR atual e corrige falhas.

Outros dispositivos

  • Mobile: app Claude para iOS e Android; sessões na nuvem e Remote Control aparecem na aba Code. /mobile mostra um QR code para baixar o app.
  • Desktop: claude --desktop abre o app desktop na pasta atual (macOS e Windows x64, v2.1.285+). Combine com --continue ou --resume <id> para levar a sessão.
  • Slack: com Pro, Max, Team ou Enterprise, Claude Code on the web habilitado e GitHub conectado. Funciona em canais, não em DMs. Em Team e Enterprise, essa versão está sendo substituída pelo Claude Tag.

18. ✅ O que só o CLI faz

Comparando com o app desktop, as IDEs, a web e o mobile:

  • Scripting e modo -p: o desktop é só interativo. Pipelines, --output-format e CI dependem do CLI.
  • Agent SDK: a página de plataformas o classifica, junto com scripting, como recurso só do CLI. Os pacotes oficiais são em Python e TypeScript.
  • Agent teams: disponíveis no CLI, não no desktop.
  • --allowedTools / --disallowedTools por sessão: o desktop não tem equivalente.
  • Comandos de diálogo como /permissions: no desktop, respondem que não estão disponíveis.
  • Vim mode (/config → Editor mode, ou "editorMode": "vim") e /terminal-setup.
  • Mover trabalho entre terminal e nuvem: claude --cloud e claude --teleport.
  • Provedores terceiros (Bedrock, Agent Platform, Foundry): suportados no CLI e nas IDEs que rodam o CLI. O desktop usa a API da Anthropic por padrão.

Subagents, hooks, skills, CLAUDE.md, plugins, MCP, checkpoints e sandbox não são exclusivos do CLI: funcionam em todas as superfícies e provedores.

19. ❌ O que o CLI não faz

  • Revisão visual de diff, preview do app e computer use: recursos do app desktop.
  • Diffs inline no editor: recurso das extensões de VS Code e JetBrains.
  • Rodar sem a sua máquina: uma sessão do CLI depende do seu computador. Para continuar com tudo desligado, use sessões na nuvem (--cloud) ou rotinas (/schedule).
  • Sandbox no Windows nativo: só no macOS, Linux e WSL 2.
  • Sandbox para tudo: o sandbox cobre comandos de shell. Ferramentas de arquivo, servidores MCP e hooks rodam fora dele.
  • Desfazer efeitos de Bash: checkpoints não cobrem rm, mv, deploys ou chamadas de API.
  • Ferramentas no /btw: a pergunta paralela não usa ferramentas.
  • Fast mode em Bedrock, Agent Platform ou Foundry: não disponível.

Recursos que exigem login no claude.ai (não funcionam com API key do Console nem provedores terceiros): sessões na nuvem, Claude Code no mobile, integração com Slack, app desktop, rotinas, /ultrareview, Remote Control e computer use.

20. 🤫 Recursos pouco conhecidos

Recurso O que faz
/statusline <descrição> Gera um script de status line a partir de linguagem natural. Roda localmente, sem gastar tokens
/output-style Troca o estilo de resposta: Proactive, Concise, Explanatory, Learning ou estilos próprios em .claude/output-styles/
/keybindings Abre ~/.claude/keybindings.json para remapear atalhos, sem reiniciar
/terminal-setup Configura Shift+Enter para quebra de linha (VS Code, Cursor, Alacritty, Zed e outros)
/sandbox Liga o sandbox de comandos de shell (Seatbelt no macOS; bubblewrap e socat no Linux/WSL 2)
--add-dir / /add-dir Dá acesso a pastas fora do projeto (ex.: claude --add-dir ../lib)
/copy [N] Copia a N-ésima resposta mais recente; w no seletor grava em arquivo (útil por SSH)
/export [arquivo] Exporta a conversa como texto
claude --from-pr 123 Abre o seletor de sessões ligadas a um PR
/insights Gera um relatório HTML de uso em ~/.claude/usage-data/report.html
/recap Resume a sessão em uma linha
/goal <condição> Mantém o Claude trabalhando entre turnos até a condição ser atendida
ultrathink no prompt Pede raciocínio mais profundo só naquele turno, sem mudar o /effort
--safe-mode Inicia com todas as personalizações desligadas, para depurar
/powerup Lições interativas sobre recursos do Claude Code
/team-onboarding Gera um guia para o time a partir de 30 dias de uso

Mais detalhes úteis:

  • Sugestões de prompt: Tab ou → aceita. Desligue com promptSuggestionEnabled: false.
  • Notificações: por padrão só no Ghostty, Kitty e iTerm2. Nos outros terminais, use "preferredNotifChannel": "terminal_bell".
  • Imagens: cole com Ctrl+V ou arraste para o prompt.

21. 🏆 Fluxo de trabalho recomendado

Baseado na página oficial de boas práticas:

  1. Explore, planeje, implemente, faça commit. Entre no plan mode (Shift+Tab ou claude --permission-mode plan), deixe o Claude ler o código e propor um plano. Use Ctrl+G para editar o plano no seu editor antes de implementar.
  2. Pule o plano em mudanças pequenas. Se dá para descrever o diff em uma frase, não precisa de plano.
  3. Dê ao Claude um jeito de verificar. Testes, build, linter ou screenshot comparado ao design. Sem verificação, ele para quando o trabalho parece pronto.
  4. Faça a verificação decidir quando parar. Use /goal para uma condição da sessão, um hook Stop para um portão determinístico, ou um subagent revisor.
  5. Seja específico. Diga o arquivo, o cenário, o padrão existente a seguir e como fica o "corrigido".
  6. Mantenha um CLAUDE.md enxuto. Comece com /init. Para cada linha, pergunte: "se eu tirar isso, o Claude erra?".
  7. Corrija cedo. Esc para no meio; Esc Esc ou /rewind volta atrás. Depois de duas correções sem sucesso, rode /clear e escreva um prompt melhor.
  8. Use /clear entre tarefas sem relação e subagents para investigações longas.
  9. Entreviste antes de features grandes. Peça ao Claude para te entrevistar, gere um SPEC.md e implemente numa sessão nova.
  10. Escritor e revisor. Uma sessão implementa, outra (com contexto limpo) revisa o diff.
  11. Migrações grandes: /batch, ou um loop de claude -p com --allowedTools e --permission-mode dontAsk.

Padrões de falha a evitar: sessão "pia de cozinha" (tudo misturado), correções em série, CLAUDE.md inchado, confiar sem verificar, investigação sem escopo.

22. ⚠️ Cuidados e limitações

Segurança

  • No modo default, o Claude só escreve na pasta inicial e nas subpastas, e pede confirmação antes de ler fora dela.
  • curl e wget não são aprovados automaticamente.
  • A documentação admite que nenhum sistema é imune a todos os ataques. Prompt injection é um risco real, principalmente com conteúdo da web e servidores MCP.
  • A Anthropic não audita servidores MCP. Configuração versionada no repositório é responsabilidade do time.
  • No Windows, evite WebDAV e caminhos \\*: eles podem contornar o sistema de permissões.

bypassPermissions e auto mode

  • bypassPermissions não protege contra prompt injection nem ações indesejadas. Use só em container ou VM isolada.
  • No Linux e no macOS, a flag é recusada quando roda como root ou com sudo. Administradores podem bloqueá-la com permissions.disableBypassPermissionsMode: "disable".
  • O classificador do auto mode bloqueia ações irreversíveis, destrutivas ou fora do ambiente. Por padrão, confia só no diretório de trabalho e nos remotes configurados do repositório.
  • Depois de 3 bloqueios seguidos ou 20 no total, o auto mode pausa e volta a pedir permissão.
  • Redefinir listas como soft_deny sem "$defaults" remove as proteções internas, incluindo os bloqueios de force-push e de deploy em produção.
  • Para limites rígidos, use permissions.deny, não o classificador.

Dev containers

  • Recomendados para isolamento, mas um container não impede que um projeto malicioso leia o que está dentro dele, inclusive as credenciais em ~/.claude.
  • Não monte segredos do host (como ~/.ssh ou credenciais de nuvem) e restrinja a saída de rede com allowlist.

IDEs

  • No JetBrains em acceptEdits, o Claude pode alterar arquivos de configuração que a IDE executa sozinha, contornando a confirmação de Bash.

Dados

  • Planos de consumidor (Free, Pro, Max): os dados podem ser usados para treino se a opção estiver ligada (retenção de 5 anos); com a opção desligada, retenção de 30 dias.
  • Planos comerciais (Team, Enterprise, API): sem treino por padrão; retenção padrão de 30 dias. Zero Data Retention para contas qualificadas.
  • As transcrições locais ficam em texto puro em ~/.claude/projects/ por 30 dias (cleanupPeriodDays).
  • /feedback envia a conversa inteira, incluindo código, e ela é guardada por 5 anos.
  • Telemetria: desligue com DISABLE_TELEMETRY ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

Custo

  • Média em empresas: cerca de US$ 13 por desenvolvedor por dia ativo e US$ 150 a 250 por mês; 90% dos usuários ficam abaixo de US$ 30 por dia ativo.
  • O que encarece: contexto longo, perda de cache, tarefas agendadas e subagents. Agent teams consomem cerca de 7 vezes mais tokens que uma sessão comum quando os teammates rodam em plan mode.
  • Para gastar menos: /clear entre tarefas, /compact com foco, CLAUDE.md abaixo de 200 linhas, Sonnet para a maior parte do trabalho e Opus para o difícil, model: haiku em subagents simples, ferramentas de CLI em vez de MCP quando possível.
  • Acompanhe com /usage.

23. 📚 Fontes oficiais

Todas em code.claude.com/docs, consultadas em outubro de 2026.

Visão geral e instalação

Uso no terminal

Permissões, memória e configuração

Extensões

Contexto, automação e paralelismo

Remoto e outras superfícies

Boas práticas, segurança e custo

Fim da série. Parte 1: fundamentos e configuração. Parte 2: extensões, MCP e automação.

Top comments (0)