InfoQ 中文 · 2026/10/19 11:43:34
Cloudflare 推出 AI 代理专用 CLI cf，将逐步停用 Wrangler
Cloudflare 发布开源命令行工具 cf，专为 AI 代理设计，支持结构化 JSON 输出与命令发现，旨在解决旧工具 Wrangler 命名混乱及非机器友好问题。该工具采用 TypeScript 编写并集成 Vite，计划通过 18 个月过渡期逐步弃用 Wrangler，以统一云平台交互范式。
报道全文原始报道全文
Cloudflare 推出以智能代理为中心的开源 CLI 工具 cf，采用 TypeScript 编写，支持结构化输出与命令发现，专为 AI 代理与开发者协同调用 Cloudflare 服务设计。其诞生旨在规避 Wrangler 架构约束，实现统一 CLI 设计范式。
Wrangler 各团队命令风格不一，280+ 命令路径缺乏统一命名与结构；cf 从零构建，解除历史兼容负担；结构化输出与命令发现能力直接提升 AI 代理解析与调用效率。
适合云平台工程师、CLI 工具开发者、AI 系统集成工程师阅读。
最近，Cloudflare 推出了 cf 的公开测试版。这是一个全新的、以智能代理为中心的开源命令行界面，让 AI 代理可以通过统一的 CLI 与 Cloudflare 服务进行交互。该工具采用 TypeScript 编写，提供结构化输出和命令发现功能，使开发人员和 AI 代理都能更轻松地使用 Cloudflare 的 API。
这家超大规模云服务提供商认为，引入新的 CLI 可以避免与 LLM 在 Wrangler 方面已习得的行为产生冲突，从而使 cf 能够采用以智能代理为中心的设计变更，而不必受既有工具的兼容性限制。Cloudflare 高级产品经理 Matt Taylor 和高级系统工程师 Samuel Macleod 解释了为何需要一个新的 CLI：
Wrangler 是通过手工构建的，每个产品团队都贡献了自己的力量，并根据各自的命令行开发体验采用了不同的方法。在各团队之间强制推行统一的模式几乎是不可能的，即使是在我们的大约 280 条命令路径中也是如此。由于各团队在不同时期形成了各自的实践，d1 info、hyperdrive get 和 workflows describe 等术语在各团队之间并不统一。
cf CLI 遵循 Apache 2.0 许可或 MIT 许可发布，专为智能代理驱动的开发而设计，具备命令发现功能，其 JSON 输出既适合人类阅读也适合代理处理，并且还采用了基于 TypeScript 的新型 cloudflare.config.ts 配置格式。它还将 Vite 设为默认开发环境，从而可以提供一致的本地开发体验和插件支持。
以 Cloudflare 的 OpenAPI schema 为源，cf 可以覆盖 3000 多个 API 操作，而 Wrangler 内置的功能仅约 280 个。Taylor 和 Macleod 补充道：
我们希望既能统一现有的系统，又能进行大规模扩展，并且要两者同时实现。Forge——Cloudflare 全新的统一 API 生成管道——使我们能够实现这一目标。它基于这样一个理念：直接从支撑 API 文档和 SDK 生成的 API 模式中生成 CLI 命令。
在 Hacker News 上的一则热门帖子中，社区的讨论主要集中在选择使用 TypeScript 编写 CLI 这一决策上，围绕启动时间、可移植性和依赖项管理展开了讨论。用户 slowin 评论道：
我不明白为什么用 TypeScript 编写这个。这很好地说明了智能代理可以编写代码（我敢肯定他们写了 cf），但具备基础的计算机科学知识仍然至关重要。不要强迫用户管理 CLI 的依赖项。请使用编译型语言编写 CLI。
Cloudflare 则认为，TypeScript 提供类型安全性和 LSP 支持，不管是人类还是智能代理配置起来都更加容易，有利于代理更准确地理解和修改配置。作者将此与 TOML 和 JSONC 进行了对比——在后两者中，代理更难获取模式信息——并指出程序化配置还可以消除配置冗余。Ashish Ganda 在 LinkedIn 上指出：
Cloudflare 的新 cf CLI 默认输出 JSON，而非表格。你必须主动要求它输出表格……表格是为人类设计的，而 JSON 则是为解析器准备的。
Cloudflare 将 JSON 设为默认输出格式，这使得智能代理能够过滤并转换输出内容，以提供人类用户所需的格式，同时避免了 Wrangler 中默认使用的表格输出。该公司计划在 cf 公开测试结束后弃用 Wrangler，并发布最后一个 Wrangler 大版本，借此引导用户转向 cf，并提供 18 个月的维护支持以方便用户迁移。