# HTTP クライアント

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

HTTP クライアント プラグインを使用し、CLion の [コードエディター](using-code-editor.html)で HTTP リクエストを直接作成・編集・実行できます。

![Example HTTP request](https://resources.jetbrains.com/help/img/idea/2026.3/basic_request.animated.gif)

HTTP リクエストを作成して実行する必要がある場合、主に 2 つのユースケースがあります：

* RESTful Web サービスを開発していて、それが期待どおりに機能し、仕様に準拠してアクセス可能であり、正しく応答することを確認したい場合。

* RESTful Web サービスに対応するアプリケーションを開発している場合。 この場合、開発を開始する前にサービスへのアクセスと必要な入力データを調査すると役立ちます。 開発中に、アプリケーションの外部からこの Web サービスを呼び出すこともできます。 これは、コード内で論理エラーが検出されないにもかかわらず、アプリケーションで予期しない出力が発生し、Web サービスとの対話がボトルネックであると疑われる場合に、エラーを特定できます。

HTTP リクエストは  `.http`  および  `.rest`  ファイルに保存され、 ![HTTP ファイルアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/restClient.com.intellij.ws.rest.client.icons.expui.httpRequestsFiletype.svg) アイコンでマークされます。

HTTP ファイルのサポートには、以下の機能が含まれます：

* [コードのハイライト](configuring-colors-and-fonts.html)

* [コード補完](auto-completing-code.html)は、 [OpenAPI](openapi.html)で定義されたホスト、メソッドタイプ、ヘッダーフィールド、エンドポイントに対応します。

* リクエストやその一部、レスポンスハンドラースクリプトの [コードの折りたたみ](working-with-source-code.html#code_folding)

* [リフォーマット](reformat-and-rearrange-code.html)で、 HTTP リクエスト コードスタイルに合わせてリクエストを整形できます。

* リクエストヘッダーフィールドとドキュメントタグの [インラインドキュメント](null)

* HTTP リクエストファイルの [構造を見る](#structure-tool-window)

* 要求メッセージ本体内の [Web 言語での言語インジェクション](using-language-injections.html)

* [ライブテンプレート](using-live-templates.html)

必要であれば、作業開始前に [HTTP プロキシ](settings-http-proxy.html) ページ（   設定   ダイアログ、 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）でプロキシ設定を構成してください。

## HTTP リクエストファイルを作成する

スクラッチファイルまたは   HTTP リクエスト   タイプの物理ファイルから HTTP リクエストを処理できます。 各ファイルには複数の要求を含めることができ、必要な数のファイルを作成できます。

[スクラッチファイル](scratches.html)は、開発中の HTTP リクエストテストに利用できます。 スクラッチファイルはプロジェクト内に保存されないため、CLion で自由に編集したり、リクエストに追加情報を付与できます。 スクラッチファイルから HTTP リクエストを実行すると、応答出力ファイルへのリンクがリクエストの下と [リクエスト履歴](#requests_history)ファイルの上部に追加されます。

Procedure: HTTP リクエストスクラッチファイルを作成する

* `Ctrl+Alt+Shift+Insert` (Windows), `⌘ ⇧ N` (macOS), `⌃ ⇧ N` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ N` (macOS System Shortcuts), `Ctrl+Alt+Shift+Insert` (XWin), `Ctrl+Alt+Shift+Insert` (GNOME), `Ctrl+Alt+Shift+Insert` (KDE), `Ctrl+Alt+Shift+Insert` (Emacs), `Ctrl+Alt+Shift+Insert` (Sublime Text), `⌘ ⇧ N` (Sublime Text (macOS)), `Ctrl+Alt+Shift+Insert` (Xcode), `Ctrl+Alt+Shift+Insert` (Visual Studio), `⌘ ⇧ N` (Visual Studio (macOS)), `Ctrl+Alt+Shift+Insert` (ReSharper), `⌘ ⇧ N` (ReSharper (macOS)), `Ctrl+Alt+Shift+Insert` (QtCreator), `Ctrl+Alt+Shift+Insert` (QtCreator (macOS)), `Ctrl+Alt+Shift+Insert` (NetBeans), `Ctrl+Alt+Shift+Insert` (Eclipse), `⌘ ⇧ N` (Eclipse (macOS)) を押して   HTTP リクエスト   を選択します。

物理ファイル は、HTTP リクエストの文書化、テスト、検証に使用できます。 物理ファイルはプロジェクト内に保存され、CLion では変更されません。 物理ファイルから HTTP リクエストが実行された場合、このファイルは変更されません。 実行されたリクエストに関する情報とレスポンス出力ファイルへのリンクは、 [リクエスト履歴](#requests_history)ファイルの先頭に追加されます。

Procedure: 物理 HTTP リクエストファイルを作成する

* ファイル   メニューで   新規   をポイントし、   HTTP リクエスト   をクリックします。

Procedure: HTTP リクエストを移動する

`F6` (Windows), `F6` (macOS), `F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ I` (macOS System Shortcuts), `F6` (XWin), `F6` (GNOME), `F6` (KDE), `F6` (Emacs), `F6` (Sublime Text), `F6` (Sublime Text (macOS)), `⌥ F6` (Xcode), `Ctrl+R, O` (Visual Studio), `⌘ R, O` (Visual Studio (macOS)), `F6` (ReSharper), `F6` (ReSharper (macOS)), `F6` (QtCreator), `F6` (QtCreator (macOS)), `Ctrl+M` (NetBeans), `Alt+Shift+V` (Eclipse), `⌘ ⌥ V` (Eclipse (macOS)) リファクタリング [移動](null)を使用して、HTTP リクエストをスクラッチから物理ファイルに移動したり、物理ファイル間で移動したりできます。

1. エディターで移動するリクエストにキャレットを置き、次のいずれかを実行します：

* メインメニューまたはコンテキストメニューから、 `リファクタリング | 移動` を選択します。

* `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) を押し、 `リファクタリング` の入力を開始して、リストからアクションを選択します。 開いた リファクタリング ポップアップで、 移動 を選択します。

* `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押し、 HTTP リクエストの移動 [インテンションアクション](intention-actions.html) を選択します。

* `F6` (Windows), `F6` (macOS), `F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ I` (macOS System Shortcuts), `F6` (XWin), `F6` (GNOME), `F6` (KDE), `F6` (Emacs), `F6` (Sublime Text), `F6` (Sublime Text (macOS)), `⌥ F6` (Xcode), `Ctrl+R, O` (Visual Studio), `⌘ R, O` (Visual Studio (macOS)), `F6` (ReSharper), `F6` (ReSharper (macOS)), `F6` (QtCreator), `F6` (QtCreator (macOS)), `Ctrl+M` (NetBeans), `Alt+Shift+V` (Eclipse), `⌘ ⌥ V` (Eclipse (macOS)) を押す。

2. 開いた   HTTP リクエストの移動   ダイアログで、次の手順を実行します。

1.

パス  フィールドで、リストから既存の  `.http` ファイルを選択するか、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)をクリックしてファイルを指定します。

ファイルへのフルパスを手動で入力することもできます。 存在しないファイルの名前を指定すると、指定した名前の新しいファイルが自動的に作成されます。

2.    要求   リストで移動したいリクエスト横のチェックボックスを選択します。

## HTTP リクエストを作成する

CLion で使用する  HTTP リクエスト in エディター フォーマットは、HTTP リクエストを簡単に作成・実行・保存できる方法を提供します。 [作成した HTTP リクエストファイル](#creating-http-request-files)で、以下の一般構文を使って直接入力できます：

```GENERIC
###
Method Request-URI HTTP-Version
Header-field: Header-value

Request-Body

```

`###`  セパレーターの後に、  `#`  または  `//`  で始まるコメントを入力できます。

> **Tip:**
> 実行 / デバッグ構成、   どこでも検索  、   Run Anything   でリクエストを素早く見つけるために、 [名前を付ける](exploring-http-syntax.html#http_request_names)ことができます。

> **Note:**
> `エディター | カラースキーム | HTTP リクエスト` 設定を使って、リクエスト構文（名前、コメント、パラメーター、ヘッダーなど）のハイライトする色やスタイルを [カスタマイズ](configuring-colors-and-fonts.html#customize-color-scheme)できます。

HTTP リクエストの作成を高速化するには、次のことができます：

* `ツール | HTTP クライアント | HTTP クライアントでリクエストを作成` をクリックします。 リクエストファイルがエディターで開かれると、開かれたファイルにリクエストテンプレートが追加されます。 それ以外の場合は、新しい `.http` スクラッチファイルが作成されます。

* リクエストのエディターパネルの上部にある ![リクエスト追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックします。 ポップアップメニューで追加するリクエストの種類を選択します。 ![HTTP リクエストを追加する](https://resources.jetbrains.com/help/img/idea/2026.3/add-http-request.png)

または [ライブテンプレート](using-live-templates.html)を利用できます。 エディター上で `Ctrl+J` (Windows), `⌘ J` (macOS), `⌘ J` (IntelliJ IDEA Classic (macOS)), `⌘ J` (macOS System Shortcuts), `Ctrl+J` (XWin), `Ctrl+J` (GNOME), `Ctrl+J` (KDE), `Ctrl+J` (Emacs), `Ctrl+J` (Sublime Text), `Ctrl+J` (Sublime Text (macOS)), `⌘ J` (Xcode), `Ctrl+K, X` (Visual Studio), `⌘ E, L` (Visual Studio (macOS)), `Ctrl+J` (ReSharper), `⌘ J` (ReSharper (macOS)), `Ctrl+J` (QtCreator), `Ctrl+J` (QtCreator (macOS)), `Ctrl+J` (NetBeans), `Ctrl+Alt+Shift+J` (Eclipse), `Ctrl+J` (Eclipse (macOS)) を押すと、利用可能なテンプレート一覧が表示されます。 例として、   gtr   はシンプルな GET リクエスト、   mptr   は  `multipart/form-data`  POST リクエストとなります。

![Expand post template](https://resources.jetbrains.com/help/img/idea/2026.3/expand_post_template.animated.gif)

> **Tip:**
> `application/x-www-form-urlencoded`  コンテンツタイプを使用する場合は、リクエスト本文のキーと値内の  `%`  、  `&`  、  `=`  、  `+`  特殊文字をエスケープするために  `%`  を使用する必要があります。
>
>
>
> 例: サーバーが  `field1=value%2Bvalue&field2=value%26value`  (  `%2B`  は  `+`  に対応し、  `%26`  は  `&`  に対応) を受信する場合、リクエスト本体は次のようになります。
>
>
>
>
> ```
> POST https://ijhttp-examples.jetbrains.com/post
> Content-Type: application/x-www-form-urlencoded
>
> field1=value%+value&field2=value%&value
>
> ```
>
>
>
> または、エンコードされた値をすぐに書き込むこともできます。たとえば、  `value1 value2` の場合は  `value1%ADvalue2` 、  `value1+value2` の場合は  `value1%2Bvalue2` です。

Procedure: カスタム HTTP メソッドを作成する

Web サービスでカスタム HTTP メソッドを必要とする場合、そのメソッドを CLion に追加して HTTP リクエストで利用できます。

1. `.http`  ファイルで、カスタムメソッドを大文字で入力します。

2. この方法が不明としてハイライトされたら、 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) (   コンテキストアクションの表示   ) を押して   カスタム HTTP メソッドを追加   を選択します。

![カスタム HTTP メソッドを追加](https://resources.jetbrains.com/help/img/idea/2026.3/http_client_custom_methods.png)

これで CLion がそれを有効な HTTP メソッドとして認識します。 すべてのカスタム HTTP メソッド (および新しいメソッドの追加) は、IDE 設定 ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ) の  `ツール | HTTP クライアント | カスタム HTTP メソッド`  にあります。

### HTTP/2

バージョン 2024.1 以降、CLion は HTTP リクエストで HTTP/2 をサポートします。 HTTP バージョンは URL の後ろで指定できます。例えば：

```HTTP_REQUEST_FULL
GET https://example.org HTTP/2

```

バージョンが指定されていない場合、HTTP クライアントは安全な接続には HTTP/2 (HTTP/2 のネゴシエーションに失敗した場合は HTTP/1.1) を使用し、安全でない接続には HTTP/1.1 を使用します。

Procedure: HTTP バージョンを選択

1. リクエスト URL の後に空白を入れて `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `⌃ Space` (Xcode), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (ReSharper), `⌃ Space` (ReSharper (macOS)), `Ctrl+Space` (QtCreator), `⌃ Space` (QtCreator (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS)) を押すか、  `HTTP プロキシ設定用の HTTP プロトコル設定です。誤訳ではありません。HTTP は標準的なプロトコル名として日本語 UI でも英字表記を維持します。HTTP`  の入力を開始します。

2. 補完リストから、推奨値のいずれかを選択します：

* HTTP/1.1 の使用を強制する `HTTP/1.1`

* HTTP/2 の使用を有効にするには `HTTP/2` を使用します。

* `HTTP/2 (Prior Knowledge)` は、HTTP/1.1 にアップグレードせずに HTTP/2 を使用して送信します。 サーバーが HTTP/2 接続を処理できることがわかっている場合に使用します。

![HTTP/2 を有効にする](https://resources.jetbrains.com/help/img/idea/2026.3/http_client_enable_http_version_two.png)

HTTP クライアント機能の概要を把握するには、構成されたリクエストのいくつかの選択肢である   HTTP リクエストコレクション   を調べることができます。

Procedure: HTTP リクエストコレクションからリクエストを開く

1. リクエストのエディターパネルの上部にある   サンプル例   ショートカットリンクをクリックします。

2. ポップアップメニューで、開きたい HTTP リクエストコレクションを選択します：

![HTTP リクエストコレクションポップアップを開く](https://resources.jetbrains.com/help/img/idea/2026.3/open-http-requests-collection.png)

> **Note:**
> 構文の詳細については、 [HTTP リクエスト構文の調査](exploring-http-syntax.html)を参照してください。

### cURL リクエストを変換する

[cURL(英語)](https://curl.haxx.se) リクエストを使用している場合は、cURL リクエストと  エディターでの HTTP リクエスト 形式を変換できます。

Procedure: cURL を HTTP リクエストに変換

* cURL リクエストを HTTP リクエストファイルに貼り付けます。 CLion はそれを HTTP リクエストフォーマットへ変換し、元の cURL リクエストは後から参照できるようコメントアウトのままにします。

![貼り付け時に cURL リクエストが HTTP リクエストに変換されました](https://resources.jetbrains.com/help/img/idea/2026.3/aqua_http_client_convert_curl_on_paste.png)

* または、HTTP リクエストエディターパネルの上部にある ![cURL を HTTP リクエストに変換](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.import.svg) をクリックして、   cURL を HTTP リクエストに変換   を選択します。

cURL を HTTP リクエストに変換   ダイアログで、変換する cURL リクエストを入力または貼り付けます。

![cURL を HTTP リクエストに変換するダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/aqua_convert_curl_request_dialog.png)

次の cURL リクエストの例を考えてみましょう：

```SHELL
curl 'https://httpbin.org/' -H 'Connection: keep-alive' -H 'Accept: text/html' -H 'Accept-Encoding:
gzip, deflate' -H 'Accept-Language: en-US,en;q=0.9,es;q=0.8'

```

CLion はこれを以下に変換します：

```HTTP_REQUEST_FULL
# curl 'http://httpbin.org/' -H 'Connection: keep-alive' -H 'Accept: text/html' -H 'Accept-Encoding: gzip, deflate' -H 'Accept-Language: en-US,en;q=0.9,es;q=0.8'
GET http://httpbin.org/
Connection: keep-alive
Accept: text/html
Accept-Encoding: gzip, deflate
Accept-Language: en-US,en;q=0.9,es;q=0.8

###

```

コンバーターは次の cURL オプションをサポートします：

|  オプション  |  説明  |
| --- | --- |
|  [-X, --request(英語)](https://curl.haxx.se/docs/manpage.html#-X)  |  使用するリクエストメソッド。  |
|  [-H, --header(英語)](https://curl.haxx.se/docs/manpage.html#-H)  |  リクエストに含めるリクエストヘッダー。  |
|     [-u, --user(英語)](https://curl.haxx.se/docs/manpage.html#-u)       [--basic(英語)](https://curl.haxx.se/docs/manpage.html#--basic)       [--digest(英語)](https://curl.haxx.se/docs/manpage.html#--digest)     |  要求とともに提供されるユーザーの資格情報、および使用する許可方法。  |
|     [-d, --data, --data-ascii(英語)](https://curl.haxx.se/docs/manpage.html#-d)       [--data-binary(英語)](https://curl.haxx.se/docs/manpage.html#--data-binary)       [--data-raw(英語)](https://curl.haxx.se/docs/manpage.html#--data-raw)       [--data-urlencode(英語)](https://curl.haxx.se/docs/manpage.html#--data-urlencode)     |  POST リクエストで送信されるデータ。  |
|  [-F, --form(英語)](https://curl.haxx.se/docs/manpage.html#-F)  |  POST 要求で送信される  マルチパート / フォームデータ メッセージ。  |
|  [--url(英語)](https://curl.haxx.se/docs/manpage.html#--url)  |  取得する URL（主に設定ファイルで URL を指定するときに使用されます）。  |
|  [-i, --include(英語)](https://curl.haxx.se/docs/manpage.html#-i)  |  HTTP レスポンスヘッダーを出力に含めるかどうかを定義します。  |
|  [-v, --verbose(英語)](https://curl.haxx.se/docs/manpage.html#-v)  |  詳細動作モードを有効にします。  |
|  [-L, --location(英語)](https://curl.haxx.se/docs/manpage.html#-L)  |  要求されたページが別の場所に移動された場合に要求を再送信することを可能にします。  |

Procedure: HTTP リクエストを cURL に変換する

1. cURL 形式に変換する HTTP リクエストにキャレットを置きます。

2. `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押して   cURL に変換してクリップボードにコピー   を選択します。

または、HTTP リクエストエディターパネルの上部にある   変換   ショートカットリンクをクリックして、   キャレットの HTTP リクエストを cURL に変換してコピーする   を選択することもできます。

これにより、HTTP リクエストから cURL リクエストが生成され、クリップボードにコピーされます。

### Postman のコレクションと環境をインポートする

Postman コレクションは、関連する HTTP リクエストをグループ化する方法です。 Postman では、コレクションと変数を JSON 形式でエクスポートできます。 HTTP クライアントでそのようなファイルを CLion にインポートし、対応する  `.http` と環境ファイルに変換できます。

Procedure: Postman コレクションを HTTP クライアントにインポートする

1. [Postman からコレクションをエクスポートします(英語)](https://learning.postman.com/docs/getting-started/importing-and-exporting/exporting-data/)。 CLion で使用する場合は、環境ファイルをエクスポートすることもできます。

2. 次のいずれかの方法でファイルを CLion にインポートします：

* エクスポートされたファイルがプロジェクト内にある場合は、それを右クリックして Collection を .http ファイルに変換 を選択します。

* 任意の `.http` ファイルを開き、ツールバーの ![HTTP リクエストをインポート](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.import.svg) をクリックして、 Postman コレクション を選択します。

* `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) を押し、 `Import from Postman Collection File` の入力を開始し、対応するアクションを選択します。

3. 環境ファイルもインポートする場合は、   環境をアタッチ   を選択してファイルを指定します。 HTTP クライアント環境形式に変換され、指定された  `.http`  ファイルに対してこの環境が選択されます。

4. 表示されるウィンドウで、「   変換   」をクリックします。

![Postman ウィンドウからインポート](https://resources.jetbrains.com/help/img/idea/2026.3/http_client_import_from_postman.png)

> **Note:**
> ファイルマネージャーからコレクションファイルを CLion エディターへドラッグすると、Postman コレクションも素早くインポートできます。 エディターでファイルを開くだけでなく、CLion は該当のリクエストを含む  `.http`  ファイルへ変換します。

### 応答ハンドラーと事前要求スクリプトを使用する

応答ハンドラースクリプトを使用すると、受信した HTTP レスポンスにプログラムで対応できます。 これらのスクリプトを使用すると、受信したデータを自動的に処理し、指定した条件に対して検証することができます。 応答ハンドラースクリプトは、HTTP リクエストファイル内の要求の一部として提供され、応答を受信するとすぐに実行されます。 応答処理例を表示するには、   認証を含むリクエスト   または   テストとスクリプトによるリクエスト   [リクエストコレクションを開きます](#open-requests-collection)。

リクエスト前スクリプトを使用すると、 [HTTP リクエストで使用される変数](http-client-variables.html#per_request_variables)を設定できます。

Procedure: 応答ハンドラースクリプトを挿入する

応答ハンドラースクリプトは、その場で書いて挿入するか、外部ファイルを参照して挿入できます。

* その場でスクリプトを挿入するには、その前に  `>`  を付けて  `{% %}`  で囲みます。

```HTTP_REQUEST_FULL
GET host/api/test

> {%
// Response Handler Script
...
%}

```

* 外部ファイルからスクリプトを挿入するには、  `>`  を先頭に追加します。

```HTTP_REQUEST_FULL
GET host/api/test

> scripts/my-script.js

```

応答ハンドラースクリプトからの出力 (エラーまたは [client.log](http-client-reference.html#client-methods) からの出力) がある場合は、要求の実行時に   サービス   ツールウィンドウの   レスポンスハンドラー   タブに表示されます。

Procedure: 事前リクエストスクリプトを挿入する

事前リクエストスクリプトも、その場で記述するか外部ファイル参照でリクエストに挿入可能です。

* その場でスクリプトを挿入するには、その前に  `<`  を付けて  `{% %}`  で囲みます。

```HTTP_REQUEST_FULL
< {%
    request.variables.set("petName", "Bella")
%}
POST https://example.org/pets/{{petName}}

```

* 外部ファイルからスクリプトを挿入するには、  `<`  を先頭に追加します。

```HTTP_REQUEST_FULL
< scripts/my-script.js

POST https://example.org/pets/{{petName}}

```

リクエスト前スクリプトからの出力 (エラーまたは [client.log](http-client-reference.html#client-methods) からの出力) がある場合は、リクエストを実行すると、   サービス   ツールウィンドウの   プレリクエストハンドラー   タブに表示されます。

Procedure: JavaScript コードをインポートする

場合によっては、変数や関数などの特定の機能を外部ファイルから使用する必要がある場合があります。 このため、事前リクエストおよび応答ハンドラースクリプトで、通常の ES6 インポート機能を使用して、ローカル JavaScript ファイルで定義された変数と関数にアクセスできます。

* 必要な値を JavaScript ファイルからエクスポートします。 HTTP クライアントは、次の形式の  `export`  ステートメントをサポートします。

```JAVASCRIPT
export let name1, name2/*, … */; // also var
export const name1 = 1, name2 = 2/*, … */; // also var, let
export function functionName() { /* … */ }

export { name1, /* …, */ nameN };
export { variable1 as name1, variable2 as name2, /* …, */ nameN };

export default expression;
export default function functionName() { /* … */ }
export default function () { /* … */ }

```

* 必要な値を応答ハンドラーまたは事前要求スクリプトにインポートします。 HTTP クライアントは、次の形式の  `import`  ステートメントをサポートします。

```JAVASCRIPT
import defaultExport from "module-name";
import * as name from "module-name";
import { export1 } from "module-name";
import { export1 as alias1 } from "module-name";
import { export1, export2 } from "module-name";
import { export1, export2 as alias2, /* … */ } from "module-name";
import defaultExport, { export1, /* … */ } from "module-name";
import defaultExport, * as name from "module-name";
import "module-name"; // side effect import

```

> **Note:**
> 外部ファイルから一部テストを実行し、何もインポートする必要がない場合は、応答ハンドラースクリプトで [副作用インポート](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#import_a_module_for_its_side_effects_only)（例えば  `import 'test-scripts/mytests'` ）を利用できます。 これは、共通のテストがあり、複数のリクエストで再利用しながら、一部のリクエストに対して個別のテストを作成 (またはインポート) する機能を維持したい場合に便利です。

* `import`  ステートメントを、現在の  `.http`  ファイルの先頭にある共通ブロック宣言  `={% ... %}`  の中に配置することで、そのファイル内のすべてのプリリクエストスクリプトとレスポンスハンドラーから JavaScript モジュールが使用できるようになります。

例  `logger.js`  :

```JAVASCRIPT
export const logMessage = () => {
    console.log("Request executed");
};

```

`.http`  ファイルの例:

```JAVASCRIPT
                ={%
import { logMessage } from "logger"
%}

###
< {%
    logMessage();
%}

GET https://examples.http-client.intellij.net/get

> {%
    logMessage();
%}
            
```

レスポンスハンドラースクリプトと事前リクエストスクリプトは JavaScript ECMAScript 2023 で記述され、コーディング支援とドキュメントはバンドルされた  `HTTP Pre-Request and Response Handler`  ライブラリによって処理されます。 インプレーススクリプトの場合、この機能は自動的に有効になります。 外部スクリプトの場合は、手動で有効にする必要があります。

Procedure: 応答ハンドラーと事前要求スクリプトの JavaScript コーディング支援を有効にする

1. `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) （   アクションの検索   ）を押します。

2. JavaScript ライブラリの使用   と入力し、対応するアクションをクリックし、開いたコンテキストメニューで   HTTP Pre-Request and Response Handler   を選択します。

`HTTP Response Handler`  ライブラリは、レスポンスハンドラースクリプトを作成するために使用される 2 つのオブジェクトを公開します。

* `client` オブジェクトはセッションメタデータを保持し、スクリプト内で変更できます。 `client` の状態は CLion を閉じるまで保持されます。 `client.global` に `variable_name` として保存した変数は、その後の HTTP リクエストで `{{variable_name}}` として利用可能です。

* `response` は受信したレスポンスに関する情報を保持しています: そのコンテンツタイプ、ステータス、レスポンスボディなど。

エディターで  HTTP レスポンスハンドラー ライブラリを開くには、ライブラリオブジェクトにキャレットを置き、 `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `⌘ Click` (Xcode), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (ReSharper), `⌘ B` (ReSharper (macOS)), `F2` (QtCreator), `F2` (QtCreator (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) を押します。

レスポンスハンドラースクリプトにはテストも記述でき、HTTP クライアントをテストフレームワークとして利用できます。 テストは  `client.test(testName, function)`  メソッドで作成します。 テスト内では  `client.assert(condition, message)`  メソッドで条件アサートも可能です。例えば：

```JAVASCRIPT
GET https://httpbin.org/status/200

> {%
    client.test("Request executed successfully", function() {
        client.assert(response.status === 200, "Response status is not 200");
    });
%}

```

Procedure: 構造ツールウィンドウを使用して .http ファイル内を移動する

`.http`  ファイルに複数のリクエストがある場合、   構造   ツールウィンドウは、ファイルをすばやくプレビューしてファイル内を移動できます。 ツールウィンドウには、ヘッダー、リクエスト本文、事前リクエストスクリプト、応答ハンドラースクリプトなどのリクエスト部分も表示されます。

1. 構造   ツールウィンドウを開きます:  `表示 | ツールウィンドウ | 構造`  。

または、 `Alt+7` (Windows), `⌘ 7` (macOS), `⌘ 7` (IntelliJ IDEA Classic (macOS)), `⌘ 7` (macOS System Shortcuts), `Alt+7` (XWin), `Alt+7` (GNOME), `Alt+7` (KDE), `Alt+7` (Emacs), `Alt+7` (Sublime Text), `⌘ 7` (Sublime Text (macOS)), `⌘ 3` (Xcode), `Ctrl+Alt+F` (Visual Studio), `⌃ ⌥ F` (Visual Studio (macOS)), `Ctrl+F11` (ReSharper), `⌃ F11` (ReSharper (macOS)), `Alt+7` (QtCreator), `⌘ 7` (QtCreator (macOS)), `Ctrl+7` (NetBeans), `Alt+7` (Eclipse), `⌘ 7` (Eclipse (macOS))を押します。

2. 構造   ツールウィンドウで、HTTP メソッドまたはリクエスト名、あるいはリクエストの一部をクリックします。

![HTTP クライアント構造ツールウィンドウ](https://resources.jetbrains.com/help/img/idea/2026.3/http_client_structure_tool_window.png)

右クリックして ![実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) を選択することで、そこからリクエストを送信することもできます。

## HTTP リクエストを実行する

Procedure: 単一のリクエストを実行する

1. 独自の Web サービスをテストする場合は、Web サービスがデプロイされ、実行されていることを確認してください。

2. [環境](http-client-variables.html)を定義している場合は、リクエストのエディターパネルの上部にある   実行   リストで環境を選択します。

3. ガターで、リクエストの横にある ![実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックします。

Procedure: 複数のリクエストを順番に実行する

`.http`  ファイルからのすべてのリクエストを一度に実行できます。 これは、サーバーから特定のデータをリクエストし、それを [client.global](http-response-handling-examples.html#script-var-example) 変数として保存し、そのデータを含む後続のリクエストを送信するなどの複雑なシナリオに役立ちます。

1. `.http`  ファイルを開きます。

2. エディターパネルの上部にある ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.runAll.svg) (   ファイル内のすべてのリクエストを実行   ) をクリックします。

リクエストが実行されると、CLion はそのリクエスト用の一時的な [HTTP リクエスト実行 / デバッグ構成](#http-request-run-debug-configurations)を自動的に作成します。 必要に応じて [永続的な実行 / デバッグ構成として保存する](#save-temporary-http-request-run-debug-configuration)を使用できます。

Procedure: ブラウザーでリクエストを開く

設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）の [ウェブブラウザーとプレビュー](settings-tools-web-browsers.html)ページで指定されたブラウザーで HTTP リクエストを開くことができます。

* `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押し、   Web ブラウザーで開く   [インテンションアクション](intention-actions.html) を選択します。

### HTTP リクエストの実行 / デバッグ構成を操作する

[エディターから HTTP リクエストを実行](#execute_request_procedure)すると、CLion はリクエストパラメーター付きの一時的な実行 / デバッグ構成を自動的に作成します。 一時的な実行 / デバッグ構成は、永続的な実行 / デバッグ構成と同じように機能します。 [実行 / デバッグ構成](run-debug-configurations-dialog.html)ダイアログを使用して設定を変更し、オプションで永続的に保存できます。

Procedure: HTTP リクエストの実行 / デバッグ構成を変更する

1. 以下のいずれかを行います：

* エディターでリクエストを右クリックし、コンテキストメニューで 実行構成の変更… を選択します。

* または、メインメニューの `実行 | 実行構成の編集​` に移動し、 HTTP リクエスト リストから必要な実行 / デバッグ構成を選択します。

2. 必要に応じて構成パラメーターを変更します。

* 環境 リストで、リクエストで使用される環境変数のセットを定義する [環境](http-client-variables.html)を選択します。

* ファイル フィールドに、 [HTTP リクエストファイル](#creating-http-request-files)へのパスを指定します。 パスを手動で入力し、入力時にパス補完 `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `⌃ Space` (Xcode), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (ReSharper), `⌃ Space` (ReSharper (macOS)), `Ctrl+Space` (QtCreator), `⌃ Space` (QtCreator (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS)) を使用するか、 ![ディスクから開く](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.open.svg) をクリックして、表示されるダイアログで必要なフォルダーを選択できます。

* 要求ファイルに複数の要求が含まれている場合は、 リクエスト リストで、実行する要求の名前を選択します。

Procedure: 一時的な HTTP リクエストの実行 / デバッグ構成を保存する

以下のいずれかを行います：

* 実行 / デバッグ構成   セレクターで、  `<構成名> を保存`  を選択します。

* 実行 / デバッグ構成   ダイアログで、構成を選択し、 ![保存ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.save.svg) をクリックします。

Procedure: 実行 / デバッグ構成を使用して要求を実行する

以下のいずれかを行います：

* 実行 / デバッグ構成   セレクターで、目的の実行構成を選択します。 次に、メインツールバーの ![実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックするか、 `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `⌘ ⌥ ⇧ R` (Xcode), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `Ctrl+F5` (ReSharper), `⌃ F5` (ReSharper (macOS)), `Ctrl+R` (QtCreator), `⌘ R` (QtCreator (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS)) を押します。

* `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `⌘ ⌃ ⌥ ⇧ R` (Xcode), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Ctrl+Alt+Shift+R` (ReSharper), `⌘ ⌥ ⇧ R` (ReSharper (macOS)), `Ctrl+T` (QtCreator), `⌘ T` (QtCreator (macOS)), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS)) を押し、リストから必要な実行構成を選択して、 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押します。

## 他の .http ファイルから HTTP リクエストをインポートする

CLion を使用すると、他の  `.http` ファイルから HTTP リクエストをインポートできます。 次のことが可能です。

* [指定されたファイルからのすべての HTTP リクエストを実行する](#run-all-requests-from-another-http-file)

* [インポートしたファイルから特定の HTTP リクエストを実行する](#run-specific-requests-from-another-http-file)

[サンプル](#open-requests-collection)をクリックし、   Include を含むリクエスト   を選択すると、IDE でこの機能の構文例が表示されます。

Procedure: すべてのリクエストを別の .http ファイルから実行する

1. `.http`  ファイルで、  `run`  に続けて、含める別の  `.http`  の名前を入力します。 ファイルが同じディレクトリにある場合は、その名前を入力します。 そうでない場合は、パスを指定します。 例：

```HTTP_REQUEST_FULL
run ./myFolder/get-requests.http

```

2. このファイルからのすべてのリクエストを送信するには、  `run`  の横にある ![実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックします。

Procedure: 別の .http ファイルから特定のリクエストを実行する

1. `.http`  ファイルの先頭に、  `import`  と入力し、その後に必要なリクエストを含む別の  `.http`  の名前を入力します。

2. `run`  と入力し、実行するリクエストの名前を指定します。

`Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `⌃ Space` (Xcode), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (ReSharper), `⌃ Space` (ReSharper (macOS)), `Ctrl+Space` (QtCreator), `⌃ Space` (QtCreator (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS)) を押すと、インポートされたファイルで利用可能なすべてのリクエストを表示できます。

![別の .http ファイルから特定のリクエストを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/http_client_import_other_http_requests.png)

Procedure: インポートされた .http ファイルからの変数を上書きする

インポートされた  `.http`  ファイルに変数が含まれている場合は、特定の実行に対してその値を指定または変更できます。

1. `run`  と入力し、  `.http`  ファイルまたはリクエストの名前を指定します。

2. リクエストまたはファイルの名前の後に、  `(@variable=value)`  形式で変数を入力します。 複数の変数を指定するには、コンマで区切ります。 例：

```HTTP_REQUEST_FULL
import new-requests.http

run #GET request with one var (@host=example.com)

run #GET request with two vars (@host=example.com, @user=userName)

```

## Web サービスからの応答を表示する

HTTP リクエストを実行すると CLion はレスポンスを  `.idea/httpRequests/` ディレクトリ配下に別ファイルとして自動保存します。 最近保存された 50 件の応答を表示し、 [要求履歴](#requests_history)を使用して対応するファイルに移動することができます。 リクエストがスクラッチファイルから実行された場合、そのレスポンス出力へのリンクも元のリクエストに追加されます。

![HTTP レスポンス](https://resources.jetbrains.com/help/img/idea/2026.3/http_response_in_scratch.png)

Procedure: 受け取った応答を見る

1. 応答が届くと自動的に開く [サービスツールウィンドウ](services-tool-window.html)へ切り替えます。

2. デフォルトでは、サーバーレスポンスはリクエストヘッダー内の [content-type](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17)フィールドで指定されたフォーマットで表示されます。 レスポンスを他のフォーマットに変換したい場合は、 ![レスポンス表示設定](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.show.svg)をクリックして   テキスト  、   JSON  、   XML  、または   HTML   を選択します。

![サービスツールウィンドウの HTTP レスポンス](https://resources.jetbrains.com/help/img/idea/2026.3/idea_http-run-response.png)

レスポンスにバイナリファイルが含まれている場合、このファイルも  `.idea/httpRequests/`  ディレクトリに保存されます。 レスポンスがイメージ、PDF、HTML ファイルの場合は、IDE 内で直接プレビューできます。

イメージ:

サービス   ツールウィンドウでイメージをプレビューします。

![イメージ付きの HTTP レスポンス](https://resources.jetbrains.com/help/img/idea/2026.3/http_response_with_image.png)

PDF:

サービス   ツールウィンドウで PDF ファイルをプレビューします。   サービス   ツールウィンドウで PDF プレビューの表示を無効にするには、 ![レスポンス表示設定](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.show.svg) をクリックして   PDF プレビューのインライン化を有効化   オプションをクリアします。

![PDF を含む HTTP 応答](https://resources.jetbrains.com/help/img/idea/2026.3/http_response_with_pdf.png)

HTML:

応答が HTML ファイルの場合は、   プレビューの表示   をクリックして、JCEF ベースのブラウザーを使用してエディタータブでプレビューできます。

![HTML による HTTP レスポンス](https://resources.jetbrains.com/help/img/idea/2026.3/http_response_with_html.png)

[レスポンスハンドラースクリプト](#using-response-handler-scripts)がある場合、このスクリプトの一部として実行されたテストの結果は、   サービス   ツールウィンドウの   テスト   タブに表示されます。 各テストをクリックすると、対応するレスポンスハンドラースクリプト内のテストソースコードに簡単に移動できます。

![サービスツールウィンドウのテストタブ](https://resources.jetbrains.com/help/img/idea/2026.3/http-request-failed-tests.png)

イベントストリームをサブスクライブすると、CLion は   サービス  ツールウィンドウにイベントを表示します。 ここでは、 ![停止](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stop.svg) をクリックして、クライアント / サーバー接続のステータスを表示し、接続を終了することもできます。 コンテンツタイプ（  `text/event-stream`  または  `application/x-ndjson`  のいずれか）に応じて、応答はプレーンテキストまたは改行で区切られた JSON としてフォーマットされます。 [イベントストリームの各行を処理](http-response-handling-examples.html#stream_scripting)する応答ハンドラースクリプトを作成できます。

![サーバーから送信されたイベント](https://resources.jetbrains.com/help/img/idea/2026.3/http_client_json_event_stream.png)

ストリームイベントのファイルへの [リダイレクト](exploring-http-syntax.html#response-redirect)は現在サポートされていません。

Procedure: エディターで応答ファイルを開く

1. 開きたいレスポンスのリンク上にキャレットを置きます。

2. 次のいずれかを実行します：

* メインメニューで `表示 | ソースに移動` へ移動します。

* `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `⌘ Click` (Xcode), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (ReSharper), `⌘ B` (ReSharper (macOS)), `F2` (QtCreator), `F2` (QtCreator (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) または `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) を押します。

* サービス ツールウィンドウまたはエディター (スクラッチファイルの場合) で、応答行のリンクを `Ctrl+Click` (Windows), `Ctrl+Click` (macOS), `Ctrl+Click` (IntelliJ IDEA Classic (macOS)), `Ctrl+Click` (macOS System Shortcuts), `Ctrl+Click` (XWin), `Ctrl+Click` (GNOME), `Ctrl+Click` (KDE), `Ctrl+Click` (Emacs), `Ctrl+Click` (Sublime Text), `Ctrl+Click` (Sublime Text (macOS)), `Ctrl+Click` (Xcode), `Ctrl+Click` (Visual Studio), `Ctrl+Click` (Visual Studio (macOS)), `Ctrl+Click` (ReSharper), `Ctrl+Click` (ReSharper (macOS)), `Ctrl+Click` (QtCreator), `Ctrl+Click` (QtCreator (macOS)), `Ctrl+Click` (NetBeans), `Ctrl+Click` (Eclipse), `Ctrl+Click` (Eclipse (macOS)) します。

Procedure: JSONPath を使用して JSON レスポンスからデータを抽出する

HTTP クライアントは JSONPath クエリをサポートしており、受信した JSON ドキュメントからデータを解析して抽出することができます。 これを行うには、 [応答ハンドラースクリプト](#using-response-handler-scripts)で次の関数を使用します。

```HTTP_REQUEST_FULL
jsonPath(ObjectToParse, JSONPathExpression)

```

この関数をすばやく挿入するには、  `jsonPath`  ライブテンプレートを使用します。

1. リクエスト後、応答ハンドラースクリプト部分で、  `> jsonPath`  と入力し始めます。

2. `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押してライブテンプレートを展開し、JSONPath 式を補完します。

例: この式は、  `slideshow`  オブジェクトの一部である  `slides`  配列内の最初の要素の  `title`  フィールドの値を取得して出力します。

```HTTP_REQUEST_FULL
GET https://examples.http-client.intellij.net/json

> {%
    client.log(jsonPath(response.body, "$.slideshow.slides[0].title",))
%}

```

取得した値を   サービス   ツールウィンドウの   レスポンスハンドラー   タブでプレビューします。

Procedure: XPath を使用して XML 応答からデータを抽出する

HTTP クライアントは XPath 式をサポートしており、受信した XML ドキュメントからデータを解析・抽出できます。

1. [応答ハンドラースクリプト](#using-response-handler-scripts)では、次の関数を使用します。

```HTTP_REQUEST_FULL
xpath(XMLToParse, XPathExpression)

```

2. `XMLToParse`  に解析する XML コンテンツ (たとえば、  `response.body`  ) を入力し、  `XPathExpression`  に XPath 式を入力します。

例：

```HTTP_REQUEST_FULL
GET https://examples.http-client.intellij.net/xml

> {%
    client.log(xpath(response.body, '//slide[@type="all"][1]/title/text()'))
%}

```

Procedure: スクラッチファイル内のレスポンスを比較する

スクラッチファイルからリクエストを実行すると、レスポンス出力ファイルへのリンクが元のリクエストの下に追加されます。

* 以下のいずれかを行います：

* 応答ファイルへのリンクにキャレットを置きます。 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押し、 <レスポンス名> と比較 インテンションアクションを選択します。

* ガターで ![レスポンスを比較](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.vcs.diff.svg) をクリックし、リストから <レスポンス名> と比較 を選択します: ![リクエスト履歴の応答を比較する](https://resources.jetbrains.com/help/img/idea/2026.3/ps_compare_responses_menu.png)

Procedure: リクエスト履歴の応答を比較する

物理ファイルからリクエストが実行されると、応答出力へのリンクが [リクエストの履歴](#requests_history)に追加されます。

1. 応答ファイルへのリンクにキャレットを置きます。 メインメニューで  `表示 | ソースに移動`  に移動するか、 `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `⌘ Click` (Xcode), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (ReSharper), `⌘ B` (ReSharper (macOS)), `F2` (QtCreator), `F2` (QtCreator (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) または `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) を押して、このファイルを新しいエディタータブで開きます。

2. メインメニューで  `表示 | 比較`  に移動するか、 `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Ctrl+D` (Emacs), `Ctrl+D` (Sublime Text), `⌘ D` (Sublime Text (macOS)), `⌘ D` (Xcode), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (ReSharper), `⌘ D` (ReSharper (macOS)), `Ctrl+D` (QtCreator), `⌘ D` (QtCreator (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `⌘ D` (Eclipse (macOS)) を押します。 CLion は  `httpRequests` フォルダーからレスポンスファイルを開くよう促します。

3. 現在のファイルと比較する応答ファイルを選択し、   オープン   をクリックします。

2 つの応答ファイルが [差分ビューアー](differences-viewer.html)で開かれ、内容を比較できます。

![HTTP レスポンスを比較する](https://resources.jetbrains.com/help/img/idea/2026.3/compare_http_responses_diff.png)

## リクエスト履歴を表示

CLion は直近 50 件の実行済みリクエストを  `http-requests-log.http`  ファイルへ自動保存し、これはプロジェクト配下の  `.idea/httpRequests/`  ディレクトリにあります。 リクエスト履歴により特定のレスポンスへ素早くアクセスでき、 [再実行](#run_request)も可能です。 リクエスト履歴から再発行された際、実行情報とレスポンス出力リンクが履歴ファイル上部に追加されます。

> **Note:**
> リクエストがリクエスト履歴に保存されないようにするには、リクエストの前に [@no-log](exploring-http-syntax.html#enable-disable-saving-request) タグを付けたコメント行を追加します。 これは、リクエストに機密データが含まれていて、ログに記録したくない場合に役立ちます。

Procedure: リクエスト履歴を開く

* リクエストのエディターパネルの上部にある ![HTTP リクエスト履歴を表示](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.history.svg) をクリックします。

* メインメニューから  `ツール | HTTP クライアント | HTTP リクエストの履歴を表示`  を選択します。

Procedure: 出力をカスタムファイルまたはディレクトリにリダイレクトする

* HTTP クライアントは、出力をカスタムファイルまたはディレクトリにリダイレクトできます。 強制リダイレクトとソフトリダイレクトの 2 つの演算子をサポートしています。

* `>>` オペレーターは常に新しいファイルを作成し、要求されたファイル名がすでに存在する場合は、ファイル名に `-n` 接尾辞を追加します。

* `>>!` オペレーターは、ファイルがすでに存在する場合、ファイルを書き換えます。

## クッキーを管理する

応答によって受信された Cookie は、  `.idea/httpRequests/`  ディレクトリの専用  `http-client.cookies`  ファイルに自動的に保存されます。 保存できるクッキーの数は  300  に制限されています。  有効期限 に達していない限り、Cookie の  名前 と  値 は、Cookie に指定された  ドメイン と  パス に一致する URL への後続の各要求に自動的に含まれます。

クッキーを無期限にしたい場合は、  `date`  パラメーターとして  `-1`  を入力します。 例：

```HTTP_REQUEST_FULL
# domain path name value date

.example.com / userId 0x4d2 -1

```

![http-cookies ファイル](https://resources.jetbrains.com/help/img/idea/2026.3/ps_http_cookie.png)

> **Note:**
> リクエストの前に [@no-cookie-jar](exploring-http-syntax.html#enable-disable-saving-cookies) タグを含むコメント行を追加することにより、受信した Cookie が Cookie jar に保存されないようにすることができます。

HTTP リクエストでカスタムクッキーを設定したい場合、  `Cookie`  ヘッダーを利用できます。 クッキーは  `name=value`  ペアのリストとしてセミコロン区切りで入力します。例：

```HTTP_REQUEST_FULL
GET http://localhost:80/api
Cookie: theme=dark; country=France

```

## Websocket リクエスト

HTTP クライアントは WebSocket リクエストをサポートします。 HTTP クライアントがリクエストを WebSocket リクエストとして処理するには、  `WEBSOCKET`  キーワードで開始し、その後にサーバーアドレスを続けます。 リクエストの構造は次のとおりです。

```HTTP_REQUEST_FULL
WEBSOCKET ws://localhost:8080/websocket
Content-Type: application/json // Used for content highlighting only

// Request body, for example:
{
  "message": "First message sent on connection"
}
===  // message separator
{
  "message": "Second message" // will be sent right after the previous one
}
=== wait-for-server  // keyword used to wait for the server response
{
  "message": "Send this after the server response"
}

```

> **Note:**
> `Content-Type` ヘッダーは WebSocket 接続では使われませんが、CLion WebSocket リクエストで送信データの構文ハイライトに利用できます。

WebSocket リクエストの作成を高速化するには、次のことができます：

* `.http` ファイルのエディターパネルの上部にある ![リクエスト追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、 WebSocket リクエスト を選択します。

* `.http` ファイルで、 `wsr` と入力し、 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押して WebSocket ライブテンプレートを適用します。

Procedure: 複数のメッセージを送信する

* `===`  セパレーターを使用して、複数のメッセージを送信します。

```JSON
{
  "message": "First message sent on connection"
}
===  // message separator
{
  "message": "Second message"
}
===
{
  "message": "Third message"
}

```

Procedure: サーバーの応答後にメッセージを送信する

* メッセージの前に、  `=== wait-for-server`  と入力します。

これにより、HTTP クライアントはメッセージを送信する前にサーバーの応答を待機します。  `=== wait-for-server`  行を繰り返すことにより、複数の応答を待つことができます。 例: 次のメッセージは、3 つのサーバー応答の後に送信されます。

```JSON
=== wait-for-server
=== wait-for-server
=== wait-for-server
{
  "message": "This messages is sent after 3 server responses"
}

```

Procedure: インタラクティブにメッセージを送信する

接続を開始すると、   サービス   ツールウィンドウから直接サーバーと対話できます。 新しいメッセージごとにメッセージを送信したり、サーバーの応答を表示したりできます。

1. サービス   ツールウィンドウで、開いている接続を選択します。

2. ウィンドウの下部の   WebSocket に送信されるメッセージ   に、メッセージの内容を入力します。

3. その右側で、メッセージ形式（プレーンテキスト、JSON、XML、HTML）を選択します。

4. `Ctrl+Enter` (Windows), `⌘ ⏎` (macOS), `⌘ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ ⏎` (macOS System Shortcuts), `Ctrl+Enter` (XWin), `Ctrl+Enter` (GNOME), `Ctrl+Enter` (KDE), `Ctrl+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `⌘ ⏎` (Xcode), `Ctrl+Enter` (Visual Studio), `⌘ ⏎` (Visual Studio (macOS)), `Ctrl+Enter` (ReSharper), `⌘ ⏎` (ReSharper (macOS)), `Ctrl+Enter` (QtCreator), `Ctrl+Enter` (QtCreator (macOS)), `Ctrl+Enter` (NetBeans), `Ctrl+Enter` (Eclipse), `⌘ ⏎` (Eclipse (macOS)) を押してリクエストを送信します。

ウィンドウ上部にサーバーレスポンスが表示されます。

![サービスツールウィンドウ](https://resources.jetbrains.com/help/img/idea/2026.3/websocket_interactive.png)

## GraphQL

CLion は、HTTP リクエスト本文で GraphQL 操作を送信するためのサポートを提供します。 HTTP または [WebSocket](#websocket) を介して送信できます。

> **Tip:**
> リクエスト本文での GraphQL 言語のサポート（構文のハイライト、スキーマへのクイックナビゲーションなど）については、 [GraphQL(英語)](https://plugins.jetbrains.com/plugin/8097-graphql) プラグインをインストールして有効にすることができます。

Procedure: GraphQL クエリを使用して HTTP リクエストを作成する

1. `.http`  ファイルに、  `GRAPHQL`  キーワードに続けてサーバーアドレスを入力します。

2. リクエストの本文で、GraphQL 操作（クエリ、ミューテーション、サブスクリプション）を作成します。例:

```HTTP_REQUEST_FULL
### HTTP request with GraphQL query
GRAPHQL http://localhost:8080/graphql

query {
  toDos {
    title,
    completed,
    author {
      username
    }
  }
}

```

GraphQL クエリを含む HTTP リクエストの作成を高速化するには、次のことができます：

* `.http` ファイルのエディターパネルの上部にある ![リクエスト追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、 GraphQL クエリリクエスト を選択します。

* `.http` ファイルで、 `gqlr` と入力し、 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押して GraphQL ライブテンプレートを適用します。

Procedure: GraphQL 変数を使用する

HTTP リクエストボディ内では、クエリ文字列とは別に動的データを渡したい際に GraphQL 変数が利用できます。

* クエリ部分の後に、JSON 変数辞書を入力します：

```JAVASCRIPT
query ($name: String!, $capital: String!) {
  country(name: $name, capital: $capital) {
    name
    capital
  }
}

{
  "name": "France",
  "capital": "Paris"
}

```

また GraphQL 変数値として [HTTP クライアント環境変数](http-client-variables.html)も使用可能です。 例えばこの JSON では、  `"{{Author}}"`  は環境変数です。実行時の値は、リクエスト送信時に選択した環境によって決まります：

```JSON
{
  "author": "{{Author}}"
}

```

> **Note:**
> リクエスト本文で `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) （   コンテキストアクションの表示   ）を押し、   GraphQL JSON 変数ブロックの追加   を選択することで、GraphQL クエリに変数ブロックをすばやく追加できます。

## プロキシ設定の構成

Procedure:

1. 設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）で、   外観 & 振る舞い   の   システム設定   を選択し、次に   HTTP プロキシ   を選択します。

2. 開いた [HTTP プロキシ](settings-http-proxy.html)ダイアログで、   手動プロキシ構成  を選択し、以下を指定します：

* ホスト名 および ポート番号 フィールドにプロキシのホスト名とポート番号を入力します。

* 認証を有効にするには、 プロキシ認証 チェックボックスを選択して、対応するフィールドにユーザー名とパスワードを入力します。

## クライアント SSL/TLS 証明書を設定する

HTTP サーバーが安全な通信のために SSL/TLS 認証を必要とする場合、HTTPS 要求を送信する前にクライアント証明書を指定する必要がある場合があります。 HTTP クライアントでは、 [プライベート環境ファイル](http-client-variables.html)を使用してクライアント証明書をセットアップできます。

> **Tip:**
> 現在、SSL/TLS 証明書の構成は [HTTP Client CLI](http-client-cli.html) ではサポートされていません（ [IJPL-69643](https://youtrack.jetbrains.com/issue/IJPL-69643/HttpClient-add-certificate-support-in-CLIrunner) で機能リクエストに投票できます）。 HTTP クライアント CLI でサポートされている唯一の SSL 関連設定は、 [証明書の検証を無効にする機能](#disable_certificate_verification)です。

Procedure: 証明書へのパスを指定

1. `.http`  ファイルの   実行   リストで、   環境を Private ファイルに追加…   を選択します。

2. 開いた  `http-client.private.env.json`  ファイルで、必要な環境に  `SSLConfiguration`  オブジェクトを追加します。  `clientCertificate`  に、クライアント証明書へのパスを入力します。 証明書キーが別のファイルに保存されている場合は、そのパスを  `clientCertificateKey`  に入力します。 例：

```JSON
{
    "dev": {
        "MyVar": "SomeValue",
        "SSLConfiguration": {
            "clientCertificate": "cert.pem",
            "clientCertificateKey": "MyFolder/key.pem"
        }
    }
}

```

> **Tip:**
> 絶対パスまたは  `http-client.private.env.json`  ファイルへの相対パスを指定できます。 環境ファイルがスクラッチに保存されている場合は、プロジェクトルートからの相対パスを追加で指定できます。 パスの入力を開始して、コード補完ポップアップを取得します。

または、  `clientCertificate`  と  `clientCertificateKey`  をオブジェクトとして記述することで、パスに加えて証明書のフォーマットも指定できます。 例：

```JSON
{
    "dev": {
        "SSLConfiguration": {
            "clientCertificate": {
                "path": "file.crt",
                "format": "PEM"
            },
            "clientCertificateKey": {
                "path": "file.key",
                "format": "DER"
            }
        }
    }
}

```

Procedure: 証明書のパスフレーズを設定する

クライアント証明書を生成するときにパスフレーズを使用した場合は、それを HTTP クライアントに提供してください。

1. `http-client.private.env.json` ファイルで、  `"hasCertificatePassphrase": true` を  `SSLConfiguration` オブジェクトに追加します。例:

```JSON
{
    "dev": {
        "SSLConfiguration": {
            "clientCertificate": "file.crt",
            "hasCertificatePassphrase": true
        }
    }
}

```

2. ガターの ![証明書パスフレーズの値を設定](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg) をクリックするか、キャレットを  `hasCertificatePassphrase`  に置いて `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押し、   「証明書パスフレーズ」の値を設定する   を選択します。

3. 表示されたウィンドウで証明書のパスフレーズを入力してください。

![HTTP クライアントのセキュリティで保護された値ウィンドウ](https://resources.jetbrains.com/help/img/idea/2026.3/http_client_set_passphrase.png)

パスフレーズを今すぐ入力したくない場合は、2 番目の手順を省略できます。 この場合、CLion は HTTPS リクエストを実行するときにパスフレーズの入力を促します。

Procedure: 証明書の検証を無効にする

開発目的で、自己署名証明書または期限切れの証明書を持つホストがある場合があります。 このホストを信頼する場合は、その証明書の検証を無効にすることができます。

* `http-client.private.env.json`  ファイルで、  `verifyHostCertificate": false`  を  `SSLConfiguration`  オブジェクトに追加します。 例：

```JSON
{
    "sslTest": {
        "SSLConfiguration": {
            "verifyHostCertificate": false
        }
    }
}

```

この環境でリクエストを実行すると、CLion はホスト証明書を検証しません。

###   `SSLConfiguration`  参照 

|  属性  |  タイプ  |  説明  |
| --- | --- | --- |
|   `clientCertificate`   |  文字列またはオブジェクト  |     サーバーに送信するクライアント証明書を指定します: 証明書ファイルへのパス、または  `path`  属性と  `format`  属性を持つオブジェクトのいずれかです。       サポートされているフォーマットは  `PEM` 、  `P12` 、  `DER`  です。  `format`  を省略すると、HTTP Client はファイル拡張機能から検出します:  `.pem`  と  `.crt`  は  `PEM`  に解決され、  `.p12` 、  `.pkcs12` 、  `.pfx`  は  `P12`  に解決され、  `.der`  と  `.cer`  は  `DER`  に解決されます。 その他の拡張機能の場合は、フォーマットを明示的に指定してください。     |
|   `clientCertificateKey`   |  文字列またはオブジェクト  |     クライアント証明書の秘密鍵を指定します。キーが別のファイルに保存されている場合: キーファイルへのパス、または  `path`  属性と  `format`  属性を持つオブジェクトのいずれかです。 この属性は  `clientCertificate`  と一緒に使用します。       サポートされているフォーマットは  `PEM`  と  `DER`  です。  `format`  を省略すると、HTTP Client はファイル拡張機能から検出します:  `.pem`  と  `.key`  は  `PEM`  に解決され、  `.der`  は  `DER`  に解決されます。 その他の拡張機能の場合は、フォーマットを明示的に指定してください。     |
|   `hasCertificatePassphrase`   |  ブール値  |     クライアント証明書がパスフレーズで保護されているかどうかを指定します。 デフォルト値は  `false`  です。        `true`  に設定すると、CLion は環境ファイルから読み取る代わりに、パスフレーズの入力を求めます。 この属性は  `clientCertificate`  と一緒に使用します。 詳細については、 [証明書のパスフレーズを設定する](#passphrase)を参照してください。     |
|   `verifyHostCertificate`   |  ブール値  |     リクエスト送信先ホストの証明書を検証するかどうかを指定します。 デフォルト値は  `true`  です。        `false`  に設定すると、CLion は任意のホスト証明書を受け入れます。 [証明書検証の無効化](#disable_certificate_verification)を参照してください。     |

> **Note:**
> CLion は  `SSLConfiguration`  を  `http-client.private.env.json`  ファイルからのみ読み取ります。  `http-client.env.json`  では、通常の変数として扱われ、リクエストの実行には影響しません。

## See also

