一句话结论:cf 不是 Wrangler 的升级版,是 Cloudflare 为 Agent 时代重新设计的命令行——你不用背命令,用自然语言描述就行。
上周 Cloudflare 把这个项目推到 GitHub 开放 beta,1K多星,Apache-2.0 协议,一周前刚更新。名字就叫 cf,副标题写得很大胆:the agentic CLI for the entire Cloudflare API。
我装上来实测在Hermes Agent中安装使用一轮,说说它到底在干什么。
安装
命令行直接安装
npm i -g cf
Hermes Agent 中安装
直接发消息给Hermes说
帮我安装 cloudflare cli

登录
- 直接用自然语言让Hermes Agent登录就行了

- 然后点击打开设备授权页面,按操作登录cloudfrare并授权就完成了

- 完成授权,可以测试一下

它想解决什么问题
你平时操作 Cloudflare 要几个入口:Dashboard 网页、wrangler(只管 Workers)、API Token + curl。每个入口的心智模型都不一样,wrangler 管不了 DNS,Dashboard 点来点去效率低,curl 得查文档拼 URL。
cf 想把这些统一成一个命令行,而且是给 Agent 用的。三个设计点:
- 命令自带说明书:2900+ 条命令,从 Cloudflare API schema 自动生成。每条命令都能查自己会发什么请求(
cf schema) - 默认输出 JSON:人类看带缩进,Agent 看压缩版,不占上下文
- 自然语言找命令:
cf cli search "想干什么"直接出候选,不需要记住命令名
实测:一句话完成操作
我最关心的是不用背命令,也不用去页面找功能在哪,只要用自然语言操作。试了几个场景:
使用cf查看`zngw.cc`域名解析

帮我在 `zngw.cc`域名 中 加条 A 记录 test.zngw.cc 指向1.2.3.4

跟 Wrangler 什么关系
这是最容易被问到的。简单说:
| 维度 | Wrangler | cf |
|---|---|---|
| 定位 | Workers 项目专用 | 整个 Cloudflare API |
| 配置文件 | wrangler.jsonc / wrangler.toml |
cloudflare.config.ts |
| 项目命令 | wrangler dev/deploy |
cf dev/build/deploy |
| 管 DNS/R2/D1 | ❌ | ✅ |
| 类型提示 | JSONC 手写 | TypeScript,有 LSP 补全 |
| 本地开发服务器 | workerd + 自建 | Vite(默认) |
| Agent 友好度 | 一般 | 专门设计 |
两者可以共存。你现有 Wrangler 项目不用改,cf 的资源命令照样能跑。想在 Wrangler 项目里用 cf dev/deploy,得先 cf migrate 转一下。
cf migrate 也支持 --dry-run,先看会改哪些文件,再决定动不动手。
跟 MCP / Composio 比
现在操作 Cloudflare 的 Agent 方案,主流是 MCP server。我搜到的 Composio 就把 Cloudflare 封成了 MCP + CLI 双模式。
cf 的路线不一样:它直接是官方 CLI,不依赖 MCP 协议。好处是不用配 server、不用管 token 转发、多步操作更稳。坏处是 Agent 得能跑 shell——不过现在主流 coding agent 都能跑 shell,所以这个门槛基本为零。
顺带一提,Cloudflare 自己也出了 MCP server(Code Mode MCP、Domain-specific MCP),官方文档里 cf 和 MCP 是并列的两条路。不冲突,看你的 Agent 习惯哪种。
还有几个细节
- **
cf docs search**:搜 Cloudflare 官方文档,返回标题 + 描述 + URL,配合curl -H "Accept: text/markdown"能直接抓全文。Agent 找资料不用开浏览器 - **
cf auth**:支持多 profile,可以给不同目录绑定不同账号(cf auth activate <name> <dir>),团队协作友好 - JSON 输出稳定:stdout 只有结果,消息和错误走 stderr,可以直接
| jq处理
坑点提醒
- **
--body的字段不一定全**:文档说有些命令的requestBodyFields列表不完整甚至为空,这时候得查 API reference - 2900+ 命令≠2900 个功能:很多是同一个 API 的 CRUD 变体,真正要记的核心命令没几个
- Wrangler 项目迁移有成本:
cf migrate会改配置和文件结构,动手前用--dry-run看清楚 - Node 版本有要求:只支持每个 Node 大版本的最新 minor,太老的 Node 跑不了
说说我的用法
我平时操作 Cloudflare 主要是三件事:DNS 解析、Workers 部署、R2 存储。这三件 cf 都覆盖了,而且 DNS 这块终于不用开网页——之前改个解析记录要登 Dashboard 找 zone、找记录、点编辑,现在一条命令的事。
但我暂时不会把 cf 当主力。原因很简单:刚上线没多久,Github上工程属于beta版本,命令可能变,而且我现有的 Wrangler 项目跑得好好的,没必要为了「统一」去迁移。
我的建议:
- Agent 重度用户:直接装上,让 Agent 用
cf cli search找命令,比 MCP 轻 - 纯手工运维:等稳定版,或者继续用 Dashboard +
wrangler组合 - CI/CD 场景:可以试,
cf支持 API token 认证,适合流水线
评论区