Configurando seu ambiente de desenvolvimento no Windows

Se você está começando a programar e usa Windows, esse guia vai preparar sua máquina com tudo que você precisa para ter um ambiente de desenvolvimento profissional.

Vamos instalar, configurar e entender cada ferramenta: do terminal ao editor de código, do controle de versão às ferramentas de IA que vão acelerar seu aprendizado.

Warp: o terminal

O Warp é o terminal mais moderno disponível para Windows. Feito em Rust, renderizado na GPU e com inteligência artificial integrada, ele é o equivalente (e muitos dizem superior) ao iTerm2 do Mac.

Diferente do Windows Terminal padrão, o Warp organiza cada comando em blocos navegáveis, tem autocomplete inteligente, sugestões por IA e até permite compartilhar sessões de terminal com outras pessoas.

Instalação

1. Acesse warp.dev/download
2. Baixe a versão para Windows
3. Execute o instalador
4. Crie uma conta (pode usar GitHub ou Google): é gratuito

Se preferir instalar via terminal, abra o PowerShell e rode:

winget install Warp.Warp

Configuração inicial

Após instalar e abrir o Warp:

1. Ele já vem com um tema escuro bonito por padrão
2. Vá em Settings (engrenagem) > Appearance para customizar cores, fonte e opacidade
3. Vá em Settings > Features e explore as opções de IA

Dicas para iniciantes

• Blocos de comando: cada comando que você roda vira um bloco separado. Você pode copiar a saída inteira clicando no ícone de cópia
• IA integrada: pressione Ctrl + Space para pedir ajuda em linguagem natural. Ex: “como listar todos os arquivos .js nesta pasta?”
• Histórico inteligente: pressione Ctrl + R para buscar no histórico com fuzzy search

Git: controle de versão

O Git é o sistema de controle de versão que todo programador usa. É com ele que você salva o histórico do seu código e colabora com outras pessoas.

Instalação

1. Acesse git-scm.com/downloads/win
2. Baixe o instalador (64-bit)
3. Execute o instalador: na maioria das telas, pode clicar em Next com as opções padrão
4. Atenção em duas telas:
   • “Choosing the default editor”: selecione Visual Studio Code (ao invés do Vim)
   • “Adjusting the name of the initial branch”: selecione “Override” e digite main

Configuração inicial

Abra o Warp (ou PowerShell) e configure seu nome e email:

git config --global user.name "Seu Nome"
git config --global user.email "seuemail@exemplo.com"

Verificar se funcionou

git --version

Deve aparecer algo como git version 2.47.1.windows.1.

Visual Studio Code (VSCode)

O VSCode é o editor de código mais usado no mundo. É gratuito, leve e tem milhares de extensões.

Instalação

1. Acesse code.visualstudio.com
2. Clique no botão grande de download para Windows
3. Execute o instalador
4. Marque estas opções durante a instalação:
   • Adicionar ao PATH
   • “Abrir com Code” no menu de contexto de arquivos
   • “Abrir com Code” no menu de contexto de diretórios

Verificar se funcionou

code --version

Configurações recomendadas

Abra o VSCode e pressione Ctrl + , (vírgula) para abrir as Configurações. Procure e ative:

WSL 2 + Zsh + Oh My Zsh

O WSL (Windows Subsystem for Linux) permite rodar Linux dentro do Windows. Com ele, você tem acesso a um terminal Linux de verdade, com Zsh (um shell mais poderoso que o Bash) e o Oh My Zsh (que deixa tudo bonito e produtivo).

Instalar o WSL

Abra o PowerShell como Administrador (clique direito no ícone > “Executar como administrador”) e rode:

wsl --install

Isso instala o WSL 2 com Ubuntu automaticamente. Reinicie o computador quando solicitado.

Após reiniciar, o Ubuntu vai abrir automaticamente pedindo para criar um nome de usuário e senha. Escolha algo simples que você vá lembrar. A senha não aparece enquanto você digita: isso é normal no Linux.

Depois de configurar o WSL, volte ao Warp e vá em Settings > Features > Session para mudar o shell padrão para WSL / Ubuntu.

Instalar o Zsh

Com o Ubuntu aberto no terminal, rode:

sudo apt update && sudo apt install zsh -y

Defina o Zsh como shell padrão:

chsh -s $(which zsh)

Feche e abra o terminal Ubuntu novamente.

Instalar o Oh My Zsh

O Oh My Zsh adiciona temas, autocompletar inteligente e atalhos ao terminal:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Quando perguntar se quer mudar o shell padrão para Zsh, responda Y (sim).

Plugins úteis

Estes dois plugins vão acelerar muito seu dia a dia.

zsh-autosuggestions: sugere comandos enquanto você digita:

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

zsh-syntax-highlighting: colore os comandos no terminal:

git clone https://github.com/zsh-users/zsh-syntax-highlighting ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

Agora ative os plugins editando o arquivo de configuração:

vim ~/.zshrc

Encontre a linha que diz plugins=(git) e substitua por:

plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

Salve com Ctrl + O, Enter, e saia com Ctrl + X. Depois recarregue:

source ~/.zshrc

Tema Powerlevel10k (opcional, mas recomendado)

O Powerlevel10k é o tema mais popular e bonito para Zsh.

Primeiro, instale uma Nerd Font (fonte com ícones especiais):

1. Acesse o repositório do Powerlevel10k e baixe as 4 fontes MesloLGS NF
2. Extraia e instale as fontes (clique duplo em cada .ttf > Instalar)
3. No Warp, vá em Settings > Appearance > Font e selecione MesloLGS NF
4. No VSCode, pressione Ctrl + ,, pesquise terminal font e coloque MesloLGS NF

Agora instale o tema:

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

Edite o ~/.zshrc:

vim ~/.zshrc

Encontre a linha ZSH_THEME="robbyrussell" e mude para:

ZSH_THEME="powerlevel10k/powerlevel10k"

Salve e recarregue:

source ~/.zshrc

O assistente do Powerlevel10k vai abrir automaticamente. Siga as perguntas para personalizar o visual do seu terminal.

Configurar o VSCode para usar WSL

1. Abra o VSCode
2. Instale a extensão WSL (pesquise “WSL” nas extensões)
3. Pressione Ctrl + Shift + P, digite Terminal: Select Default Profile e selecione Ubuntu (WSL)

Agora seu terminal integrado do VSCode vai usar o Linux com Zsh. Para abrir uma pasta do WSL no VSCode, rode no terminal Ubuntu:

code .

Node.js (via nvm)

O Node.js permite rodar JavaScript fora do navegador. O nvm (Node Version Manager) permite instalar e alternar entre versões do Node facilmente.

Instale o Node dentro do WSL (Ubuntu), não no Windows. Isso evita problemas de compatibilidade.

Instalar o nvm

No terminal Ubuntu (WSL), rode:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Feche e abra o terminal, depois verifique:

nvm --version

Instalar o Node.js

Instale a versão LTS (mais estável) e a versão 22 (necessária para algumas ferramentas):

nvm install --lts
nvm install 22

Defina a versão LTS como padrão:

nvm alias default lts/*

Verificar se funcionou

node --version
npm --version

O npm (Node Package Manager) vem junto com o Node. É com ele que você instala bibliotecas e ferramentas JavaScript: pense nele como uma loja de peças para programadores.

Extensões essenciais do VSCode

Abra o VSCode e instale estas extensões (clique no ícone de quadradinhos na barra lateral ou pressione Ctrl + Shift + X).

Para iniciantes

Para quando avançar

Extras úteis

Criar uma conta no GitHub

O GitHub é onde programadores guardam e compartilham código. É como um Google Drive para código.

Depois de criar sua conta, configure a autenticação SSH para não precisar digitar senha toda vez. No terminal Ubuntu (WSL):

ssh-keygen -t ed25519 -C "seuemail@exemplo.com"

Pressione Enter em todas as perguntas (aceite os padrões). Copie a chave pública:

cat ~/.ssh/id_ed25519.pub

Copie o texto que aparecer. Vá em GitHub > Settings > SSH Keys, clique em New SSH key, cole a chave e salve.

Teste a conexão:

ssh -T git@github.com

Deve aparecer: Hi seuusuario! You've successfully authenticated.

Configurar o Git no WSL

Dentro do Ubuntu (WSL), configure o Git novamente: a configuração do Windows não vale aqui:

git config --global user.name "Seu Nome"
git config --global user.email "seuemail@exemplo.com"
git config --global init.defaultBranch main

Estrutura de pastas recomendada

Dentro do WSL, crie uma pasta para seus projetos:

mkdir -p ~/projetos
cd ~/projetos

Regra de ouro: sempre trabalhe dentro do sistema de arquivos do Linux (~/...), nunca em /mnt/c/.... Trabalhar dentro de /mnt/c/ é significativamente mais lento.

Claude Code: IA da Anthropic no terminal

O Claude Code é um agente de IA que roda direto no seu terminal. Ele entende seu projeto, edita arquivos, roda comandos e ajuda você a programar como se fosse um colega de trabalho senior.

Requisitos

• Uma conta Anthropic com plano Pro, Max, Teams ou Enterprise (o plano gratuito não inclui o Claude Code)
• Git instalado (você já fez isso)

Instalação no WSL/Ubuntu

curl -fsSL https://claude.ai/install.sh | bash

Verifique a instalação:

claude --version

Instalação no PowerShell (se preferir usar fora do WSL)

irm https://claude.ai/install.ps1 | iex

O Claude Code no Windows nativo requer o Git for Windows, que você já instalou.

Primeiro uso

1. Navegue até a pasta do seu projeto:

   cd ~/projetos/meu-projeto
   

2. Rode claude
3. O navegador vai abrir para você fazer login com sua conta Anthropic
4. Após autenticar, você volta ao terminal e já pode começar a conversar

O que dá pra fazer

• Pedir para criar arquivos, funções, componentes
• Perguntar sobre erros no código
• Pedir para explicar trechos de código
• Ele lê e edita seus arquivos diretamente
• Ele roda comandos no terminal por você (com sua permissão)

Exemplo prático

> claude
> Crie uma página HTML com um botão que muda a cor de fundo quando clicado

O Claude Code vai criar os arquivos necessários para você.

Codex CLI: IA da OpenAI no terminal

O Codex é o agente de IA da OpenAI para terminal. Assim como o Claude Code, ele pode editar seus arquivos e rodar comandos.

Requisitos

• Uma conta na OpenAI (ChatGPT Plus ou API key)
• Node.js 22+ (você já instalou via nvm)

Instalação no WSL/Ubuntu

Garanta que está usando o Node 22:

nvm use 22

Instale globalmente:

npm i -g @openai/codex

Primeiro uso

1. Navegue até a pasta do seu projeto:

   cd ~/projetos/meu-projeto
   

2. Rode codex
3. Na primeira vez, ele vai pedir para autenticar com sua conta da OpenAI

Diferenças entre Claude Code e Codex

Os dois são excelentes. Teste ambos e veja com qual você se sente mais confortável: muitos desenvolvedores usam os dois.

Checklist final

Depois de seguir todo o tutorial, confira se tudo está funcionando. Rode estes comandos no terminal Ubuntu (WSL):

git --version          # Git instalado
node --version         # Node.js instalado
npm --version          # npm instalado
nvm --version          # nvm instalado
zsh --version          # Zsh instalado
claude --version       # Claude Code instalado
codex --version        # Codex instalado
code --version         # VSCode acessível do terminal

Se todos retornarem uma versão, seu ambiente está 100% configurado.

Resumo visual da stack

┌──────────────────────────────────────────────┐
│            Warp (terminal com IA)             │
│  ┌────────────────────────────────────────┐   │
│  │        Ubuntu (WSL 2)                  │   │
│  │  ┌──────────────────────────────────┐  │   │
│  │  │  Zsh + Oh My Zsh + P10k         │  │   │
│  │  │  ┌────────────┐ ┌─────────────┐ │  │   │
│  │  │  │  Node.js   │ │     Git     │ │  │   │
│  │  │  │  (nvm)     │ │             │ │  │   │
│  │  │  └────────────┘ └─────────────┘ │  │   │
│  │  │  ┌──────────────────────────────┐│  │   │
│  │  │  │  Claude Code  |  Codex CLI  ││  │   │
│  │  │  └──────────────────────────────┘│  │   │
│  │  └──────────────────────────────────┘  │   │
│  └────────────────────────────────────────┘   │
│                                               │
│  ┌────────────────────────────────────────┐   │
│  │  Visual Studio Code (com extensão WSL) │   │
│  └────────────────────────────────────────┘   │
└───────────────────────────────────────────────┘

Próximos passos

Agora que seu ambiente está pronto, você pode:

1. Continuar seus estudos de JavaScript: agora com um terminal profissional
2. Praticar Git: crie um repositório no GitHub e faça commits dos seus exercícios
3. Explorar o Claude Code: peça para ele explicar partes do código que você não entendeu
4. Criar seu primeiro projeto: comece com algo simples como uma calculadora ou lista de tarefas

Bons estudos!