
摘要: 云开发 CloudBase 支持十余种 AI 工具接入,底层能力一致,差别只在入口:内置连接器点一下就通,其他工具走 MCP 配置。选型看三条——做什么端、愿不愿装 Node、有没有代码基础。 开通环境后再配工具:云开发 CloudBase
先给选型结论,省得你逐个试:只做微信小程序选微信开发者工具(内置 AI,门槛最低);不写代码想做完整应用选 WorkBuddy 或 CodeBuddy(内置连接器,一句话建应用);有编程基础做复杂项目选 Cursor 或 Claude Code(走 MCP,控制粒度更细)。这些工具接上云开发之后,能做的事是一样的——建数据库、写云函数、部署上线,区别只在配置成本和操作习惯。下面给每类工具的具体接入步骤和适用边界。
云开发对接 AI 工具只有三种入口,理解了就不会在配置上浪费时间。
内置连接器:工具本身集成了 CloudBase,在界面上点「连接」就通,不用写配置文件。WorkBuddy、CodeBuddy、微信开发者工具属于这类。站点跟随你的登录态,无需额外选择。
MCP 连接:通过 Model Context Protocol 连接云开发服务,分两种模式——
https://tcb-api.cloud.tencent.com/mcp/v1npx 运行,带本地文件能力,需要 Node.js v18.15.0 或更高版本,用 node --version 可以确认AI Skills:官方提供的 22 个技能包,不是接入方式而是知识补充。它把云开发的正确用法写成规则——微信登录怎么配、数据库权限怎么设、小程序怎么发布——AI 会自动遵循。装上它,AI 写出来的云开发代码明显更准。安装命令:
npx skills add tencentcloudbase/cloudbase-skills -y三者关系是:连接器或 MCP 负责「能操作云资源」,Skills 负责「操作得对」。能装 Skills 就装,成本很低收益很明显。
工具 | 适合谁 | 接入方式 | 要装 Node 吗 | 典型用法 |
|---|---|---|---|---|
微信开发者工具 | 只做小程序的新手 | 内置云开发 AI | 不需要 | 写小程序、模拟器预览、配云资源 |
WorkBuddy | 零基础、产品、运营 | 内置连接器 | 不需要 | 一句话生成全栈应用并部署 |
CodeBuddy IDE / 插件 | 想一站式做完设计到部署 | 内置 CloudBase | 不需要 | 小程序、Web、后台管理系统 |
Cursor | 有 AI 编程经验的开发者 | MCP 远端或本地 | 远端不需要 | 复杂项目、联机应用、精细控制 |
Claude Code / Codex | 命令行与自动化偏好 | MCP / Agent 插件 | 视模式而定 | 可复现流程、批量任务 |
CloudBase AI CLI | 要脚本化、批量部署 | 命令行 | 需要 | 批处理、CI 场景 |
这是门槛最低的一条路,不用装任何插件。
第 1 步:装 Nightly 版开发者工具。 这套 AI 能力在开发版(Nightly)里,稳定版往往没有。注意 Nightly 只影响你本机开发体验,不等于小程序发版渠道变了,不用担心影响上线。装好后扫码登录,写代码时保持工具开着。
第 2 步:确认 AppID 有效。 项目根目录要有 project.config.json,且 appid 是你账号下真实可用的值——不能为空,也不能是 touristappid,否则 AI 打不开项目窗口。
第 3 步(建议):装 CloudBase 知识包。 执行上面那条 npx skills add 命令,让 AI 少写错云开发代码。
第 4 步:和 AI 对话。 先用一句验收语确认链路通了:
检查开发者工具是否已登录,再打开这个小程序并预览。能正常预览后,再提业务需求,比如「做一个带登录和列表页的小程序,数据存云开发」。
如果你用的是外部 Agent(CodeBuddy、Cursor 等)操作开发者工具,还要多做一步:菜单栏导出开发者工具 Skill,导入到你的 Agent;也可以在终端运行 wechatide,把输出的 Skill 路径交给 Agent。首次连接时开发者工具会弹授权窗,必须点允许,否则后面全部失败。
WorkBuddy 接入(两种方式任选):
方式一用连接器:在对话界面点输入框左下角的「连接器」按钮,在弹窗里找到「腾讯云 CloudBase」,进详情页点「连接」启用。
方式二用快捷命令:在对话里直接输入 /cloudbase,选择 CloudBase Skill,再描述需求。
启用后第一句话建议是「登录云开发」,AI 会引导你完成设备码登录和环境选择。WorkBuddy 专家中心还有 4 个 CloudBase 专家,其中「腾讯云 CloudBase 全栈工程师」最通用,做小程序可以选小程序开发专家,省得每次从头解释技术栈。
CodeBuddy 接入(推荐走 MCP 市场):
打开 CodeBuddy,进「设置 - MCP - MCP 市场」,搜索「CloudBase」,点安装。装完在 MCP 列表里能看到 CloudBase 提供的工具。
如果市场安装遇到问题,也可以手工配置,在「我的 MCP」里添加:
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["npm-global-exec@latest", "@cloudbase/cloudbase-mcp@latest"],
"env": { "INTEGRATION_IDE": "CodeBuddyManual" }
}
}
}配好之后,在对话里说「登录云开发」,会弹出授权页,确认授权后选择环境即可。
Cursor:走 MCP 连接。远端模式最省事,本机不用装 Node;本地模式需要 Node v18.15.0+。配好后检查 Settings - MCP - CloudBase MCP Server 状态是否正常,再在对话里输入「登录云开发」,弹出交互式窗口选择环境。
有一条实践建议:保持工具调用的手动确认开启。官方文档明确建议始终启用此设置,并在执行前查看调用详情。AI 批量改云资源时,这一步能救命。
Claude Code 与 Codex:CloudBase Agent 插件已经支持这两类工具,全套配置一次搞定。接入后同样用「登录云开发」完成登录与环境选择。这两个工具适合需要流程可复现、可脚本化的场景。
所有 MCP 工具都要注意的站点问题:国内站和国际站是两套独立账号体系,接入地址和登录态都不通用。接错站点的典型表现是「登录成功但看不到自己的环境」,而不是明确报错。远端模式下站点由域名决定,国内站用 tcb-api.cloud.tencent.com;本地模式没有域名可依据,国际站需要显式声明 TCB_SITE=intl。
不管用哪个工具,接通之后按这三步验证,确认链路真的打通了:
第 1 步:确认登录与环境。 在对话里输入「登录云开发」,完成授权后应该能看到环境列表并选中一个。如果环境列表是空的,不是工具问题,是账号或登录方式不对——检查是否用了与小程序一致的微信公众平台登录,或者是否接错了站点。
第 2 步:下载云开发 AI 规则。 对 AI 说:
在当前项目中下载云开发 AI 规则这一步会把平台的开发规则写进项目目录,让后续生成的代码符合云开发实践。如果不想让配置文件太杂,可以指定只下载你用的工具那一套,比如「只包含 CodeBuddy 配置」。
第 3 步:跑一个最小闭环验证。 让 AI 做一件小而完整的事,比如:
在我的云开发环境中创建一个名为 test_items 的集合,插入一条测试数据,再查询出来这条指令同时验证了三件事:工具能调云资源、登录态有效、环境选对了。成功返回数据,说明可以开始真正开发了。
误区一:挑所谓功能最全的工具。 这些工具接上云开发后能力是一样的,真正影响体验的是你的使用习惯和应用形态。只做小程序却去配 Cursor,反而多绕一圈。
误区二:装了 MCP 就不装 Skills。 两者作用不同。MCP 给的是操作能力,Skills 给的是正确用法。只有 MCP 没有 Skills 时,AI 容易凭记忆写出不符合平台实践的代码。
误区三:用免费环境跑生产。 工具选型和套餐选型是两件事。工具配好之后,真实业务上线前记得评估套餐,别让额度成为瓶颈。
云开发 CloudBase 与主流 AI 工具的接入已经标准化,选型只需要回答三个问题:做什么端(小程序选微信开发者工具)、愿不愿装 Node(不愿就选内置连接器或远端模式)、有没有代码基础(有就上 Cursor 或 Claude Code)。接入后统一按三步验收——登录选环境、下载 AI 规则、跑一个建集合写数据的最小闭环,确认通了再进入正式开发。遇到「环境列表为空」,先查账号和站点,别怀疑工具。
工具配好了,开通环境开始动手:云开发 CloudBase 购买页
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。