Você quer usar Claude Code no seu Mac mas não sabe por onde começar? Este guia mostra exatamente como instalar e configurar Claude Code no macOS, passo a passo. Quer você tenha um MacBook Air M1, um Mac Studio ou um iMac Intel, você encontrará aqui todas as instruções para estar operacional em menos de 10 minutos. Cobrimos os pré-requisitos do sistema, os diferentes métodos de instalação, a configuração inicial e as soluções para os problemas mais frequentes.
Quais são os pré-requisitos para instalar Claude Code no macOS?
Para instalar Claude Code no macOS, você precisa de macOS 10.15 (Catalina) no mínimo, 4 GB de RAM, 500 MB de espaço em disco e uma conta Anthropic ativa. Esses requisitos são intencionalmente leves para permitir que o máximo de pessoas tenha acesso à ferramenta.
Aqui está o detalhe dos pré-requisitos técnicos:
- Sistema operacional: macOS 10.15 (Catalina) ou mais recente. As versões Monterey, Ventura e Sonoma são totalmente compatíveis.
- Processador: Compatível com chips Intel e Apple Silicon (M1, M2, M3). Nenhuma diferença de funcionalidade entre as duas arquiteturas.
- Memória RAM: 4 GB no mínimo, 8 GB recomendados para uma experiência fluida com vários projetos abertos.
- Espaço em disco: 500 MB para a aplicação, mais 1 a 2 GB para dependências e projetos.
- Conexão com internet: Necessária para a instalação inicial e o uso (Claude Code funciona online).
Quanto à conta de usuário, você deve ter uma conta Anthropic. A criação é gratuita no site oficial da Anthropic. Você pode começar com o plano gratuito que oferece uma cota mensal suficiente para começar. Os planos pagos (Pro a $20/mês, Team a $30/mês por usuário) desbloqueiam cotas mais altas de acordo com a documentação oficial da Anthropic.
Verifique sua versão do macOS clicando no logo Apple no canto superior esquerdo, depois em "Sobre este Mac". Se você estiver em uma versão anterior a Catalina, precisará atualizar seu sistema antes de continuar.
Como baixar e instalar Claude Code no Mac?
A instalação de Claude Code no macOS é feita baixando o arquivo .dmg do site oficial da Anthropic e depois arrastando a aplicação para a pasta Aplicativos. O processo completo leva cerca de 5 minutos.
Siga estas etapas precisas:
Acesse o site oficial: Vá para claude.ai e faça login com sua conta Anthropic.
Baixe Claude Code: No menu principal, clique em "Downloads" e depois selecione "Claude Code for macOS". O download do arquivo .dmg (cerca de 150 MB) inicia automaticamente.
Abra o arquivo .dmg: Quando o download terminar, clique duas vezes no arquivo "ClaudeCode-macOS.dmg" em sua pasta Downloads.
Instale a aplicação: Uma janela se abre com o ícone do Claude Code e um atalho para a pasta Aplicativos. Arraste o ícone do Claude Code para a pasta Aplicativos.
Inicie Claude Code: Abra sua pasta Aplicativos (Cmd + Shift + A no Finder) e clique duas vezes em Claude Code.
Autorize a aplicação: No primeiro lançamento, o macOS exibe uma mensagem de segurança. Clique em "Abrir" para confirmar. Se o botão "Abrir" não aparecer, vá para Preferências do Sistema > Privacidade e segurança, depois clique em "Abrir mesmo assim" ao lado da mensagem sobre Claude Code.
Faça login: A aplicação pede que você se autentique com sua conta Anthropic. Digite seu email e senha.
A instalação agora está concluída. Claude Code aparece em seu dock e você pode fixá-lo para acesso rápido clicando com o botão direito no ícone e depois em "Opções" > "Manter no Dock".
Para usuários avançados que preferem a linha de comando, uma instalação via Homebrew também está disponível com o comando brew install --cask claude-code, mas o método .dmg continua sendo o mais simples para iniciantes.
Como configurar Claude Code após a instalação?
A configuração inicial do Claude Code consiste em escolher seu modelo preferido (Claude 3.5 Sonnet recomendado), definir sua pasta de projetos e ajustar os parâmetros de geração de código. Esta etapa leva 2 a 3 minutos e melhora significativamente sua experiência.
Aqui estão as configurações essenciais a fazer:
Escolha do modelo
Clique no ícone de engrenagem no canto superior direito, depois em "Modelo". Você tem acesso a várias versões do Claude:
- Claude 3.5 Sonnet: O melhor compromisso para código. Rápido, preciso, excelente para iniciantes. É a escolha padrão e a que recomendamos.
- Claude 3 Opus: Mais poderoso mas mais lento e consome mais créditos. Reserve-o para projetos complexos.
- Claude 3 Haiku: Muito rápido, ideal para perguntas simples e modificações leves.
Para começar, mantenha Claude 3.5 Sonnet. Você pode mudar a qualquer momento conforme suas necessidades.
Pasta de projetos
Nas configurações, seção "Projetos", defina onde Claude Code vai criar e salvar seus projetos. Por padrão, ele usa ~/Documents/ClaudeCode. Você pode mudá-lo para qualquer pasta do seu Mac.
Dica prática: crie uma pasta dedicada como ~/Projetos-Claude para manter uma organização clara, especialmente se você já usa outras ferramentas de desenvolvimento.
Parâmetros de geração
Em "Preferências" > "Geração de código", você pode ajustar:
- Nível de detalhe dos comentários: "Médio" é perfeito para aprender. "Alto" adiciona mais explicações no código gerado.
- Estilo de código: Escolha entre "Moderno" (recomendado) ou "Clássico" conforme suas preferências.
- Verificação automática: Ative esta opção para que Claude verifique o código antes de apresentá-lo.
Atalhos de teclado
Em "Preferências" > "Atalhos", personalize as teclas rápidas. As mais úteis:
- Cmd + N: Novo projeto
- Cmd + Shift + P: Abrir paleta de comandos
- Cmd + K: Iniciar uma geração de código
Uma vez que essas configurações forem feitas, salve clicando no botão "Aplicar" na parte inferior da janela de preferências.
Quais são os erros de instalação comuns e como resolvê-los?
Os três erros mais frequentes ao instalar Claude Code no macOS são o bloqueio pelo Gatekeeper, problemas de permissões e conflitos com outras ferramentas de desenvolvimento. Aqui está como identificá-los e corrigi-los.
Erro "A aplicação não pode ser aberta"
Esta mensagem aparece quando o Gatekeeper bloqueia Claude Code. Solução:
- Vá para Preferências do Sistema > Privacidade e segurança
- Desça até ver a mensagem sobre Claude Code
- Clique em "Abrir mesmo assim"
- Confirme com sua senha de administrador
- Reinicie Claude Code
Se o problema persistir, abra o Terminal e digite:
xattr -cr /Applications/ClaudeCode.app
Este comando remove os atributos de quarentena que às vezes bloqueiam aplicações baixadas.
Erro de conexão com o servidor
Se Claude Code não conseguir se conectar após a autenticação:
- Verifique sua conexão com a internet (abra um navegador e teste)
- Desative temporariamente sua VPN se estiver usando uma
- Verifique que seu firewall não está bloqueando Claude Code (Preferências do Sistema > Segurança > Firewall > Opções do firewall)
- Reinicie a aplicação
Se o erro persistir, o problema pode vir dos servidores da Anthropic. Consulte status.anthropic.com para verificar o status dos serviços.
Problema de permissões na pasta de projetos
Se Claude Code exibir "Impossível escrever na pasta de projetos":
- Abra o Finder e navegue até a pasta em questão
- Clique com o botão direito > "Obter informações"
- Desbloqueie as permissões clicando no cadeado na parte inferior
- Mude "Somente leitura" para "Leitura e escrita" para seu usuário
- Clique na engrenagem > "Aplicar aos itens inclusos"
Conflito com outros editores de código
Se você já instalou VS Code, Cursor ou outros IDEs, às vezes podem entrar em conflito com Claude Code. A solução: defina Claude Code como editor padrão para arquivos de código em Preferências do Sistema > Extensões > Editor de texto padrão.
Para usuários do Cursor que estão em dúvida entre as duas ferramentas, nosso artigo Cursor vs Claude Code compara em detalhes os pontos fortes e fracos de cada solução.
Como verificar que a instalação está funcionando corretamente?
Para testar sua instalação do Claude Code, crie um primeiro projeto simples que exiba "Hello World" em uma página web. Este teste leva 2 minutos e confirma que todos os componentes estão funcionando.
Aqui está o teste completo a fazer:
Inicie Claude Code a partir de sua pasta Aplicativos
Crie um novo projeto: Clique em "Novo projeto" ou digite Cmd + N
Dê um nome: Chame-o de "test-installation"
Peça ao Claude: Na barra de chat, escreva exatamente: "Crie uma página HTML simples que exiba 'Hello World' em grande no centro da tela com um fundo azul claro"
Verifique a geração: Claude Code deve gerar um arquivo
index.htmlem alguns segundos. Você vê o código aparecer no editor à direita.Visualize o resultado: Clique no botão "Visualizar" no canto superior direito. Uma janela se abre com sua página web.
Teste as modificações: Peça ao Claude "Mude a cor de fundo para verde menta". O código deve se atualizar automaticamente.
Se todas essas etapas funcionarem, sua instalação está perfeita. Você está pronto para criar seus primeiros projetos reais com Claude Code.
Para ir além no uso da ferramenta, consulte nosso tutorial completo Claude Code para iniciantes que cobre funcionalidades avançadas e melhores práticas.
Como atualizar Claude Code no macOS?
Claude Code se atualiza automaticamente ao iniciar, mas você pode forçar uma atualização manual no menu Ajuda > Procurar atualizações. As atualizações trazem regularmente novas funcionalidades e correções de bugs.
O processo de atualização automática:
- A cada lançamento, Claude Code verifica se uma nova versão existe
- Se houver, uma notificação aparece no canto superior direito
- Clique em "Atualizar" para baixar a nova versão
- A aplicação reinicia automaticamente após a instalação
- Seus projetos e configurações são preservados
Para uma atualização manual:
- Abra Claude Code
- Vá para o menu "Ajuda" no topo da tela
- Clique em "Procurar atualizações"
- Se uma versão mais recente existir, clique em "Baixar e instalar"
- Aguarde o fim do download (geralmente 1 a 2 minutos)
- Deixe a aplicação reiniciar
As atualizações maiores (mudança de versão, como 1.0 para 2.0) podem exigir uma reinicialização completa do seu Mac. Claude Code o informa antes de prosseguir.
Frequência de atualizações: A Anthropic publica atualizações menores a cada 2 a 3 semanas e versões maiores a cada 2 a 3 meses. Você pode consultar as notas de versão completas no site oficial da Anthropic para ver as novidades de cada atualização.
Dica: ative as atualizações automáticas em Preferências > Geral > "Instalar atualizações automaticamente" para sempre se beneficiar das últimas melhorias sem pensar nisso.
Conclusão
Instalar Claude Code no macOS é um processo simples que leva menos de 10 minutos. Uma vez que a aplicação esteja configurada, você tem um assistente de IA poderoso para criar sites, aplicações e scripts sem conhecimento prévio de programação. A atualização automática garante que você sempre se beneficie das últimas melhorias.
Se encontrar um problema não coberto neste guia, a documentação oficial da Anthropic e a comunidade Claude Code no Discord são recursos valiosos para obter ajuda rapidamente.
