为什么需要
出海产品上线基本都要过 Cloudflare Workers 这道门:域名、DNS、R2、KV、Queues、Pages、Workers 绑定、访问规则,全在 Dashboard 里点,或者你得自己写 wrangler.toml。
cf 就是 Cloudflare 官方为这件事出的命令行工具:官方 API 全量覆盖,设计上直接考虑 Agent。
差异在同时用 Claude Code 或 Codex 的时候最明显——Agent 需要的不是人话说明书,是能解析、上下文占用小、类型上不会出错的 JSON 输出。这套 CLI 的默认值就是按这个来的。
怎么用
-
全局安装:
bashnpm i -g cf -
Agent 用 bespoke search + steering 找命令,不用背子命令结构
-
JSON 默认输出:人读时 pretty print,Agent 读时压缩成单行
-
配置从 wrangler.toml 迁到
cloudflare.config.ts,TypeScript 类型直接进语言服务器 -
本地开发默认走 Vite
注意事项
- 处于 open beta,命令面还在扩。README 目前只给了定位,没有完整命令清单,遇到具体子命令还得靠 search 或官方文档
- 相对 forge 的关系:forge 是 schema-first 的 OpenAPI 代码生成框架,
cf是它的第一个产物。想自己生成 SDK、CLI 或 Terraform provider,才需要去用 forge - 需要 Cloudflare 账号和带权限的 API token。权限开大了就是全站暴露,token 建议按最小权限生成
- Vite 成为默认本地开发服务器,老项目的插件兼容性要自己重新确认一遍
- Cloudflare 官方产品,绑 Cloudflare 生态;不用 Workers 的项目收益有限