Guia de instalação
Instalação do Claude Code no Mac
macOS 13 ou mais recente
Progresso
0 de 5

O Claude Code roda dentro do Terminal do seu Mac. A instalação hoje é feita por um comando único, que baixa o programa já pronto. Você não precisa instalar Node.js, nem compilar nada, nem entender de programação para chegar até o fim.

Siga os passos na ordem. O processo leva de 5 a 10 minutos.

O que você vai precisar
1
Passo 1 de 5

Abrir o Terminal

O Terminal é o aplicativo onde você instala e roda o Claude Code. Ele já vem no Mac, não precisa baixar nada.

Como abrir
1
Pressione + Espaço para abrir o Spotlight
2
Digite Terminal e pressione Enter
3
Abre uma janela com fundo escuro e um cursor piscando. É ali que você vai colar os comandos.
2
Passo 2 de 5

Instalar o Claude Code

A instalação é um comando único. Copie, cole no Terminal e pressione Enter. Ele baixa o programa pronto e leva cerca de um minuto.

Terminal
%curl -fsSL https://claude.ai/install.sh | bash
Installing Claude Code...
Dica

Você não precisa instalar o Node.js antes. O instalador oficial baixa o programa já compilado e cuida de tudo sozinho, inclusive das atualizações futuras.

Se você já usa o Homebrew, pode instalar por ele em vez do comando acima:

Terminal
%brew install --cask claude-code
Atenção

Pelo Homebrew o Claude Code não se atualiza sozinho. Você precisa rodar brew upgrade claude-code de tempos em tempos. Pelo instalador oficial a atualização é automática.

3
Passo 3 de 5

Conferir se deu certo

Antes de seguir, confirme que o computador já reconhece o comando:

Terminal
%claude --version
2.x.x (Claude Code)
Atenção

Se aparecer command not found, feche a janela do Terminal e abra de novo. O Mac só reconhece um comando recém-instalado depois que o terminal reinicia.

Para um diagnóstico completo da instalação, existe também este comando. Ele não abre uma sessão, só mostra o que está certo e o que está pendente:

Terminal
%claude doctor
4
Passo 4 de 5

Instalar a extensão no VS Code

O VS Code é o editor onde você vai trabalhar junto com o Claude Code. Se ainda não tem, baixe em code.visualstudio.com. Se já tem, vá direto para a extensão.

Instalar a extensão
1
Abra o VS Code
2
Clique no ícone de extensões na barra lateral esquerda, ou pressione + Shift + X
3
Busque por Claude Code e escolha a extensão publicada pela Anthropic
4
Clique em Install
Dica

A extensão é opcional para o Claude Code funcionar, mas é ela que integra o terminal ao editor: você vê os arquivos sendo alterados na hora, em vez de só ler o resumo no terminal.

5
Passo 5 de 5

Entrar na sua conta

Falta conectar o Claude Code à sua conta. Rode o comando abaixo e siga as instruções na tela. Ele abre o navegador para você fazer login.

Terminal
%claude
Abrindo o navegador para autenticação...
Atenção

O Claude Code exige um plano pago: Pro, Max, Team, Enterprise ou conta de Console (API). O plano gratuito do Claude.ai não dá acesso.

Dica

Abra o Terminal dentro da pasta do projeto antes de rodar claude. Ele trabalha sobre os arquivos da pasta em que foi aberto. No Finder, clique com o botão direito na pasta e escolha Serviços e depois Novo Terminal na Pasta.

Tudo instalado e pronto.

O Claude Code está funcionando no seu Mac. A partir daqui é só abrir o Terminal na pasta do projeto, rodar claude e começar a trabalhar.