Um dos maiores desafios ao rodar multiplos agentes de IA no WSL 2 e o gerenciamento de memoria RAM. Claude Code, Codex e OpenCode sao processos que competem por recursos, e quando a memoria acaba, o desempenho despenca — ou pior, o sistema trava.
O WSL 2 usa uma maquina virtual leve baseada em Hyper-V. Diferente do WSL 1, que compartilhava o sistema de arquivos do Windows diretamente, o WSL 2 tem seu proprio kernel Linux com gerenciamento de memoria independente. Isso significa que voce precisa configurar explicitamente quanta RAM o WSL 2 pode usar — e essa configuracao padrao raramente e ideal para cargas de trabalho multi-agente.
Neste guia, voce vai aprender a calcular, configurar e monitorar a memoria RAM do WSL 2 para rodar quantos agentes de IA voce precisar, sem surpresas.
Consumo de RAM de cada agente de IA
Antes de configurar, e importante entender quanto cada agente consome em condicoes normais e em pico de uso. Medimos os valores em um sistema com WSL 2 (Ubuntu 24.04) usando htop:
Consumo medio por agente:
Claude Code (contexto pequeno): 300-500 MB
Claude Code (contexto grande, 100k+ tokens): 1,0-1,5 GB
Codex (workers padrao): 200-500 MB
Codex (multiplos workers): 400-800 MB
OpenCode: 150-400 MB
Node.js runtime (por instancia): ~80 MB base
A formula pratica: para cada agente simultaneo, reserve 1 GB. Para tres agentes (Claude Code + Codex + OpenCode), voce precisa de pelo menos 3 GB livres dentro do WSL 2, sem contar o consumo do sistema operacional convidado (Ubuntu consome ~500 MB em idle).
Configuracao basica de RAM no .wslconfig
O arquivo .wslconfig na sua pasta de usuario e o centro de controle de recursos do WSL 2. Se ele nao existir, crie-o:
Para uma maquina com 16 GB de RAM total:
Essa configuracao reserva metade da RAM para o WSL 2, o que e suficiente para 3-4 agentes simultaneos com folga. A swap de 4 GB funciona como rede de seguranca para picos de consumo.
Configuracao para diferentes capacidades de RAM
Adapte os valores conforme sua maquina:
8 GB RAM total: memory=4GB, swap=2GB, processors=2
16 GB RAM total: memory=8GB, swap=4GB, processors=4
32 GB RAM total: memory=16GB, swap=4GB, processors=6
64 GB RAM total: memory=32GB, swap=4GB, processors=8
A regra de ouro nunca reserve mais de 60% da RAM total para o WSL 2, a menos que voce nao rode outros aplicativos pesados simultaneamente.
Tuning avancado: cgroups e limites por processo
O .wslconfig define limites globais para toda a VM do WSL 2. Para controle mais fino sobre quanto RAM cada agente pode usar, voce precisa de cgroups dentro do Linux:
Instalando cgroup-tools
Limitando o Claude Code a 1 GB
Isso garante que o Claude Code nunca ultrapasse 1 GB, mesmo que haja memoria disponivel. Repita o processo para Codex e OpenCode com limites diferentes conforme a prioridade de cada agente.
Script automatico de alocacao
Crie um script que configura os limites automaticamente ao iniciar o WSL:
Adicione ao ~/.bashrc para executar automaticamente.
Monitoramento de RAM em tempo real
Saber quanto cada agente esta consumindo e essencial para ajustar a configuracao. Aqui estao as ferramentas mais uteis:
htop (recomendado)
Pressione F4 e filtre por "claude", "codex" ou "opencode" para ver o consumo individual de cada agente. Pressione F6 para ordenar por uso de memoria.
free e smem
O comando free -h mostra o total usado e disponivel. O smem revela o uso real de memoria por processo, incluindo memoria compartilhada, que o htop nem sempre mostra com precisao.
Monitoramento no Windows
No Windows, abra o Gerenciador de Tarefas e va ate a guia "Desempenho". O processo Vmmem representa toda a memoria usada pelo WSL 2. Se esse valor estiver constantemente no limite configurado, seus agentes estao sem folga.
Sugestao de imagem: Screenshot do htop no WSL mostrando Claude Code, Codex e OpenCode em execucao, com destaque para o consumo de memoria de cada processo.
Problemas comuns de RAM com agentes no WSL 2
Mesmo com a configuracao correta, alguns sintomas indicam problemas de memoria:
- Agente trava ou fecha inesperadamente:Pode ser OOM Killer do Linux. Verifique com
dmesg | grep -i oom. Solucao: aumente a RAM alocada no .wslconfig ou reduza o numero de agentes. - Respostas muito lentas: Provavelmente o sistema esta usando swap. Verifique com
swapon --showo quanto esta sendo utilizado. Solucao: aumente a RAM ou feche agentes ociosos. - Windows fica lento enquanto agentes rodam:O Vmmem esta consumindo toda a RAM disponivel. Reduza o limite no .wslconfig para deixar mais memoria para o Windows.
- Vazamento de memoria em sessoes longas:Agentes rodando por dias acumulam memoria. Solucao: reinicie o WSL semanalmente com
wsl --shutdowne reabra o terminal.
Perguntas frequentes
Quanta RAM cada agente de IA consome no WSL 2?
Claude Code consome entre 300 MB e 1,5 GB. Codex consome 200-500 MB. OpenCode fica em 150-400 MB. Para 3 agentes simultaneos, reserve pelo menos 3 GB livres.
O que acontece quando a RAM do WSL 2 acaba?
O WSL 2 comeca a usar swap, que e muito mais lento. Agentes podem ficar 10x mais lentos ou travar. Configure swap de 2 a 4 GB como rede de seguranca.
Posso mudar a alocacao de RAM sem reiniciar o WSL?
Nao diretamente. Alteracoes no .wslconfig exigem wsl --shutdown. Mas voce pode usar cgroups para limitar agentes individuais sem reiniciar.
Hyper-V reserva memoria mesmo com WSL ocioso?
Sim. Execute wsl --shutdown no PowerShell quando nao estiver usando agentes para liberar a memoria reservada.
Devo usar memoria swap no WSL 2 para agentes?
Sim, como reserva de emergencia, nao como memoria principal. Configure 2-4 GB de swap. Se seus agentes usam swap regularmente, aumente a RAM.
Posts relacionados
Otimize a memoria dos seus agentes
Baixe o Orquestra para Windows 11 e gerencie seus agentes de IA com configuracao otimizada de WSL 2. 7 dias gratis.