Cloudflare 把自家 3,000 條 API 全部變成 CLI 命令,而且承認一件事:這個工具的主要使用者已經不是人類,是 agent。Wrangler 進入倒數計時,本文整理發布數據、社區反應,以及我自己實測半天的轉移判定。
為什麼 Wrangler 不夠用了
官方發布文(2026-09-28)給了三個關鍵數字:
| 指標 | 數據 |
|---|---|
| Agent 佔 Wrangler 使用量(2026-03) | 25% |
| Agent 佔比(發布前一週) | 48% |
| Wrangler 命令數 | 約 280 條 |
| Cloudflare API 總操作數 | 3,000+ 條 |
一年前 agent 用量還是個位數百分比,現在將近一半。Agent 的行為模式也跟人類不同:每天使用的不同命令數約是人類的兩倍,用上六條以上命令的機率是人類的四倍。Wrangler 那些為人類終端體驗設計的 Unicode 表格輸出、各產品團隊各自為政的命令命名(d1 info、hyperdrive get、workflows describe 三種說法講同一件事),對 agent 全是浪費 token 的負擔。

cf 怎麼解決:三個 agent 優先設計
1. 命令不再是手寫的,是從 API schema 生成的
cf 底層是 Forge,Cloudflare 開源的生成管線。API 文件、SDK、CLI 命令現在全部從同一份 OpenAPI schema 生成,一次生成三個產物。命令覆蓋率從 Wrangler 的 280 條直接跳到 3,000+ 條,而且術語強制一致。

2. JSON 是預設,表格是附屬
Wrangler 時代 agent 要對每條命令手動加 --json,還常常再用 jq 過濾。cf 反過來:JSON 就是預設輸出,人類要看的時候才排版。官方的說法很直白:你是這個 CLI 的人類客戶,但你實際上已經隔著一層 agent 在用它,給你一張你不會直接讀的表格沒有意義。
3. cf cli search:自然語言找命令
3,000 條命令沒有人記得住,agent 也不用記。cf cli search "create a DNS record" 用自然語言描述任務,本地搜尋索引回傳匹配的命令與參數說明。agent 第一次跑 --help 時,cf 會自動告訴它這條搜尋命令的存在。這個設計我認為會被其他 CLI 供應商抄走,一年內會變成標配。
配套還有 cloudflare.config.ts:整個 Cloudflare 的設定改用 TypeScript 定義,走 LSP 型別檢查,bindings(KV、D1、R2、Queue、AI)全部有自動補全。TOML 時代 agent 改設定靠猜,現在靠型別提示。dev server 也從 esbuild 換成 Vite(HMR、Rolldown tree-shaking、Vitest 插件一條龍)。
Wrangler 退役時間線
這是所有現有用戶最該記的一段:
| 階段 | 內容 |
|---|---|
| 現在 | cf open beta、Wrangler 照常維護 |
| Beta 結束時 | Wrangler 出最後一個 major 版本,內容是引導你轉 cf |
| 之後 18 個月 | Wrangler 維護支援期,給你時間遷移 |
遷移本身是 cf migrate 一條命令:已經用 Vite 的 Worker 直接轉成 cloudflare.config.ts;依賴 esbuild 的舊 Worker,cf 會繼續委派 Wrangler 處理建置,不強迫一次到位。

社區反應:正面,但盯著一個缺口
這條新聞在 Hacker News 拿了 171 分、87 則留言(討論串)。代表性意見四種:
| 陣營 | 說法 |
|---|---|
| 押注派 | 「現有雲端的形狀是為人類設計的,Cloudflare 押對了 agent 這個未來」 |
| 實用派 | cf cli search 被點名最有價值,搭配 agent 工作流順手 |
| 觀望派 | 基於 Forge 的管線,希望 Terraform 原生支援也在路上 |
| 棄舊派 | 「說不上來為什麼一直不喜歡 Wrangler,樂見它被取代」 |
第三方教學已經跟上:openreplay 的實戰指南、Flavio Copes 的入門文、日文圈甚至出現了 18 個月遷移決策分析。生態熱度不是公關稿,是真實的採用信號。
我的一線實測:三個專案三種判定
最近我把 cf(v0.15.0)裝起來實測了半天,包括把它接進現有的 Cloudflare 工作流。實測撞到的第一件事恰好說明轉移期的真實摩擦:wrangler 4.x 已經把 pages tail 改名成 pages deployment tail,而且 deployment ID 和 --project-name 兩個參數缺一不可,命令參數在不同小版本之間持續漂移。這種漂移正是 cf 用 schema 生成命令要根治的問題。
實測之後我的轉移判定分成三層:
| 專案類型 | 判定 | 原因 |
|---|---|---|
| Cloudflare Pages 純靜態站(push 即部署) | 不用轉 | 部署鏈在 git push 上,本地 CLI 本來就沒參與 |
| Workers 專案(有 wrangler.jsonc) | 先別動 | 官方鐵律:Wrangler 專案勿跑 cf 的 dev/build/deploy,等 beta 收斂或跑 cf migrate --dry-run 先看 diff |
| 資源操作(DNS、zones、D1、KV、R2) | 可以開始用 cf | 3,000+ 條 schema 生成命令、--dry-run 預覽、不碰專案設定 |
還有一個隱藏好處值得單獨講:cf 的 --dry-run 只印出請求 JSON 不真的送出,而且不需要憑證。對 agent 工作流來說這是安全欄杆,對人類來說是免費的 API 文件查詢器。
給猶豫的人一個決策順序
- 新專案:直接
cf init,官方已經建議新專案用 cf,不用等 - 現有 Workers:把
cf migrate排進季度工作,先--dry-run看產出的cloudflare.config.ts長什麼樣,18 個月緩衝期完全夠 - 純靜態站:什麼都不用做,繼續 push
- CI/CD:cf 支援
CLOUDFLARE_API_TOKEN環境變數無人值守模式,但 beta 期建議 CI 先不動,等 stable
Wrangler 沒有做錯什麼,它只是為一個「人類是主要使用者」的時代設計的。當 48% 的流量來自 agent,CLI 的介面契約就得跟著換。cf 是我第一次看到一家雲端供應商明確承認這件事,並且把整個工具鏈推倒重來而不是打補丁。值得追。
延伸閱讀
- 上一波 Cloudflare Pages 部署實務(與本文的轉移判定互相補充):Cloudflare Pages 現代部署最佳實踐
- 官方發布文:Introducing cf: the agentic CLI for the entire Cloudflare API
- Wrangler 遷移指南:Migrate a Wrangler project

Calpa 擅長使用 TypeScript、React.js 和 Vue.js 建立 Responsive Website。
他積極參與開源社群,曾在 2019 年的香港開源大會上擔任講者,提供工作經驗和見解。此外,他也在GitHub 上公開分享個人部落格程式碼,GitHub 專案已累積超過 300 個 stars 與 60 個 forks。
他熱愛學習新技術,並樂意分享經驗。他相信,唯有不斷學習才能跟上快速演變的技術環境。
如果你有 AI 專案、網站開發或技術整合需求,或正在為團隊尋找工程師,歡迎來信交流:partner@calpa.me
歡迎訂閱 Calpa 的頻道,一同將想像力化為可能:



















