cf 正式发布：面向整个 Cloudflare API 的智能体驱动的 CLI

AI 总结
• Cloudflare 正式发布面向全平台的智能体驱动 CLI 工具 cf，旨在解决 AI 智能体使用 Wrangler 时覆盖范围有限（仅约 280 条命令）且术语不一致的问题。
• 数据显示 AI 智能体对 Wrangler 的使用量急剧攀升，2026 年 3 月贡献了四分之一的使用量，上周已达 48%，且智能体用户比人类用户更频繁地使用多个命令。
• cf 基于全新的 Forge API 生成流水线构建，将可操作范围从 Wrangler 的约 280 个功能扩展至 Cloudflare API 的全部 3,000 多个操作，涵盖 Workers、D1、Access 及 WAF 等。
• 该工具以智能体为核心设计，默认使用 JSON 接口以节省上下文并便于过滤，新增的 `cf cli search` 命令允许智能体通过自然语言快速发现正确的操作命令。
• 目前 cf 已进入全球公开测试版，建议用户更新全局智能体指令文件（如 Claude Code 的 CLAUDE.md 或 Codex 的 AGENTS.md），将 Wrangler 替换为 cf 以管理 Cloudflare 资源。

【标题】cf 正式发布：面向整个 Cloudflare API 的智能体驱动的 CLI

在过去一年里，AI 智能体对 Wrangler 的使用量急剧攀升。2026 年 3 月，AI 智能体贡献了 Wrangler 使用量的四分之一，而前一年的占比还是个位数百分比。上周，智能体的使用率已达到 48%。

AI 智能体是更高产的用户，每天使用的不同命令数量几乎翻倍，使用六个或更多命令的可能性几乎是四倍。

AI 智能体喜爱 CLI。

但 Wrangler 仅提供约 280 种操作的命令，而 Cloudflare 提供的操作多达数千种。

今年早些时候，我们曾预告过我们的解决方案。

今天，我们正式推出全新 CLI：cf，让 AI 智能体能够使用每一个 Cloudflare 产品。

cf 是专为下一代软件开发打造的 CLI：
• AI 智能体可以通过专属搜索和引导找到所需的命令，完成任何想做的事情。

• JSON 是默认接口，对人类友好地美化输出，对 AI 智能体则进行压缩，以实现最大限度的上下文节省。

• cloudflare.config.ts 是 Cloudflare 全平台的全新配置格式，从 Workers 开始，将 TypeScript 的安全性和准确性带给您以及您的智能体的语言服务器协议（LSP）。

• Vite 成为默认工具，带来业界最佳的本地开发服务器，以及面向开发者和框架作者的插件套件。

立即全球安装公开测试版，随时随地运行：

Copy prompt 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.

【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 …` (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 ` 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】
如果您的 AI 智能体能做到 Cloudflare 能做的一切，会怎样？

这正是我们今年初产生兴趣的问题：智能体变得越来越强大，但它们通过 Cloudflare CLI 所能完成的事情仍然有限。

Wrangler 是手工构建的，每个产品团队都以自己的方式为命令开发者体验做出贡献。

即便只有约 280 条命令路径，在团队之间推行统一模式几乎不可能。

d1 info 、 hyperdrive get 、 workflows describe 之间的术语不一致，因为每个团队在不同时期制定了各自的实践方式。

部分团队花费数千行代码构建了完全自定义的体验，但这些体验极少被使用，而且各团队对同一问题采用了不同的解决方案。

我们希望在标准化现有内容的同时，一次性完成大规模扩展。

Forge ——Cloudflare 全新的统一 API 生成流水线——让我们得以实现这一目标。

其核心理念是直接从支持 API 文档和 SDK 生成的 API 模式中生成 CLI 命令。

我们提供的所有内容都有 OpenAPI 模式，只需添加一点额外信息进行注解，即可将其作为 Forge 生成 CLI 的来源。

这使我们能够将 cf 从 Wrangler 多年积累的约 280 个功能，扩展到涵盖 Cloudflare API 全部超过 3,000 个操作。

现在，只需将 cf 交给您的 AI 智能体，让它设置 worker、部署、监控、使用 Cloudflare Access 进行保护、购买域名，并通过 Cloudflare WAF 进行防护——全部通过单一工具完成。

【为从未使用过 cf 的智能体而构建】
cf 是为软件工程的发展轨迹而构建的，智能体驱动的开发正在从根本上改变软件的构建和部署方式。

今年，我们专注于提供支持这一转变的工具，cf 是这一努力的集大成之作。

cf 从零开始以智能体为核心进行构建，包含用于智能体驱动命令发现的创新工具，我们认为这些工具将在不久的将来成为更多 CLI 的标准。

Wrangler 有一个优势：多年的文档、博客和第三方指南已被纳入 LLM 的训练过程。

但这也带来了同样的劣势：改变 Wrangler 的工作方式现在与已学习的行为相悖，而鉴于我们希望实现的改进规模，重大变更是不可避免的。

引入一个 AI 智能体从未见过的新 CLI 听起来像是一次巨大的颠覆性变化——但实际上这是我们能做的最干净的事情。

由于我们所做的设计决策、我们可以进行的上下文注入以及我们可以追加的 AGENTS.md 文件，以这种方式进行切换实际上比让智能体理解它所熟悉的工具的两个版本之间的主要差异更少令人困惑。

我们在发布时内置了几项此类面向智能体的功能，更多功能即将推出。

【智能体需要过滤 JSON，而不是查看表格】
当 AI 智能体使用 Wrangler 时，它们会在每个命令后附加 --json ，然后经常用 jq 过滤输出以提取字段子集。

但 Wrangler 中只有部分命令支持 --json ；

许多命令返回的是专为人类在终端查看而设计的 Unicode 表格。

智能体能够解读这些表格，但代价是比 jq 过滤器更多的时间和 token。

在 cf 中，我们采取了相反的立场：智能体只需要 JSON，如果智能体是这个工具未来的主要用户，那么 JSON 就应该是默认值。

对于极少由人类访问的绝大多数命令来说，这显然是正确的选择。

作为这个 CLI 的人类用户，您实际上与直接使用它隔了一层。

让 AI 智能体能够轻松过滤其结果，然后以您要求的任何格式返回该过滤后的列表，比提供您可能永远不会直接阅读的表格更为可取。

但如果您想做一些可能需要真实个人输入的事情，比如搜索要购买的域名，该怎么办？

对于您的 AI 智能体可以通过在长而繁琐的序列中链接命名参数来访问的命令，您只需填写表单即可。

cf 将 API 的要求分解为一系列经过验证的输入，因此购买域名——即使是有复杂要求的域名——也简单易懂。

或者，如果您坚持，直接让您的智能体来做。

【您的智能体可以自行找到正确的命令】
在一个有 3,000 条可能路径的 CLI 中，您的 AI 智能体如何才能快速找到所需操作而不会让您的上下文爆炸？

为此，我们还添加了 cf cli search 。

这个命令允许您的 AI 智能体用自然语言询问需要做什么，一个小型搜索索引将根据 API 描述和参数提供合适命令的列表。

当智能体第一次运行 --help 时，我们会自动告知它这个命令。

【对智能体进行类型检查的配置】
我们的新配置格式基于 TypeScript，人类和 AI 智能体都易于解析，并允许您以编程方式编写配置。

类型化配置对 AI 智能体极为有用。

我们发现，即使没有对编程配置格式的任何先验背景，智能体也能够轻松识别并按需编辑配置，即便是像 env 这样相比 Wrangler 中同名特性已发生重大变化的元素也不例外。

所有使用 LSP 插件的智能体，例如 Claude Code 和 Codex，都能从在上下文中解读更多配置文件格式信息中获益

[来源链接] https://blog.cloudflare.com/zh-cn/cloudflare-cf-cli-launch/