---
title: "Cloudflare cf CLI 解析：為 AI Agent 重新設計的命令列工具"
description: "Cloudflare 推出專為 AI Agent 設計的 cf CLI，以 OpenAPI schema 自動生成指令，覆蓋超過 3,000 個 API 操作（Wrangler 約 280 個），預設輸出 JSON。本文整理四個核心設計、與 Wrangler 的分工及導入評估清單。"
canonical: "https://yotron-ai.com/blog/cloudflare-cf-cli-ai-agent-guide"
published: "2026-09-30"
last-updated: "2026-09-30"
---

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

Cloudflare 推出專為 AI Agent 設計的 cf CLI，以 OpenAPI schema 自動生成指令，覆蓋超過 3,000 個 API 操作（Wrangler 約 280 個），預設輸出 JSON。本文整理四個核心設計、與 Wrangler 的分工及導入評估清單。

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](https://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。

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

## 常用指令速覽

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