Pular para o conteudo
Voltar aos artigos
claude-codedesktop-appguiworkflowanthropic

Claude Code Desktop: a GUI chegou pra quem não curte terminal

App para Mac e Windows troca o terminal por janelas e cliques: sessões paralelas, diff visual, preview integrado e modos de permissão. Sem perder o engine do CLI.

11 min de leitura

Claude Code Desktop: a GUI chegou pra quem não curte terminal

App nativo para Mac e Windows substitui o terminal por janelas e cliques, mantém o mesmo engine do CLI, e adiciona coisas que a linha de comando não consegue entregar.

Contexto: o prompt preto espanta muita gente

Você abre um tutorial de Claude Code. A primeira imagem é uma tela preta com $ piscando. Para quem cresceu clicando em ícone e arrastando janela, aquilo parece um retorno involuntário aos anos 80. Desiste antes de instalar.

Essa barreira sempre existiu. Quem programa convive bem com terminal, mas a maioria das pessoas que quer criar um app com IA, incluindo designers, product managers, pessoas de negócio e gente totalmente não técnica, não tem esse costume. Em 14 de abril de 2026, a Anthropic reconstruiu a GUI do Claude Code de alto a baixo, trazendo sessões paralelas, workspace com drag-and-drop e uma experiência desenhada para operar fora do terminal.

O que é o Claude Code Desktop

É uma aba chamada Code dentro do aplicativo Claude Desktop. O app tem três abas:

Aba Função
Chat Conversa geral sem acesso a arquivos, igual ao claude.ai
Cowork Agente autônomo em VM na nuvem, roda em segundo plano
Code Assistente interativo com acesso direto aos seus arquivos locais

A aba Code é o Claude Code com interface gráfica. Mesmo engine do CLI, mesma configuração (CLAUDE.md, MCP, skills, hooks), só que com sidebar, painéis, diff visual, browser embutido e botões para aceitar ou rejeitar cada alteração.

Plataformas suportadas:

  • macOS (build universal para Intel e Apple Silicon)
  • Windows x64
  • Windows ARM64 (instalador separado)
  • Linux: não suportado

Plano necessário: Pro, Max, Team ou Enterprise. O plano gratuito abre o Chat mas não desbloqueia a aba Code.

O download é um .dmg ou instalador .exe normal. Sem Node.js, sem npm, sem WSL, sem variáveis de ambiente. Baixa, instala, loga com a conta Anthropic, clica em Code.

Não é só um frontend do CLI

A escolha óbvia seria transformar cada comando do CLI em botão. A Anthropic foi além. A aba Code resolve coisas que o terminal simplesmente não consegue entregar bem.

Sessões paralelas com Git worktree automático

Clique em + New session na sidebar. Cada sessão ganha uma cópia isolada do projeto via Git worktree, sem você configurar nada. Uma sessão refatorando auth, outra corrigindo bug de pagamento, outra escrevendo testes, todas no mesmo projeto, sem conflito, sem git stash, sem se pisarem. Quando o PR é mergeado, a sessão arquiva sozinha se você ativar Auto-archive after PR merge or close.

No CLI isso existe (a v2.1.49 trouxe suporte nativo a worktrees), mas exige configuração e múltiplos terminais em paralelo. No Desktop, é o padrão: clicou em nova sessão, ganhou worktree.

Diff visual com comentário inline

Depois que o Claude edita arquivos, aparece um indicador tipo +12 -1. Clique e abre o diff lado a lado com a lista de arquivos à esquerda. Clicar em uma linha abre um comentário. Escreve, pressiona Cmd+Enter (ou Ctrl+Enter no Windows) e envia todos os comentários de uma vez. O Claude lê e revisa. É a mesma dinâmica de code review do GitHub, dentro do próprio app.

Preview integrado

O app inicia o dev server do seu projeto e embute o browser na lateral. Clicou em um arquivo HTML no chat, abre no preview. Pediu pra ajustar o layout, ele edita e você vê na hora. Quando autoVerify está ligado (padrão), depois de cada edição o Claude tira print, inspeciona o DOM, clica em elementos e confirma que a mudança funcionou antes de devolver o controle pra você.

Para dev server customizado, edita .claude/launch.json:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

Monitoramento de PR com auto-fix e auto-merge

Depois que você (ou o Claude) abre um pull request, aparece uma barra de status de CI na sessão. Dois toggles:

  • Auto-fix: o Claude lê o log da falha e tenta corrigir sozinho
  • Auto-merge: quando todas as checks passam, o PR é squash-merged automaticamente

Requer o gh (GitHub CLI) instalado e autenticado. Se não estiver, o app pede pra instalar na primeira vez.

Computer use (research preview)

Claude pode abrir aplicativos, clicar na sua tela e controlar o mouse. Útil para testar app nativo em simulador mobile, preencher ferramentas de desktop sem CLI, ou automatizar algo que só funciona via GUI. Está desligado por padrão e precisa ser ativado em Configurações → Geral. No macOS, também exige permissões de Acessibilidade e Gravação de Tela.

Disponível apenas nos planos Pro ou Max, em macOS e Windows. Fora de Team e Enterprise.

Chat lateral que não contamina o thread principal

Pressiona Cmd+; (ou Ctrl+; no Windows). Abre um chat lateral que enxerga tudo do chat principal até aquele ponto, mas cuja resposta não volta pra conversa principal. Serve para perguntar "por que esse arquivo existe?", validar uma suposição ou explorar uma ideia, sem poluir o contexto da tarefa que o Claude está fazendo.

Modos de permissão: controle sem comando

O botão ao lado de Enviar tem cinco níveis de autonomia:

Modo Comportamento
Ask permissions Pergunta antes de cada edição ou comando. Padrão para quem está começando.
Auto accept edits Aceita automaticamente edição de arquivo e comandos tipo mkdir, touch, mv. Ainda pergunta para outros comandos.
Plan mode Explora o projeto e propõe um plano sem editar nada. Ótimo antes de refatoração grande.
Auto Executa tudo com checagens de segurança em segundo plano. Research preview. Em Max, requer Opus 4.7; em Team, Enterprise e API aceita Sonnet 4.6, Opus 4.6 ou Opus 4.7. Fora de Pro e provedores terceiros.
Bypass permissions Sem prompt algum. Equivalente ao --dangerously-skip-permissions do CLI. Só em container ou VM.

Recomendação da própria doc: começa em Plan mode para tarefas complexas, aprova o plano, e só depois troca para Auto accept ou Ask.

Para quem é (e para quem não é)

É para:

  • Quem nunca usou terminal e quer começar a construir com IA sem aprender cd e ls primeiro
  • Dev que prefere revisar diff lado a lado em vez de ler patches no terminal
  • Quem roda múltiplas tarefas em paralelo e não quer gerenciar worktrees na mão
  • Times em Mac ou Windows
  • Trabalhos visuais: landing page, dashboard, app frontend, onde ver o preview ao lado acelera tudo

Não é para:

  • Usuário Linux (sem suporte oficial)
  • Plano gratuito (precisa de assinatura paga)
  • Automação em CI ou pipelines (o CLI continua sendo a ferramenta certa)
  • Fluxos que dependem de dontAsk (esse modo só existe no CLI)

Repercussão na comunidade

O redesign foi anunciado em 14 de abril de 2026 e gerou repercussão imediata no Twitter/X. O print que mais circulou foi o de duas sessões do Claude Code rodando lado a lado na mesma janela, com um comentário recorrente: a Anthropic cruzou uma fronteira que os concorrentes estão longe, transformando Claude Code de "AI pair programmer" em algo mais próximo de "AI operations platform".

A crítica mais comum não foi sobre o app em si e sim sobre consumo de token. The New Stack publicou a manchete "Anthropic's redesigned Claude Code desktop app lets you burn through tokens even faster", e usuários no Reddit e GitHub reportaram que sessões que antes duravam horas estavam esgotando os limites em minutos. A combinação de sessões paralelas, auto-verify após cada edição e PR monitoring consome contexto rápido. O Desktop facilita tanto rodar várias coisas ao mesmo tempo que é fácil perder a conta.

No r/ClaudeAI o sentimento geral ficou positivo sobre as features (worktree automático foi o ponto mais celebrado) e negativo sobre o custo. VentureBeat avaliou o redesign como o primeiro sinal sério de que a Anthropic agora trata o app gráfico como workspace primário, não mais como extensão do CLI.

Na Prática

Passo a passo para instalar e rodar a primeira sessão local:

1. Baixe o instalador

Acesse claude.com/download e escolha sua plataforma. No Windows, confirme se você está em x64 ou ARM64 e baixe o correto.

2. Instale Git (se estiver no Windows)

Sem Git, a aba Code não funciona em sessões locais. Baixe em git-scm.com/downloads/win. No Mac, Git normalmente já vem instalado. Verifique com:

git --version

3. Abra o Claude, logue e clique em Code

Use sua conta Anthropic. Se aparecer prompt de upgrade ao clicar em Code, seu plano ainda não desbloqueia a aba. Se pedir pra entrar online, complete o login no browser e reinicie o app.

4. Configure a sessão

Na caixa de prompt, escolha:

  • Ambiente: Local (para rodar na sua máquina)
  • Pasta do projeto: clique em "Select folder" e aponte para um repositório existente
  • Modelo: escolha no dropdown ao lado do botão enviar
  • Modo de permissão: comece em Ask permissions

5. Escreva a primeira tarefa

Comece pequeno. Algo como:

Leia o README e crie um CLAUDE.md resumindo os padrões de código do projeto

Pressione Enter. O Claude vai propor edições e mostrar cada diff antes de aplicar. Aceite ou rejeite uma por uma.

6. Abra uma segunda sessão em paralelo

Clique em + New session na sidebar ou pressione Cmd+N (Mac) / Ctrl+N (Windows). Escolha a mesma pasta. Essa nova sessão vai rodar em worktree isolado, sem pisar na primeira. Pra alternar entre sessões, use Ctrl+Tab.

Dica: o atalho Cmd+/ (ou Ctrl+/ no Windows) mostra todos os atalhos disponíveis. Vale olhar uma vez antes de começar.

Limites que você vai esbarrar

  • Linux fora: só macOS e Windows. Usuários de Ubuntu, Fedora e companhia seguem com CLI ou Claude Code na web.
  • Sessões remotas têm menos features: o modo Ask permissions não existe lá (elas aceitam edits automaticamente), e @mention de arquivo não funciona.
  • Painel de terminal só em sessão local: em SSH ou sessão remota, o Ctrl+` não traz terminal.
  • Computer use tem pré-requisitos: Pro ou Max, macOS ou Windows, ativação explícita, e no Mac permissões do sistema.
  • Layout novo exige versão atualizada: o workspace drag-and-drop requer Claude Desktop v1.2581.0 ou posterior. Use Claude → Check for Updates (Mac) ou Help → Check for Updates (Windows).

CLI não morreu, ganhou um vizinho

O Desktop não substitui o terminal. Roda o mesmo engine, lê o mesmo CLAUDE.md, reconhece as mesmas skills, chama os mesmos MCP servers. Você pode abrir o terminal e o Desktop ao mesmo tempo no mesmo projeto. No próprio app, o botão Continue in envia a sessão atual para a web ou para o VS Code com um clique.

A diferença está em quem você é e no que você está fazendo. Automação em CI, script em pipeline, pipe de tail com claude -p? CLI. Revisar diff visual, rodar três experimentos em paralelo, ver o preview do app lado a lado, testar algo sem sair da janela? Desktop.

Resultado Final

Em pouco mais de uma semana desde o redesign, o Claude Code Desktop entregou:

  • Uma porta de entrada real para quem trava no terminal
  • Sessões paralelas com worktree automático sem configuração
  • Diff visual, preview embutido, terminal integrado e PR monitoring no mesmo app
  • Mesmo engine do CLI, então tudo que você já configurou (CLAUDE.md, MCP, skills) funciona sem ajuste
  • Computer use em research preview para quem precisa controlar app nativo
  • E uma discussão aberta sobre quanto de token isso consome, que vale acompanhar antes de virar padrão do time

Se o terminal era o motivo pelo qual você adiou testar o Claude Code, o motivo acabou.

Referências