HTTP Client

HTTP Client の拡張機能は、IntelliJ IDEA の HTTP Client を Zed にもたらします。リクエストを .http や .rest ファイルに書き、ガターの ▶ ボタンで実行すると、応答が Zed のターミナルに表示されます。コードの中では、すべてのルートや HTTP クライアントの呼び出しが、それを既製のリクエストに変えるレンズを受け取ります。

ファイルの形式は IntelliJ IDEA、WebStorm、PhpStorm と互換性があり、VS Code の REST Client ともおおむね互換性があるので、既存の .http ファイルと http-client.env.json ファイルはそのまま動きます。

拡張機能の ID http-client
バージョン 0.3.1
言語 HTTP (.http、.rest)。加えて Dart、Java、Kotlin、JavaScript、TypeScript、TSX、Python、Go、Rust、PHP、Ruby、C# でのリクエストの生成
ランナー 拡張機能が自分でインストールするネイティブのバイナリー zed-http
プラットフォーム macOS と Linux。Windows でも動くはずですが未テスト
ソース zed_editor_extensions リポジトリの http-client-extension

提供するもの

見た目

api.http を作ります。

@baseUrl = https://httpbin.org

### Get data
GET {{baseUrl}}/get?client=zed
Accept: application/json

### Create a record
POST {{baseUrl}}/post
Content-Type: application/json

{
  "id": "{{$uuid}}",
  "name": "Zed"
}

各 GET と POST の行の横のガターに ▶ が現れます。GET の横のものをクリックすると、HTTP: GET {{baseUrl}}/get?client=zed という名前のターミナルのタブが開き、次のように表示されます。

GET https://httpbin.org/get?client=zed
Accept: application/json

HTTP/1.1 200 OK  413 ms · 250 B
access-control-allow-origin: *
content-length: 250
content-type: application/json
date: Sat, 07 Nov 2026 19:05:38 GMT

{
  "args": {
    "client": "zed"
  },
  "headers": {
    "Accept": "application/json",
    "Host": "httpbin.org"
  },
  "method": "GET",
  "url": "https://httpbin.org/get?client=zed"
}

saved: ./.zed-http/line-3.json

環境のファイルが見つかった場合は、environment: dev の行が先頭に来ます。

ステータスは、2xx では緑、3xx では黄、4xx と 5xx では赤です。JSON は整形され、バイナリーのボディはそのサイズと種類だけが表示されます。saved: のパスはクリックでき、ハイライトと検索付きで Zed で応答を開きます。

{{baseUrl}} にホバーすると、解決された値とその出どころが表示されます。

baseUrl · environment `dev`
https://httpbin.org

ファイルの最初の行の上には、ファイル自身のものを先頭に、環境を示すレンズの行があります。

env: prod | dev | staging

リクエストを実行する

方法 実行されるもの
メソッドの横のガターの ▶ このリクエスト
task: spawn → HTTP: GET … カーソルの下のリクエスト。# @name があればその名前が付く
task: spawn → HTTP: run all requests in … ファイルのすべてのリクエストを順に
task: rerun 最後の実行をもう一度
キーバインド (キーバインド を参照) カーソルに最も近いリクエスト

タスクとそのターミナルのタブには、リクエストの # @name (HTTP: get-todos-by-id)、またはそのメソッドと URL の名前が付きます。

.http ファイルの形式

### Optional title
# @name requestName
METHOD URL [HTTP/version]
Header: value
Header: value

request body

ディレクティブ

ディレクティブ 意味
# @name login リクエストの名前: --name、応答の参照、タスクのタイトルのため
# @env prod 環境: 最初の ### の上ならファイル全体の、その下なら一つのリクエストの
# @no-redirect 3xx のリダイレクトをたどらない
# @no-log 応答を保存しない。以後の実行はそれを参照できない。生成されたリクエストはこれを持つ

変数

変数は、URL、ヘッダー、ボディ、ファイルパスの中で {{name}} と書きます。波括弧の中の空白は許可され、値は他の変数を含められます。

@host = api.example.com
@baseUrl = https://{{host}}/v1

GET {{baseUrl}}/users

ファイルの変数はファイル全体に適用され、環境の値を上書きします。

動的な変数

変数 結果
{{$uuid}}、{{$random.uuid}} UUID v4
{{$timestamp}} 秒単位の Unix 時間
{{$isoTimestamp}} 2026-10-16T11:01:53.123Z のような ISO 8601 の UTC 時刻
{{$randomInt}} 0 から 999 の整数
{{$randomInt 1 100}}、{{$random.integer 1 100}} [1, 100) の整数
{{$random.float}} 0 と 1 の間の浮動小数点数
{{$random.alphabetic 8}} 8 個のランダムな英字
{{$random.alphanumeric 12}} 12 個のランダムな英数字
{{$random.hexadecimal 16}} 16 個の 16 進数の文字
{{$processEnv.TOKEN}}、{{$env.TOKEN}} OS の環境変数 TOKEN

使うたびに新しい値が生成されます。変数は次の順で検索されます。動的な変数、ファイルの変数、選択された環境 (public より private のファイル)、$shared ブロック、そして保存された応答への参照です。未知の変数はエラーで、リクエストは送られません。

環境

http-client.env.json はプロジェクトとともにコミットします。

{
  "$shared": { "apiVersion": "v1" },
  "dev": { "baseUrl": "http://localhost:8080" },
  "prod": { "baseUrl": "https://api.example.com" }
}

http-client.private.env.json は秘密情報を保持し、.gitignore に入れるべきものです。

{
  "dev": { "token": "dev-secret" },
  "prod": { "token": "prod-secret" }
}

private ファイルは public のものの上にマージされます。ファイルは .http ファイルのフォルダーとその .zed/http/ で探され、次に最初に一致するまでツリーを上へたどります。

環境を選ぶ。 最初の行の上のレンズの行で一つをクリックすると、ファイルに # @env が書き込まれます。リクエストは独自の環境を持てます。カーソルをそれに置き、Cmd-. を押して HTTP: choose an environment for this request を選びます。すると、そのレンズの行は再びそれを取り除くための from file を提供します。レンズには Zed の設定で "code_lens": "on" が必要です。それがなければ、# @env の行を入力してください。

環境は優先順位で選ばれます。

  1. CLI の --env prod フラグ。
  2. その ### の下にある、リクエスト自身の # @env。
  3. 最初の ### の上にある、ファイルの # @env。
  4. HTTP_CLIENT_ENV 変数。たとえば "terminal": { "env": { "HTTP_CLIENT_ENV": "prod" } } の中で。
  5. あれば dev、local、development。
  6. ファイルの最初の環境。

定義されていない環境は、何かが送られる前に実行を止め、レンズで (not defined) と示されます。

定義へ移動

変数の上で Cmd クリックまたは F12:

カーソルの下 移動先
@token = ... で宣言された {{token}} @token の行
環境からの {{baseUrl}} http-client.env.json または private ファイルの "baseUrl" キー
{{login.response.body.token}} # @name login
{{$uuid}} とその他の動的な変数 どこにも移動しない

変数が public と private の両方のファイルにある場合、Zed は両方を列挙します。応答の参照のホバーは保存された値を表示するか、リクエストがまだ実行されていないことを伝えます。動的な変数のホバーは値のサンプルを表示します。

リクエストのチェーン

名前付きのリクエストの応答は保存され、以後のリクエストで使えます。

### Login
# @name login
POST {{baseUrl}}/auth/login
Content-Type: application/json

{ "user": "admin", "password": "{{password}}" }

### Profile
GET {{baseUrl}}/me
Authorization: Bearer {{login.response.body.accessToken}}
式 値
{{login.response.body}} ボディ全体
{{login.response.body.data.token}} パスによる JSON のフィールド
{{login.response.body.$.data.token}} 同上、JSONPath の形式
{{login.response.body.items[0].id}} 配列の要素
{{login.response.headers.Location}} ヘッダー。大文字小文字を区別しない
{{login.response.status}} ステータスコード

応答は .http ファイルの隣の .zed-http/responses.json に保存され、再起動後も残ります。login を一度実行すれば、他のリクエストを一つずつ実行できます。@name のないリクエストは line-<number> として保存されます。

ボディと応答

構文 効果
空行の後のボディ 次の ### まで、そのまま送られる。末尾の空行は取り除かれる
ボディとしての < ./payloads/item.json ファイルが変数の置換なしにバイト列として送られる
マルチパートのボディの中の < ./report.txt ファイルのテキストで置き換えられる
Authorization: Basic user password 自動で Base64 エンコードされる (user:password も)
リクエストの後の >> ./out/report.csv 応答を保存する。存在すれば report-1.csv、report-2.csv など
>>! ./out/report.csv 応答を保存し、ファイルを上書きする

すべての応答は、Content-Type で選ばれた拡張子で、.zed-http/<name or line-N>.<ext> にも保存されます。.gitignore に追加してください。

.zed-http/
http-client.private.env.json

コードからリクエストを生成する

コードの中のすべてのルートや HTTP クライアントの呼び出しは、行の上に 🌐 Generate .http request レンズを受け取ります。一回のクリックで、完全なリクエストが .zed/http/endpoints/<source file>.http (server.ts は server.ts.http になります) に追加され、それが開きます。リクエストが存在すると、レンズは 🔗 Open とファイル名 (🔗 Open server.ts.http など) になります。同じアクションは Cmd-. のメニューにもあります。Zed ではコードレンズはデフォルトで無効なので、有効にしてください。

{ "code_lens": "on" }

"menu" では、レンズは代わりに Cmd-. のメニューに現れます。ここではガターの ▶ は不可能です。拡張機能がガターのボタンを追加できるのは、自分で定義する言語だけだからです。

リクエストは、同じファイルのハンドラーとモデルのクラスから埋められます。パス変数は、先頭に @id = 1 を置いた {{id}} になります。クエリパラメーター、ヘッダー、型に基づくプレースホルダー (""、0、false、[]、入れ子のオブジェクト) を持つ JSON のボディが追加され、ハンドラーが認証を必要とする場合は Authorization: Bearer {{token}} が追加されます。Spring for Dart のコントローラーの場合:

@RestController()
@RequestMapping('/api/books')
class BookController {
  @GetMapping('/{isbn}')
  Future<Book> find(@PathVariable() String isbn) => books.find(isbn);

  @PostMapping()
  Future<ResponseEntity<Book>> create(
    @RequestHeader('X-Request-Id') String requestId,
    @RequestBody() @Valid() NewBook book,
  ) async => ...
}

class NewBook {
  const NewBook({required this.isbn, required this.title, this.stock = 0});

  final String isbn;
  final String title;
  final int stock;
}

@GetMapping と @PostMapping のレンズは、.zed/http/endpoints/book_controller.dart.http に次のものを追加します。

### get-api-books-by-isbn
# @name get-api-books-by-isbn
# @no-log
@isbn = 1
GET {{baseUrl}}/api/books/{{isbn}}
Accept: application/json

### post-api-books
# @name post-api-books
# @no-log
@xRequestId = value
POST {{baseUrl}}/api/books
Accept: application/json
X-Request-Id: {{xRequestId}}
Content-Type: application/json

{
  "isbn": "",
  "title": "",
  "stock": 0
}

サーバーのアドレス。 Spring のアプリケーション (Java や Kotlin の Spring Boot、または Spring for Dart) では、拡張機能は application.yml、application.yaml、application.properties (Spring for Dart では lib/resources/ の中) から、server.port、server.servlet.context-path、server.address、TLS の設定を読みます。最初に生成されたリクエストが、そのアドレスを持つ .zed/http/http-client.env.json を作ります ("baseUrl": "http://localhost:9090/shop" など)。自分で設定した baseUrl が変更されることはありません。

クライアントはクライアントの行き先へ。 Feign クライアント (@FeignClient、Java と Dart) は、同じ設定から ${...} プレースホルダーを解決した url を使います。解決できないものは、{{catalogUrl}} のように、プロパティにちなんだ名前の変数になります。

http.post(_endpoint, ...) のように 変数に保持された URL も見つけられます。リクエストは、変数に代入された URL、それを読む環境変数 ({{GROQ_URL}})、または変数名が URL を示す場合はその名前 ({{apiUrl}}) を使います。

複数の文やファイルにわたって組み立てられる URL は見つけられず、他のファイルで定義されたモデルは解決されません。その場合、ボディは {} になります。

サポートされるフレームワーク

フレームワークは、ファイルがそのインポートのいずれかを持つ場合にだけ、そのファイルで有効になるので、同じ言語のフレームワークが干渉することはありません。

言語 フレームワークとクライアント
Dart と Flutter Spring Web for Dart (spring_boot_starter_web)、Feign for Dart (spring_boot_starter_feign)、Dio、package:http、retrofit.dart、Chopper、shelf_router
Java Spring Web (MVC、WebFlux、OpenFeign)、JAX-RS (Quarkus、Jakarta EE、Helidon、Dropwizard)、Micronaut、Retrofit、OpenFeign
Kotlin Spring Web、Ktor サーバー、Ktor クライアント、Retrofit、JAX-RS (Quarkus)
TypeScript と JavaScript Express、Fastify、Hono、Koa router、NestJS、Axios、Angular HttpClient、fetch
Python FastAPI、Flask、Django URLconf、requests / httpx / aiohttp
Go gorilla/mux、net/http、Gin、Echo、chi、Fiber
Rust axum、actix-web、Rocket、reqwest
PHP Laravel、Symfony、Slim、Guzzle
Ruby Rails routes、Sinatra、Faraday / HTTParty
C# ASP.NET Core のコントローラー、ASP.NET Core の minimal API、Refit、HttpClient

カタログは frameworks.json です。正規表現ではなく、型付きのプレースホルダーを持つソースコードとして書かれたパターンです。プロジェクトは .zed/http/frameworks.json で独自のフレームワークを追加でき、それは組み込みのカタログにマージされ、保存時に拾われます。

{
  "$schema": "https://raw.githubusercontent.com/farum-azula/zed_editor_extensions/main/http-client-extension/frameworks.schema.json",
  "languages": {
    "dart": {
      "frameworks": {
        "my-api-client": {
          "name": "Our ApiClient",
          "imports": ["package:my_app/api_client.dart"],
          "routes": ["api.call(\"{method}\", \"{route}\""],
          "body": ["api.call(...data: {keys}"]
        }
      }
    }
  }
}

プロジェクトのルートでの zed-http frameworks は、マージされたカタログをチェックして表示します。examples/code フォルダーには、フレームワークごとに一つの実行可能なファイルがあります。

新しいエンドポイント

http: new endpoint タスクは、ターミナルでメソッド、URL、名前を尋ね、.zed/http/endpoints/<name>.http を作り、それを開きます (zed コマンドが PATH にある場合)。環境がまだなければ、dev プロファイルを持つ .zed/http/http-client.env.json も作ります。拡張機能のタスクは .http ファイルが開いている間だけ見えます。これをどこでも使えるようにするには、~/.config/zed/tasks.json に追加します。

[
  {
    "label": "http: new endpoint",
    "command": "zed-http",
    "args": ["new", "\"$ZED_WORKTREE_ROOT\""],
    "use_new_terminal": true,
    "reveal": "always",
    "hide": "on_success"
  }
]

zed-http コマンド

ランナーは、ターミナルで、スクリプトで、CI で、単独で動きます。

zed-http run <file.http> [--line N | --name NAME | --all] [--env ENV] [--raw] [--timeout SECS]
zed-http list <file.http>
zed-http envs <file.http>
zed-http new [ROOT] [--name NAME] [--method METHOD] [--url URL] [--from FILE:LINE] [--no-open]
zed-http detect <file> [--line N]
zed-http frameworks [ROOT]
zed-http lsp
コマンドまたはフラグ 効果
run リクエストを実行する
list リクエストを列挙する: 行、メソッド、URL、名前
envs 環境を列挙する
new ROOT/.zed/http/endpoints/<name>.http を作る。--from FILE:LINE はコードからメソッドと URL を取る。--no-open はそれを開かない
detect コードの中のエンドポイントを見つける: 行、メソッド、URL、フレームワークをタブ区切りで
frameworks サポートされるフレームワークを表示し、ROOT/.zed/http/frameworks.json をチェックする
lsp Zed が起動する言語サーバー
-l、--line N 行 N を含むリクエスト
-n、--name NAME @name またはタイトルによるリクエスト
-a、--all すべてのリクエストを順に
-e、--env ENV 環境
--raw JSON の整形なし
--timeout SECS リクエストのタイムアウト。デフォルトは 60 秒

終了コードは、すべてのリクエストが 400 未満のステータスを返した場合は 0、一つが 4xx や 5xx を返したり失敗したりした場合は 1、引数、ファイル、変数、環境のエラーでは 2 です。そのため、zed-http run smoke.http --all --env staging は CI のチェックとして使えます。

$ zed-http detect lib/api/auth_api.dart
12	POST	{{baseUrl}}/auth/login	dart/dio

キーバインド

エディターにフォーカスを保ったまま、Cmd-Enter でカーソルの下のリクエストを実行するには、キーマップ (zed: open keymap) に追加します。

[
  {
    "context": "Editor && extension == http",
    "bindings": {
      "cmd-enter": ["editor::SpawnNearestTask", { "reveal": "no_focus" }]
    }
  }
]

ランナーのインストールのされ方

拡張機能は次の順で zed-http を見つけます。

  1. すでに PATH 上にある zed-http。自分のインストールが常に優先されます。
  2. 以前にインストールしたコピー。Zed の拡張機能の作業ディレクトリの下の、そのフォルダーにあります。
  3. リポジトリの リリース からダウンロードした、このプラットフォーム向けのリリースビルド (macOS と Linux、Intel と ARM)。
  4. 拡張機能自身の cli/ フォルダーからの cargo install によるビルド。リポジトリからクローンした開発用の拡張機能では、これが通常のケースです。その場合、最初の起動にはランナーのリリースビルドと同じだけの時間がかかります。

その間、Zed はサーバーをインストール中として表示します。サーバーは ~/.zed-http/bin に自分のコピーを保持し、PATH に zed-http がない場合、▶ ボタンはそこを探します。CLI として使うためにランナーを手でインストールするには:

cd zed_editor_extensions/http-client-extension
cargo install --path cli

制限

トラブルシューティング

ガターに ▶ がない。 右下の言語が HTTP であることと、"gutter": { "runnables": true } が無効にされていないことを確認してください。▶ はあるのに実行すると zed-http: command not found と報告される場合、このウィンドウではサーバーがまだ起動していません。.http ファイルを開き、ステータスバーに zed-http が表示されるのを待ってから、もう一度実行してください。

▶ はあるが、HTTP: … タスクが提供されない。 拡張機能の languages/http/tasks.json をプロジェクトの .zed/tasks.json にコピーしてください。

変数の上で Cmd クリックしても何も起きない。 editor: restart language server を実行し、dev: open language server logs を確認してください。

cargo でインストールしたランナーで zed-http: command not found。 ~/.cargo/bin が、Zed が起動するシェルの PATH にありません。シェルのプロファイルに追加し、Zed を再起動してください。

unknown variable {{baseUrl}}。 http-client.env.json が見つからないか、環境にその変数がありません。zed-http envs file.http を実行し、出力の先頭の environment: の行を確認してください。

no stored response for request 'login'。 まず # @name login を持つリクエストを実行してください。

自己署名証明書での TLS のエラー。 システムのルート証明書が使われます。自分の CA をシステムのストアに追加してください。

リンク