Cloudflare 新命令行 cf:为 Agent 重做的一套工具
原文链接: https://blog.cloudflare.com/cloudflare-cf-cli-launch 来源: Cloudflare 发现于: 小互 · AI 解读站 · 2026/9/29 说明: 本文由 AIHot 自动聚合,并由 GLM 翻译为中文(保留全部代码与链接)

在过去一年中,代理对 Wrangler 的使用量急剧增长。
2026 年 3 月,代理已占 Wrangler 使用量的四分之一,而前一年还只是个位数百分比。上周,代理使用量达到了 48%。
代理是更高产的用户,每天使用的不同命令数量几乎是之前的两倍,并且使用六条及以上命令的可能性几乎是之前的四倍。
代理喜欢 CLI。但 Wrangler 仅提供约 280 个操作的命令,而 Cloudflare 提供了数千个。
今年早些时候,我们预告了计划如何解决这个问题,今天,我们通过引入一个新的 CLI:cf,让代理能够使用每一个 Cloudflare 产品。
cf 是一个为下一代软件开发而构建的 CLI:
- 代理可以通过定制搜索和引导,找到执行任何操作所需的命令。
- JSON 是默认接口,对人类友好地漂亮打印,对代理则压缩以最大化节省上下文。
cloudflare.config.ts是 Cloudflare 整体的新配置格式,从 Workers 开始,将 TypeScript 的安全性和准确性带给您和您的代理的语言服务器协议(LSP)。- Vite 成为默认,带来最佳的本地开发服务器,以及面向开发者和框架作者的插件套件。
立即安装今天的开放测试版,并从任何地方运行它:
<span class="line"><span class="sk-6f42c1-ffc799">npm</span><span class="sk-032f62-99ffe4"> i</span><span class="sk-005cc5-99ffe4"> -g</span><span class="sk-032f62-99ffe4"> cf</span></span>
cf 让您的代理能够访问整个 Cloudflare API
如果您的代理能做 Cloudflare 能做的所有事情,会怎样?这就是今年早些时候激发我们兴趣的问题:代理变得越来越强大,但它们能用 Cloudflare 的 CLI 做的事情仍然有限。
Wrangler 是手工构建的,每个产品团队都贡献并采用自己的方法来开发命令体验。跨团队强制执行模式几乎是不可能的,即使是在我们大约 280 条命令路径中也是如此。我们在 d1 info、hyperdrive get、workflows describe 中使用了不一致的术语,因为每个团队在不同时间提出了自己的实践。有些团队在数千行代码中构建了完全自定义的体验,结果却极少被使用,而不同团队提出了不同的方法来解决相同的问题。
我们希望既标准化现有内容,又同时进行大规模扩展。Forge —— Cloudflare 新的统一 API 生成管道 —— 使我们能够做到这一点,它基于直接从 API 模式生成 CLI 命令的理念,该模式为我们的 API 文档和 SDK 生成提供支持。我们提供的所有内容都有一个 OpenAPI 模式,如果我们再添加一点额外信息,就可以将其用作 Forge 生成 CLI 的源。
这使我们能够将 cf 从 Wrangler 随时间积累的约 280 个函数扩展到覆盖整个 Cloudflare API 表面,超过 3,000 个操作。
现在,只需将 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 过滤器花费更多的时间和 token。
在 cf 中,我们采取了相反的立场:代理只需要 JSON,如果代理是未来这个工具的主要用户,那么 JSON 应该是默认输出。对于绝大多数人类很少访问的命令,这显然是正确的选择。
作为这个 CLI 的人类客户,实际上你与使用它之间隔了一层。代理能够轻松过滤结果,然后以你要求的任何格式返回过滤后的列表,这比提供你可能永远不会直接阅读的表格更可取。
但如果你需要做一些可能需要真正个人输入的事情,比如搜索要购买的域名呢?
对于你的代理可以通过将命名参数链接成冗长且笨拙的序列来访问的命令,你只需填写一个表单即可。Cf 将 API 的需求分解为一系列经过验证的输入,因此购买域名(即使是具有复杂要求的域名)也很容易遵循。
或者,如果你坚持,就让你的代理去做。
你的代理可以自己找到正确的命令
通过 CLI 有 3000 条可能的路径,你的代理如何在不使上下文膨胀的情况下快速找到所需操作?为此,我们还添加了 cf cli search。
此命令允许你的代理用自然语言询问它需要做什么,一个小型搜索索引将根据 API 描述和参数提供一系列合适的命令。当你的代理第一次运行 --help 时,我们会自动告知它这个命令。
对你的代理进行类型检查的配置
我们的新配置格式基于 TypeScript,对人类和代理来说都很容易解析,并且允许你以编程方式编写配置。
类型化配置对代理非常有帮助。我们发现,即使没有编程配置格式的先前上下文,代理也能够轻松识别和按需编辑配置,甚至跨元素(如 env,它与 Wrangler 中同名功能相比发生了巨大变化)也是如此。所有使用 LSP 插件的代理(例如 Claude Code 和 Codex)都能够更好地理解配置文件的格式上下文,从而做出更准确的建议。
相比之下,TOML 没有可访问的模式,JSONC 有一个链接的模式,但代理很少使用。
Cloudflare 内部的一些 Wrangler 配置文件已从超过 5,000 行压缩了 40%,每个开发者原本拥有多个自定义环境,现在转变为工厂文件,能够更高效地构建每个开发者的配置。
这是通过从同一个通用基础以编程方式定义每个环境来实现的,而不是像 Wrangler 中常见的那样复制 env 块。一个简单的多环境 Worker 只需切换 Vite 原生的 mode 参数,即可在一组配置和另一组配置之间切换。
实现这一功能的简单配置现在看起来像这样:
<span class="line"><span class="sk-24292e-fff">import { bindings, defineConfig } from </span><span class="sk-032f62-99ffe4">"cf/config"</span><span class="sk-24292e-fff">;</span></span>
<span class="line"><span class="sk-24292e-fff">import </span><span class="sk-d73a49-a0a0a0">*</span><span class="sk-d73a49-ffc799"> as</span><span class="sk-24292e-fff"> entrypoint from </span><span class="sk-032f62-99ffe4">"./index.js"</span><span class="sk-24292e-fff"> with { </span><span class="sk-d73a49-a0a0a0">type:</span><span class="sk-032f62-99ffe4"> "cf-worker"</span><span class="sk-24292e-fff"> };</span></span>
<span class="line"></span>
<span class="line"><span class="sk-24292e-fff">export default </span><span class="sk-6f42c1-ffc799">defineConfig</span><span class="sk-24292e-fff">(({ mode }) </span><span class="sk-d73a49-a0a0a0">=></span><span class="sk-24292e-fff"> ({</span></span>
<span class="line"><span class="sk-24292e-fff"> worker</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-24292e-fff"> {</span></span>
<span class="line"><span class="sk-24292e-fff"> name</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-032f62-99ffe4"> "example-worker"</span><span class="sk-24292e-fff">, </span></span>
<span class="line"><span class="sk-24292e-fff"> entrypoint,</span></span>
<span class="line"><span class="sk-24292e-fff"> compatibilityDate</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-032f62-99ffe4"> "2026-09-27"</span><span class="sk-24292e-fff">,</span></span>
<span class="line"><span class="sk-24292e-fff"> env</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-24292e-fff"> {</span></span>
<span class="line"><span class="sk-6f42c1-ffc799"> Environment</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-24292e-fff"> bindings</span><span class="sk-d73a49-a0a0a0">.</span><span class="sk-6f42c1-ffc799">text</span><span class="sk-24292e-fff">(`</span><span class="sk-6f42c1-ffc799">This</span><span class="sk-24292e-fff"> is </span><span class="sk-d73a49-a0a0a0">$</span><span class="sk-24292e-fff">{mode} environment`),</span></span>
<span class="line"><span class="sk-24292e-fff"> },</span></span>
<span class="line"><span class="sk-24292e-fff"> },</span></span>
<span class="line"><span class="sk-24292e-fff">}));</span></span>
你可以通过 cf migrate 将你的 Cloudflare Worker 迁移到这种新格式。
我们还提供了一些辅助函数,让你轻松构建 Worker。
bindings 为你提供了一个简单的位置,让你的 agent 能够发现开发者平台提供的所有功能。从环境变量到存储、数据库和队列,所有内容都可以由你的编辑器自动补全和解释。
<span class="line"><span class="sk-d73a49-a0a0a0">import</span><span class="sk-24292e-fff"> { bindings, defineConfig } </span><span class="sk-d73a49-a0a0a0">from</span><span class="sk-032f62-99ffe4"> "cf/config"</span><span class="sk-24292e-fff">;</span></span>
<span class="line"></span>
<span class="line"><span class="sk-d73a49-a0a0a0">export</span><span class="sk-d73a49-a0a0a0"> default</span><span class="sk-6f42c1-ffc799"> defineConfig</span><span class="sk-24292e-fff">(({ </span><span class="sk-e36209-fff">mode</span><span class="sk-24292e-fff"> }) </span><span class="sk-d73a49-a0a0a0">=></span><span class="sk-24292e-fff"> ({</span></span>
<span class="line"><span class="sk-24292e-fff"> worker: {</span></span>
<span class="line"><span class="sk-6a737d-8b8b8b94"> // ...</span></span>
<span class="line"><span class="sk-24292e-fff"> env: {</span></span>
<span class="line"><span class="sk-24292e-fff"> API_URL: bindings.</span><span class="sk-6f42c1-ffc799">text</span><span class="sk-24292e-fff">(</span></span>
<span class="line"><span class="sk-24292e-fff"> mode </span><span class="sk-d73a49-a0a0a0">===</span><span class="sk-032f62-99ffe4"> "production"</span></span>
<span class="line"><span class="sk-d73a49-a0a0a0"> ?</span><span class="sk-032f62-99ffe4"> "https://example.com"</span></span>
<span class="line"><span class="sk-d73a49-a0a0a0"> :</span><span class="sk-032f62-99ffe4"> "https://staging.example.com"</span><span class="sk-24292e-fff">,</span></span>
<span class="line"><span class="sk-24292e-fff"> ),</span></span>
<span class="line"><span class="sk-24292e-fff"> API_TOKEN: bindings.</span><span class="sk-6f42c1-ffc799">secret</span><span class="sk-24292e-fff">(),</span></span>
<span class="line"><span class="sk-24292e-fff"> CACHE: bindings.</span><span class="sk-6f42c1-ffc799">kv</span><span class="sk-24292e-fff">({</span></span>
<span class="line"><span class="sk-24292e-fff"> id: mode </span><span class="sk-d73a49-a0a0a0">===</span><span class="sk-032f62-99ffe4"> "production"</span></span>
<span class="line"><span class="sk-d73a49-a0a0a0"> ?</span><span class="sk-032f62-99ffe4"> "production-namespace-id"</span></span>
<span class="line"><span class="sk-d73a49-a0a0a0"> :</span><span class="sk-032f62-99ffe4"> "staging-namespace-id"</span><span class="sk-24292e-fff">,</span></span>
<span class="line"><span class="sk-24292e-fff"> }),</span></span>
<span class="line"><span class="sk-24292e-fff"> DATABASE: bindings.</span><span class="sk-6f42c1-ffc799">d1</span><span class="sk-24292e-fff">({ name: </span><span class="sk-032f62-99ffe4">`example-${</span><span class="sk-24292e-fff">mode</span><span class="sk-032f62-99ffe4">}-database`</span><span class="sk-24292e-fff"> }),</span></span>
<span class="line"><span class="sk-24292e-fff"> UPLOADS: bindings.</span><span class="sk-6f42c1-ffc799">r2</span><span class="sk-24292e-fff">({ name: </span><span class="sk-032f62-99ffe4">`example-${</span><span class="sk-24292e-fff">mode</span><span class="sk-032f62-99ffe4">}-uploads`</span><span class="sk-24292e-fff"> }),</span></span>
<span class="line"><span class="sk-24292e-fff"> JOBS: bindings.</span><span class="sk-6f42c1-ffc799">queue</span><span class="sk-24292e-fff"> < { </span><span class="sk-e36209-fff">userId</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-005cc5-ffc799"> string</span><span class="sk-24292e-fff"> } > ({</span></span>
<span class="line"><span class="sk-24292e-fff"> name: </span><span class="sk-032f62-99ffe4">`example-${</span><span class="sk-24292e-fff">mode</span><span class="sk-032f62-99ffe4">}-jobs`</span><span class="sk-24292e-fff">,</span></span>
<span class="line"><span class="sk-24292e-fff"> }),</span></span>
<span class="line"><span class="sk-24292e-fff"> AI: bindings.</span><span class="sk-6f42c1-ffc799">ai</span><span class="sk-24292e-fff">(),</span></span>
<span class="line"><span class="sk-24292e-fff"> SEARCH_INDEX: bindings.</span><span class="sk-6f42c1-ffc799">vectorize</span><span class="sk-24292e-fff">({</span></span>
<span class="line"><span class="sk-24292e-fff"> name: </span><span class="sk-032f62-99ffe4">`example-${</span><span class="sk-24292e-fff">mode</span><span class="sk-032f62-99ffe4">}-search`</span><span class="sk-24292e-fff">,</span></span>
<span class="line"><span class="sk-24292e-fff"> }),</span></span>
<span class="line"><span class="sk-24292e-fff"> API: bindings.</span><span class="sk-6f42c1-ffc799">worker</span><span class="sk-24292e-fff">({ worker: </span><span class="sk-032f62-99ffe4">`example-${</span><span class="sk-24292e-fff">mode</span><span class="sk-032f62-99ffe4">}-api`</span><span class="sk-24292e-fff"> }),</span></span>
<span class="line"><span class="sk-24292e-fff"> },</span></span>
<span class="line"><span class="sk-24292e-fff"> },</span></span>
<span class="line"><span class="sk-24292e-fff">}));</span></span>
同样,我们为 triggers 添加了一个辅助工具,这是为 Worker 定义路由、队列、调度和邮件触发器的新方式。这些配置不再分散在配置文件中,现在可以轻松地在单个块中找到可能触发 Worker 运行的操作。
<span class="line"><span class="sk-24292e-fff">import { defineConfig, triggers } from </span><span class="sk-032f62-99ffe4">"cf/config"</span><span class="sk-24292e-fff">;</span></span>
<span class="line"></span>
<span class="line"><span class="sk-24292e-fff">export default </span><span class="sk-6f42c1-ffc799">defineConfig</span><span class="sk-24292e-fff">({</span></span>
<span class="line"><span class="sk-24292e-fff"> worker</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-24292e-fff"> {</span></span>
<span class="line"><span class="sk-6a737d-8b8b8b94"> // ...</span></span>
<span class="line"><span class="sk-24292e-fff"> triggers</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-24292e-fff"> [</span></span>
<span class="line"><span class="sk-24292e-fff"> triggers</span><span class="sk-d73a49-a0a0a0">.</span><span class="sk-6f42c1-ffc799">fetch</span><span class="sk-24292e-fff">({ pattern</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-032f62-99ffe4"> "example.com/*"</span><span class="sk-24292e-fff"> }),</span></span>
<span class="line"><span class="sk-24292e-fff"> triggers</span><span class="sk-d73a49-a0a0a0">.</span><span class="sk-6f42c1-ffc799">scheduled</span><span class="sk-24292e-fff">({ schedule</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-032f62-99ffe4"> "0 * * * *"</span><span class="sk-24292e-fff"> }),</span></span>
<span class="line"><span class="sk-24292e-fff"> triggers</span><span class="sk-d73a49-a0a0a0">.</span><span class="sk-6f42c1-ffc799">queue</span><span class="sk-24292e-fff">({ name</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-032f62-99ffe4"> "jobs"</span><span class="sk-24292e-fff">, maxBatchSize</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-005cc5-ffc799"> 10</span><span class="sk-24292e-fff"> }),</span></span>
<span class="line"><span class="sk-24292e-fff"> triggers</span><span class="sk-d73a49-a0a0a0">.</span><span class="sk-6f42c1-ffc799">email</span><span class="sk-24292e-fff">({ addresses</span><span class="sk-d73a49-a0a0a0">:</span><span class="sk-24292e-fff"> [</span><span class="sk-032f62-99ffe4">"support@example.com"</span><span class="sk-24292e-fff">] }),</span></span>
<span class="line"><span class="sk-24292e-fff"> ],</span></span>
<span class="line"><span class="sk-24292e-fff"> },</span></span>
<span class="line"><span class="sk-24292e-fff">});</span></span>
defineConfig.worker 仅仅是一个开始。我们设计 cloudflare.config.ts 的初衷是让你通过它来整体管理 Cloudflare。你需要的每一个产品——以及通过 cf 提供给 Agent 的 API——都能通过类型安全的配置来表达。很快,你将能够通过这个配置文件配置完整的策略、设置区域、配置 DNS 等等。
一流的开发体验
当 Wrangler 最初开始构建 JavaScript Worker 时,Vite 还不存在。相反,我们在 Wrangler 中使用 esbuild 来打包你的 Worker。Wrangler 在 :8787 上提供的开发服务器是由 Wrangler 团队构建的,修改其中的任何部分都需要深入 Cloudflare 特定的本地工具(如 Miniflare)的内部。
Vite 在这方面有了巨大的改进,它附带了一个庞大的插件生态系统,同时提供了具有 HMR(热模块替换)的一流开发服务器,以及使用基于 Rust 的 Rolldown 库进行 tree-shaking 的构建。任何你可以在 Vite 中做的事情,都可以通过 Cloudflare Vite 插件完成。
Cloudflare Vite 插件是我们推荐构建 Worker 的方式,无论你构建的是前端项目还是后端 API。结合我们的 Vitest 插件,它提供了一个与 Worker 运行时一致的统一开发和测试环境,并让你直接访问绑定和平台 API。
cf 默认基于 Vite 构建。你的大多数 Worker 可以简单地通过 agents 迁移。其他 Worker 可能需要更多时间,因此 cf 将继续委托 Wrangler 进行开发和部署,适用于需要继续使用 esbuild 的 JavaScript Worker 以及 Rust 和 Python Worker。
从 Wrangler 迁移
从 Wrangler 迁移 Worker 只需运行:
<span class="line"><span class="sk-6f42c1-ffc799">cf</span><span class="sk-032f62-99ffe4"> migrate</span></span>
已经使用 Vite 构建的 Worker 将自动转换为 cloudflare.config.ts。如果你的 Worker 依赖 Wrangler 进行 esbuild 构建,那么 cf 将继续委托 Wrangler 进行构建。
当公开测试版结束时,我们将发布 Wrangler 的最终主要版本,该版本会引导你和你的 agent 使用 cf。我们将在测试版结束后继续为 Wrangler 提供 18 个月的支持维护,以便你有时间进行迁移。
你也可以通过运行 cf init/deploy 来创建新项目并自动配置 Cloudflare,这将为你安装 Cloudflare Vite Plugin 并创建配置文件。
静态站点仍然无需配置文件即可启动,部署它们只需在项目中运行 cf deploy。
要使用 cf 启动一个新的 Hello World 项目,请运行 cf init。
cf 是开源的,问题可以报告到我们的 GitHub 仓库。
相关标签
AgentsAPIBirthday WeekcfDevelopers
关注社交媒体
Cloudflarehttps://blog.cloudflare.com/rss/https://x.com/Cloudflarehttps://www.linkedin.com/company/cloudflare-inc-https://www.youtube.com/cloudflarehttps://instagram.com/cloudflarehttps://github.com/cloudflarehttps://bsky.app/profile/cloudflare.socialhttps://www.threads.com/@cloudflarehttps://www.tiktok.com/@cloudflare
Matt “TK” Taylorhttps://tk.gg/https://x.com/MattieTKhttps://www.linkedin.com/in/mattietk/http://github.com/mattietkhttp://bsky.app/profile/tk.gg