跳到正文
cloudflare blog(blog.cloudflare.com)· Matt “TK” Taylor·· 2026-09-28精選品質評分81

Cloudflare 釋出面向AI 助理的新命令列工具 cf

Introducing cf: the agentic CLI for the entire Cloudflare API

重點導讀

Cloudflare 推出了全新的命令列工具 cf,旨在讓AI 助理能夠訪問整個 Cloudflare 平臺中超過 3,000 種操作。

該工具預設輸出 JSON 格式以節省上下文,內建自然語言搜尋功能,並採用基於 TypeScript 的全新配置格式和 Vite 開發服務。

AI 伴隨問答

自備 Key 深度分析

針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:

推薦理由

該產品直接將整個平臺的 API 能力適配給AI 助理,讀者可以通過專屬配置和命令簡化相關工作流。

正文 · 中文翻譯

在過去的一年裡,AI 代理(agent)對 Wrangler 的使用量呈指數級增長。

2026 年 3 月,代理佔 Wrangler 使用量的四分之一,而前一年這一比例僅為個位數。上週,代理的使用率達到了 48%。

代理是更高產的使用者,每天使用的不同命令數量接近人類的兩倍,使用 6 個或更多命令的機率接近人類的四倍。

代理非常喜歡 CLI。但 Wrangler 僅提供約 280 個操作的命令,而 Cloudflare 提供了數千個。

今年早些時候,我們預告了 我們計劃如何解決這個問題,而今天,我們通過推出一個新的 CLI:cf,讓代理能夠使用所有的 Cloudflare 產品。

cf 是一個為下一代軟體開發構建的 CLI:

  • 藉助定製搜尋和引導,代理可以找到完成其想做的任何事情所需的命令。
  • JSON 是預設介面,為人類進行了美化列印(pretty printed),為代理進行了壓縮,以最大程度地節省上下文。
  • cloudflare.config.ts 是整個 Cloudflare 的新配置格式,從 Workers 開始,將 TypeScript 的安全性和準確性帶給您和您的代理的語言伺服器協議(LSP)。
  • Vite 成為預設選擇,帶來了最佳的本地開發伺服器,以及面向開發者和框架作者的外掛套件。

今天在全球範圍內安裝公開測試版,並從任何地方執行它:

複製提示詞

Please update your global agent instructions, so you use Cloudflare's new `cf` CLI.

Add the Markdown below to the user-level instructions file that you load in every project – not this repository's AGENTS.md or CLAUDE.md. Use the file for the agent you are: Claude Code `~/.claude/CLAUDE.md`, Codex `~/.codex/AGENTS.md`, OpenCode `~/.config/opencode/AGENTS.md`, Pi `~/.pi/agent/AGENTS.md`. For any other agent, use its equivalent global rules file; if your global rules can only be set in a settings screen, tell me what to paste there instead. Create the file if it doesn't exist. Keep everything already in it, but replace any existing instruction about Wrangler or the Cloudflare CLI instead of adding a conflicting one. If the same guidance is already there, leave the file as it is. When you're done, tell me the path of the file you changed.

```markdown
## Cloudflare CLI - cf - v20260928

`cf` is Cloudflare's current CLI and covers the whole Cloudflare platform. Prefer it over Wrangler: create projects with `cf init`, develop with `cf dev`, deploy with `cf deploy`, and manage account resources with `cf <product> …` (for example `cf d1 list`).

Wrangler is only for projects that already use it – a `wrangler.jsonc`, `wrangler.json` or `wrangler.toml` file – or when the user asks for it. Keep using Wrangler in those projects unless asked to migrate, and use `cf migrate` in this case.

`cf` commands differ from Wrangler's; check `cf --help` or `cf cli search <what you want to do>` instead of guessing. If a `cf` command fails in a project that doesn't use Wrangler, don't fall back to Wrangler (including `npx wrangler`) without offering to report it.

cf 讓您的代理能夠訪問整個 Cloudflare API

如果您的代理能夠做 Cloudflare 能做的所有事情會怎樣?這就是今年早些時候激發我們興趣的問題:代理變得越來越強大,但它們能夠通過 Cloudflare 的 CLI 做的事情仍然有限。

Wrangler 是由每個產品團隊共同構建的,他們對命令開發體驗採取了各自的方法。在團隊之間強制推行統一模式幾乎是不可能的,甚至在我們大約 280 個命令路徑中也是如此。我們在 d1 info、hyperdrive get、workflows describe 中擁有不一致的術語,因為每個團隊在不同時間都提出了自己的實踐。一些團隊編寫了數千行程式碼來構建完全自定義的體驗,結果卻極少被使用,而且各個團隊還提出了不同的方法來解決相同的問題。

我們希望同時標準化工具有限的現狀並實現巨大擴充套件。Forge(Cloudflare 全新的統一 API 生成管道)使我們能夠做到這一點,它建立在直接從驅動 API 文件和 SDK 生成的 API 架構生成 CLI 命令的理念之上。我們提供的所有內容都有一個 OpenAPI 架構,如果我們為其新增一點額外的資訊,就可以將其用作 Forge 生成 CLI 的源。

這使我們能夠將 cf 從 Wrangler 隨時間積累的大約 280 個函式擴充套件到涵蓋擁有 3,000 多個操作的整個 Cloudflare API 表面。

現在,只需一個工具,就可以簡單地將 cf 交給您的代理,並要求它去設定一個 worker、部署它、監控和觀察它、用 Cloudflare Access 保護它、購買一個域名,並用 Cloudflare WAF 為其提供前端防護。

為從未用過 cf 的代理構建

cf 是為軟體工程的發展軌跡而構建的,在這裡,代理式開發正在徹底改變軟體的構建和部署方式。今年我們專注於提供支援這一轉變的工具,最終形成了 cf。cf 從零開始就以代理為中心構建,並包含我們認為在不久的將來會成為更多 CLI 標準的新型代理命令發現工具。

Wrangler 的優勢在於多年的文件、部落格和第三方指南已被吸收到 LLM 的訓練過程中。它也帶來了同樣的缺點:改變 Wrangler 的工作方式現在違背了已學到的行為,而鑑於我們想要實現的改進規模,重大變更將不可避免。

推出一個代理從未見過的新 CLI 看起來像一次大規模顛覆性的變化——但實際上這是我們能做的最乾淨的事情。由於我們做出的設計決策、可以注入的上下文以及可以追加的 AGENTS.md 檔案,這種切換方式實際上比讓代理對其熟悉的工具的兩個版本之間的主要差異進行上下文化更不易混淆。我們將以幾項面向代理的功能預裝啟動,後續還會有更多功能。

代理需要過濾 JSON,而不是查看錶格

當代理使用 Wrangler 時,它們會在每個執行的命令後追加 --json,並且經常使用 jq 過濾輸出以提取一部分欄位。但 Wrangler 中只有部分命令支援 --json;許多命令返回的是為終端中人類檢視而設計的 Unicode 表格。代理可以搞清楚這些,但這比使用 jq 過濾器花費更多時間和令牌。

在 cf 中,我們採取相反的立場:代理只需要 JSON,如果代理是該工具未來的主要使用者,它應該是預設設定。對於絕大多數很少被人類訪問的命令,這顯然是正確的選擇。

你作為此 CLI 的人類客戶,實際上已經與使用它隔了一步。代理能夠輕鬆過濾其結果,然後按你請求的任何格式返回過濾後的列表,比提供你幾乎不會直接閱讀的表格更可取。

但如果你想做一些可能需要真實個人輸入的事情,例如搜尋可購買的域名,該怎麼辦?

對於代理可以通過在長而笨拙的序列中鏈式呼叫命名引數來訪問的命令,你只需填寫一個表單。Cf 將 API 的需求拆解為一系列已驗證的輸入,因此即使是具有複雜需求的域名購買也很容易跟隨。

或者,如果你堅持,只需讓你的代理去做。

你的代理可以自己找到正確的命令

在 CLI 中有 3,000 條可能的路徑,代理如何在不膨脹上下文的情況下快速找到所需的正確操作?為此,我們還添加了 cf cli search。

此命令允許你的代理用自然語言詢問它需要做什麼,隨後一個小型搜尋索引將根據其 API 描述和引數提供一份合適命令列表。我們在代理第一次執行 --help 時會自動告知它此命令。

對你的代理進行型別檢查的配置

我們的新配置格式基於 TypeScript,易於人類和代理解析,並允許你以程式設計方式編寫配置。

型別化配置對代理非常有幫助。我們發現,即使沒有關於程式化配置格式的先前上下文,代理也能輕鬆識別並按需編輯配置,即使在像 env 這樣與 Wrangler 中同名功能已大幅變化的元素上也是如此。所有使用 LSP 外掛(如 Claude Code 和 Codex)的代理,都能更好地理解配置檔案格式的上下文,從而提供更準確的建議。

與 TOML(沒有可訪問的模式)或 JSONC(擁有連結模式但代理很少使用)相比。

Cloudflare 內部的一些 Wrangler 配置檔案已被壓縮 40%,從 5,000 行以上、每位開發者擁有眾多自定義環境,轉變為更高效構建每位開發者配置的工廠檔案。

這通過從同一通用基底以程式設計方式定義每個環境實現,而不是像 Wrangler 典型做法那樣複製 env 塊。一個具有多環境的簡單 Worker 只需切換 Vite 原生 mode 引數,即可在一組配置與另一組之間切換。

現在實現此功能的簡單配置如下:

您可以通過 cf migrate 將 Cloudflare Worker 遷移到此新格式。

我們還提供了一些輔助函式,讓構建 Worker 變得輕而易舉。

bindings 為您的代理提供了一個簡單的位置,發現開發者平臺提供的一切。環境變數、儲存、資料庫、佇列等所有內容,都可由編輯器自動完成並解釋。

同樣,我們為 triggers, 提供了一個輔助工具,它是定義 Worker 路由、佇列、計劃和電子郵件觸發器的新方式。與其在配置檔案中散佈這些內容,不如在單一塊中簡單查詢可能觸發 Worker 執行的操作。

defineConfig.worker 僅是起點。我們對 cloudflare.config.ts 的意圖是,這就是您整體管理 Cloudflare 的方式。您所需的每個產品——以及通過 cf 可供代理使用的 API——都能通過型別安全的配置來表達。很快,您將能夠通過此配置檔案配置整個策略、設定區域、配置 DNS 等。

一流的開發體驗

當 Wrangler 最初開始構建 JavaScript Workers 時,Vite 並不存在。相反,我們在 Wrangler 中使用 esbuild 來打包你的 Workers。Wrangler 在 :8787 上提供的開發伺服器是 Wrangler 團隊自己構建的,修改其中任何部分都意味著要深入 Cloudflare 專用本地工具 Miniflare 的內部。

Vite 在這方面有了巨大改進,並配備了豐富的外掛生態系統,提供一流的開發伺服器(支援 HMR 熱模組替換)以及使用 Rust 庫 Rolldown 進行樹搖的構建。您能用 Vite 做的任何事,都可以用 Cloudflare Vite 外掛完成。

Cloudflare Vite 外掛是我們建議您構建 Workers 的推薦方式,無論您在構建什麼:前端聚焦專案還是後端 API。結合我們的 Vitest 外掛,它提供了與 Workers 執行時匹配的統一開發和測試環境,並讓您直接訪問繫結和平臺 API。

cf 預設基於 Vite 構建。你的大部分 Workers 可以通過 agent 輕鬆遷移。其他的可能需要更多時間,這就是為什麼 cf 將繼續把開發和部署委託給 Wrangler,以便需要繼續使用 esbuild、Rust 和 Python Workers 的 JavaScript Workers 使用。

從 Wrangler 遷移

從 Wrangler 遷移 Worker 只需執行

已經使用 Vite 構建的 Worker 將為你轉換為 cloudflare.config.ts 。如果你的 Worker 依賴 Wrangler 進行 esbuild,那麼 cf 將繼續把構建委託給 Wrangler。

當公開測試版結束時,我們將釋出 Wrangler 的最後一個主要版本,指導你和你的 agent 使用 cf。在測試版結束後,我們將繼續為 Wrangler 提供 18 個月的維護支援,以便你有時間進行遷移。

你還可以通過執行 cf init/deploy 來獲取新專案並自動為 Cloudflare 進行配置,這會為你安裝 Cloudflare Vite 外掛並建立一個配置檔案。

靜態網站仍然不需要配置檔案即可啟動,部署它們只需在你的專案中執行 cf deploy 。

要使用 cf 啟動一個新的 Hello World 專案,請使用 cf init。

cf 是開源的,問題可以 向我們的 GitHub 倉庫報告.

來源: cloudflare blog (blog.cloudflare.com)
開啟原文

讀者討論

理性交流 · 即時討論