AI 部署

配置好 Cloudflare API Token 和 Skills,后面创建项目、配置数据库、绑定域名、GitHub 部署全部交给 AI 一句话搞定。

这是 AI 辅助的快速部署路径。如果需要传统手动部署(OpenNext + Wrangler),请参考 Cloudflare Workers 部署

配置一次后,做新项目只需要对 AI 说一句话:

用 Cloudflare 创建一个待办清单应用,项目名 tododemo。
包含用户登录和待办事项管理,使用 D1 数据库。
部署到 tododemo.01mvp.com。

AI 会自动帮你完成:创建 Worker 项目、配置 D1 数据库、写好前后端代码、推送到 GitHub 私有仓库、配置自动部署、绑定自定义域名。

前提条件

  • 一个 Cloudflare 账号(免费,额度很慷慨)
  • 一个域名,托管在 Cloudflare(DNS 由 Cloudflare 管理)
  • 一个支持 Cloudflare Skills 的 AI 工具(比如 Claude Code)

核心原理

整个流程的关键是两个东西:

1. Cloudflare API Token 这是一把钥匙,让 AI 工具能代替你操作 Cloudflare。

2. Cloudflare Skills 这是 AI 的「操作手册」,告诉 AI 怎么用 Cloudflare 的各种服务。

配置好这两个,AI 就能自动完成:创建 Worker、配置数据库(D1)、配置对象存储(R2)、配置 DNS 和域名绑定、设置 GitHub 自动部署。

第一步:创建 Cloudflare API Token

在哪创建

登录 Cloudflare 控制台

如果你要创建个人 Token:

右上角头像
  -> My Profile
  -> API Tokens
  -> Create Token

如果你的账号里已经有 Account API Tokens:

Manage Account
  -> API Tokens
  -> Create Token

个人练手项目,用 user token 就够了。

团队项目、长期 CI/CD,更适合用 account token。

选择模板

在模板里选:

Edit Cloudflare Workers

这个模板会给你一部分 Worker 相关权限。

但如果你想让 AI 后面还能帮你配域名、建数据库、接对象存储,需要补一些权限。

建议加的权限

01mvp.com 这个域名为例,推荐这样配:

Account -> Cloudflare Workers Scripts -> Edit
Zone    -> Zone                    -> Read
Zone    -> DNS                     -> Edit
Account -> D1                      -> Edit
Account -> Workers R2 Storage       -> Edit

如果你在权限列表里看到 Durable Objects 相关权限,也可以给 Edit。

资源范围尽量收窄:

Account Resources: 选择你的 Cloudflare account
Zone Resources:    只选择 01mvp.com

这样就算 Token 泄漏,影响范围也不会无限扩大。

Token 创建完成后只会显示一次。马上复制下来,别写进代码仓库。

获取 Account ID

在 Cloudflare 控制台:

Account Home(账户主页)
单账户:账户名右侧点 ...(三点菜单)-> Copy account ID
多账户:在账户列表行末尾点 ... -> Copy account ID

保存到环境变量

可以直接用下面的命令追加到 .zshrc,永久生效:

echo 'export CLOUDFLARE_API_TOKEN="你的_token"' >> ~/.zshrc
echo 'export CLOUDFLARE_ACCOUNT_ID="你的_account_ID"' >> ~/.zshrc
source ~/.zshrc

为什么不用 wrangler login

理论上也可以直接 npx wrangler login,但问题在于:

  • wrangler login 没有 DNS 的修改权限
  • 如果你要给 AI 工具、CI/CD、脚本化部署用,最佳方案还是 API token

第二步:添加 Cloudflare Skills

Skills 是 Cloudflare 官方提供的 AI 操作手册。

如果你用的是 Claude Code,可以直接运行:

npx skills add https://github.com/cloudflare/skills --yes --all

这会把 Cloudflare 的所有 Skills 添加到你的 AI 工具里。

以后 AI 就知道怎么:用 C3 创建项目、配置 wrangler.jsonc、创建和绑定 D1 数据库、配置 R2 对象存储、设置自定义域名、配置 GitHub 自动部署。

第三步:对 AI 说一句话

配置完成后,以后做新项目只需要对 AI 说:

示例 1:待办清单应用

用 Cloudflare 创建一个待办清单应用,项目名 tododemo。

功能:
- 用户名密码登录
- 创建、查看、删除待办事项
- 使用 D1 数据库存储

部署:
- 创建 GitHub 私有仓库
- 配置 Cloudflare 自动部署
- 绑定到 tododemo.01mvp.com

示例 2:图片分享站

用 Cloudflare 创建一个图片分享站,项目名 photoshare。

功能:
- 用户登录
- 上传图片(< 5MB)
- 浏览所有人的图片流
- 使用 D1 存储用户信息,R2 存储图片

部署:
- 创建 GitHub 私有仓库
- 配置 Cloudflare 自动部署
- 绑定到 photoshare.01mvp.com

示例 3:简单说明站

用 Cloudflare 创建一个产品说明站,项目名 demo。

使用 React + Vite,纯静态页面。
部署到 demo.01mvp.com。

AI 会自动完成什么

当你说完这句话,AI 会自动:

  1. 创建项目 — 用 C3 创建 Worker 或 Pages 项目,选择合适的模板
  2. 写代码 — 实现你要的功能,配置数据库 schema,写好前后端逻辑
  3. 配置数据库 — 创建 D1 数据库,在 wrangler.jsonc 里绑定,运行 migration
  4. 配置存储(如果需要)— 创建 R2 bucket,在 wrangler.jsonc 里绑定
  5. 本地测试 — 运行 npm run dev,确认功能正常
  6. 推送到 GitHub — 初始化 git,创建私有仓库,推送代码
  7. 配置自动部署 — 在 Cloudflare 控制台连接 GitHub,设置自动部署
  8. 绑定域名 — 在 wrangler.jsonc 配置 custom_domain,自动配置 DNS

全程不需要手动操作任何一步。

常见问题

参考资料