Instalação Fundamental
1. Sistema
Prepare seu sistema operacional para desenvolvimento com IA. Instale dependências essenciais na sua plataforma.
Antes de tudo, prepare seu sistema com as dependências base que diversas ferramentas precisam. Selecione sua plataforma:
sudo apt update && sudo apt upgrade -ysudo apt install -y build-essential curl wget unzip git jq ripgrep iproute2 net-toolssudo apt update && sudo apt upgrade -ysudo apt install -y build-essential curl wget unzip git jq ripgrep iproute2 net-toolsO Ubuntu WSL já vem com curl, git e wget, mas frequentemente em versões antigas. O apt upgrade resolve isso.
xcode-select --installEsse comando abre um diálogo do sistema pedindo confirmação. Aceite e aguarde a instalação (inclui Git, compiladores C/C++ e ferramentas essenciais).
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Após instalar o Homebrew, siga as instruções exibidas no terminal para adicionar o brew ao PATH (geralmente envolve adicionar uma linha ao ~/.zprofile).
brew install jq ripgrep wgetDica: Para a experiência mais completa com Claude Code no Windows, considere usar WSL2 (aba WSL2 acima). O suporte nativo a Windows funciona bem, mas WSL2 oferece melhor sandboxing e compatibilidade com ferramentas Unix.
Abra o PowerShell como Administrador:
winget install --id Git.Git -e --source wingetGit for Windows é obrigatório. O Claude Code no Windows depende do Git Bash que vem junto. Após instalar, feche e reabra o PowerShell.
winget install --id jqlang.jq -e --source winget
winget install --id BurntSushi.ripgrep.MSVC -e --source wingetO Windows não precisa de build-essential — o Visual Studio Build Tools será instalado automaticamente se necessário por ferramentas como o Node.js.
Por que isso importa?
build-essential/ Xcode CLT — compiladores C/C++ necessários para instalar pacotes nativos (Node, Python)curl/wget— todos os instaladores oficiais usam um dessesgit— o Claude Code depende fortemente do Git para navegar, commitar e criar PRsjq— processador JSON de linha de comando, recomendado pela doc oficial para parsear saída do modo programático (claude -p), e usado em hooks e pluginsripgrep— busca rápida em arquivos (rg), usado internamente pelo Claude Code para pesquisar no código-fonte. Já vem incluído no Claude Code, mas instalar separadamente garante que funcione em outros contextos também
Sudo sem senha — Autonomia para o Claude Code
O Claude Code frequentemente precisa de sudo para instalar ferramentas e ajustar o sistema. Sem a configuração abaixo, ele fica travado esperando a senha.
echo "$USER ALL=(ALL:ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/$USERIsso remove a barreira de senha para todos os comandos sudo. Adequado para máquinas de desenvolvimento pessoal, mas não recomendado para servidores de produção.
O Claude Code frequentemente precisa de sudo para instalar ferramentas e ajustar o sistema. Sem a configuração abaixo, ele fica travado esperando a senha.
echo "$USER ALL=(ALL:ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/$USERIsso remove a barreira de senha para todos os comandos sudo, não apenas os do Claude Code. Adequado para ambientes de desenvolvimento WSL onde o Linux roda localmente, mas não recomendado para servidores de produção.
No macOS, o Homebrew instala pacotes sem sudo, então a maioria dos comandos do Claude Code não precisa de privilégios elevados. Se necessário, o Claude Code pedirá sua senha pontualmente.
Se quiser configurar sudo sem senha no macOS (opcional):
sudo sh -c 'echo "$(whoami) ALL=(ALL:ALL) NOPASSWD: ALL" > /etc/sudoers.d/$(whoami)'No Windows, o Claude Code roda no PowerShell do usuário e não usa sudo. Se um comando precisar de privilégios de administrador, o Windows exibirá o prompt UAC automaticamente.
Não é necessária nenhuma configuração especial de permissões no Windows.