Como usar o cURL no Windows 10: Comandos essenciais

O Windows 10 inclui o curl.exe , permitindo que você faça requisições web a partir do PowerShell ou do Prompt de Comando sem precisar instalar uma ferramenta separada. Abra um terminal, verifique se ele está em execução e, em seguida, use o cURL com uma URL para recuperar uma página, inspecionar cabeçalhos de resposta, baixar um arquivo ou enviar dados para uma API. No Windows PowerShell 5.1, digite `curl` curl.exeem vez de `curl` para curlque o PowerShell execute o programa cURL real.

1. Abra um terminal e verifique o cURL.

Abra o Menu Iniciar, procure por PowerShell ou Prompt de Comando e execute-o normalmente. Permissões de administrador não são necessárias para solicitações ou downloads comuns em suas pastas de usuário.

curl.exe --version

A saída inclui a versão instalada e os protocolos e recursos disponíveis nessa versão. O Windows PowerShell 5.1 possui um alias integrado curlpara o Invoke-WebRequestcomando separado, portanto, comandos copiados de tutoriais do Linux podem se comportar de maneira diferente, a menos que você use ` curl.exe. O PowerShell 7 não define esse alias. A Microsoft documenta essa diferença em seu guia do cURL no Windows .

2. Faça uma solicitação básica

Insira um URL após o comando. O cURL usa o método HTTP GET por padrão e escreve o corpo da resposta no terminal:

curl.exe "https://example.com"

Para uma página web, a resposta é HTML; uma API pode retornar JSON ou outro formato. O comando transfere a resposta tal como está, em vez de a renderizar como um navegador. Se um URL contiver caracteres como `\` &ou `\` ?, mantenha o URL completo entre aspas para que o shell o passe como um único argumento.

3. Verifique os cabeçalhos de resposta

Use letras maiúsculas -Ipara enviar uma solicitação HEAD e exibir os cabeçalhos da resposta sem baixar o corpo:

curl.exe -I "https://example.com"

Os cabeçalhos podem exibir o status HTTP, o tipo de conteúdo, detalhes de cache e outros metadados do servidor. Alguns serviços não suportam o método HEAD ou retornam um resultado diferente para ele em comparação com o método GET. Para incluir cabeçalhos em uma resposta GET comum, use letras minúsculas -i. Utilize-os -Lquando o servidor redirecionar a solicitação e você quiser que o cURL siga esse redirecionamento.

4. Salvar a resposta em um arquivo

Por padrão, o cURL imprime os dados da resposta no terminal. Use -o`--filename` para escolher um nome de arquivo e um local. Este exemplo em PowerShell grava uma resposta HTML na sua pasta de Downloads:

curl.exe -L -o "$env:USERPROFILE\Downloads\example.html" "https://example.com"

-Lsegue redirecionamentos, enquanto -onomeia o arquivo de saída. O comando sobrescreve um arquivo com o mesmo nome, portanto, escolha um destino com cuidado. Para salvar na pasta atual, use curl.exe -L -o "example.html" "https://example.com". A -Oopção (letra O maiúscula) usa o nome do arquivo da URL:

curl.exe -L -O "https://example.com/files/archive.zip"

O segundo URL é um exemplo de formato; substitua-o por um URL direto para um arquivo existente e que você tenha autorização para baixar.

5. Enviar JSON para uma API

Para uma requisição POST em JSON, especifique o método, o tipo de conteúdo e o corpo da requisição. Substitua o endpoint de exemplo pela URL da sua API:

curl.exe -X POST "https://api.example.com/items" -H "Content-Type: application/json" -d '{"name":"widget"}'

-X POSTSeleciona o método HTTP, -Hadiciona um cabeçalho e -dfornece o corpo da requisição. O servidor deve aceitar requisições POST e os campos JSON devem corresponder à sua API. Não cole senhas, tokens privados ou outros segredos em um comando se o histórico do seu terminal ou logs compartilhados puderem expô-los. O manual oficial do cURL lista essas opções e seus requisitos de versão.

Corrigir problemas comuns

• "O comando 'curl' não foi reconhecido." Execute-o where.exe curlno PowerShell ou no Prompt de Comando. No Windows 10, a cópia da Microsoft geralmente está disponível como ` cURL` C:\Windows\System32\curl.exe. Se o executável estiver faltando em uma instalação personalizada, baixe uma versão para Windows na página oficial do cURL para Windows , escolha o pacote para o seu sistema e execute-o curl.exea partir da pasta extraída. Adicione essa pasta ao PATH somente se desejar executá-lo de qualquer diretório.
• O PowerShell indica que um parâmetro é inválido. Certifique-se de que o comando comece com ` curl.exe.`. No Windows PowerShell 5.1, o comando `plain` curlpode ser usado Invoke-WebRequestem vez de `.`.
• A solicitação falha com um erro de certificado HTTPS. Verifique a data e a hora do computador, atualize o Windows e verifique se um proxy ou produto de segurança da empresa exige um certificado confiável. Evite usar -kessa solução como rotina, pois ela desativa a verificação de certificados.

O Windows 10 ainda executa o cURL, mas a Microsoft encerrou o suporte ao Windows 10 em 14 de outubro de 2025. Dispositivos fora de um programa de atualização de segurança aplicável não recebem mais correções de segurança regulares; consulte o aviso de suporte do Windows 10 da Microsoft .