Cloudflare cf CLI 解析：為 AI Agent 重新設計的命令列工具

Cloudflare cf CLI 是 Cloudflare 官方推出、專為 AI Agent 設計的命令列工具。它以 OpenAPI schema 自動生成指令，涵蓋超過 3,000 個 API 操作（Wrangler 僅約 280 個），預設輸出 JSON，並以 TypeScript 設定檔取代冗長的 Wrangler 設定。結論先說：它是 Cloudflare 對「Agent 已成為主要使用者」的正式回應，值得在新專案試用，但既有專案不需要急著遷移。

資料來源：Cloudflare 官方部落格〈cf CLI launch〉（blog.cloudflare.com/cloudflare-cf-cli-launch）。以下「官方說法」為公告內容，「YOTRON 分析」為我們的判斷。

為什麼 Cloudflare 要重做 CLI？

官方指出 Wrangler 遇到三個結構性問題：

• 覆蓋不足：Wrangler 只支援約 280 個操作，Cloudflare 平台有超過 3,000 個。
• 設計不一致：各產品團隊各自設計指令，例如 d1 info 與 hyperdrive get 做的是同類事情，命名卻不同；也不是每個指令都支援 JSON 輸出。
• 使用者變了：官方數據顯示，Agent 占 Wrangler 使用量的比例，從 2026 年 3 月的 25% 升到最近一週的 48%，而且 Agent 每天使用 6 個以上指令的機率是人類的 4 倍。

YOTRON 分析：當近一半使用者是 Agent，CLI 的介面設計就要以「機器讀得懂、猜得對」為優先，而不是以人類終端機閱讀體驗為優先。這也是我們在客戶專案中看到的趨勢：Agent 出錯多半不是能力不足，而是工具介面不一致。

cf CLI 的四個核心設計

1. 由 OpenAPI schema 自動生成指令

cf 直接從驅動 API 文件與 SDK 的 OpenAPI schema 生成指令，背後是 Cloudflare 開源的 Forge SDK 生成器。Schema 加上註解後，指令結構自動一致，也就不必再靠人工逐一開發，才能擴張到 3,000 多個操作。

2. 預設 JSON 輸出

輸出預設為 JSON，Agent 可以用 jq 直接篩選結果。相較於解析帶 Unicode 框線的表格，這能明顯節省 token 並降低解析錯誤。需要人類互動的複雜操作（例如購買網域）則提供表單介面。

3. Agent 的指令探索機制

第一次執行 --help 時，cf 會提示可以使用 cf cli search，以自然語言搜尋指令；搜尋建立在 API 描述與參數的小型索引上。另外內建 AGENTS.md，可直接注入 Agent 的上下文。

4. TypeScript 設定檔與 Vite

設定改用 cloudflare.config.ts，以型別化的 bindings 宣告資源，搭配 LSP 外掛（如 Claude Code、Codex）可以改善 Agent 的準確度。官方說設定檔可比 Wrangler 縮減約 40%。開發伺服器預設改用 Vite，取代 esbuild，帶來 HMR 與 Rolldown 的 tree-shaking。

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

export default defineConfig(({ mode }) => ({
  worker: {
    name: "example-worker",
    env: {
      API_URL: bindings.text(
        mode === "production" ? "https://example.com" : "..."
      ),
      CACHE: bindings.kv({ id: "..." }),
      DATABASE: bindings.d1({ name: `db-${mode}` }),
    },
  },
}));

常用指令速覽

npm i -g cf        # 全域安裝
cf init            # 初始化新專案
cf migrate         # 從 Wrangler 遷移
cf cli search      # 以自然語言搜尋指令
cf deploy          # 部署（靜態網站可免設定檔）

與 Wrangler 的關係與遷移路徑

• Vite 相容的 Worker：cf migrate 會自動轉為 cloudflare.config.ts。
• 依賴 esbuild 的專案，以及 Python、Rust Worker：cf 繼續委派給 Wrangler。
• Wrangler 提供 18 個月維護期，之後新版 Wrangler 會引導使用者升級到 cf。
• 目前設定檔只涵蓋 Worker；DNS、政策、區域等全產品設定列在後續計畫。

企業導入前的評估清單

YOTRON 分析：以下是我們建議在採用前逐項確認的事項，官方公告並未涵蓋這些細節。

1. 產品覆蓋：你實際使用的產品（Pages、D1、R2、KV、Queues 等）是否都有對應指令，先在測試帳號驗證。
2. 權限邊界：cf 擴大的是「能呼叫多少 API」，不是「Token 有多少權限」。Agent 使用的 API Token 仍應依最小權限原則建立，並分開 CI 與本機用途。
3. 不可逆操作：網域購買、資源刪除這類動作，應保留人工確認，不要因為指令好找就讓 Agent 直接執行。
4. CI/CD 相容：確認現有 GitHub Actions 或部署流程是否依賴 wrangler-action，遷移前先在分支驗證。
5. 維護狀況：這是新發布的工具，導入前請自行確認 GitHub 專案的活躍度與 issue 處理情形。

結語：CLI 也要為 Agent 設計

cf CLI 的價值不只是多了 2,700 多個指令，而是示範了一種做法：用單一 schema 生成一致的介面，預設輸出機器可讀格式，並提供讓 Agent 自己找指令的入口。 這套原則同樣適用於企業內部工具：如果你的內部系統要讓 AI Agent 操作，先檢查指令命名是否一致、輸出是否為結構化格式、權限是否可以細分。

如果你正在評估如何讓 Agent 安全地操作雲端與內部系統，歡迎與優創智能討論導入流程。

相關推薦與延伸閱讀

• ego-lite 教學：ego browser 安裝與 Agent 瀏覽器自動化實戰，零搶焦點免重登入：ego-lite（ego browser）完整教學！解析專為 AI Agent 設計的 Chromium 瀏覽器，一鍵匯入 Chrome 登入態。本文提供 ma
• Agent SDK 是什麼？OpenAI Agents SDK 核心架構與企業自動化指南：Agent SDK 是什麼？完整拆解 OpenAI Agents SDK 的四大核心組件（Agents、Handoffs、Guardrails、Sessions
• Claude Agent SDK 每月 $100 額度教學：Anthropic Max 5x 政策解析與台灣企業導入指南：Anthropic Max 5x 使用者每月可領 $100 Claude Agent SDK 額度，不佔訂閱限制。了解政策細節與台灣企業的導入方式。本文說明這次
• Devin 自建 Mac 雲端支援 iOS 開發：AI 代理進入原生生態的關鍵條件：Cognition 為 Devin Cloud 加入原生 macOS 虛擬化與 Xcode 模擬器支援。本文從底層虛擬化、TCC 權限治理、預熱機制到閉環驗證，