Cloudflare cf 命令行推荐，给 AI 代理配的全线钥匙
用 AI 代理管 Cloudflare 资产的人越来越多了，官方博客给了一组自称数字，代理调用已占 Wrangler 使用量的近一半，三月时还只有四分之一，一年前是个位数百分比。9 月 28 日 Cloudflare 发布公开测试版命令行工具 cf，专门为代理设计，我把官方博客、文档和 GitHub 仓库翻了一遍，这个工具的野心比名字大，细节不少，慢慢看。
主要功能
覆盖面是核心卖点。官方博客称 cf 覆盖三千多个 API 操作，而 Wrangler 只覆盖约二百八十个命令路径，这两组都是自称数字；官方文档另写两千九百多条命令，四月的技术预览博客说近三千，口径略有出入，引用时取近三千。安装走 npm 全局装一条命令，要求 Node 二十二点一八以上，装完同时提供 cf 与 cloudflare 两个等价命令。包名的来龙去脉也交代一句，npm 上的 cf 是二零一三年的老包，Cloudflare 四月接手从零点零点四开始迭代，九月底走到一点零测试五，迭代一个月八个版本。认证走浏览器授权流程，打印链接配一次性代码，CI 场景用环境变量注入令牌，全局 API 密钥明确不支持，Wrangler 的登录凭据也不复用，干净利落。用 Bun 的注意，官方文档写明 Bun 下加载配置文件会失败，包管理器老实选 npm 或 pnpm。
为代理做的设计还有几处。cf cli search 用自然语言查命令，本地运行不需要凭据；输出默认 JSON，方便程序解析；仓库支持 AGENTS 与 CLAUDE 指令文件，代理读了就知道怎么用。要说清一件事，cf 本身并不是 MCP 服务器，官方文档没这么写过，另有一套 Agent setup 机制负责给编码代理配技能与 MCP 服务，两者别混。代理生态的指令文件兼容是加分项，主流编码代理开箱能认。
与 Wrangler 的关系写在明面上。长期看是替代，官方说将来会发一个最终大版本的 Wrangler，把用户和代理都指向 cf，测试期结束后 Wrangler 还有十八个月维护期，过渡期内依赖 esbuild 的 JS Worker 与 Rust、Python Worker 的开发部署仍委托 Wrangler 处理。迁移有现成命令，一条 cf migrate 起步。
解决了什么需求
让代理全权管理云资源的场景，缺的就是一个口径统一、输出规整的入口。HN 帖子一百六十四分，讨论质量在线。用户 verdverm 给开发团队点赞，原话是特别中意那个自然语言命令检索，夸得具体；用户 smithclay 说自己几乎只通过代理调 Cloudflare API，这工具处处合意；用户 alasano 直言欢迎它取代 Wrangler。质疑也有分量。用户 slowin 反对用 TypeScript 写命令行还让用户管 Node 依赖，原话是别强迫用户管你命令行的依赖；用户 recroad 问代理直接调 REST 接口不就行了，何必再隔一层。两头都有道理，工具层的价值最终看代理调用成功的比率，这个数字要等时间给。写自动化前把仓库的开放 issue 过一遍，能省不少排查时间。
GitHub 的硬伤反馈更要紧。有用户报告 cf deploy 不带密钥文件参数时会把既有 Worker 密钥全部删掉，这是数据丢失级的坑，已有两位用户分别独立撞上；有用户上传两百六十四兆文件到对象存储超时，五十兆以内正常，大文件分片还欠火候；有用户发现非交互确认中止操作时退出码仍是零，代理会误判成功；还有缺 tail 替代、包管理器兼容等问题。仓库挂着七十个开放 issue，测试期问题清单还长，尝鲜可以，生产先等。
注意事项
工具本身免费开源，Apache 2.0 与 MIT 双许可，仓库九月底创建，四百六十多星。代理占比那组数字来自官方自称，趋势比绝对值可信，方向错不了。npm 包名 cf 是二零一三年的老包，包名怎么到手的官方没有说明。通过 cf 使用的云服务按各产品自身资费计费，工具不加价，企业环境里给代理配令牌时按最小权限发，别图省事给全局钥匙，beta 的坑都在 issue 里躺着，勤翻。
总结
方向正确，代理时代的运维入口就该这么设计。测试期坑不少，个人与测试环境先跑，密钥删除那个问题盯住修复再上生产，迁移命令先在测试项目跑通。
来源
- Cloudflare 官方博客 https://blog.cloudflare.com/cloudflare-cf-cli-launch/
- 官方文档 https://developers.cloudflare.com/cf/
- 开源仓库 https://github.com/cloudflare/cf
- HN 讨论 https://news.ycombinator.com/item?id=49879577
- 小众软件报道 https://www.appinn.com/cloudflare-cf-agentic-cli/