HN 日本語サマリー

← 一覧へ戻る
インフラ・DevOps

Cf: Cloudflare APIのためのエージェント対応CLI

Cf: The Agentic CLI for the Cloudflare API (blog.cloudflare.com)

171 pointsby macleos87 コメント

要約

Cloudflareは、エージェントによる利用が急増しているWrangler CLIに代わる新しいCLIツール「cf」を発表しました。cfは、Cloudflareの3,000以上のAPI操作すべてに対応し、エージェントが自然言語でコマンドを検索・実行できるように設計されています。JSON出力をデフォルトとし、TypeScriptベースの設定ファイル、Viteの統合など、エージェントの効率と開発者の生産性向上を目指した機能が搭載されています。

全文翻訳

Introducing cf: the agentic CLI for the entire Cloudflare API

この1年間で、エージェントによるWranglerの利用は急増しています。

2026年3月には、エージェントがWrangler利用の4分の1を占めるようになり、前年は一桁台のパーセンテージでした。先週には、エージェントの利用率は48%に達しました。

エージェントはより多くのコマンドを実行し、1日あたりのユニークコマンド数はほぼ2倍、6つ以上のコマンドを使用する可能性もほぼ4倍になります。

エージェントはCLIを好みます。しかし、Wranglerはわずか約280の操作に対するコマンドしか提供しておらず、Cloudflareは数千ものAPIを提供しています。

今年の初めにこの問題をどのように解決する予定かをティーザーしましたが、本日、新しいCLIである「cf」を導入することで、エージェントがすべてのCloudflare製品を利用できるようにします。

cfは、次世代のソフトウェア開発のために構築されたCLIです。

  • エージェントは、カスタム検索とステアリングにより、あらゆる目的のコマンドを見つけることができます。
  • JSONはデフォルトのインターフェースであり、人間向けには整形され、エージェント向けには圧縮されて最大のコンテキスト節約を実現します。
  • cloudflare.config.ts は、Workersから始まり、TypeScriptの安全性と精度をあなたとエージェントの言語サーバープロトコル(LSP)にもたらす、Cloudflare全体の新しい設定フォーマットです。
  • Viteがデフォルトとなり、最高のローカル開発サーバーと、開発者およびフレームワーク作成者向けのプラグインスイートをもたらします。

本日よりグローバルでオープンベータ版をインストールし、どこからでも実行できます。

npm i -g cf

cfはエージェントにCloudflare API全体へのアクセスを提供します

もしあなたのエージェントがCloudflareのできるすべてを実行できるとしたらどうなるでしょうか?それが今年の初めに私たちの関心を spark した質問でした。エージェントはますます強力になっていましたが、CloudflareのCLIでできることにはまだ限界がありました。

Wranglerは各プロダクトチームが貢献し、独自のコマンド開発者体験を採用して手作業で構築されました。チーム間でパターンを強制することは、約280のコマンドパス全体であっても、事実上不可能でした。私たちは、「d1 info」、「hyperdrive get」、「workflows describe」のように、各チームが異なる時期に独自のプラクティスを考案したため、用語に一貫性がありませんでした。一部のチームは、コードが数千行に及ぶ完全にカスタムな体験を構築しましたが、これはごくまれに使用されるだけで、チームは同じ問題を解決するために異なるアプローチを採用していました。

私たちは、既存のものを標準化すると同時に、大規模な拡張を一度に行いたかったのです。Forge — Cloudflareの新しい統一API生成パイプライン — がこれを可能にし、APIドキュメントやSDK生成を支えるAPIスキーマから直接CLIコマンドを生成するというアイデアに基づいています。私たちが提供するすべてのものにはOpenAPIスキーマがあり、これを少し追加情報で注釈付けすれば、ForgeがCLIを作成するためのソースとして使用できます。

これにより、Wranglerが長年かけて構築してきた約280の関数から「cf」を拡張し、3,000を超えるCloudflare APIサーフェス全体をカバーできるようになります。

今では、エージェントに「cf」を与えて、ワーカーの設定、デプロイ、監視、オブザーブ、Cloudflare Accessによる保護、ドメインの購入、そしてCloudflare WAFによるフロントエンド化まで、すべてを単一のツールから実行させることが簡単になりました。

cfを使ったことのないエージェントのために構築する

cfは、ソフトウェアエンジニアリングの軌跡、つまりエージェント開発がソフトウェアの構築とデプロイの方法を劇的に変えているために構築されています。今年、私たちはこのシフトをサポートするツールを提供することに注力しており、その集大成がcfです。cfは最初からエージェントを念頭に置いて構築されており、エージェントが将来的にさらに多くのCLIで標準となるであろう、エージェントコマンド発見のための新しいツールが含まれています。

Wranglerは、長年のドキュメント、ブログ、サードパーティガイドがLLMのトレーニングプロセスに吸収されているという利点がありました。同時に、同じ欠点もありました。Wranglerの動作を変更することは、学習済みの行動に反するため、私たちが望む改善の規模を考えると、大幅な変更は避けられません。

エージェントがまだ見たことのない新しいCLIを導入することは、大きな破壊的な変化のように聞こえるかもしれませんが、実際には最もクリーンな方法です。私たちが下した設計上の決定、提供できるコンテキスト注入、そして追加できるAGENTS.mdファイルのおかげで、このように切り替えることは、エージェントが使い慣れたツールの2つのバージョンの大きな違いをコンテキスト化するよりも、実際には混乱が少なくなります。私たちは、エージェントに焦点を当てた機能のいくつかを組み込んでローンチしており、今後さらに追加していく予定です。

エージェントはテーブルではなくJSONをフィルタリングする必要がある

エージェントがWranglerを使用する際、すべてのコマンドに「--json」を付加し、その後「jq」で出力をフィルタリングしてフィールドのサブセットを抽出します。しかし、Wranglerのコマンドの一部しか「--json」をサポートしておらず、多くのコマンドは人間がターミナルで出力を確認するために設計されたUnicodeテーブルを返していました。エージェントはこれらを理解できますが、人間が「jq」フィルターを使用するよりも多くの時間とトークンを消費します。

cfでは逆のアプローチを取っています。エージェントはJSONを必要とするだけで、このツールの将来の主要ユーザーがエージェントであるならば、それがデフォルトであるべきです。ほとんどのコマンドは人間がアクセスすることはまれなので、これは明らかに正しい選択です。

このCLIの人間のお客様であるあなたは、実際にはそれを使用する一歩手前にいます。エージェントが結果を簡単にフィルタリングし、そのフィルタリングされたリストを要求された形式で返すことができる方が、あなたが直接読むことはまずないであろうテーブルを提供するよりも望ましいです。

しかし、ドメインの購入など、実際の個人的な入力が必要なことをしたい場合はどうでしょうか?

エージェントが長くて扱いにくいパラメータのシーケンスを連鎖させることでアクセスできるコマンドの場合、フォームに記入するだけで済みます。CfはAPIの要件を検証済みの入力のシリーズに分解するため、複雑な要件を持つドメインの購入でさえ、簡単に追跡できます。

あるいは、どうしてもというなら、エージェントにそれを実行するように頼むだけです。

あなたのエージェントは自分で正しいコマンドを見つけることができます

CLIには3,000もの可能なルートがありますが、コンテキストを肥大化させることなく、エージェントは必要な操作を迅速に見つけることができますか?このため、「cf cli search」も追加しました。

このコマンドにより、エージェントは自然言語で必要なことを尋ねることができ、小さな検索インデックスがAPIの説明とパラメータに基づいて適切なコマンドのリストを提供します。エージェントが初めて「--help」を実行したときに、このコマンドについて自動的に通知します。

エージェントのタイプチェックを行う設定

新しい設定フォーマットはTypeScriptに基づいており、人間とエージェントの両方が解析しやすく、設定をプログラムで記述できます。

型付けされた設定はエージェントにとって非常に役立ちます。プログラムによる設定フォーマットに関する事前のコンテキストがなくても、エージェントはオンデマンドで設定を簡単に識別および編集でき、Wranglerの同じ名前の機能から劇的に変更された「env」のような要素であっても対応できます。Claude CodeやCodexなどのLSPプラグインを使用するすべてのエージェントは、コンテキスト内で設定ファイルフォーマットについてより多くのことを解釈できるようになり、その結果、はるかに正確な提案を行うことができます。

アクセス可能なスキーマを持たないTOMLや、エージェントがほとんど使用しないリンクされたスキーマを持つJSONCと比較してください。

Cloudflare内のWrangler設定ファイルの一部は、開発者ごとのカスタム環境が多く、5,000行を超えていたものが40%削減され、各開発者の設定をより効率的に構築するファクトリファイルになりました。

これは、Wranglerで一般的だった「env」ブロックをコピーするのではなく、同じユニバーサルベースから各環境をプログラムで定義することによって達成されます。複数の環境を持つシンプルなWorkerは、Viteネイティブの「mode」引数を切り替えるだけで、1つの設定セットから別の設定セットに切り替えることができます。

これを実行するシンプルな設定は次のようになります。

import { bindings, defineConfig } from "cf/config";
import * as entrypoint from "./index.js" with { type: "cf-worker" };

export default defineConfig(({ mode }) => ({
  worker: {
    name: "example-worker", 
      entrypoint,
      compatibilityDate: "2026-09-27",
      env: {
        Environment: bindings.text(`This is ${mode} environment`),
      },
    },
}));

「cf migrate」を実行することで、Cloudflare Workerをこの新しいフォーマットに移行できます。

Workerの構築を容易にするためのいくつかのヘルパー関数も提供しています。

bindings は、エージェントが開発者プラットフォームが提供するすべてのものを発見するための簡単な場所を提供します。環境変数からストレージ、データベース、キューまで、すべてがエディタによって自動補完され、説明されます。

import { bindings, defineConfig } from "cf/config";

export default defineConfig(({ mode }) => ({
  worker: {
    // ...
    env: {
      API_URL: bindings.text(
        mode === "production"
          ? "https://example.com"
          : "https://staging.example.com"
      ),
      API_TOKEN: bindings.secret(),
      CACHE: bindings.kv ({
        id:
          mode === "production"
            ? "production-namespace-id"
            : "staging-namespace-id",
      }),
      DATABASE: bindings.d1({ name: `example-${mode}-database` }),
      UPLOADS: bindings.r2({ name: `example-${mode}-uploads` }),
      JOBS: bindings.queue < { userId: string } > ({
        name: `example-${mode}-jobs`,
      }),
      AI: bindings.ai(),
      SEARCH_INDEX: bindings.vectorize({
        name: `example-${mode}-search`,
      }),
      API: bindings.worker({ worker: `example-${mode}-api` }),
    },
  },
}));

同様に、「triggers」のためのヘルパーを含めました。これは、Workerのルート、キュー、スケジュール、およびメールトリガーを定義する新しい方法です。これらの設定が設定ファイル全体に散らばるのではなく、Workerを実行するアクションを単一のブロックで簡単に見つけることができるようになりました。

import { defineConfig, triggers } from "cf/config";

export default defineConfig({
  worker: {
    // ...
    triggers: [
      triggers.fetch({ pattern: "example.com/*" }),
      triggers.scheduled({ schedule: "0 * * * *" }),
      triggers.queue({ name: "jobs", maxBatchSize: 10 }),
      triggers.email({ addresses: ["support@example.com"] }),
    ],
  },
});

defineConfig.worker はほんの始まりにすぎません。cloudflare.config.ts の意図は、Cloudflare全体を管理する方法です。必要なすべての製品 — エージェントがcfを通じて利用できるAPIとともに — 型安全な設定を通じて表現できるようになります。すぐに、ポリシー全体を設定し、ゾーンを設定し、DNSを設定するなど、すべてをこの設定ファイルを通じて行うことができるようになります。

クラス最高の開発体験

WranglerがJavaScript Workersの構築を始めたとき、Viteはまだ存在しませんでした。代わりに、Wranglerではesbuildを使用してWorkerをバンドルしていました。Wranglerが:8787で提供していた開発サーバーはWranglerチームが構築したもので、これを変更するにはMiniflareのようなCloudflare固有のローカルトゥールの内部に手を伸ばす必要がありました。

Viteはこの点で大きな改善であり、大規模なプラグインエコシステムを備えているだけでなく、HMR(ホットモジュールリプレイスメント)を備えた最高の開発サーバーと、ツリーシェイキングにRustベースのライブラリRolldownを使用するビルドを提供します。Viteでできることは何でも、Cloudflare Viteプラグインでできます。

Cloudflare Viteプラグインは、フロントエンド中心のプロジェクトであれ、バックエンドAPIであれ、Workerを構築する際に推奨される方法です。Vitestプラグインと組み合わせることで、Workersランタイムと一致する統合された開発およびテスト環境を提供し、バインディングとプラットフォームAPIに直接アクセスできます。

cfはデフォルトでVite上に構築されています。ほとんどのWorkerはエージェントによって簡単に移行できます。他のものは時間がかかる可能性があるため、cfはesbuildとRustおよびPython Workerを引き続き使用する必要があるJavaScript Workerの開発とデプロイのために、Wranglerに委任し続けます。

Wranglerからの移行

WranglerからのWorkerの移行は、次を実行するのと同じくらい簡単です。

cf migrate

すでにViteでビルドしているWorkerは、cloudflare.config.tsに変換されます。WorkerがesbuildのためにWranglerに依存している場合、cfは引き続きWranglerにビルドを委任します。

オープンベータが終了すると、Wranglerの最終メジャーバージョンをリリースし、あなたとあなたのエージェントにcfの使用を指示します。移行期間を与えるために、ベータ終了後18ヶ月間、Wranglerのメンテナンスサポートを提供し続けます。

新しいプロジェクトを開始し、cf init/deployを実行することでCloudflare用に自動的に設定することもできます。これにより、Cloudflare Viteプラグインがインストールされ、設定ファイルが作成されます。

静的サイトは開始するために設定ファイルを必要としないままで、デプロイはプロジェクトでcf deployを実行するのと同じくらい簡単です。

cfで新しいHello Worldプロジェクトを開始するには、cf initを使用してください。

cfはオープンソースであり、問題はGitHubリポジトリに報告できます