Windows Port Process Management is a operations claude skill built by gzpaitch. Best for: Developers and system administrators need to free up blocked ports (like 3000 for Node.js) by identifying and killing processes—this skill provides exact commands and interpretation guides for Windows environments..
- What it does
- Identify and terminate processes occupying specific Windows ports using netstat and taskkill commands with practical examples.
- Category
- operations
- Created by
- gzpaitch
- Last updated
Windows Port Process Management
Identify and terminate processes occupying specific Windows ports using netstat and taskkill commands with practical examples.
Skill instructions
Gerenciar Processos e Portas no Windows
Índice
Identificar processos usando uma porta
Comando básico
netstat -ano | findstr :PORTA
taskkill /F /PID NUMERO_DO_PID
Explicação dos parâmetros:
netstat- Comando que exibe conexões de rede ativas-a- Exibe todas as conexões e portas de escuta-n- Exibe endereços e portas em formato numérico-o- Exibe o PID (Process ID) associado a cada conexão|- Pipe (redireciona a saída para outro comando)findstr- Filtra linhas que contêm o texto especificado:PORTA- O número da porta que você quer verificar (ex::3000)
Exemplo de saída
TCP 0.0.0.0:3000 0.0.0.0:0 LISTENING 50060
TCP [::]:3000 [::]:3000 LISTENING 50060
TCP [::1]:3000 [::1]:52820 ESTABLISHED 50060
Interpretação das colunas:
- Protocolo - TCP ou UDP
- Endereço Local - IP:Porta local
- Endereço Remoto - IP:Porta remota
- Estado - Status da conexão (LISTENING, ESTABLISHED, CLOSE_WAIT, etc.)
- PID - Process ID (última coluna) - ESTE É O NÚMERO QUE VOCÊ PRECISA
Entender o PID
O que é PID?
PID (Process ID) é um número único que identifica cada processo em execução no sistema operacional.
Como identificar o PID na saída do netstat
Na saída do comando netstat -ano, o PID está sempre na última coluna:
TCP 0.0.0.0:3000 0.0.0.0:0 LISTENING 50060
^^^^^
Este é o PID
Estados de conexão comuns
- LISTENING - O processo está escutando/aguardando conexões naquela porta
- ESTABLISHED - Conexão ativa estabelecida
- CLOSE_WAIT - Conexão sendo fechada
- TIME_WAIT - Aguardando para garantir que a conexão foi fechada
- FIN_WAIT - Finalizando conexão
Encerrar processos
Comando para encerrar um processo
IMPORTANTE: O número de barras depende do terminal que você está usando!
CMD do Windows (Prompt de Comando)
taskkill /F /PID NUMERO_DO_PID
Git Bash / Bash no Windows
taskkill //F //PID NUMERO_DO_PID
Explicação dos parâmetros:
taskkill- Comando para encerrar processos/Fou//F- Force (força o encerramento do processo)/PIDou//PID- Especifica que você vai informar um Process IDNUMERO_DO_PID- O número do PID que você identificou
Por que a diferença?
- No CMD do Windows, use uma barra (
/F,/PID) - No Git Bash ou terminais Unix-like, use duas barras (
//F,//PID) porque uma barra é interpretada como caminho de arquivo
Verificar qual programa está usando o PID (opcional)
Antes de matar um processo, você pode verificar qual programa ele representa:
tasklist | findstr NUMERO_DO_PID
Exemplos práticos
Exemplo 1: Liberar a porta 3000
Passo 1: Identificar qual processo está usando a porta
netstat -ano | findstr :3000
Saída:
TCP 0.0.0.0:3000 0.0.0.0:0 LISTENING 50060
TCP [::]:3000 [::]:3000 LISTENING 50060
Passo 2: Identificar o PID (última coluna): 50060
Passo 3: (Opcional) Ver qual programa é
tasklist | findstr 50060
Passo 4: Encerrar o processo
No CMD:
taskkill /F /PID 50060
No Git Bash:
taskkill //F //PID 50060
Passo 5: Verificar se a porta está livre
netstat -ano | findstr :3000
Se não houver saída, a porta está livre!
Exemplo 2: Múltiplos processos na mesma porta
Se você encontrar vários PIDs diferentes:
TCP 0.0.0.0:3000 0.0.0.0:0 LISTENING 50060
TCP [::1]:3000 [::1]:52820 ESTABLISHED 14144
Você precisa encerrar cada PID individualmente:
No CMD:
taskkill /F /PID 50060
taskkill /F /PID 14144
No Git Bash:
taskkill //F //PID 50060
taskkill //F //PID 14144
Exemplo 3: Portas comuns em desenvolvimento
| Porta | Uso comum | | ----- | ------------------------------------- | | 3000 | React, Node.js | | 4200 | Angular | | 5000 | Flask, .NET | | 8000 | Django, Python HTTP Server | | 8080 | Tomcat, servidores de desenvolvimento | | 9000 | PHP, diversos frameworks |
Resumo dos comandos
No CMD do Windows
# 1. Descobrir quem está usando a porta
netstat -ano | findstr :PORTA
# 2. Identificar qual programa (opcional)
tasklist | findstr PID
# 3. Encerrar o processo
taskkill /F /PID NUMERO_DO_PID
# 4. Confirmar que a porta está livre
netstat -ano | findstr :PORTA
No Git Bash
# 1. Descobrir quem está usando a porta
netstat -ano | findstr :PORTA
# 2. Identificar qual programa (opcional)
tasklist | findstr PID
# 3. Encerrar o processo
taskkill //F //PID NUMERO_DO_PID
# 4. Confirmar que a porta está livre
netstat -ano | findstr :PORTA
Dicas importantes
- Sempre identifique o processo antes de matar - Use
tasklistpara ter certeza do que está encerrando - Cuidado com processos do sistema - Alguns PIDs são críticos para o Windows
- Use //F com cuidado - A flag force encerra sem salvar dados
- Várias instâncias - Se você iniciou o mesmo servidor várias vezes, pode haver múltiplos PIDs
- Reinicie se necessário - Se um processo não morrer, pode ser necessário reiniciar o computador
Alternativas
PowerShell (alternativa mais moderna)
# Encontrar processo na porta 3000
Get-NetTCPConnection -LocalPort 3000 | Select-Object -Property LocalPort, OwningProcess
# Encerrar processo
Stop-Process -Id PID -Force
GUI (Interface Gráfica)
- Abra o Gerenciador de Tarefas (Ctrl + Shift + Esc)
- Vá na aba Detalhes
- Procure pelo PID
- Clique com botão direito > Finalizar tarefa
Use this skill
Most skills are portable instruction packages. Claude Code supports SKILL.md directly. Other agents can use adapted files like AGENTS.md, .cursorrules, and GEMINI.md.
Claude Code
Save SKILL.md into your Claude Skills folder, then restart Claude Code.
mkdir -p ~/.claude/skills/windows-port-process-management && curl -L "https://raw.githubusercontent.com/gzpaitch/gztips/7d51e42b22053f10354fcd5ce5c430d32dde70a8/FIND-TASKILL.md" -o ~/.claude/skills/windows-port-process-management/SKILL.mdInstalls to ~/.claude/skills/windows-port-process-management/SKILL.md.
Use cases
Developers and system administrators need to free up blocked ports (like 3000 for Node.js) by identifying and killing processes—this skill provides exact commands and interpretation guides for Windows environments.
Reviews
No reviews yet. Be the first to review this skill.