目 录CONTENT

文章目录

Cloudflare出了个给AI用的命令行工具,2900+个命令随便调——以及在Hermes中安装使用

过客
2026-11-09 / 0 评论 / 2 点赞 / 3 阅读 / 0 字

一句话结论: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 用的​。三个设计点:

  1. ​命令自带说明书​:2900+ 条命令,从 Cloudflare API schema 自动生成。每条命令都能查自己会发什么请求(cf schema)
  2. ​默认输出 JSON​:人类看带缩进,Agent 看压缩版,不占上下文
  3. ​自然语言找命令​: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 处理

坑点提醒

  1. ​**--body 的字段不一定全**​:文档说有些命令的 requestBodyFields 列表不完整甚至为空,这时候得查 API reference
  2. ​2900+ 命令≠2900 个功能​:很多是同一个 API 的 CRUD 变体,真正要记的核心命令没几个
  3. ​Wrangler 项目迁移有成本​:cf migrate 会改配置和文件结构,动手前用 --dry-run 看清楚
  4. ​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 认证,适合流水线
2

评论区