1. Sistema — Claude Code Guide

Antes de tudo, atualize o Ubuntu e instale as dependências base que diversas ferramentas precisam.

Atualizar pacotes do sistema

sudo apt update && sudo apt upgrade -y

Instalar ferramentas essenciais

sudo apt install -y build-essential curl wget unzip git jq ripgrep iproute2 net-tools

Por que isso importa?

build-essential — compiladores C/C++ necessários para instalar pacotes nativos (Node, Python)
curl / wget — todos os instaladores oficiais usam um desses
git — o Claude Code depende fortemente do Git para navegar, commitar e criar PRs
jq — 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 plugins
ripgrep — busca rápida em arquivos (rg), usado internamente pelo Claude Code para pesquisar no código-fonte
iproute2 — fornece o comando ss para verificar portas e conexões de rede
net-tools — fornece o comando netstat (alternativa clássica ao ss)

O Ubuntu WSL já vem com curl, git e wget, mas frequentemente em versões antigas. O apt upgrade resolve isso.

Sudo sem senha — Autonomia para o Claude Code

O Claude Code frequentemente precisa de sudo para instalar ferramentas, configurar pacotes e ajustar o sistema. Sem a configuração abaixo, ele fica travado esperando a senha ou você precisa aprovar cada comando manualmente — quebrando o fluxo de trabalho autônomo.

Configurar sudo sem senha

echo "mh ALL=(ALL:ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/usuario-linux

O que cada parte faz:

mh — nome do seu usuário Linux
ALL=(ALL:ALL) — pode executar qualquer comando como qualquer usuário
NOPASSWD: ALL — sem solicitar senha
/etc/sudoers.d/ — diretório de configs auxiliares do sudoers (mais seguro que editar /etc/sudoers diretamente)

Isso 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.

Substitua mh pelo seu próprio nome de usuário Linux. Não sabe qual é? Execute whoami no terminal.

Por que isso importa?

build-essential — compiladores C/C++ necessários para instalar pacotes nativos (Node, Python)

curl / wget — todos os instaladores oficiais usam um desses

git — o Claude Code depende fortemente do Git para navegar, commitar e criar PRs

jq — 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 plugins

ripgrep — busca rápida em arquivos (rg), usado internamente pelo Claude Code para pesquisar no código-fonte

iproute2 — fornece o comando ss para verificar portas e conexões de rede

net-tools — fornece o comando netstat (alternativa clássica ao ss)

O Ubuntu WSL já vem com curl, git e wget, mas frequentemente em versões antigas. O apt upgrade resolve isso.

Sudo sem senha — Autonomia para o Claude Code

Configurar sudo sem senha

echo "mh ALL=(ALL:ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/usuario-linux

mh — nome do seu usuário Linux

ALL=(ALL:ALL) — pode executar qualquer comando como qualquer usuário

NOPASSWD: ALL — sem solicitar senha

/etc/sudoers.d/ — diretório de configs auxiliares do sudoers (mais seguro que editar /etc/sudoers diretamente)

Substitua mh pelo seu próprio nome de usuário Linux. Não sabe qual é? Execute whoami no terminal.