Guia de Configuração Inicial do Aplicativo Desktop Claude Code

@dansyu_callenge
JAPONÊShá 2 meses · 14/05/2026
464K
476
43
15
1.7K

TL;DR

Este guia aborda as quatro áreas críticas de configuração para o aplicativo desktop Claude Code, incluindo permissões de segurança, privacidade de dados e o uso do CLAUDE.md para evitar erros de IA e garantir uma automação segura.

Você está começando a usar o Claude Code imediatamente após a instalação? Sinceramente, isso é arriscado.

O Claude Code é uma IA que lê e escreve arquivos, executa comandos, reescreve código e pode até criar Pull Requests. Em outras palavras, não é apenas um interlocutor; é uma entidade que realmente realiza ações no seu PC.

Começar sem verificar as configurações é como dizer a um novo contratado: "Não há regras específicas, então faça o que quiser." Quanto mais capacitado o funcionário, mais ele agirá por conta própria se não houver regras. A IA é a mesma coisa.

Eu pessoalmente abri todas as telas de configuração do aplicativo de desktop Claude Code e as verifiquei uma por uma. Há uma distinção clara entre configurações que você definitivamente deve verificar e aquelas que não precisa mexer desde o início.

Ao ler este artigo, você saberá onde procurar nas configurações do aplicativo de desktop Claude Code, quais configurações alterar e quais ignorar.

O menu de configurações do aplicativo de desktop Claude Code tem muitos itens: Geral, Notificações, Personalização, Aplicativos, Agenda, Faturamento, Controle de Dados, Armazenamento, Segurança, Controles Parentais e Conta. Abaixo deles estão Privacidade, Uso, Funcionalidades, Conectores, Claude Code, Cowork e Claude no Chrome. Mais abaixo, na seção "Aplicativo de Desktop", estão Geral, Extensões e Desenvolvedor.

Sinceramente, é muita coisa. Mas há apenas quatro lugares que você precisa verificar primeiro.

  1. Aplicativo de Desktop "Geral"
  2. "Privacidade"
  3. "Claude Code"
  4. Modo de Permissão e CLAUDE.md no início de uma sessão

Você não precisa mexer no restante inicialmente.

1. Aplicativo de Desktop "Geral": Construindo uma Base para o Uso Seguro

Role o menu lateral até a seção "Aplicativo de Desktop" e abra "Geral". Essa é a base para usar o Claude Code com segurança.

Executar na Inicialização

Isso determina se o Claude Code inicia automaticamente quando você faz login. Mantenha desligado por enquanto. Você pode ativá-lo quando começar a usá-lo diariamente.

Atalho de Acesso Rápido

Um atalho para enviar mensagens ao Claude de qualquer lugar. O padrão é "Duplo toque na tecla Option". Verifique se não há conflitos com outros aplicativos.

Atalho de Voz

Um atalho para falar com o Claude. O padrão é "Nenhum". A entrada por voz é muito útil para dar instruções detalhadas, como:

  • "Verifique este conteúdo, mas não faça nenhuma alteração ainda."
  • "Sempre me mostre o diff antes de alterar qualquer coisa."
  • "Apenas encontre a causa deste erro. Nenhuma correção necessária ainda."

O Claude Code pode ir longe demais se as instruções forem vagas. Poder dar instruções frequentes por voz é mais seguro.

Barra de Menu

Se deve mostrar o Claude na barra de menu. Deixar ativado é tranquilo.

Evitar que o Computador Durma

Isso é surpreendentemente importante. Se o seu PC dormir enquanto o Claude está executando uma tarefa longa, o trabalho para. Se você estiver deixando ele lidar com tarefas demoradas, como revisão de múltiplos arquivos ou reescrita de código, mantenha isso ativado. Está ativado por padrão.

Uso do Navegador

A partir daqui, são configurações relacionadas a permissões. Tenha cuidado. Ativar "Permitir todas as ações do navegador" permite que o Claude navegue e opere em qualquer site no Chrome sem confirmação. A tela de configurações avisa que isso pode colocar os dados em risco. Recomendo manter desligado inicialmente. Se ativar, feche abas desnecessárias e tenha cuidado extra com páginas que exibem e-mails, pagamentos ou informações de clientes.

Uso do Computador (Beta)

Isso é crítico. Quando ativado, o Claude pode tirar capturas de tela e operar seu teclado e mouse em aplicativos autorizados. Está desligado por padrão. Mantenha desligado por enquanto. Se ativar, o macOS exige permissões de "Acessibilidade" e "Gravação de Tela".

Aplicativos Bloqueados

Registre aplicativos que você não quer que o Claude acesse. Se você usar o Uso do Computador, adicione clientes de e-mail, gerenciadores de senhas e ferramentas confidenciais internas aqui.

2. Privacidade: Verificando o Tratamento de Dados

Metadados de Localização

Permite que o Claude use dados aproximados de localização para melhorar a experiência. Isso é opcional.

Ajude a Melhorar o Claude

Permite que seus dados de chat e código sejam usados para treinar os modelos da Anthropic. Se você lida com código de clientes ou projetos confidenciais, é mais seguro desligar isso. Está desligado por padrão, mas verifique novamente.

3. Claude Code: Definindo o Comportamento da Sessão e PR

Classificação do Estado da Sessão

Permite que o Claude classifique automaticamente as sessões como bloqueadas, pendentes de revisão ou concluídas. Mantenha ativado para acompanhar várias sessões paralelas.

Permitir Ignorar Modo de Permissão

Aviso: Isso ignora todas as verificações de permissão. É de alto risco e pode levar à perda de dados ou danos ao sistema. Mantenha desligado. Não use fora de sandboxes ou VMs.

Localização da Worktree

O aplicativo de desktop isola automaticamente uma cópia de trabalho em uma Git worktree para cada nova sessão. Isso impede que alterações na Sessão A afetem a Sessão B. O padrão é "Dentro do projeto (.claude/w...)".

Crucialmente, lembre-se do .worktreeinclude. Arquivos ignorados pelo git (como .env) não são copiados para as worktrees automaticamente. Se você receber erros sobre variáveis de ambiente ausentes, crie um arquivo .worktreeinclude na raiz do projeto e especifique os arquivos a serem copiados.

Automação de Pull Request

Há configurações para criar PRs automaticamente e corrigir automaticamente falhas de CI. Mantenha isso desligado inicialmente. É mais seguro verificar o conteúdo do PR você mesmo primeiro.

Arquivamento Automático após Merge/Fechamento de PR

Recomendo ativar isso. Evita que sessões concluídas acumulem na sua barra lateral.

4. Modo de Permissão e CLAUDE.md: Verifique Cada Sessão

Modo de Permissão

Selecione isso ao lado do botão de envio no início de uma sessão. Determina o quanto o Claude pode fazer por conta própria.

  • Solicitar permissões: Confirma todas as edições de arquivos e comandos. Melhor para iniciantes entenderem como o Claude funciona.
  • Aceitar edições automaticamente: Aceita automaticamente edições de arquivos e operações básicas. Acelera o trabalho quando você confia no julgamento do Claude.
  • Modo de planejamento: Lê arquivos e executa comandos para investigar, mas não edita código. Use isso para obter um plano primeiro antes de mudar para Aceitar edições automaticamente.
  • Auto: Quase totalmente automático. Apenas para planos Max/Team/Enterprise/API. Não comece com isso; o Claude pode interpretar mal as instruções e reescrever demais.

CLAUDE.md

Se o Modo de Permissão é "o quanto ele pode fazer", o CLAUDE.md é "como você quer que seja feito". Coloque este arquivo na raiz do projeto. O Claude o lê no início de cada sessão. Use para:

  1. Comandos básicos do projeto (build, test, dev).
  2. Regras (ex.: "Sempre mostre o diff antes de alterar", "Não mude a estrutura de arquivos").
  3. Regras de correção (adicione uma linha sempre que o Claude cometer um erro para evitar que aconteça novamente).

Mantenha abaixo de 100 linhas. Use /init em uma sessão para gerar um automaticamente.

Resumo

O Claude Code não é apenas uma IA de chat; é um agente operando no seu PC. Gastar 10 minutos nas configurações faz a diferença entre ser controlado pela IA e ser o controlador. Não diga apenas "Conserte isso"; comece com "Verifique isso e proponha um plano." Segurança em primeiro lugar.

Save to YouMind

Use YouMind to read viral articles deeply

Save the source, ask focused questions, summarize the argument, and turn a viral article into reusable notes in one AI workspace.

Explore YouMind
Para criadores

Transforme o seu Markdown num artigo 𝕏 impecável

Quando publica os seus próprios textos longos, formatar imagens, tabelas e blocos de código para o 𝕏 é uma dor de cabeça. O YouMind transforma um rascunho completo em Markdown num artigo 𝕏 impecável e pronto a publicar.

Experimente Markdown para 𝕏

Mais padrões para decifrar

Artigos virais recentes

Explorar mais artigos virais