Skip to content

入门实战案例二之云端部署

视频链接

【Claude Code 实战教程】新手必看!网站部署到云端超简单,用Cloudflare Workers让项目零成本上线!本期我用 Claude + Cursor + Cloudflare 将本地开发的声音克隆项目成功部署上线,涵盖 API 配置、样式修复、R2 绑定,适合想让项目上线的开发者学习参考。https://www.bilibili.com/video/BV1fUY4zgEcK

内容

API 令牌

  • 登录 Cloudflare → 管理账户 → API 令牌 → 创建令牌
  • 使用 Workers 模板,权限默认即可
  • 区域资源:账户的所有区域
  • 令牌只显示一次,需妥善保存
  • 作用:本地工具访问 Cloudflare 的“钥匙”

MCP 工具配置

  • 设置环境变量

    text
    export CLOUDFLARE_API_TOKEN="你的令牌"
  • 安装文档查询服务器

    text
    claude mcp add cloudflare-docs --transport sse https://docs.mcp.cloudflare.com/sse
  • 安装部署服务器

    text
    claude mcp add cloudflare-builds https://builds.mcp.cloudflare.com/sse --transport sse -e CLOUDFLARE_API_TOKEN=$CLOUDFLARE_API_TOKEN
  • 安装资源绑定服务器

    text
    claude mcp add cloudflare-bindings https://bindings.mcp.cloudflare.com/sse --transport sse -e CLOUDFLARE_API_TOKEN=$CLOUDFLARE_API_TOKEN
  • 查询 MCP 工具

    text
    claude mcp list
  • 连接失败 → 手动「认证」→ 浏览器 Allow

Claude 部署流程

  • 使用 Plan 模式 输入需求:

    text
    我想把项目部署到 Cloudflare Workers,可用 MCP 查询资料,并用多个子代理并行完成;若需对象存储请自动配置 R2;部署后若有页面/样式/接口问题请自动诊断并修复。ultra think
  • Claude 自动执行:

    • 生成详细任务清单
    • 子代理分工协作
    • 适配 Workers(后端、前端、路由、静态资源)
    • 配置 R2 存储(需绑定支付方式,提供免费额度)
    • 执行部署并反馈进度
    • 部署后巡检并修复问题

常见问题与解决

  • 样式丢失 → 截图发 Claude 修复
  • 模型列表加载失败 → Claude 修复配置
  • 音频文件读取失败 → Claude 修复路径/权限
  • MCP 连接失败 → 手动认证
  • 本地端口冲突 → 修改端口或结束进程

上线验收

  • 打开 Workers 网址,检查是否与本地一致
  • 测试完整流程:上传音频 → 创建模型 → 文本转语音 → 下载 MP3
  • 报错 → 截图交给 Claude 修复

运维与更新

  • 查看运行情况:Cloudflare 控制台 → Workers 页面(性能、日志、配置)

更新版本

text
wrangler publish --new-version

安全巡检

text
把我们审查一下这个项目是否存在安全隐患,有的话自动修复,可以启动多个子代理并行执行。

版本管理

  • 使用 /init 总结报告
  • 使用 Git 存档备份