Guia

Como usar o Claude Code no app Claude para desktop

Você não precisa de terminal para usar o Claude Code. O app Claude para desktop já vem com ele, na aba Code. Este guia mostra como iniciar uma sessão em uma pasta, controlar o que o Claude pode alterar, revisar as edições e rodar várias sessões ao mesmo tempo.

Atualizado em 30 de outubro de 2026

Resposta rápida: instale o app Claude para desktop, faça login e clique na aba Code no topo da barra lateral. Abaixo da caixa de mensagem, escolha um ambiente Local, clique no controle de pasta e escolha Open folder… (abrir pasta), depois digite sua tarefa e pressione Enter. É preciso um plano Pro, Max, Team ou Enterprise.

Antes de começar

A aba Code roda o mesmo motor do Claude Code da versão de terminal, só que com janelas e botões em vez de comandos digitados. Você indica uma pasta, dá uma tarefa e confere as edições na tela. O Claude Code vem dentro do app, então você não instala nada a mais.

Plano: a aba Code exige uma assinatura paga (Pro, Max, Team ou Enterprise). No Free, clicar em Code mostra um convite para fazer upgrade.
Sistema: macOS (uma versão para Intel e Apple Silicon), Windows x64 ou ARM64 e Linux em beta (Ubuntu e Debian, via apt ou um .deb).

Se o app ainda não está instalado, nosso guia sobre como instalar o app Claude para desktop explica cada sistema.

Inicie sua primeira sessão

Abra o Claude e faça login com sua conta da Anthropic.
Clique em Code no topo da barra lateral. Se as abas mostram só ícones, passe o mouse sobre elas para encontrá-la.
Veja a linha de controles abaixo da caixa de mensagem. Clique no primeiro, o seletor de ambiente, e escolha a primeira opção em Local.
Clique no controle de pasta ao lado, escolha Open folder… e selecione a pasta em que o Claude deve trabalhar. Um projeto pequeno que você conhece bem é o melhor primeiro teste.
Se quiser, escolha um modelo no seletor de modelo, mais à direita na mesma linha.
Descreva a tarefa com palavras simples, por exemplo "Explique o que este projeto faz" ou "Crie um CLAUDE.md com instruções para esta pasta", e pressione Enter.

Cada conversa na aba Code é uma sessão, com histórico, pasta e alterações próprios. Para parar o Claude, clique no botão de parar ou pressione Esc. Para mudar de direção sem parar, digite uma correção e pressione Enter; o Claude a lê assim que termina a ação atual.

Para indicar um arquivo específico, digite @ seguido do nome do arquivo na caixa de mensagem. Digite / para ver os comandos e skills disponíveis.

Escolha quanto o Claude pode fazer sozinho

O seletor de modo, também abaixo da caixa de mensagem, define quando o Claude para e pergunta a você. Em outubro de 2026, as opções são:

Modo	O que acontece
Manual	O Claude pergunta antes de cada edição e comando; você aprova ou recusa cada alteração.
Accept edits (aceitar edições)	Edições de arquivos e comandos simples de arquivos passam direto; os outros comandos ainda precisam da sua aprovação.
Plan (planejar)	O Claude explora e propõe um plano sem editar nada.
Auto	Sem perguntas de rotina; um classificador em segundo plano verifica as ações e bloqueia as arriscadas.
Bypass permissions (ignorar permissões)	Nenhuma pergunta, além das verificações de segurança. A Anthropic recomenda usar só dentro de contêineres isolados ou máquinas virtuais.

Um bom hábito que vem da documentação da Anthropic: comece uma tarefa maior em Plan, leia o plano e depois mude para Manual ou Accept edits para executá-lo. Você pode trocar de modo no meio da sessão com Cmd+Shift+M no Mac ou Ctrl+Shift+M no Windows. O app lembra o modo que você escolhe para cada pasta, exceto o Plan, que vale só para aquela sessão.

Revise o que o Claude alterou

Depois que o Claude edita arquivos, aparece um contador como +12 -1. Clique nele, ou em Changes (alterações) na barra de título, para abrir a visualização do diff.
Revise as alterações arquivo por arquivo. Para comentar uma linha, passe o mouse sobre ela, clique no + ao lado do número da linha, digite sua observação e pressione Enter.
Envie todos os comentários com Cmd+Enter (Ctrl+Enter no Windows). O Claude os lê e revisa o trabalho.

Para que o Claude confira o próprio trabalho, digite /code-review na caixa de mensagem. Em sessões locais, o resultado aparece como um cartão com os botões Walk through in diff (percorrer no diff) e Apply fixes (aplicar correções).

Rode várias sessões ao mesmo tempo

Nova sessão: clique em + New (novo) na barra lateral ou pressione Cmd+N (Ctrl+N no Windows). Alterne entre sessões com Ctrl+Tab.
Lado a lado: clique em uma sessão segurando Option (Alt no Windows), ou clique com o botão direito e escolha Open in > Split view (abrir em > visualização dividida).
Mantenha trabalhos paralelos separados: em um projeto Git, ative Worktree abaixo da caixa de mensagem antes de começar, e cada sessão recebe sua própria cópia isolada do projeto.
Pergunta rápida: pressione Cmd+; (Ctrl+; no Windows) para abrir um chat lateral que enxerga a sessão, mas não acrescenta nada a ela. Os chats laterais não são guardados depois que você fecha o app.
Organize: passe o mouse sobre uma sessão concluída, abra o menu dela e escolha Archive (arquivar).

Bom saber

Outros lugares para rodar: o seletor de ambiente também oferece Cloud (roda nos servidores da Anthropic e continua depois que você fecha o app), SSH (uma máquina remota) e, no Windows, WSL.
Uso: no Pro e no Max, o Claude Code e as conversas normais do Claude usam os mesmos limites de uso, e as sessões na nuvem também contam.
O terminal está lá se você quiser: pressione Ctrl+` para abrir um dentro da sessão, mas você nunca precisa usá-lo.
Extras: o botão + ao lado da caixa de mensagem adiciona conectores e plugins; gerencie-os em Customize (personalizar) na barra lateral.
As mesmas configurações em todo lugar: o CLAUDE.md, as configurações e os servidores MCP de uma pasta valem no app para desktop, no terminal e na web.

Se não funcionar

Clicar em Code mostra um convite para upgrade: sua conta está no Free. O Claude Code exige um plano pago.
Ele pede para fazer login online: conclua o login no navegador e reinicie o app.
Erro 403 ou de autenticação: saia da conta e entre de novo; a documentação do desktop da Anthropic tem uma seção de solução de problemas para esse erro.
Não há controle de ambiente abaixo da caixa de mensagem: você está com um layout antigo do app. Atualize o app; a documentação da Anthropic explica como verificar qual layout você tem.
Local aparece desativado: em uma conta de trabalho, sua organização pode ter desativado as sessões locais. Fale com o administrador.

Acompanhe o que cada sessão decidiu

Com várias sessões rodando, é fácil perder as decisões e os itens em aberto. O plugin do Workbranch para o Claude Code mostra o que ainda está em aberto quando uma sessão começa em uma pasta ligada a um projeto do Workbranch, e "save this to Workbranch" (salve isto no Workbranch) arquiva as tarefas e decisões da sessão por tema. Veja Workbranch para Claude.

Fontes

Use Claude Code with your Pro or Max plan (Central de Ajuda do Claude, consultado em 2026-10-30)
Get started with the desktop app (Claude Code Docs, consultado em 2026-10-30)
Use Claude Code Desktop (Claude Code Docs, consultado em 2026-10-30)
Claude Code overview (Claude Code Docs, consultado em 2026-10-30)

Perguntas frequentes

Preciso instalar o Node.js ou a CLI do Claude Code antes?

Não. O app para desktop já vem com o Claude Code, então a aba Code funciona sozinha. Instale a CLI só se também quiser rodar o claude em um terminal.

Posso levar uma sessão do terminal para o app para desktop?

Sim. Execute /desktop em uma sessão do terminal para continuá-la no app, onde o diff é mais fácil de revisar. A Anthropic diz que isso exige uma assinatura do claude.ai e funciona no macOS e no Windows x64.

Uma sessão continua rodando se eu fechar o app?

Sessões locais exigem o app aberto. Escolha um ambiente Cloud e a sessão roda na infraestrutura da Anthropic, continuando depois que você fecha o app; sessões na nuvem contam para os limites do seu plano.