Guia Completo · Do Zero ao Avançado

Configurando o Claude Code
do Zero

Passo a passo para instalar e integrar o Claude Code no Mac ou Windows, com Figma, GitHub e economia de tokens via RTK.

Antes de começar
  • Acesso de administrador no computador
  • Conexão com a internet
  • Uma conta em claude.ai (Anthropic)
  • Mac (macOS 12+) ou Windows 10 / 11
Introdução

Visão Geral

O Claude Code é a CLI oficial da Anthropic. Ele roda no terminal e permite que o Claude leia, edite e execute arquivos no seu projeto, integre com Figma, crie pull requests no GitHub e muito mais — tudo por linguagem natural.

Ordem de instalação
Node.js → Git → Claude Code → Figma MCP → GitHub CLI → Homebrew → RTK
Passo 1

Instalando o Node.js

O Claude Code é instalado via npm, que vem junto com o Node.js. Instale sempre a versão LTS.

macOS
Windows
1
Baixe o instalador LTS
Acesse nodejs.org e baixe o arquivo .pkg para macOS — clique em "LTS".
2
Execute o instalador .pkg
Abra o arquivo baixado e siga as instruções: Continuar → Instalar → Fechar.
3
Verifique no Terminal
Abra o Terminal (cmd+espaço → "Terminal") e rode:
bash
node --version
npm --version
Resultado esperado
Deve aparecer algo como v22.x.x e 10.x.x.
1
Baixe o instalador .msi para Windows
Acesse nodejs.org, clique em "LTS" e baixe o arquivo .msi para Windows.
2
Execute o instalador
Dê dois cliques no .msi. Aceite os termos e siga o assistente. Deixe marcada a opção "Add to PATH".
3
Verifique no PowerShell
Abra o PowerShell (Menu Iniciar → PowerShell):
powershell
node --version
npm --version
Comando não reconhecido?
Feche e reabra o PowerShell. Se ainda não funcionar, reinicie o computador.
Passo 2

Instalando o Git

O Git é necessário para o Claude Code interagir com seus repositórios de código — criar commits, branches, pull requests, etc.

macOS
Windows
1
Instale via Xcode Command Line Tools
No Terminal, rode o comando abaixo. Uma janela de confirmação vai aparecer — clique em "Instalar".
bash
xcode-select --install
2
Verifique e configure
Substitua com seu nome e e-mail (os mesmos do GitHub):
bash
git --version
git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"
1
Baixe o instalador em git-scm.com
Acesse git-scm.com/download/win — o download começa automaticamente. Execute o .exe.
Configuração importante durante instalação
Em "Adjusting PATH": selecione "Git from command line and 3rd-party software". Em line endings: "Checkout as-is, commit Unix-style".
2
Verifique e configure no PowerShell
powershell
git --version
git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"
Passo 3

Instalando o Claude Code

Com o Node.js instalado, o Claude Code é instalado com um único comando npm. Funciona igual no Mac e no Windows.

1
Instale globalmente via npm
No Terminal (Mac) ou PowerShell (Windows):
bash
npm install -g @anthropic-ai/claude-code
2
Verifique a instalação
bash
claude --version
3
Faça login com sua conta Anthropic
Execute o comando abaixo. Uma URL será gerada — abra no navegador, autorize o acesso e volte ao terminal.
bash
claude
Primeiro acesso
O Claude Code vai abrir o navegador para autorização OAuth com sua conta Anthropic. Após autorizar, a sessão fica ativa no terminal.
4
Teste em um projeto
Navegue até a pasta de qualquer projeto e inicie:
bash
cd ~/meu-projeto
claude
Passo 4

Conectando o Figma MCP

O MCP (Model Context Protocol) permite que o Claude Code leia seus designs diretamente do Figma — componentes, estilos, layouts — para gerar código com precisão.

1
Gere seu token de acesso no Figma
No Figma: clique no seu avatar (canto superior direito) → Settings → Security → Personal access tokens → Generate new token.
Guarde o token agora
O token só é exibido uma vez. Copie e cole em um local seguro antes de fechar a tela.
2
Registre o servidor MCP do Figma
No Terminal ou PowerShell:
bash
claude mcp add figma-developer-mcp --scope user \
  -- npx -y figma-developer-mcp --stdio
3
Configure o token como variável de ambiente
Substitua SEU_TOKEN_AQUI pelo token copiado do Figma:
macOS
Windows
bash
echo 'export FIGMA_API_KEY="SEU_TOKEN_AQUI"' >> ~/.zshrc
source ~/.zshrc
powershell
[System.Environment]::SetEnvironmentVariable("FIGMA_API_KEY", "SEU_TOKEN_AQUI", "User")
4
Confirme que o MCP está registrado
bash
claude mcp list
Pronto para usar
Cole qualquer URL do Figma diretamente no chat do Claude Code e ele vai ler o design automaticamente.
Passo 5

Integrando com GitHub

O GitHub CLI (gh) permite que o Claude Code crie branches, commits e pull requests diretamente do terminal, sem precisar abrir o navegador.

macOS
Windows
1
Instale o GitHub CLI via Homebrew
Se ainda não tem o Homebrew, instale-o primeiro (Passo 6) e volte aqui.
bash
brew install gh
1
Instale via winget
No PowerShell (como Administrador):
powershell
winget install --id GitHub.cli
2
Faça login no GitHub
Execute e siga as instruções. Escolha: GitHub.com → HTTPS → Login with a web browser.
bash
gh auth login
3
Configure o credential helper
Evita que o Git peça senha em cada push ou pull:
bash
gh auth setup-git
gh auth status
Integração completa
Agora o Claude Code pode criar PRs, revisar código e interagir com issues usando comandos como gh pr create e gh issue list.
Passo 6

Instalando o Homebrew

O Homebrew é o gerenciador de pacotes do macOS. Com ele você instala ferramentas como o GitHub CLI e o RTK com um único comando. No Windows, o equivalente é o winget (já incluso no Windows 11).

macOS
Windows
1
Instale o Homebrew
Cole o comando abaixo no Terminal. O processo leva alguns minutos — vai pedir sua senha de administrador.
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Mac com Apple Silicon (M1, M2, M3, M4)
Após a instalação, o terminal mostrará dois comandos começando com echo e eval. Execute-os para adicionar o Homebrew ao PATH.
2
Verifique a instalação
bash
brew --version
Homebrew não existe no Windows
Use o winget (já incluso no Windows 11) ou o Chocolatey para instalar pacotes. Veja abaixo como instalar o Chocolatey.
1
Instale o Chocolatey (opcional, mas recomendado)
Abra o PowerShell como Administrador e execute:
powershell
Set-ExecutionPolicy Bypass -Scope Process -Force
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
Passo 7

RTK — Rust Token Killer

O RTK é um proxy CLI que intercepta e filtra as saídas dos comandos antes que elas consumam tokens do Claude. Resultado: 60 a 90% de economia em operações do dia a dia, sem mudar nada no seu fluxo de trabalho.

60%
Economia mínima
90%
Economia máxima
0ms
Overhead por comando
Como funciona
O RTK age como proxy transparente — você continua usando os mesmos comandos (ex: git status). O Claude Code os passa automaticamente pelo RTK, que filtra output desnecessário antes de enviar ao modelo. Menos tokens, mesmo comportamento.
1
Instale o RTK via Homebrew (macOS)
bash
brew install rtk
2
Verifique a instalação
bash
rtk --version
which rtk
Atenção — colisão de nome
Se rtk gain falhar, pode ser que você tenha outra ferramenta com o mesmo nome instalada (reachingforthejack/rtk). Use which rtk para verificar o binário correto.
3
Ative o RTK globalmente no Claude Code
Edite (ou crie) o arquivo ~/.claude/settings.json e adicione o hook abaixo. Isso faz o RTK interceptar automaticamente todos os comandos Bash do Claude Code:
bash
# Abra o arquivo de configurações do Claude Code
open ~/.claude/settings.json

# Ou edite via terminal
nano ~/.claude/settings.json
4
Adicione o hook no settings.json
Cole a configuração abaixo no arquivo (se o arquivo já tiver conteúdo, adicione apenas o bloco "hooks"):
json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "rtk proxy"
          }
        ]
      }
    ]
  }
}
5
Comandos do RTK para monitorar sua economia
Use esses comandos diretamente no terminal (fora do Claude Code):
bash
# Ver economia de tokens acumulada
rtk gain

# Ver histórico de comandos com economia por operação
rtk gain --history

# Analisar o histórico do Claude Code em busca de oportunidades perdidas
rtk discover

# Executar um comando sem filtragem (para debug)
rtk proxy git status
Configuração completa
Seu ambiente está totalmente configurado. O RTK vai economizar tokens automaticamente em todas as sessões do Claude Code. Use rtk gain regularmente para acompanhar sua economia acumulada.