App Desktop
📚 Navegação da Série: O artigo anterior 09 Integração com JetBrains colocou o Claude Code em toda a suíte do IntelliJ. Este artigo fala sobre uma porta de entrada que muitos ignoram — o app desktop oficial, uma janela independente onde você pode executar o Claude Code sem um terminal e sem uma IDE.
Diziam que a linha de comando era o "jeito certo" de usar o Claude Code, e que o app desktop era no máximo uma versão simplificada para novatos — para ser sincero, essa avaliação já está ultrapassada.
Muitas pessoas pensavam assim no começo. Mas quando você precisa fazer três alterações em requisitos não relacionados ao mesmo tempo, abre três abas no terminal, e enquanto altera você mesmo se confunde: qual aba está alterando o login, qual está refatorando a camada de dados, trocando de uma para outra você vê errado várias vezes. Tente a mesma tarefa no app desktop: a barra lateral esquerda lista três conversas, cada uma automaticamente isolada por um Git worktree, as alterações não se contaminam, com um clique você troca para a outra — é aí que você percebe que esse negócio não é um "CLI simplificado", é uma outra forma de trabalhar.
E o mais importante: o app desktop, a extensão para VS Code e a linha de comando rodam o mesmo motor subjacente, compartilhando o mesmo CLAUDE.md e configuração. Portanto, isso não é "uma ferramenta mais fraca", mas sim o mesmo Claude Code com uma interface mais adequada para paralelismo e revisão visual.
Quando usar este, e quando honestamente voltar para o terminal, este artigo explicará claramente para você.
Após ler este artigo, você obterá:
- O passo a passo completo para instalar o app desktop no macOS / Windows, além de uma explicação clara de "por que não funciona no Linux"
- Os três atrativos exclusivos do app desktop: conversas paralelas + isolamento do Git, terminal / edição de arquivos integrados, e como usar a revisão visual de diff
- Uma tabela de comparação sobre "qual usar: app desktop vs terminal vs extensão de IDE", e um comando para transferir uma conversa do terminal para o desktop em um clique
01 Primeiro, entenda: o que é exatamente o app desktop
A primeira reação de muitos ao ver "aplicativo desktop" é: não é apenas o cliente do claude.ai, uma caixa de bate-papo com uma capa?
Não. Vamos direto à conclusão: o app desktop é o Claude Code completo com interface gráfica, criado especificamente para "executar várias conversas ao mesmo tempo". Ele roda o mesmo motor do comando claude no terminal, pode ler e gravar arquivos locais diretamente, modificar códigos, rodar comandos, apenas movendo essas operações para uma janela com uma barra lateral e um layout de painéis.
Analogia: o mesmo carro, mas com um painel diferente. A linha de comando é como aquele painel puramente digital de carros de corrida — informações completas, resposta rápida, mas você precisa saber ler cada número; o app desktop é como a tela central de um carro de família — tarefas paralelas, diff de alterações e visualização de aplicação todos exibidos na superfície, você pode absorver tudo em um piscar de olhos. O motor é o mesmo, os resultados são idênticos, a única diferença é o quão confortável você fica sentado lá dentro.
Há um ponto fácil de confundir aqui: depois que o app desktop é aberto, existem três abas na parte superior, não confunda onde você quer ir.
| Aba | O que faz | Pode acessar seus arquivos |
|---|---|---|
| Chat | Diálogo normal, semelhante ao claude.ai | ❌ Não pode |
| Cowork | Dispatch e tarefas de agentes mais longas | Na nuvem em máquina virtual, não acessa local |
| Code | Programação interativa, lê e grava diretamente em arquivos locais | ✅ Pode, cada passo pode ser revisado e aprovado |
Este artigo cobrirá apenas a aba Code — ela é que é a "versão desktop do Claude Code". Chat e Cowork são outras duas funções do Claude Desktop, que não têm muito a ver com a nossa linha de escrever códigos.
💡 Resumo em uma frase: o app desktop não é uma interface para o cliente de chat, é o Claude Code completo com interface gráfica, apenas procure pela aba Code e pronto.
02 Como instalar: três plataformas, grandes diferenças
Vamos colocar a regra mais importante em primeiro lugar: O Linux não possui app desktop.
Isso não significa que você esqueceu de instalar algo, é explicitamente não fornecido oficialmente — usuários de Linux devem usar diretamente a CLI (explicamos como instalar no capítulo 02). Portanto, falaremos apenas sobre macOS e Windows abaixo.
Este fluxograma conecta todo o caminho, do download à emissão do primeiro comando, e marca dois obstáculos fáceis de travar: assinatura paga (contas gratuitas clicando em Code saltarão para a página de atualização) e instalar o Git no Windows (é necessário reiniciar o app após a instalação), o canto inferior direito também lembra de passagem que o Linux não possui app desktop. Vamos detalhar as etapas por plataforma a seguir.
Antes de instalar, confirme: você deve ter uma assinatura paga
Muitas pessoas já caíram nessa. A aba Code do app desktop exige a assinatura Pro, Max, Team ou Enterprise, ao clicar nela com uma conta gratuita, será solicitado imediatamente que você faça o upgrade. Um cenário comum de erro é: clicar em Code com uma conta gratuita, ser redirecionado continuamente para a página de atualização, e pensar que a instalação falhou — na verdade, é apenas a assinatura que não está ativada.
macOS
Vá até a página oficial de download e obtenha a versão Universal (compatível com Intel e Apple Silicon), baixe o .dmg, arraste-o para a pasta de Aplicativos, inicie e faça login com sua conta da Anthropic, e clique na aba Code no centro superior.
O macOS geralmente já vem com o Git integrado, e o isolamento de conversas paralelas do app desktop depende dele. Se não tiver certeza, execute um comando no terminal para confirmar:
git --versionA saída esperada é semelhante (o número da versão não importa, desde que seja impresso):
git version 2.39.5 (Apple Git-154)Windows
Baixe o instalador .exe para processadores x64; Windows ARM64 deve baixar o pacote de instalação ARM64 separadamente, não baixe o errado.
O Windows tem um requisito rígido que o macOS não tem: as conversas locais na aba Code exigem que o Git for Windows seja instalado primeiro. É muito fácil cair nessa armadilha em uma instalação nova do Windows — sem o Git instalado, você clica em Code, surge um Git is required em vermelho e a conversa não inicia de jeito nenhum. Após instalar o Git, lembre-se de reiniciar o aplicativo, caso contrário ele não será capaz de lê-lo.
Além disso, algumas bibliotecas no Windows também precisam do Git LFS. Se você encontrar um erro como Git LFS is required by this repository mas is not installed, vá até git-lfs.com para instalar, execute git lfs install e reinicie o aplicativo.
Um lembrete importante: o app desktop já inclui o Claude Code, não há necessidade de instalar Node.js ou a CLI separadamente. Mas, por outro lado, se você ainda quiser digitar
claudeno terminal, aquela CLI deve ser instalada separadamente (veja o capítulo 02) — os dois são programas separados, apenas compartilham a mesma configuração.
💡 Resumo em uma frase: Não disponível no Linux, não funciona em contas gratuitas; no macOS basta pegar a versão Universal e está pronto para uso, no Windows é necessário instalar o Git e depois reiniciar.
03 Atrativo 1: Conversas paralelas + Isolamento automático com Git
Este é o motivo mais válido para usar o app desktop, sem dúvidas.
Primeiro o problema: A dor do paralelismo no terminal
Você com certeza já se deparou com esse cenário: três tarefas em mãos, corrigir um bug de login, adicionar um conjunto de testes e aproveitar para refatorar uma função utilitária. No terminal, você só consegue abrir três abas e executar um claude em cada, mas eles alteram arquivos no mesmo diretório de trabalho — se a conversa A altera utils.js e a conversa B também quiser alterá-lo, as alterações dos dois lados irão entrar em conflito.
Como o app desktop resolve isso
A abordagem do app desktop é muito limpa: clique em + New session na barra lateral para iniciar uma nova conversa. Se o projeto for um repositório Git, ele automaticamente criará um Git worktree independente para esta conversa.
Analogia: Salas de estudo independentes em uma biblioteca. Você e outras duas pessoas estão lendo a mesma coleção de livros (o mesmo repositório), mas cada um recebe uma sala de estudo à prova de som (worktree), lendo por conta própria, escrevendo suas próprias notas, sem interferência; quando você termina de organizar (fizer o commit), os resultados retornam para a biblioteca principal. Antes do commit, as alterações de uma conversa jamais contaminarão as de outra.
A barra lateral lista todas as suas conversas, Ctrl+Tab / Ctrl+Shift+Tab ciclam entre elas (estas duas teclas usam Ctrl em todas as plataformas, não o Cmd). Quer ver duas conversas ao mesmo tempo? No macOS, segure Cmd, no Windows, segure Ctrl e clique em outra conversa na barra lateral, e ela abrirá em uma tela dividida ao lado.
Alguns detalhes práticos
- Onde o worktree é salvo: Por padrão em
<raiz do projeto>/.claude/worktrees/. Pode ser alterado para outro diretório em "Configurações → Claude Code → Worktree location". - Se você quiser incluir arquivos do gitignore, como
.env, no worktree: Crie um arquivo.worktreeincludena raiz do projeto, listando os arquivos a serem trazidos (consulte a documentação oficial como padrão). - Como limpar as conversas concluídas: Passe o mouse sobre a conversa na barra lateral, clique no ícone de arquivar, e o worktree correspondente será excluído.
- Arquivar automaticamente após o PR ser mesclado: Ative Auto-archive after PR merge or close em "Configurações → Claude Code", as conversas locais finalizadas serão fechadas sozinhas.
Um bom hábito a se cultivar é: uma conversa para um PR. Após alterar, fazer o commit, abrir o PR e fazer a mesclagem, a conversa é arquivada automaticamente, o desktop permanece sempre limpo, e você não precisa anotar manualmente "o que essa aba está fazendo". Comparado a abrir cinco ou seis abas no terminal e tentar acompanhar, a carga mental é muito menor.
💡 Resumo em uma frase: Um Git worktree para cada conversa, modificar múltiplos requisitos em paralelo sem contaminação mútua — essa é a vantagem mais concreta do app desktop sobre o terminal.
04 Atrativo 2: Terminal integrado + edição de arquivo, sem precisar alternar o tempo todo
A aba Code do app desktop é construída ao redor de painéis (panes): chat, diff, visualização, terminal, arquivo, plano, tarefas... você pode organizá-los como quiser. Arraste o título do painel para mover, arraste as bordas do painel para redimensionar, assim como montar blocos de construção.
Nota: Este layout de painéis, terminal integrado e editor de arquivos requerem Claude Desktop v1.2581.0 ou superior. Se sua versão for mais antiga, vá primeiro para "Check for Updates" para atualizar (consulte a documentação oficial como padrão, o número da versão pode mudar).
Terminal integrado: compartilha o mesmo ambiente que o Claude
Abra o terminal no menu Views, ou simplesmente pressione Ctrl+` (esta tecla também é Ctrl em todas as plataformas).
O mais brilhante sobre ele é: o terminal se abre no diretório de trabalho da conversa, compartilhando o mesmo ambiente que o Claude. Portanto, se você rodar npm test ou git status neste terminal, o que você verá é o arquivo exato que o Claude está modificando, e não haverá o erro de "O Claude modificou mas eu estou vendo a versão antiga no terminal".
Isso resolve um velho problema de quando se usava a extensão do VS Code: antigamente, você tinha que garantir sozinho que o terminal fizesse cd para o diretório correto, agora isso está pronto — ele já está no lugar certo.
Lembrete: O terminal integrado só está disponível em conversas locais, não pode ser usado em conversas remotas.
Editor de arquivos: clique no caminho para modificar
Clique em qualquer caminho de arquivo no chat ou no diff, o arquivo será aberto no painel de arquivo. Modifique diretamente e clique em Save para gravar no disco.
Se você modificar o arquivo depois que ele for aberto e ele também for modificado no disco (por exemplo, se o Claude o alterou novamente), o painel irá te avisar, permitindo que você escolha sobrescrever ou descartar, ele não vai cegamente sobrescrever as alterações de outras pessoas.
Um detalhe: Se o caminho for HTML, PDF, imagens ou vídeos, ao clicar, ele não abrirá no painel de arquivo, mas sim irá para o painel de visualização — isso será detalhado na próxima seção. O painel de arquivos está disponível em conversas locais e SSH; para modificar arquivos em conversas remotas, você deve deixar o Claude agir diretamente.
Um bônus: Modos de Visualização
O histórico do chat, por padrão, colapsa a chamada de ferramentas em um resumo (modo Normal). Para ver o que exatamente o Claude fez em cada etapa, pressione Ctrl+O para alternar circularmente para Verbose; se quiser ver apenas o resultado final e as alterações, alterne para Summary. Ao depurar "por que ele fez isso", o Verbose é muito útil; ao verificar paralelamente os resultados de várias conversas, o Summary é o mais rápido.
💡 Resumo em uma frase: O terminal compartilha o diretório de trabalho, arquivos abrem com um clique e podem ser editados — todas as ferramentas de desenvolvimento necessárias em uma janela, sem necessidade de encher a tela alternando entre aplicativos.
05 Atrativo 3: Revisão de diff visual, acertos e erros em um piscar de olhos
Esta é a melhoria mais intuitiva da interface gráfica sobre um terminal puro.
No terminal, quando o Claude termina de modificar o código, o diff é um fluxo de texto verde e vermelho; o app desktop transforma isso em uma interface visual clicável, comentável e capaz de auto-revisão pelo Claude.
Como olhar o diff
Depois que o Claude modificar um arquivo, aparecerá um pequeno indicador como +12 -1 (adicionou 12 linhas, deletou 1 linha). Clique nele para abrir o visualizador de diff: a coluna da esquerda lista os arquivos alterados e a coluna da direita mostra exatamente o que foi modificado em cada arquivo.
Adicionando comentários diretamente em uma linha
Esta é a melhor parte de todo o processo de revisão de diff: clique em qualquer linha no diff e aparecerá uma caixa de anotação, digite seu feedback e pressione Enter. Se quiser comentar em várias linhas, clique linha por linha, escreva uma por vez e, finalmente, submeta todos os comentários de uma só vez:
- macOS:
Cmd+Enter - Windows:
Ctrl+Enter
O Claude lê suas anotações, modifica conforme solicitado, e depois de terminar, gera um novo diff para você revisar. Esse processo de ida e volta é muito mais preciso do que digitar "modifique aquele nome de variável na linha 23" no terminal — você apenas clica na linha e fala.
Deixe o Claude fazer a auto-revisão primeiro
Há um botão Review code no canto superior direito do visualizador de diff. Clique nele e o Claude fará uma revisão das alterações antes de você confirmar, deixando comentários diretamente no diff, aos quais você pode responder ou pedir para ele alterar.
Note que ele revisa problemas de alto sinal: erros de compilação, bugs de lógica óbvios, vulnerabilidades de segurança e coisas do tipo. Ele não analisa estilo de código, formatação ou coisas que o linter já pegaria — deixe isso para o linter.
Depois de modificar abra um PR, a CI ainda pode monitorar
Depois de abrir o PR, aparecerá uma barra de status de CI na conversa, o Claude Code usa a CLI do GitHub para buscar os resultados. Dois interruptores valem a pena saber:
- Auto-fix: A CI falhou, o Claude lê automaticamente o log de falha e tenta corrigir.
- Auto-merge: Assim que todas as verificações passarem, ele faz o merge automático do PR (o modo de merge é squash, e você precisará habilitar o auto-merge nas configurações do repositório no GitHub).
Pré-requisito: O monitoramento de PRs requer que o GitHub CLI (
gh) esteja instalado e com login ativo na sua máquina. Se não estiver instalado, o app desktop irá solicitar que você o instale ao abrir um PR pela primeira vez.
Com base em testes práticos, a combinação de comentários linha a linha + Review code, já é capaz de substituir a maior parte da "primeira etapa manual de code review". Antigamente, você teria que percorrer cada arquivo para procurar problemas após o Claude terminar; agora basta pedir a ele que faça a auto-revisão primeiro, e depois verificar apenas os pontos críticos sinalizados, economizando bastante esforço.
💡 Resumo em uma frase: O diff é clicável, comentável linha a linha, e o Claude pode fazer auto-revisão de problemas críticos primeiro, acompanhado de CI e autocorreção — "saber se está correto" deixou de ser questão de visão e passou a ser de interface.
06 App Desktop vs Terminal vs Extensão da IDE: Qual usar afinal?
Até aqui você pode estar ainda mais confuso: você já tem o claude no terminal, já tem a extensão do VS Code, e agora vem o app desktop, qual deles você deve usar afinal?
Vamos começar com as palavras oficiais:
Se quiser gerenciar conversas paralelas em uma única janela, organizar painéis lado a lado e realizar revisões visuais de alterações, use o Desktop; se precisar de scripts, automação ou se preferir o fluxo de trabalho do terminal, use a CLI.
Colocando os três lado a lado, escolha com base em "com o que você mais se importa":
| O que mais te importa... | CLI do Terminal | Extensão do VS Code / JetBrains | App Desktop |
|---|---|---|---|
| Várias conversas em paralelo + Isolamento Git | Abrir abas manualmente, gerenciar worktree sozinho | Médio | ✅ Worktree automático, barra lateral de troca |
| Diff visual, anotações linha a linha | Diff em texto puro | ✅ Diff inline | ✅ Diff + anotação + auto-revisão |
| Escrever código no editor familiar | ❌ | ✅ Exatamente dentro da sua IDE | Tem editor de arquivos embutido, mas não é sua IDE |
| Scripts / Automação / Sem cabeça (Headless) | ✅ --print, Agent SDK | Parcial | ❌ Apenas interativo |
Atalho !bash, Autocompletar Tab | ✅ | Parcial | ❌ (sem a conveniência nativa do terminal) |
| Visualização de app, monitoramento CI, plano de tarefas | Você mesmo deve montar | Parcial | ✅ UI nativa |
| Linux | ✅ | ✅ | ❌ Não fornecido |
| Modelos de terceiros (Bedrock/Vertex/Foundry) | ✅ | ✅ | Por padrão, conecta apenas na API Anthropic (Implantações empresariais podem configurar Vertex / gateways) |
Conseguiu ver a jogada? Os três não são opções substitutas, cada um tem o seu domínio:
- Para automação por scripts, rodar pipelines CI, usar modelos locais/de terceiros → Vá de CLI no terminal, o app desktop não consegue fazer essas coisas.
- A base de escrever código continua no VS Code / JetBrains → Use a extensão da IDE, códigos e AI na mesma janela é o mais fluido.
- Empurrando três a quatro tarefas independentes em paralelo, precisando revisar visualmente → Domínio do app desktop.
E eles podem ser usados simultaneamente, e até simultaneamente no mesmo projeto — compartilhando o CLAUDE.md, servidor MCP, hooks, skills, settings.json. Um uso prático seria: codificação diária na extensão do VS Code, quando for a hora de trabalhar com três a quatro tarefas paralelas independentes, mude para o app desktop, e se precisar de automação em lote, retorne para o terminal para criar scripts.
⚠️ Nota: Comandos que ativariam painéis interativos no terminal, como /permissions, /config, /agents, /doctor, não podem ser usados na aba Code, eles irão responder com um isn't available in this environment. Se precisar alterar as regras de permissão ou configuração, edite diretamente o settings.json ou execute na CLI independente.
💡 Resumo em uma frase: A CLI cuida da automação, a extensão da IDE cuida de escrever códigos, o app desktop cuida de tarefas paralelas + visualização — os três compartilham configurações, cada um no seu quadrado, apenas alterne entre eles de acordo com sua necessidade no momento.
07 Mão na massa: instale o app desktop e conclua sua primeira conversa
Ver e não fazer é só conversa fiada. Vamos percorrer o fluxo mínimo desde a instalação até a conclusão da sua primeira conversa, cada passo trará um resultado esperado que você mesmo pode verificar.
Passo 1: Instale e abra a aba Code
Siga as instruções da Seção 02 (pegue a versão Universal no macOS, primeiro instale o Git no Windows). Abra o aplicativo, faça login e clique na aba Code no centro superior.
✅ Auto-verificação: Você consegue ver a barra lateral de conversas à esquerda, a caixa de chat no meio, sinalizando que a aba Code está normal. Se clicar em Code e for redirecionado à página de upgrade → sua conta é gratuita, será necessário assinar o Pro/Max.
Passo 2: Selecione o Ambiente + Pasta do Projeto
Antes de enviar a primeira mensagem, quatro coisas devem ser configuradas na área do prompt:
- Environment (Ambiente): Selecione Local (roda na sua máquina, lendo e gravando arquivos diretamente). Você também verá Remote (nuvem) e SSH (sua própria máquina remota), use Local como a opção mais simples para começar.
- Folder (Pasta): Clique em Select folder, escolha um projeto pequeno que você conheça bem — não pegue um repositório gigantesco para testar.
- Modelo: No menu suspenso ao lado do botão de enviar, Opus / Sonnet / Haiku, qualquer um, pode mudar no meio da conversa.
- Modo de permissão: Mantenha no padrão de "solicitar permissão" (
default), mais estável para novatos.
Passo 3: Envie o primeiro comando
Na caixa de prompt, insira uma pequena tarefa específica, como o exemplo oficial:
Encontre um comentário TODO e corrija-oOu:
Crie um CLAUDE.md para esta base de código, e inclua a documentação do projetoPressione Enter para enviar.
Passo 4: Revise e aceite as alterações
Como é o modo de "solicitar permissão", o Claude não irá modificar o arquivo diretamente, ele primeiro vai gerar um diff. Você verá:
- Uma visualização de diff, mostrando onde ele vai alterar cada arquivo
- Os botões de Accept / Reject
- O progresso em tempo real enquanto o Claude processa
✅ Resultado esperado: Antes de você clicar em Aceitar, o arquivo no disco não será tocado. Esse é a sensação de segurança do modo de "solicitar permissão" — veja bem antes de consentir. Se você rejeitar, o Claude perguntará como você quer que ele modifique.
Passo 5 (Opcional): Mover uma conversa do terminal para o desktop
Se você estiver no meio de uma conversa com claude no terminal e decidir mudar para o app desktop, não precisa recomeçar. Na sua conversa do terminal, digite:
/desktopO Claude salvará a conversa atual, abrirá no app desktop, e então encerrará a CLI.
Nota: O
/desktopestá disponível apenas no macOS / Windows e só funciona quando você fizer o login com a assinatura Claude — logins com chaves de API, ou implantações em Bedrock / Vertex / Foundry não são compatíveis (consulte a documentação oficial como padrão).
08 Resumo
Este artigo explicou o terceiro ponto de entrada do Claude Code — o app desktop — claramente, com base nestas diretrizes fundamentais:
- É a versão completa do Claude Code com interface gráfica, não apenas um invólucro de chat: Usa o mesmo motor que o terminal e compartilha o CLAUDE.md e a configuração; basta procurar a aba Code.
- A instalação varia entre as três plataformas: Não tem no Linux; não é compatível com a conta gratuita (exige a partir do Pro/Max); o Windows exige o Git instalado antes de reiniciar o app.
- Três atrativos exclusivos: Isolamento automático via Git worktree em conversas paralelas; terminal integrado / editor de arquivos compartilhando o mesmo ambiente; as anotações visuais linha a linha em diff e o botão de auto-revisão pelo Claude.
- Os três têm suas utilidades específicas: Automação pela CLI, edição pela extensão da IDE e paralelismo + visualização no app desktop, você pode usá-los simultaneamente.
Neste momento, você deve ser capaz de: instalar o app desktop de forma independente no macOS / Windows, abrir várias conversas em paralelo e entender que elas estão isoladas via worktree, e usar o diff visual para revisar e anotar as mudanças do Claude, além de saber claramente quando deve retornar para o terminal. Ao dominar essas conversas em paralelo, trabalhar com vários requisitos ao mesmo tempo não será mais caótico.
Próximo artigo: 11 Versão Web e Nuvem (Web / Celular) — O que exatamente é o ambiente Remote no app desktop e a habilidade de checar o progresso via celular? Vamos explorar como deixar o Claude Code trabalhando na nuvem para você, mesmo sem o computador ligado ou quando estiver fora da sua estação.