Um ano atrás, o atalho para instalar um agente de código no Windows era “primeiro instale o WSL”. Hoje, a maioria dos grandes agentes se instala nativamente no PowerShell. Só que cada um tem seu caminho: um pede um script de uma linha, outro npm, outro winget ou scoop.
Este post reúne todos num só lugar. Os comandos foram tirados da documentação de cada agente em novembro de 2026; se algo não funcionar, confira primeiro a documentação do agente, porque os caminhos de instalação mudam com frequência.
Antes de começar
Node.js 20 ou superior. Codex, Gemini CLI, Copilot CLI, Qwen Code e Cline vêm como pacotes npm.
winget install OpenJS.NodeJS.LTS
node -vGit for Windows. A maioria dos agentes trabalha com git; o Claude Code também usa o Git Bash para os comandos de shell, se ele existir. Não é mais obrigatório, mas facilita a sua vida.
winget install Git.GitWindows Terminal e PowerShell 7. Não são obrigatórios, mas o Copilot CLI pede PowerShell 6 ou superior, e cores e Unicode aparecem melhor no terminal novo.
winget install Microsoft.PowerShellComandos de instalação
| Agente | Comando de instalação no Windows |
|---|---|
| Claude Code | irm https://claude.ai/install.ps1 | iex |
| Codex | npm i -g @openai/codex |
| Gemini CLI | npm i -g @google/gemini-cli |
| Copilot CLI | npm i -g @github/copilot |
| Cursor CLI | irm 'https://cursor.com/install?win32=true' | iex |
| opencode | scoop install opencode |
| Qwen Code | npm i -g @qwen-code/qwen-code |
| Kiro CLI | irm 'https://cli.kiro.dev/install.ps1' | iex |
| Droid | irm https://app.factory.ai/cli/windows | iex |
| Kimi Code | irm https://code.kimi.com/kimi-code/install.ps1 | iex |
| Crush | winget install charmbracelet.crush |
| Aider | powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex" |
| Cline CLI | npm i -g cline |
| Mistral Vibe | uv tool install mistral-vibe |
Depois de instalar, abra um terminal novo. Se a instalação mudou o PATH, os terminais já abertos não enxergam a mudança.
Notas por agente
Claude Code
irm https://claude.ai/install.ps1 | iex
claudeRoda no Windows 10 1809 ou superior. Se você usa o CMD, use o comando para CMD da documentação oficial; winget (winget install Anthropic.ClaudeCode) e npm também são opções. Se o Git for Windows estiver instalado, os comandos de shell rodam no Git Bash; senão, no PowerShell. Para apontar um Git Bash específico, defina a variável de ambiente CLAUDE_CODE_GIT_BASH_PATH. O sandbox do Claude Code não existe no Windows nativo, só no WSL 2. Detalhes: como usar o Claude Code.
Codex
npm i -g @openai/codex
codexNa primeira execução, pede login com sua conta do ChatGPT. O Codex roda nativamente no Windows com seu próprio sandbox. Detalhes: como usar o Codex CLI.
Gemini CLI
npm i -g @google/gemini-cli
geminiCom login pela conta Google, há uma cota gratuita. Detalhes: como usar o Gemini CLI.
Copilot CLI
npm i -g @github/copilot
copilotTambém pode ser instalado com winget. Requer uma assinatura do GitHub Copilot e PowerShell 6 ou superior.
Cursor CLI
irm 'https://cursor.com/install?win32=true' | iexO comando é agent (nas versões antigas, cursor-agent). Você faz login com sua conta do Cursor.
opencode
scoop install opencodechoco e npm também são opções. A documentação recomenda o WSL para a melhor experiência, mas ele também roda no Windows nativo.
Os demais
- Qwen Code e Cline se instalam com npm.
- Kiro CLI só é suportado no Windows 11.
- Droid (Factory) e Kimi Code se instalam com script de PowerShell. O antigo Kimi CLI foi arquivado; o Kimi Code tomou o lugar dele.
- Crush se instala com winget, e Mistral Vibe, com uv.
- A documentação oficial do Amp indica o WSL para Windows.
Erros de instalação comuns
“não é reconhecido” (is not recognized). Abra um terminal novo. Se ainda não aparecer, procure com where claude ou where codex; se instalou com npm, confira se a pasta de npm prefix -g está no PATH.
“a execução de scripts foi desabilitada neste sistema”. Os wrappers .ps1 que o npm instala podem esbarrar na política de execução do PowerShell. Ou libere só para o seu usuário:
Set-ExecutionPolicy -Scope CurrentUser RemoteSignedou chame o comando com a extensão .cmd, como claude.cmd ou codex.cmd.
Acentos ou emojis aparecem quebrados. A página de código do console antigo não é UTF-8. Use o Windows Terminal ou mude para UTF-8 com chcp 65001.
irm ... | iex dá erro na rede da empresa. Um proxy ou software de segurança pode estar bloqueando o script. Tente o caminho do winget ou do npm.
Erros de caminho longo. Pastas node_modules profundas podem bater no limite de 260 caracteres. Configure git config --global core.longpaths true e coloque os projetos numa raiz curta como C:\src.
Depois de instalar: rodar todos juntos
Se você instalou vários agentes, acompanhá-los em janelas de terminal separadas cansa rápido. O AgentVera é um app desktop que roda nativamente no Windows: encontra sozinho os agentes instalados, mostra a dica de instalação para Windows ao lado dos que faltam e abre todos lado a lado numa grade por projeto.
Como ele abre os wrappers .cmd que o npm instala e inicia diretamente o script que eles envolvem, a interpretação de argumentos do cmd.exe não estraga papéis nem configurações em JSON que contenham & ou %.
Para gerenciar vários agentes em paralelo, veja agentes de código no Windows; para decidir se vale migrar para o WSL, WSL ou Windows nativo; e para o resumo completo, a página do Windows.