Cloudflare／官方：推出代理式 CLI「cf」——以 Forge 自 OpenAPI 生成逾三千操作；JSON 預設、自然語言搜尋指令；Wrangler 將維護十八個月

Key takeaway

Cloudflare 於二零二六年九月二十八日 Birthday Week 正式推出新一代命令列工具「cf」（開放測試版），以代理（agent）為主要使用對象，涵蓋整個 Cloudflare API 表面逾三千項操作。官方指 Wrangler 僅約二百八十項操作路徑，而代理使用 Wrangler 的佔比已由二零二六年三月約四分一升至上週百分之四十八；新 CLI 預設輸出 JSON，並提供自然語言指令搜尋與 TypeScript 設定檔。本文已核對 Cloudflare 官方網誌；來源真實性已驗證。

Cloudflare／官方：推出代理式 CLI「cf」——以 Forge 自 OpenAPI 生成逾三千操作；JSON 預設、自然語言搜尋指令；Wrangler 將維護十八個月

Cloudflare 於二零二六年九月二十八日 Birthday Week 正式推出新一代命令列工具「cf」（開放測試版），以代理（agent）為主要使用對象，涵蓋整個 Cloudflare API 表面逾三千項操作。官方指 Wrangler 僅約二百八十項操作路徑，而代理使用 Wrangler 的佔比已由二零二六年三月約四分一升至上週百分之四十八；新 CLI 預設輸出 JSON，並提供自然語言指令搜尋與 TypeScript 設定檔。本文已核對 Cloudflare 官方網誌；來源真實性已驗證。

Cloudflare／官方：推出代理式 CLI「cf」——以 Forge 自 OpenAPI 生成逾三千操作；JSON 預設、自然語言搜尋指令；Wrangler 將維護十八個月

Cloudflare 於二零二六年九月二十八日在官方開發者網誌宣布，推出面向代理開發時代的新 CLI：cf（open beta）。安裝方式為 npm i -g cf。官方強調，cf 並非 Wrangler 的小幅升級，而是以 Forge 生成管線直接由 API schema／OpenAPI 產出指令，把可操作表面由 Wrangler 約二百八十項擴至逾三千項 Cloudflare API 操作。本文已核對 Cloudflare 官方網誌〈Introducing cf: the agentic CLI for the entire Cloudflare API〉；來源真實性已驗證。本站稍早已報道同日開源的 Forge 管線本身；本稿聚焦 cf 產品 CLI 正式開放測試，屬可獨立核對的產品落地。

一、核心事件：代理用量翻倍，CLI 必須覆蓋全 API

官方數據：代理已成為主力 CLI 用戶

Cloudflare 寫明：二零二六年三月，代理約佔 Wrangler 使用量的四分一；上週代理使用佔比達百分之四十八。代理每日使用的相異指令數約為人類用戶的兩倍，且使用六項或以上指令的機會約為四倍。官方結論是：代理喜愛 CLI，但 Wrangler 只能覆蓋約二百八十項操作，而 Cloudflare 產品表面有數千項。

為何不能只「改」Wrangler

官方指出，Wrangler 多年來由各產品團隊手寫指令，術語與參數風格不一致（例如不同產品對 info／get／describe 類動詞的用法不一），要在既有約二百八十條路徑上強制統一已極困難。更關鍵的是：大型語言模型已吸收大量 Wrangler 舊文件與第三方教學；若在同一工具名下做大規模破壞性變更，反而與訓練記憶衝突。因此 Cloudflare 選擇推出全新 CLI 名稱 cf，再以 AGENTS.md、首次 --help 的上下文注入與搜尋指令，讓代理更快學會正確路徑。

Forge 生成：由 OpenAPI 一次擴到三千以上操作

官方明確將 cf 的擴張能力歸功於 Forge——統一 API 生成管線，由驅動文件與 SDK 的同一份 API schema 直接生成 CLI 指令。這使 cf 可從 Wrangler 累積的約二百八十項功能，擴至整個 Cloudflare API 表面逾三千項操作。官方舉例：可把 cf 交給代理，要求它建立 Worker、部署、監控觀測、用 Access 保護、購買網域、並掛上 WAF——全部經單一工具完成。

二、技術原理深度解析

1. JSON 預設：為代理而非終端表格設計

官方觀察：代理使用 Wrangler 時幾乎總是附加 --json，再用 jq 過濾欄位；但 Wrangler 僅部分指令支援 --json，其餘常回傳給人類閱讀的 Unicode 表格。cf 採取相反預設：輸出以 JSON 為預設，方便代理過濾後再以人類要求的格式回報。對多數「代理人會呼叫、人類很少直接盯著看」的操作，官方認為這是正確預設。

2. cf cli search：自然語言找三千條路徑

面對三千條可能路徑，代理若把全部說明塞進上下文會爆 token。官方因此加入 cf cli search：代理以自然語言描述意圖，小型搜尋索引依 API 說明與參數回傳合適指令列表；首次執行 --help 時會自動提示代理使用此指令。

3. cloudflare.config.ts：可程式化的 TypeScript 設定

新設定格式以 TypeScript 為基礎（cloudflare.config.ts），方便人類與代理解析，並允許以程式產生環境差異。官方指內部部分 Wrangler 設定檔可從逾五千行、每個開發者複製大量 env 區塊，壓縮約百分之四十，改為以共用基底工廠化產生各環境。文中亦展示 bindings／triggers 等輔助函式，讓編輯器自動完成與代理更容易發現 KV、Queue、排程、郵件等綁定。

4. Vite 預設建置，與 Wrangler 過渡委派

官方回顧：Wrangler 早期以 esbuild 與自建 :8787 開發伺服器為核心；如今推薦以 Cloudflare Vite Plugin 建置與開發（含 HMR、Rolldown tree-shaking）。cf 預設建基於 Vite；多數 Workers 可由代理協助遷移。若專案仍依賴 Wrangler 的 esbuild、或 Rust／Python Workers，cf 會在開發與部署路徑上繼續委派給 Wrangler。

5. 遷移與維護時程

  • cf migrate：已用 Vite 建置的 Workers 可轉為 cloudflare.config.ts；仍靠 Wrangler esbuild 者則繼續委派。
  • cf init／cf deploy：新專案可自動安裝 Cloudflare Vite Plugin 並建立設定；靜態站甚至可不需設定檔，在專案目錄執行 cf deploy。
  • Wrangler 退場節奏：開放測試結束後，Cloudflare 將發布 Wrangler 最終主要版本，引導用戶與代理改用 cf；測試結束後仍提供十八個月維護支援，以便遷移。

四、日常應用場景

1. 開發者與技術團隊

團隊若已用代理（Cursor、Copilot 類工具或自建 agent）操作 Cloudflare，可把「單一工具覆蓋全 API」作為優先評估點：減少為每個產品記不同 CLI／Dashboard 路徑。遷移時宜先盤點是否已 Vite 化、是否有 Rust／Python Workers、以及 CI 是否硬編碼 wrangler 指令。

2. 企業與隱私敏感行業

企業把 Access、WAF、網域與觀測也交給代理自動化時，權限邊界更重要：應以最小權限 API Token、審計日誌與變更審批約束代理可呼叫的表面。cf 擴大可自動化範圍，同時也放大「憑證洩漏＝全產品面風險」的攻擊面，需同步強化密鑰與 CI 隔離。

3. 一般用戶

一般網站訪客不會直接「用到」cf；較可感知的是：代理協助團隊更快完成部署、防護與觀測配置後，站點可用性與安全設定迭代可能加快。

4. 香港與亞洲市場視角

香港與亞洲大量中小團隊以 Cloudflare Workers／Pages 做邊緣 API 與前端託管；代理編程普及後，CLI 是否「代理友善」會直接影響交付速度。本地外包與產品團隊若要在客戶帳戶上批量建 Worker、綁定與零信任規則，統一的 cf 表面可降低腳本碎片化。同時，Birthday Week 同日仍有 Vinext、VoidZero、Kitesurf 等相關公告，選型時應分開評估「執行時建置鏈」與「營運／API CLI」，避免把不同產品混為同一升級。

五、專業評價與潛在考量

優勢

  • 官方一手、可核對：產品頁面、安裝指令、代理用量百分比、三千操作、JSON 預設、cf cli search、TypeScript 設定、Vite 預設與十八個月 Wrangler 維護，均見於 Cloudflare 官方網誌。
  • 與 Forge 敘事銜接清楚：Forge 解決「如何生成」；cf 解決「代理人實際拿什麼工具操作全 API」——屬同一基建路線的產品落地，而非重複標題。
  • 過渡路徑務實：遷移指令、Vite／esbuild 委派與十八個月維護，降低「即日斷崖」風險。

需要留意的地方

  • 仍屬 open beta：指令穩定度、文件完整度與代理幻覺（選錯相近 API）需實測；生產變更應保留人工審批。
  • 訓練資料滯後：新 CLI 名稱對模型是新知識，短期仍可能出現代理「堅持用 wrangler」；需靠專案內 AGENTS.md／規則檔矯正。
  • 與同日其他 Birthday Week 產品區隔：本站已報道 Forge 開源管線；Vinext（Next.js on Vite）等屬建置／框架方向，不宜與 cf 混寫成同一則「又一個 CLI」。
  • 資安責任上移：API 表面越大，Token 範圍與代理工具允許清單越要收緊。

結語

Cloudflare 以代理用量逼近半數為背景推出 cf，把 CLI 從「人類在終端看表格」轉向「代理人預設吃 JSON、可搜尋三千 API」。對正在用代理交付邊緣應用的團隊而言，重點不是再學一套花俏指令，而是把建置（Vite）、設定（TypeScript）與營運 API 收斂到可審計的自動化路徑，並在 Wrangler 十八個月維護窗內完成遷移。

若香港團隊需要遠端工程師協助把現有 Wrangler／Workers 專案遷移到 Vite 與代理友善的 CI（含權限、審批與部署腳本），可參考 YSK Limited 的遠端開發者外判（一年約、全遠端，月費 HK$2,000 起，含 1 部美國 VPS）：https://ysk.hk/services/outsourcing

參考來源

  1. Cloudflare 官方網誌（主來源）：Introducing cf: the agentic CLI for the entire Cloudflare API — https://blog.cloudflare.com/cloudflare-cf-cli-launch/ （2026-09-28，HTTP 200）
  2. 相關背景（本站已另文）：Cloudflare Forge 開源生成管線 — https://blog.cloudflare.com/forge-open-source-generation-pipeline/
  3. 發現來源：Cloudflare Blog RSS — https://blog.cloudflare.com/rss/

Related services & products

Related posts