A Anthropic lançou este mês uma prévia para desktop do Claude Code — um aplicativo desktop nativo que leva os fluxos de trabalho de codificação com agentes da Anthropic para fora do terminal e para um ambiente gráfico, com suporte integrado para executar várias sessões de codificação isoladas em paralelo. A prévia para desktop foi projetada para ficar ao lado das versões web e móvel do Claude Code e se concentra em dois problemas práticos de desenvolvedores: executar vários agentes de IA no mesmo repositório sem que um atrapalhe o outro, e facilitar o início de sessões locais ou em nuvem a partir de uma única GUI.
O que é o Claude Code no Desktop?
Claude Code no Desktop é o aplicativo desktop nativo (prévia) que permite aos desenvolvedores executar sessões do Claude Code localmente ou na infraestrutura de nuvem segura da Anthropic usando uma GUI em vez de apenas a CLI. Ele combina as principais capacidades de codificação com agentes do Claude Code com conveniências de desktop: gerenciamento de sessões, integração com o ambiente local e lançamento com um clique de sessões web. O aplicativo é explicitamente posicionado como um complemento às ofertas de CLI e web do Claude Code; ele inclui um runtime estável do Claude Code e gerencia versões para você, preservando uma experiência consistente e estável.
Por que isso importa? Historicamente, ferramentas de codificação com IA rodavam ou puramente no terminal (desenvolvedores confortáveis com fluxos de trabalho de CLI) ou puramente na nuvem (UIs de navegador). O app de desktop faz essa ponte ao possibilitar execuções locais de baixa latência e permitir que você troque perfeitamente para sessões hospedadas pela Anthropic (web) quando precisar de computação isolada em nuvem ou controles empresariais. A prévia para desktop é particularmente notável por suportar paralelismo de múltiplas sessões — você pode executar vários agentes Claude Code independentes no mesmo repositório simultaneamente, cada um em seu próprio worktree do Git (espaço de trabalho de branch isolado), para que os agentes não entrem em conflito. Esse é o recurso principal que muitas equipes acharão de utilidade imediata.
Como a edição desktop se relaciona com as versões web e CLI?
Claude Code começou como uma ferramenta de linha de comando e depois se expandiu para interfaces web e móveis; a prévia para desktop se baseia nesses fundamentos. O app de desktop espelha muitas das capacidades disponíveis na web (lançamento de sessões, conexões a repositórios, progresso visível), mas foca na ergonomia do fluxo de trabalho local — UX de desktop, instalação nativa e integrações mais estreitas com repositórios Git locais via worktrees — para que as sessões possam rodar simultaneamente sem interferir no estado de arquivos umas das outras.
Veja também Claude Code Web: o que é e como usar
7 excelentes recursos do Claude Code no Desktop
1) Paralelismo de múltiplas sessões
Claude Code para Desktop suporta a execução de várias sessões Claude independentes ao mesmo tempo. Isso significa que você pode ter uma sessão focada em um bugfix, outra escrevendo testes e uma terceira gerando documentação — todas executando simultaneamente em vez de enfileiradas em uma única sessão. Esse paralelismo acelera os fluxos de trabalho e permite delegar tarefas diferentes de forma concorrente.
Por exemplo:
Suponha que você tenha um projeto chamado my-app e queira:
- Fazer o Claude alterar a homepage em uma janela;
- Fazer o Claude otimizar a lógica do banco de dados em outra janela.
Claude Desktop criará automaticamente para você:
~/.claude-worktrees/my-app/homepage/
~/.claude-worktrees/my-app/database/
Duas cópias independentes (sem conflito). Isso é como executar dois branches de desenvolvimento simultaneamente, com o Claude cuidando de cada um para você.
2. .worktreeinclude: Tornar o Claude ciente de arquivos ignorados
Às vezes seu projeto tem arquivos como .env ou .local, que geralmente são ignorados por .gitignore e não serão copiados para o diretório de trabalho do Claude. Arquivos listados em .gitignore não são copiados automaticamente para novos worktrees. Claude fornece um novo mecanismo: você pode criar um arquivo .worktreeinclude no diretório raiz do projeto, informando quais arquivos precisam ser copiados — uma lista no estilo .gitignore especificando quais arquivos ignorados devem ser copiados para worktrees recém-criados (por exemplo, arquivos .env locais ou configurações específicas de desenvolvedor). Somente arquivos que aparecem tanto em .worktreeinclude quanto em .gitignore são copiados, o que evita duplicar acidentalmente arquivos rastreados. Isso é crítico para preservar arquivos de segredo ou ambiente por sessão sem colocá-los no Git.
Por exemplo:
.env
.env.local
.env.production
**/.claude/settings.local.json
Isso significa: quando o Claude criar o diretório de trabalho, esses arquivos também serão copiados.
Observação:
- Apenas arquivos que existem tanto em .gitignore quanto em .worktreeinclude serão copiados;
- Evite copiar acidentalmente arquivos rastreados importantes.
3) Inicie e sincronize com sessões web/nuvem
O app de desktop pode atuar como um lançador para sessões web/nuvem — ou seja, você pode iniciar sessões do Claude Code baseadas em nuvem a partir da UI de desktop e monitorá-las ou orientá-las localmente. Esse modo híbrido é útil se você quiser a conveniência de controles locais com o modelo de escalabilidade ou permissões de execuções hospedadas na nuvem.
Observação:
- Ao executar na nuvem, as tarefas do Claude serão executadas no servidor de segurança da Anthropic.
- A troca entre ambientes local e em nuvem é perfeita.
- Para criar uma sessão, basta selecionar "ambiente remoto".
4) Inicie e sincronize com sessões web/nuvem
O app de desktop pode atuar como um lançador para sessões web/nuvem — ou seja, você pode iniciar sessões do Claude Code baseadas em nuvem a partir da UI de desktop e monitorá-las ou orientá-las localmente. Esse modo híbrido é útil se você quiser a conveniência de controles locais com o modelo de escalabilidade ou permissões de execuções hospedadas na nuvem (local para tarefas rápidas, nuvem para tarefas arriscadas ou que exigem muitos recursos).
5) Versão integrada e configuração para empresas
O Desktop inclui um runtime estável do Claude Code que é baixado no primeiro lançamento e gerenciado automaticamente. Admins corporativos podem desabilitar o uso local do Claude Code, se necessário (isClaudeCodeForDesktopEnabled política empresarial). Os instaladores de desktop suportam formatos comuns de implantação corporativa (MSIX para Windows, PKG para macOS), e administradores podem controlar atualizações e acesso a extensões. Esses controles foram projetados para facilitar a adoção por grandes equipes.
Observação:
- O aplicativo será baixado automaticamente na primeira abertura;
- O aplicativo desktop gerencia automaticamente atualizações de versão;
- Ele limpa automaticamente versões antigas para manter o sistema limpo;
- Mesmo que você tenha a versão CLI instalada em seu computador, ele ainda usará sua própria versão (para maior estabilidade).
- A versão desktop prioriza estabilidade e compatibilidade; a CLI (versão de linha de comando) pode atualizar mais rápido, mas novos recursos podem não ser imediatamente sincronizados com a versão desktop.
6) Variáveis de ambiente personalizadas
Claude Desktop permite definir variáveis como em arquivos .env.
Essas variáveis só têm efeito dentro da sessão do Claude, tornando-as ideais para configuração de projeto.
Por exemplo:
API_KEY=abcd123
DEBUG=true
CERT="-----BEGIN CERT-----
MIIE...
-----END CERT-----"
7) Integração com ferramentas e ambientes locais
Ao executar sessões locais, o app de desktop extrai seu $PATH do shell para que os processos da sessão possam usar o mesmo node, npm, yarn, Python ou outras ferramentas de CLI das quais você depende. Ele também fornece uma UI para adicionar variáveis de ambiente personalizadas (no formato .env), com valores mascarados para segurança. Isso torna mais suave a execução de testes ou builds dentro de uma sessão com agentes, porque o agente pode invocar a mesma cadeia de ferramentas do seu terminal.
Como instalar o Claude Code no Desktop?
Esta seção apresenta o processo de instalação com o mínimo de atrito. As instruções abaixo são atuais para a prévia de desktop e apontam para os instaladores canônicos.
Pré-requisitos e configuração de conta
- Conta Anthropic e workspace: Claude Code se integra ao Anthropic Console. Você precisará concluir um fluxo de OAuth no Claude Console e ter cobrança ativa ou acesso de pesquisa em prévia conforme exigido pelo modelo de workspace da Anthropic. Claude Code usa um workspace interno no console para rastrear o uso; você não pode criar chaves de API para esse workspace — ele é gerenciado para uso do Claude Code.
- Git e prontidão do repositório: Garanta que o Git esteja instalado e que o projeto no qual deseja operar seja um repositório Git (ou inicialize o Git). O app de desktop espera repositórios válidos para recursos como worktrees; se você abrir uma pasta sem Git inicializado, um worktree não será criado.
- Específicos de SO: Instalações macOS e Linux são geralmente binários nativos; usuários Windows são recomendados a usar WSL para compatibilidade completa de comandos em muitos fluxos de trabalho. Alguns guias da comunidade abordam configurações avançadas de Windows/WSL caso você enfrente problemas de PATH ou de distribuição.
Instalação passo a passo (curta)
- Abra a página de Download do Claude e escolha o instalador correto para sua plataforma.
- Execute o instalador (PKG no macOS, MSIX ou EXE no Windows). Para parques corporativos, use os pacotes MSIX/PKG fornecidos para implantação centralizada.
- Inicie o app Claude Desktop e faça login com sua conta Anthropic/Claude. Suas conversas e preferências são sincronizadas entre desktop, web e mobile.
- No primeiro lançamento, o app fará download de um runtime integrado do Claude Code. Permita que esse download seja concluído; ele é necessário e garante que uma versão estável e gerenciada seja usada.
Verificações pós-instalação
• Abra Configurações > Ambientes e confirme que o app de desktop extraiu seu $PATH do shell.
• Escolha se deseja habilitar sessões locais (se sua máquina e política permitem) ou se seu fluxo de trabalho criará sessões web em vez disso.
Métodos de instalação opcionais, caso prefira
- Instalador nativo (recomendado): Use o instalador nativo do SO para a experiência mais simples e integrada.
- Homebrew (macOS): Conveniente para usuários macOS que gerenciam apps com Homebrew.
- Instaladores via NPM ou scripts: Úteis para configurações mais automatizadas ou com script (CI ou provisionamento), ou para distribuições Linux onde se prefere um script de instalação simples.
Instalação: macOS, Linux, WSL (fluxo recomendado)
- Baixe o instalador da prévia de desktop na página de downloads do Claude Code (a documentação dentro do produto fornece o link do instalador).
- Execute o instalador e abra o app de desktop Claude.
- Conclua o login via OAuth pelo fluxo do Claude Console dentro do app.
- Configure o local padrão do worktree e as preferências de execução local/remota nas configurações do desktop.
- Abra uma pasta de projeto ou clone um repositório pela UI para começar.
Abra um terminal e, se confiar na fonte, execute o script de instalação fornecido pela Anthropic (esta é a opção de conveniência típica recomendada). Exemplo (parafraseado):
# macOS / Linux / WSL (exemplo de instalador de conveniência)
curl -fsSL https://claude.ai/install.sh | bash
Alternativamente, se você preferir Homebrew no macOS:
brew install --cask claude-code
Instalação: Windows
WSL：
- Instale o WSL (Ubuntu é comum) e configure um ambiente WSL limpo. Resolva problemas de PATH e interoperabilidade para que a integração do WSL pelo app de desktop possa acessar a distro.
- Instale Git e quaisquer runtimes de linguagem no WSL que o Claude possa precisar para execuções locais (node, python etc.).
- Instale ou execute o app de desktop no Windows, aponte-o para seu diretório de projeto no WSL (ou inicie o app de desktop dentro do WSL se suportado) e siga o mesmo fluxo de OAuth.
Exemplo PowerShell (parafraseado):
# PowerShell (exemplo de instalador de conveniência)
irm https://claude.ai/install.ps1 | iex
Exemplo CMD (parafraseado):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Como usar o Claude Code no Desktop na prática diária?
Quais são os padrões recomendados de criação de sessões?
Tarefas curtas e independentes vs refatorações de longa duração
- Para tarefas curtas e com escopo definido (bugfix, alteração de arquivo único, pequena refatoração), crie uma sessão por tarefa e deixe o Claude produzir um commit focado. Revise e faça o merge prontamente.
- Para esforços de longa duração (grandes refatorações, desenvolvimento de recursos), considere criar uma sessão que faça checkpoints com frequência e use os controles de progresso da UI de desktop para orientar ou pausar o trabalho. Mantenha sessões em branches de feature para evitar merges acidentais.
Mantenha um CLAUDE.md ou um template de prompt no seu repositório para padronizar como as sessões devem ser instruídas (contexto, testes a executar, regras de estilo). Essa prática reduz a variabilidade e ajuda o Claude a produzir resultados consistentes entre sessões. Muitas equipes armazenam prompts padrão ou guardrails em metadados do repositório para garantir comportamento previsível dos agentes.
Iniciar e nomear uma sessão
- Abra o app de desktop e selecione ou clone um repositório.
- Clique em “New Session” (ou equivalente) e dê à sessão um nome descritivo (por exemplo,
bugfix/cs-142ouadd-tests-login). A nomeação ajuda a distinguir sessões simultâneas na UI. - Escolha execução local ou remota, selecione um branch alvo (ou deixe o agente criar um branch em um novo worktree) e inicie a sessão. O app cria automaticamente um worktree do Git dedicado para a sessão.
Orientando o agente: prompts e tarefas
- Use prompts claros e com escopo definido. Exemplo: “Encontre o teste de unidade que está falhando para
AuthServicee crie uma correção que preserve a API pública existente; execute os testes e apresente os resultados.” - Para tarefas incrementais, peça ao Claude para gerar primeiro um plano (uma checklist curta) e depois solicite as alterações específicas de código passo a passo. O progresso incremental reduz o risco de alucinações e torna os diffs mais fáceis de revisar. A Anthropic recomenda essa abordagem como boa prática.
Acompanhando o progresso e interagindo
A UI de desktop mostra logs de ações e diffs conforme o agente trabalha. Você pode pausar uma sessão, alterar instruções ou cancelar um job em execução. Quando o agente propõe edições, a UI exibe diffs de arquivos e uma explicação do que mudou. Aprove, edite ou rejeite os diffs propostos antes do commit.
Fluxos de commit, branch e PR
Depois de aprovar as alterações, o app de desktop pode fazer commit no branch do worktree da sessão. A partir daí, você pode fazer push para a origem e abrir um pull request pela UI (se tiver autorizado o acesso ao GitHub). O branch de cada sessão permanece isolado até você fazer o merge, o que mantém a revisão humana simples.
Como o isolamento do Git e o paralelismo de múltiplas sessões realmente funcionam?
Worktrees do Git: o mecanismo de isolamento
O desktop da Anthropic usa worktrees do Git para criar cópias por sessão da árvore de trabalho de um repositório vinculadas a branches separados. Worktrees são mais leves do que clones completos — compartilham os metadados .git quando apropriado, mas fornecem diretórios de trabalho independentes para que edições concorrentes não entrem em conflito nem vazem entre sessões. O desktop coloca esses worktrees criados automaticamente em um diretório configurável (padrão ~/.claude-worktrees). Esse design possibilita concorrência segura para operações com agentes.
Por que worktrees em vez de clones
Worktrees são mais rápidos de criar e mais fáceis de correlacionar com o mesmo histórico subjacente do Git, ao mesmo tempo em que proporcionam a separação de sistema de arquivos necessária para evitar contaminação entre sessões. Para a maioria dos fluxos de trabalho, isso é preferível a múltiplos clones completos; entretanto, se você precisar de ambientes de runtime totalmente isolados com dependências diferentes, um clone separado ou um contêiner ainda pode ser desejável.
Coordenação e tratamento de conflitos
Como cada sessão trabalha em um branch/worktree isolado, conflitos são minimizados. Se duas sessões alterarem independentemente o mesmo código lógico e ambas forem mescladas no mesmo branch alvo depois, o tratamento normal de conflitos de merge do Git se aplicará — que é o ponto correto para revisão e resolução humana. O modelo da Anthropic intencionalmente apresenta commits como PRs revisáveis, mantendo humanos no ciclo de merge.
Etapas comuns de solução de problemas e limitações
Se uma sessão não iniciar ou travar
- Confirme que tokens de acesso ao repositório são válidos e não estão com limites de taxa excedidos.
- Verifique espaço em disco local e permissões para o diretório de worktrees (por exemplo,
~/.claude-worktrees). - Revise os logs do app de desktop em busca de mensagens de erro; o app geralmente expõe uma visão de diagnósticos ou arquivo de log.
Se sessões contaminarem umas às outras
- Confirme que o app de desktop está criando worktrees separados (inspecione o diretório
~/.claude-worktreesou o local de worktree definido nas preferências do app). - Se você vir estado compartilhado, garanta que está usando a prévia de desktop mais recente ou consulte a documentação da Anthropic — esta versão aborda especificamente o isolamento de sessões.
Se arquivos ignorados não estiverem disponíveis nas sessões
Adicione os nomes de arquivo à sua configuração .worktreeinclude (ou ao equivalente na UI do desktop) para que o app copie com segurança os arquivos ignorados necessários (por exemplo, .env) em cada worktree. Evite armazenar segredos em, ou expô-los a partir de, worktrees sem gerenciamento apropriado de segredos.
Conclusão
A prévia para desktop do Claude Code representa uma evolução significativa na forma como ferramentas de codificação com agentes se encaixam nos fluxos de trabalho de desenvolvedores: ela mantém a velocidade e a expressividade de agentes de IA ao mesmo tempo em que resolve vários problemas práticos de coordenação que desenvolvedores enfrentam quando vários agentes precisam operar no mesmo codebase. Quer você a adote para produtividade de um único desenvolvedor ou para coordenar várias tarefas com agentes em uma equipe, entender worktrees do Git, .worktreeinclude e a distinção entre sessões locais vs. web tornará sua primeira semana com a prévia de desktop muito mais produtiva.
Pronto para usar o Claude Code CLI? Consulte o guia de API para instruções detalhadas.
Desenvolvedores podem acessar Claude Opus 4.5 API etc. por meio da CometAPI; a versão de modelo mais recente é sempre atualizada com o site oficial. Para começar, explore os recursos do modelo no Playground e consulte o guia de API para instruções detalhadas. Antes do acesso, certifique-se de ter feito login na CometAPI e obtido a chave de API. A CometAPI oferece um preço muito inferior ao preço oficial para ajudar você a integrar.
Pronto para começar? → Teste gratuito do Claude opus 4.5!
Se quiser saber mais dicas, guias e notícias sobre IA, siga-nos no VK, X e Discord!