# HTTP クライアント CLI

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

CLion プラグインに加えて、HTTP クライアントも [CLI ツールとして](https://www.jetbrains.com/ja-jp/ijhttp/download)利用できます。 これにより、IDE を使用せずにターミナルから HTTP リクエストを実行したり、CI ワークフローに HTTP リクエストのテストを含めたりすることができます。

> **Tip:**
> [SSL 構成](http-client-in-product-code-editor.html#ssl_certificate)と [OAuth 2.0 認証](oauth-2-0-authorization.html)は現在、HTTP クライアント CLI ではサポートされていません。 これらの機能の進行状況は、それぞれのタスク [IJPL-69643(英語)](https://youtrack.jetbrains.com/issue/IJPL-69643/HttpClient-add-certificate-support-in-CLIrunner) と [IJPL-69639(英語)](https://youtrack.jetbrains.com/issue/IJPL-69639/HTTP-Client-CLI-support-OAuth2-password-and-client-credentials-grant-types) で追跡できます。

Procedure: HTTP クライアント CLI をインストールする

HTTP クライアント CLI は次の方法で入手できます。

* HTTP クライアント CLI を [Docker イメージ(英語)](https://hub.docker.com/r/jetbrains/intellij-http-client)として取得するには、イメージをプルします。

```SHELL
docker pull jetbrains/intellij-http-client

```

イメージのバージョンを確認してください:  `docker run --rm -i -t -v $PWD:/workdir jetbrains/intellij-http-client --version`

* ZIP アーカイブを取得するには、 [当社のサイトからダウンロードする](https://www.jetbrains.com/ja-jp/ijhttp/download)か、cURL を使用します。

```SHELL
curl -f -L -o ijhttp.zip "https://jb.gg/ijhttp/latest"

```

> **Tip:**
> ZIP ディストリビューションを使用するには、JDK 25 以上のインストールが必要です。

インストールされているバージョンを確認する:  `./ijhttp --version`

* macOS では、Homebrew を使用してインストールすることもできます。

```SHELL
brew install ijhttp

```

インストールされているバージョンを確認する:  `ijhttp --version`

Procedure: HTTP リクエストの実行

1. [.http 要求ファイルを作成します](http-client-in-product-code-editor.html#composing-http-requests)。 すべてを一度に実行したい場合は、ファイルに複数の HTTP、WebSocket、GraphQL リクエストを含めることができます。

2. HTTP クライアント CLI を実行します：

ホストマシンで実行する場合:

ファイル名を  `./ijhttp`  コマンドに渡します。例：

`./ijhttp myrequest.http`

Docker 内で実行する場合:

`.http`  ファイルを使用してコンテナーを実行します。

`docker run --rm -i -t -v $PWD:/workdir jetbrains/intellij-http-client run.http`

このコマンドは、ホストマシン上の現在の作業ディレクトリ (  `$PWD`  ) とコンテナー内の  `workdir`  ディレクトリの間にバインドマウントを作成します。

> **Tip:**
> このコマンドでは、  `/workdir` が必要です: すべての  `.http` ファイルは、このディレクトリ内のコンテナーで実行されます。

コマンド出力には、送信されたリクエスト、テストステータス、 [環境変数](#environment-variables)に関する情報が含まれています。

![Run HTTP Client CLI](https://resources.jetbrains.com/help/img/idea/2026.3/http_client_cli.animated.gif)

Procedure: ログレベルの変更

デフォルトでは、HTTP クライアント CLI は、送信されたリクエストと環境変数に関する情報のみを出力します。  `-L`  オプションを使用して、ログレベルを変更できます。

* `-L HEADERS`  を使用して、要求ヘッダーと応答ヘッダーに関する情報をログに記録します。

* または、  `-L VERBOSE`  を使用して、要求と応答のヘッダーと本文に関する情報をログに記録します。

Procedure: 応答をファイルに保存

* HTTP 応答を別のファイルに保存する場合は、  `.http`  ファイルに  `>>`  または  `>>!`  を追加します ( [応答をリダイレクトする](exploring-http-syntax.html#response-redirect)も参照してください)。 例：

```HTTP_REQUEST_FULL
GET https://example.org/get

>> myFolder/myFile.json

```

* HTTP クライアント CLI からの出力を保存する場合は、  `>`  などの標準ターミナルコマンドを使用します。 例：

`./ijhttp rest-api.http > yourFile.txt`

保存された HTTP クライアント CLI 出力の詳細レベルは、指定された [ログレベル](#change-log-level)によって異なります。

Procedure: Docker で localhost を解決する

ホストマシンでサーバーを実行していて、Docker コンテナーで HTTP 要求を実行する場合、  `localhost`  をホストマシンのローカルホストに解決する必要がある場合があります。

* `-D`  オプションを使用します。例：

`docker run --rm -i -t -v $PWD:/workdir jetbrains/intellij-http-client -D run.http`

> **Tip:**
> Docker-for-Linux 20.10.0+ を使用する場合は、コマンドに  `--add-host host.docker.internal:host-gateway`  オプションも追加する必要があります。
>
>
>
>
> ```
> docker run --rm -i -t -v $PWD:/workdir --add-host host.docker.internal:host-gateway jetbrains/intellij-http-client -D run.http
> ```

このようにして、  `localhost`  を対象としたリクエストがホストマシンのローカルホストに送信されます。

## 環境変数

CLion HTTP クライアントと同様に、HTTP リクエストで [環境変数](http-client-variables.html)を使用できます。 HTTP 環境ファイルの変数を使用するか、変数値を CLI コマンドで直接渡すことができます。

Procedure: パブリック環境変数を使用する

* `--env-file`  オプションを使用して変数ファイルへのパスを指定し、  `--env`  オプションを使用して環境の名前を指定します。 例：

`./ijhttp --env-file http-client.env.json --env dev rest-api.http`

* または、  `-V`  オプションで変数値を渡します。 複数の変数を渡したい場合は、  `-V`  オプションを繰り返します。

`ijhttp -V host=localhost:8080 -V planet=tatooine rest-api.http`

両方のオプションを組み合わせることができます：

```
./ijhttp --env-file http-client.env.json --env dev -V host=localhost:8080 rest-api.http

```

Procedure: プライベート環境変数を使用する

* `--private-env-file`  オプションを使用して変数ファイルへのパスを指定し、  `--env`  オプションを使用して環境の名前を指定します。 例：

`./ijhttp --private-env-file http-client.private.env.json --env dev rest-api.http`

* `-P`  オプションで変数値を渡すこともできます。 複数の変数を渡したい場合は、  `-P`  オプションを繰り返します。

`ijhttp -P password=mypassword123 -P user=johndoe rest-api.http`

両方のオプションを組み合わせることができます：

```
./ijhttp --private-env-file http-client.private.env.json --env dev -P password=mypassword123 rest-api.http

```

## テストリクエスト

HTTP クライアントプラグインと同様に、  `.http`  ファイルには JavaScript ES6 で記述された [応答ハンドラースクリプト](exploring-http-syntax.html#response-handling)が含まれている場合があります。 これを使用して、 [client.assert](http-client-reference.html) メソッドで HTTP リクエストをテストできます。

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

* `.http`  ファイルで、リクエストから 1 行をスキップし、レスポンスハンドラースクリプトを  `> {% ... %}`  で囲みます。 例：

```JAVASCRIPT
GET https://httpbin.org/get

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

```

> **Note:**
> CLion を使用して、応答ハンドラースクリプトの構文ハイライトと補完を取得します。

別のファイルからテストを含めることもできます。 ファイルへのパスは、  `.http`  ファイルに対して絶対パスまたは相対パスのいずれかです。

```
GET https://httpbin.org/get

> /path/to/responseHandler.js

```

Procedure: テストレポートを JUnit XML 形式で保存する

HTTP クライアントは、JUnit XML フォーマットで出力を提供できます。

* `--report` 引数を  `ijhttp` コマンドに追加します。例:

`./ijhttp test.http --report`

HTTP クライアント CLI は、レポートを  `reports`  ディレクトリの  `report.xml`  ファイルに保存します。

