介绍 cf:面向整个 Cloudflare API 的智能体 CLI
内容提要
Cloudflare 推出面向 AI 代理的 CLI 工具 cf,基于 OpenAPI 自动生成,覆盖超 3000 项 API 操作,远超 Wrangler 的 280 项。cf 默认输出 JSON,支持自然语言搜索命令,采用 TypeScript 配置格式 cloudflare.config.ts,并以 Vite 为默认构建工具。代理可借此完成部署、监控、安全防护等全流程操作。现有 Worker 可用 cf migrate 迁移,Wrangler 将在测试期结束后继续维护 18 个月。
延伸解读
从 Wrangler 到 cf:迁移路径与时间窗口
文章明确,现有 Worker 可通过 cf migrate 迁移,已使用 Vite 构建的项目会自动转换为 cloudflare.config.ts;依赖 esbuild 的 JavaScript Worker 以及 Rust、Python Worker 仍由 cf 委托 Wrangler 处理。Wrangler 将在测试期结束后继续维护 18 个月,这为团队提供了明确的过渡窗口,但并非无限期支持,需提前规划迁移节奏。
JSON 默认输出对代理工作流的影响
cf 将 JSON 设为默认输出格式,并针对人类和代理分别提供美化与压缩版本。这与 Wrangler 需要手动追加 --json 且部分命令仅返回表格不同,能减少代理解析输出时的 token 消耗和出错概率。对于以代理为主要使用者的场景,这一设计更贴合实际,但习惯阅读表格的人类用户可能需要适应。
TypeScript 配置与 Vite 默认带来的开发体验变化
cloudflare.config.ts 采用 TypeScript 配置,支持类型检查和 LSP 辅助,代理在编辑配置时能获得更准确的建议。文章提到 Cloudflare 内部部分 Wrangler 配置文件从超过 5000 行压缩了 40%,通过工厂函数复用基础配置。同时 Vite 成为默认构建工具,带来 HMR 和 Rolldown 构建,但依赖 esbuild 的旧项目仍需 Wrangler 委托构建。
Q&A
cf 是什么?它和 Wrangler 有什么区别?
cf 是 Cloudflare 推出的面向 AI 代理的 CLI 工具,基于 OpenAPI 自动生成,覆盖超过 3000 项 API 操作,而 Wrangler 仅提供约 280 项操作。cf 默认输出 JSON,支持自然语言搜索命令,使用 TypeScript 配置格式 cloudflare.config.ts,并以 Vite 为默认构建工具。
如何安装 cf?
可以通过 npm 全局安装:npm i -g cf。
cf 如何帮助 AI 代理找到需要的命令?
cf 提供了 cf cli search 命令,允许代理用自然语言描述需求,然后基于 API 描述和参数的小型搜索索引会返回合适的命令列表。代理首次运行 --help 时会自动获知此命令。
cf 的配置文件格式是什么?有什么优势?
cf 使用 TypeScript 配置文件 cloudflare.config.ts。优势包括:类型检查帮助代理准确编辑配置,支持程序化定义环境,减少重复代码,并且所有代理(如 Claude Code、Codex)都能通过 LSP 获得更好的上下文建议。
如何从 Wrangler 迁移到 cf?
运行 cf migrate 即可迁移 Worker。已使用 Vite 构建的 Worker 会自动转换为 cloudflare.config.ts;依赖 Wrangler 进行 esbuild 构建的 Worker,cf 会继续委托 Wrangler 处理构建。
Wrangler 还会继续维护吗?
是的,在 cf 开放测试期结束后,Cloudflare 会发布 Wrangler 的最终主要版本,并继续提供 18 个月的维护支持,以便用户有时间迁移。