Cloudflare cf CLI 公開測試版：支援完整 API 的代理人導向命令列介面

cf CLI 讓代理人能完整存取 Cloudflare 超過 3,000 種 API 操作

Cloudflare 全新的 cf 命令列介面將涵蓋範圍從 Wrangler 的約 280 個指令擴展至整個 Cloudflare API 介面，使代理人能夠建立 Workers、部署程式碼、管理 DNS、購買網域以及設定安全性——所有操作皆可透過單一工具完成。這點至關重要，因為代理人現在擁有了一致的、以 JSON 為優先的介面，這不僅減少了 Token 的使用量，還消除了對臨時 --json 旗標或表格解析的需求。

---

以 JSON 為優先的設計降低了 LLM 驅動自動化的 Token 成本

過去使用 Wrangler 的代理人必須在少數支援的指令後附加 --json，然後再使用 jq 過濾輸出。大多數 Wrangler 指令會輸出以人類為導向的表格，迫使代理人花費額外的 Token 來解析無關的格式。cf 將 JSON 作為預設輸出，對人類而言格式美觀，對代理人而言則精簡，這直接降低了 API 呼叫成本並加快了推理速度。

"代理人只需要 JSON，如果代理人是此工具未來的首要使用者，那麼這就應該是預設值。" – Cloudflare 部落格

---

透過 cf cli search 實現以代理人為中心的指令搜尋

由於有超過 3,000 種可能的路由，代理人需要一種無需增加過多上下文即可找到正確操作的方法。cf cli search 指令接受自然語言查詢，並根據 API 描述和參數傳回排序後的匹配指令清單。首次執行 --help 時，系統會自動通知代理人此功能。

---

基於 TypeScript 的 cloudflare.config.ts 實現型別檢查配置

新的設定檔以 TypeScript 編寫，提供了一種支援 LSP 的代理人（例如 Claude Code、Codex）可以理解並自動完成的結構。型別化的配置讓代理人可以安全地編輯環境、綁定和觸發器，與 Wrangler 的 TOML 或 JSONC 格式相比，減少了錯誤。

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`),
    },
  },
}));

該配置還包含用於 KV、D1、R2、Queues、AI 等的輔助函式，全部皆可由編輯器自動完成。

---

Vite 預設值提供現代化的開發體驗

與依賴 esbuild 和自訂開發伺服器的 Wrangler 不同，cf 使用 Vite 作為預設的打包工具和開發伺服器。Vite 帶來了熱模組替換 (HMR)、豐富的插件生態系統，以及透過 Rolldown 實現的基於 Rust 的 Tree-shaking。Cloudflare Vite 插件和 Vitest 整合提供了一個與 Workers 執行時期相呼應的連貫工作流程。

---

從 Wrangler 無縫遷移

現有專案可以使用單一指令進行遷移：

cf migrate

已經使用 Vite 的 Workers 會自動轉換為 cloudflare.config.ts。依賴 Wrangler 的 esbuild 的專案將繼續委派建置給 Wrangler，以確保向後相容性。新專案可以使用 cf init 進行引導，或直接使用 cf deploy 部署靜態網站。

---

Hacker News 上的社群反應

• 正面興奮 – 使用者指出「如今一些最好的產品發布都是 CLI」，並歡迎 Wrangler 的替代品。
• 代理人優先的讚譽 – 評論者強調了以 JSON 為優先的介面以及 cf cli search 功能在減少 Token 使用量方面的優勢。
• 批評與建議 – 一些使用者質疑 TypeScript 的選擇，建議為 CLI 使用編譯語言，並要求支援 OpenCLI 規範以提高可發現性。
• 營運疑慮 – 少數人指出 Token 生成仍需要手動網頁導航，且有一位使用者回報了預發布版本在 CI 上的失敗。

"如今一些最好的產品發布都是 CLI，這真是太瘋狂了。" – @emadabdulrahim

"我不明白為什麼這是用 TypeScript 編寫的……不要強迫你的使用者管理你 CLI 的依賴項。" – @slowin

---

展望：代理人作為主要的 Cloudflare 操作者

Cloudflare 將 cf 定位為新興代理人開發工作流程的基礎工具。透過標準化指令命名、提供可搜尋索引以及交付型別檢查配置，該 CLI 旨在成為 AI 代理人和人類開發者的預設介面。未來的路線圖暗示包括原生的 Terraform 匯出以及透過 cloudflare.config.ts 進行更廣泛的策略配置。

---

如何開始

全域安裝公開測試版：

npm i -g cf

執行 cf --help 查看搜尋提示，然後探索諸如 cf workers deploy、cf dns create 或 cf cli search "buy a domain" 等指令。

---

cf CLI 是開源的；問題可以在 GitHub repository 上回報。