Cloudflare cf CLI 公测版：面向完整 API 的智能体命令行界面

cf CLI 为智能体提供对 Cloudflare 3,000 多项 API 操作的完全访问权限

Cloudflare 全新的 cf 命令行界面将覆盖范围从 Wrangler 的约 280 条命令扩展到了整个 Cloudflare API 体系，使智能体能够创建 Workers、部署代码、管理 DNS、购买域名以及配置安全性——所有操作均可通过单一工具完成。这一点至关重要，因为智能体现在拥有了一个一致的、以 JSON 为优先的界面，这不仅减少了 Token 的使用，还消除了对临时 --json 标志或表格解析的需求。

JSON 优先设计降低了 LLM 驱动自动化的 Token 成本

此前使用 Wrangler 的智能体必须在少数支持的命令后附加 --json，然后使用 jq 过滤输出。大多数 Wrangler 命令输出的是面向人类的表格，迫使智能体消耗额外的 Token 来解析无关的格式。cf 将 JSON 作为默认输出，既为人类提供了美观的打印格式，又为智能体提供了紧凑的数据结构，从而直接降低了 API 调用成本并加快了推理速度。

“智能体只需要 JSON，如果智能体是该工具未来的主要用户，那么 JSON 就应该成为默认格式。” – Cloudflare 博客

通过 cf cli search 实现以智能体为中心的命令发现

面对超过 3,000 条可能的路由，智能体需要一种无需占用过多上下文即可定位正确操作的方法。cf cli search 命令接受自然语言查询，并根据 API 描述和参数返回匹配命令的排名列表。首次运行 --help 时，系统会自动向智能体告知此功能。

基于 TypeScript 的 cloudflare.config.ts 实现类型检查配置

新的配置文件采用 TypeScript 编写，提供了一种支持 LSP 的智能体（如 Claude Code、Codex）可以理解并自动补全的模式。类型化的配置让智能体能够安全地编辑环境、绑定和触发器，与 Wrangler 的 TOML 或 JSONC 格式相比，减少了错误。

import { bindings, defineConfig } from "cf/config";
import * as entrypoint from "./index.js" with { type: "cf-worker" };

export default defineConfig(({ mode }) => ({
  worker: {
    name: "example-worker",
    entrypoint,
    compatibilityDate: "2026-09-27",
    env: {
      Environment: bindings.text(`This is ${mode} environment`),
    },
  },
}));

该配置还包括针对 KV、D1、R2、Queues、AI 等功能的辅助函数，所有这些均可由编辑器自动补全。

Vite 默认设置提供现代开发体验

与依赖 esbuild 和自定义开发服务器的 Wrangler 不同，cf 使用 Vite 作为默认的打包工具和开发服务器。Vite 带来了热模块替换 (HMR)、丰富的插件生态系统以及基于 Rust 的 Rolldown 树摇 (tree-shaking) 功能。Cloudflare Vite 插件和 Vitest 集成提供了一个与 Workers 运行时相呼应的连贯工作流。

从 Wrangler 无缝迁移

现有项目可以通过单条命令进行迁移：

cf migrate

已经使用 Vite 的 Workers 会自动转换为 cloudflare.config.ts。依赖 Wrangler 的 esbuild 的项目将继续委托给 Wrangler 构建，以确保向后兼容性。新项目可以通过 cf init 进行引导，或者通过 cf deploy 直接部署静态站点。

Hacker News 上的社区反应

  • 积极兴奋 – 用户指出“如今一些最好的产品发布都是 CLI”，并欢迎 Wrangler 的替代品。
  • 智能体优先的赞誉 – 评论者强调了 JSON 优先界面和 cf cli search 功能在减少 Token 使用方面的优势。
  • 批评与建议 – 一些用户质疑 TypeScript 的选择，建议为 CLI 使用编译型语言，并要求支持 OpenCLI 规范以提高可发现性。
  • 操作担忧 – 一些人指出 Token 生成仍然需要手动网页导航，还有一位用户报告了预发布版本在 CI 中的失败。

“如今一些最好的产品发布都是 CLI，这太疯狂了。” – @emadabdulrahim

“我不明白为什么要用 TypeScript 编写……不要强迫用户管理你们 CLI 的依赖项。” – @slowin

展望：智能体作为主要的 Cloudflare 操作者

Cloudflare 将 cf 定位为新兴智能体开发工作流的基础工具。通过标准化命令命名、提供可搜索索引以及交付类型检查配置，该 CLI 旨在成为 AI 智能体和人类开发者的默认界面。未来的路线图暗示包括原生的 Terraform 导出以及通过 cloudflare.config.ts 进行更广泛的策略配置。

如何开始

全局安装公测版：

npm i -g cf

运行 cf --help 查看搜索提示，然后探索诸如 cf workers deploy、cf dns create 或 cf cli search "buy a domain" 等命令。

cf CLI 是开源的；问题可以在 GitHub repository 上报告。

Sources

相关