Preciso de uma GPU dedicada para usar agentes de IA?

Para agentes como Claude Code e Codex que rodam na nuvem, GPU nao e necessaria — eles processam tudo nos servidores. GPU e util se voce tambem roda modelos locais (LLaMA, Mistral, Phi) ou faz processamento local como embeddings, transcricao ou geracao de imagens com ferramentas que acompanham os agentes.

Como verifico se a GPU esta sendo usada dentro do WSL 2?

Use nvidia-smi (NVIDIA) ou rocm-smi (AMD) dentro do WSL. Se o comando funciona e mostra sua GPU, a aceleracao esta ativa. Para monitorar uso em tempo real, use nvidia-smi -l 1 para atualizar a cada segundo.

Aceleracao GPU no WSL 2 tem perda de performance comparada ao Linux nativo?

A perda e minima — tipicamente 1-3% para NVIDIA CUDA e 3-5% para AMD ROCm. A Microsoft e a NVIDIA investiram pesado na parceria GPU-PV (GPU Paravirtualization) que fornece acesso praticamente nativo aos recursos de GPU dentro do WSL 2.

WSL · 2026-07-12

Aceleracao GPU no WSL 2 para Agentes de IA

Configure aceleracao GPU no WSL 2 para agentes de IA no Windows. NVIDIA CUDA, AMD ROCm e Intel OneAPI para Claude Code, Codex e Orquestra.

Se voce achava que GPU no WSL 2 era coisa de Linux, prepare-se para uma surpresa. O Windows 11 oferece suporte nativo a passagem de GPU para o Subsistema Linux, permitindo que agentes de IA dentro do WSL 2 utilizem toda a potencia da sua placa de video.

Embora Claude Code e Codex rodem majoritariamente na nuvem, a aceleracao GPU no WSL 2 e fundamental para tarefas locais: embeddings semanticos, executores de codigo que usam GPU, ferramentas de processamento de imagem e audio, e modelos locais que complementam os agentes.

Este guia cobre a configuracao para NVIDIA CUDA, AMD ROCm e Intel OneAPI no WSL 2, com exemplos praticos de uso com o Orquestra.

Requisitos para GPU no WSL 2

Antes de comecar, verifique se seu sistema atende aos requisitos minimos. O suporte a GPU no WSL 2 (GPU-PV) esta disponivel desde o Windows 11 build 22000:

Windows 11: Build 22000 ou superior (versao 21H2+). Recomendado 23H2 ou superior.
WSL 2: Versao mais recente. Atualize comwsl --update no PowerShell.
NVIDIA:Driver 525.41+ (Game Ready ou Studio) ou o driver "CUDA on WSL" especifico.
AMD: Driver Radeon Adrenalin 23.30+ para GPUs Radeon RX 6000/7000 series.
Intel: Driver 31.0.101.5186+ para GPUs Arc A-series e Intel Iris Xe integradas.

Nota importante: O driver deve ser instalado no Windows, nao dentro do WSL. O WSL 2 usa o driver do Windows para acessar a GPU. A instalaçao de drivers Linux dentro do WSL e opcional e usada apenas para ferramentas especificas como CUDA Toolkit.

Configuracao NVIDIA CUDA no WSL 2

A NVIDIA tem a integracao mais madura com WSL 2. O processo e direto:

1. Instale o driver NVIDIA correto

Baixe e instale o driver NVIDIA Game Ready ou Studio 525.41+ diretamente do site da NVIDIA. Durante a instalacao, escolha "Limpa" para garantir que versoes antigas nao interfiram.

2. Instale o CUDA Toolkit dentro do WSL

# Dentro do WSL (Ubuntu 24.04){' '} wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-keyring_1.1-1_all.deb{' '} sudo dpkg -i cuda-keyring_1.1-1_all.deb{' '} sudo apt update{' '} sudo apt install cuda-toolkit-12-5

3. Verifique a instalacao

nvidia-smi{' '} # Deve mostrar sua GPU, driver e uso de memoria

Se o nvidia-smi funciona dentro do WSL, sua GPU esta acessivel. O comando mostra o driver do Windows (na versao WSL) e as GPUs disponiveis.

4. Teste com um container Docker

docker run --gpus all nvidia/cuda:12.5.0-runtime-ubuntu24.04 nvidia-smi

Esse comando confirma que o Docker tambem consegue acessar a GPU, util para rodar modelos locais que agentes de IA consultam.

Configuracao AMD ROCm e Intel OneAPI

Tanto a AMD quanto a Intel oferecem suporte a GPU no WSL 2, embora com menos ferramentas que a NVIDIA.

AMD ROCm

A AMD suporta GPUs Radeon RX 6000/7000 series no WSL 2 via ROCm. A instalacao requer o driver Radeon Adrenalin 23.30+ no Windows e o ROCm dentro do WSL:

# Dentro do WSL{' '} sudo apt update{' '} sudo apt install rocm-dev{' '} # Verificar{' '} rocm-smi

Intel OneAPI

GPUs Intel Arc A-series e Iris Xe integradas sao suportadas via OneAPI. A configuracao e via driver Intel no Windows e pacotes Intel no WSL:

# Dentro do WSL{' '} wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB | sudo gpg --dearmor | sudo tee /usr/share/keyrings/oneapi-archive-keyring.gpg{' '} echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | sudo tee /etc/apt/sources.list.d/oneAPI.list{' '} sudo apt update && sudo apt install intel-basekit

Uso pratico da GPU com agentes de IA no Orquestra

Com a GPU configurada no WSL, voce pode usar o Orquestra para orquestrar tarefas que dependem de aceleracao grafica:

Modelos locais para agentes

Instale ferramentas como Ollama ou LM Studio para rodar modelos locais que os agentes podem consultar:

# Instalar Ollama no WSL{' '} curl -fsSL https://ollama.com/install.sh | sh{' '} ollama pull mistral{' '} # No Orquestra, Claude Code pode consultar o modelo local{' '} curl http://localhost:11434/api/generate -d '{'{'} "model": "mistral", "prompt": "Revise este codigo: ..." {'}'}'

Claude Code pode delegar revisoes de codigo para modelos locais rodando na GPU, liberando tokens da API da Anthropic.

Embeddings semanticos locais

Para buscas semanticas em grandes bases de codigo, use embeddings locais acelerados por GPU:

pip install sentence-transformers --upgrade{' '} python -c "from sentence_transformers import SentenceTransformer; model = SentenceTransformer('all-MiniLM-L6-v2'); print('GPU disponivel:', model.device)"

Os embeddings podem alimentar ferramentas de RAG (Retrieval Augmented Generation) que agentes de IA usam para buscar contexto em grandes repositorios.

Sugestao de imagem: Screenshot do terminal WSL executando nvidia-smi, mostrando o uso de GPU durante uma sessao do Claude Code no Orquestra.

Problemas comuns com GPU no WSL 2

Mesmo com a configuracao correta, alguns problemas sao frequentes:

nvidia-smi nao funciona no WSL:Provavelmente o driver do Windows nao e compativel. Atualize para o driver "CUDA on WSL" ou a versao Game Ready mais recente.
GPU nao aparece no Docker:Verifique se o Docker Desktop esta configurado com backend WSL 2 e se o --gpus all foi passado no comando.
Performance baixa na GPU:O WSL 2 compartilha a GPU com o Windows. Feche programas que usam GPU (jogos, renderizadores) para liberar recursos para seus agentes.
Erro de driver apos atualizacao do Windows:Atualizacoes do Windows podem quebrar a compatibilidade. Reinstale o driver NVIDIA ou AMD apos cada atualizacao grande do Windows.
WSL 2 nao inicia com GPU ativa:Execute wsl --shutdown e depois wsl novamente. Se persistir, desabilite e reabilite a virtualizacao na BIOS.

Perguntas frequentes

Toda GPU funciona com WSL 2?

Nao. NVIDIA requer driver 525.41+, AMD requer Adrenalin 23.30+, Intel requer driver 5186+. GPUs muito antigas podem nao ser suportadas.

Preciso de GPU para usar agentes de IA?

Nao para Claude Code e Codex (rodam na nuvem). GPU e necessaria para modelos locais, embeddings e processamento local de imagem/audio.

Como verifico se a GPU esta ativa no WSL?

Use nvidia-smi (NVIDIA) ou rocm-smi (AMD) dentro do WSL. Se funciona e mostra sua GPU, a aceleracao esta ativa.

Docker consegue usar a GPU do WSL 2?

Sim. Com Docker Desktop configurado para WSL 2 e --gpus all, containers acessam a GPU diretamente.

Tem perda de performance comparada ao Linux nativo?

Minima. 1-3% para NVIDIA CUDA, 3-5% para AMD ROCm. A tecnologia GPU-PV da Microsoft fornece acesso praticamente nativo.

GPU acelerada no Orquestra

Baixe o Orquestra para Windows 11 e aproveite a aceleracao GPU no WSL 2 para seus agentes de IA. Canvas infinito com suporte NVIDIA, AMD e Intel. 7 dias gratis.

Começar teste grátis