Windows 10でcURLを使用する方法：必須コマンド

Windows 10 にはcurl.exe が含まれているため、別のツールをインストールすることなく、PowerShell またはコマンド プロンプトから Web リクエストを実行できます。ターミナルを開き、実行されていることを確認してから、cURL を URL とともに使用して、ページを取得したり、応答ヘッダーを調べたり、ファイルをダウンロードしたり、API にデータを送信したりできます。Windows PowerShell 5.1 では、curl.exeではなく と入力するとcurl、PowerShell が実際の cURL プログラムを実行します。

1. ターミナルを開いてcURLを確認します。

スタートメニューを開き、「PowerShell」または「コマンドプロンプト」を検索して、通常どおり起動してください。通常のリクエストやユーザーフォルダへのダウンロードには、管理者権限は必要ありません。

curl.exe --version

curl出力には、インストールされているバージョンと、そのビルドで使用可能なプロトコルと機能が含まれます。Windows PowerShell 5.1 には、別のコマンドにという名前の組み込みのエイリアスがあるInvoke-WebRequestため、 を使用しない限り、Linux チュートリアルからコピーしたコマンドは異なる動作をする可能性がありますcurl.exe。PowerShell 7 では、このエイリアスは定義されていません。Microsoft はこの違いをWindows での cURL ガイドで説明しています。

2. 基本的なリクエストをする

コマンドの後にURLを入力してください。cURLはデフォルトでHTTP GETを使用し、レスポンスボディをターミナルに出力します。

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

ウェブページの場合、レスポンスはHTML形式です。APIの場合は、JSON形式または別の形式が返される場合があります。このコマンドは、ブラウザのようにレンダリングするのではなく、レスポンスをそのまま転送します。URLに「 」や&「」などの文字が含まれている場合は?、シェルが1つの引数として渡すように、URL全体を引用符で囲んでください。

3. レスポンスヘッダーを確認する

-IHEADリクエストを送信し、レスポンスボディをダウンロードせずにレスポンスヘッダーを表示するには、大文字を使用してください。

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

ヘッダーには、HTTP ステータス、コンテンツタイプ、キャッシュの詳細、その他のサーバーメタデータを表示できます。一部のサービスは HEAD をサポートしていないか、GET とは異なる結果を返します。通常の GET レスポンスにヘッダーを含めるには、小文字を使用します-i。-Lサーバーがリクエストをリダイレクトし、cURL にそのリダイレクトに従わせたい場合は、これを使用します。

4. 回答をファイルに保存する

デフォルトでは、cURLは応答データをターミナルに出力します。-oファイル名と保存場所を選択するには、を使用します。このPowerShellの例では、HTML応答をダウンロードフォルダに書き込みます。

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

-Lはリダイレクトに従い、-o出力ファイル名を指定します。このコマンドは同名のファイルを上書きするため、保存先は慎重に選択してください。現在のフォルダに保存するには、 を使用しますcurl.exe -L -o "example.html" "https://example.com"。-Oオプション (大文字の O) は、代わりに URL からファイル名を使用します。

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

2番目のURLは例です。実際に存在し、ダウンロード権限のあるファイルの直接URLに置き換えてください。

5. JSONをAPIに送信する

JSON POSTリクエストの場合は、メソッド、コンテンツタイプ、およびリクエストボディを指定してください。例のエンドポイントを、ご自身のAPIのURLに置き換えてください。

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

-X POSTHTTPメソッドを選択し、-Hヘッダーを追加して、-dボディを指定します。サーバーはPOSTリクエストを受け入れる必要があり、JSONフィールドはサーバーのAPIと一致している必要があります。ターミナル履歴や共有ログにパスワード、秘密トークン、その他の機密情報が記録される可能性があるため、コマンドにこれらの情報を貼り付けないでください。これらのオプションとそのバージョン要件については、公式のcURLマニュアルを参照してください。

よくある問題を修正する

• 「curl が認識されません。」 PowerShell またはコマンド プロンプトで実行してくださいwhere.exe curl。Windows 10 では、通常 Microsoft 版は として利用できますC:\Windows\System32\curl.exe。カスタマイズされたインストールで実行ファイルが見つからない場合は、公式の cURL for Windows ページから Windows ビルドをダウンロードし、システム用のパッケージを選択して、curl.exe展開したフォルダーから実行してください。任意のディレクトリから起動したい場合にのみ、そのフォルダーを PATH に追加してください。
• PowerShell はパラメーターが無効であると報告しています。コマンドが で始まっていることを確認してくださいcurl.exe。Windows PowerShell 5.1 では、代わりにcurlが呼び出される場合がありますInvoke-WebRequest。
• HTTPS証明書エラーによりリクエストが失敗しました。PCの日付と時刻を確認し、Windowsをアップデートし、職場のプロキシまたはセキュリティ製品が信頼できる証明書を必要としているかどうかを確認してください。-k証明書の検証が無効になるため、ルーチン的な解決策として使用しないでください。

Windows 10 では引き続き cURL が動作しますが、Microsoft は 2025 年 10 月 14 日に Windows 10 のサポートを終了しました。セキュリティ更新プログラムの対象外のデバイスは、定期的なセキュリティ修正プログラムを受け取ることができなくなります。詳細については、Microsoft のWindows 10 サポートに関する通知を参照してください。