João Paulo Pereira Claude Code OS

Guia prático • Claude Code OS

Instalação do Claude Code no Mac

Um guia direto, elegante e sem ruído para preparar Node.js, Terminal, Claude Code, VS Code e login na Anthropic em poucos minutos.

Começar instalação Docs oficiais
Mac

macOS 12 ou mais recente para rodar o fluxo com tranquilidade.

Internet

Conexão ativa para baixar Node.js, pacote npm e extensão.

Anthropic

Uma conta Anthropic para autenticar o Claude Code no final.

1

Passo 1 de 5

Instalar o Node.js

O Claude Code precisa do Node.js para funcionar. Baixe a versão LTS, que é a recomendada para a maioria das instalações.

1 de 5

O que fazer no site

  1. Acesse nodejs.org/en/download no navegador.
  2. Clique em macOS Installer (.pkg) na versão LTS.
  3. Abra o arquivo baixado e siga o instalador até o final.
$ node --version
# Deve aparecer um número de versão.
✓

ConfirmaçãoSe o Terminal mostrar algo como v20.x.x ou v22.x.x, o Node.js foi instalado corretamente.

Terminou este bloco? Marque e avance sem perder o ritmo.

Feito, próximo passo
2

Passo 2 de 5

Abrir o Terminal

O Terminal é o aplicativo onde você vai instalar e rodar o Claude Code. Ele já vem no Mac por padrão.

2 de 5

Como abrir

  1. Pressione Command + Espaço para abrir o Spotlight.
  2. Digite Terminal.
  3. Pressione Enter.
i

Referência visualUma janela escura com texto vai abrir. É ali que você cola os comandos dos próximos passos.

Atalho essencial

Spotlight é o caminho mais rápido para abrir apps no Mac. Use esse atalho sempre que precisar voltar ao Terminal.

Com o Terminal aberto, a instalação principal vem agora.

Feito, próximo passo
3

Passo 3 de 5

Instalar o Claude Code

Com o Terminal aberto, cole o comando abaixo. Ele baixa e instala o Claude Code globalmente na sua máquina.

3 de 5

Sequência recomendada

  1. Copie o comando principal e cole no Terminal.
  2. Aguarde a instalação terminar.
  3. Rode a verificação para confirmar que funcionou.
$ npm install -g @anthropic-ai/claude-code
!

Se aparecer erro de permissãoUse sudo antes do comando. O Mac vai pedir sua senha de administrador.

$ sudo npm install -g @anthropic-ai/claude-code
$ claude --version
# Deve aparecer algo como claude 1.x.x.

Quando a versão aparecer, o Claude Code já está instalado.

Feito, próximo passo
4

Passo 4 de 5

Instalar a extensão no VS Code

A extensão aproxima o Claude Code do seu editor. Se você não quiser usar o VS Code, este passo é opcional: pode pular direto para o login na Anthropic.

4 de 5

Instalar a extensão opcional

  1. Abra o VS Code.
  2. Clique no ícone de extensões na barra lateral.
  3. Busque por Claude Code, da Anthropic.
  4. Clique em Install.
⌘

Atalho no VS CodeVocê também pode abrir extensões com Shift + Command + X.

i

Uso opcionalSe você não quiser usar o VS Code, pode pular esta etapa e seguir direto para o login na Anthropic.

Editor pronto

Depois da extensão instalada, você pode usar o Claude Code junto ao projeto aberto no VS Code.

Falta só conectar sua conta Anthropic.

Feito, próximo passo
5

Passo 5 de 5

Fazer login na Anthropic

Agora conecte o Claude Code à sua conta. O comando abre o fluxo de login no navegador.

5 de 5

Login

  1. Rode o comando no Terminal.
  2. Siga as instruções que aparecerem.
  3. Entre ou crie sua conta Anthropic.
$ claude
✓

ProntoDepois do login, o Claude Code já pode ser usado dentro dos seus projetos.

Tutorial concluído. Sua máquina está preparada.

Finalizar instalação

Sistema pronto

Claude Code instalado no Mac.

Guarde os links oficiais abaixo para consultar documentação, produto e conta Anthropic quando precisar.

Claude Code Docs Claude Code Oficial Console Anthropic