跳到主要内容

CodeBuddy Code 配置指南

CodeBuddy Code 可通过 插件市场 安装 CloudBase 插件（MCP + Skills），再配合 CloudBase CLI 完成环境登录。配置后，你可以在命令行对话中直接操作 CloudBase 服务。

例如：

  • "用云开发做一个微信小程序点餐系统" - AI 搭页面、建云数据库、写云函数并引导预览
  • "做一个预约管理系统，支持用户下单和后台改状态" - AI 用 CloudBase PostgreSQL 建模、配权限并接好前后端
  • "给 Web 应用加上手机号登录" - AI 启用认证方式并接入 CloudBase SDK

无需切换到云控制台，所有操作都可以在命令行中用自然语言完成。

前置条件​

在开始配置之前，请确保满足以下条件：

已准备好 Node.js 环境和云开发环境

Node.js 环境： 确保已安装 Node.js v18.15.0 或更高版本：

node --version

如果未安装，请从 Node.js 官网 下载安装。

云开发环境： 请参考文档 开通云开发环境。新用户可以免费开通体验。

方式一：通过插件市场安装（推荐）​

插件市场方式会同时安装 MCP 工具和 AI Skills，一次安装即可获得完整能力。

# 添加 CloudBase 插件市场
codebuddy plugin marketplace add TencentCloudBase/CloudBase-AI-Toolkit

# 安装 CloudBase 插件
codebuddy plugin install cloudbase@tencent-cloudbase

市场源完整 URL 为：

https://github.com/TencentCloudBase/CloudBase-AI-Toolkit

安装后建议新开会话，确保插件完整加载。图形界面版步骤见 CodeBuddy 配置指南。

登录云开发环境​

已有腾讯云账号（推荐）​

无需预先配置。在 CodeBuddy Code 中直接开始对话，按提示完成 Device 登录 即可。

🌏 国际站用户：环境开通在腾讯云国际站时，需先声明站点，否则登录会走国内站授权页。在 MCP 配置的 env 中加入 "TCB_SITE": "intl"（或使用启动参数 --site intl），重启后再登录。详见 连接方式 - 国际站用户。

没有腾讯云账号（API Key）​

# 安装 CloudBase CLI
npm i -g @cloudbase/cli

# 国际站用户请先执行 tcb config set isIntl true（或设置环境变量 TCB_IS_INTL=true）切换到国际站链路
# 使用环境 API Key 登录（必须同时指定环境 ID）
tcb login --cloudbase-api-key <cloudbaseApiKey> -e <cloudbaseEnvId>

💡 API Key 可在 云开发控制台 的环境设置中创建和管理（有管理权限时）。

⚠️ 不要把 API Key 提交到代码仓库。

方式二：通过 MCP 配置连接​

如果只需 MCP 工具连接，也可以手工配置：

Client

配置你的 AI 工具以连接 CloudBase 能力 支持本地与托管两种连接方式，详见 连接方式。

步骤 1：安装 / 配置 CloudBase

使用项目模板（推荐） - 模板已内置 MCP 配置和 AI 规则查看模板

CLI 命令:

codebuddy mcp add --scope project cloudbase --env INTEGRATION_IDE=CodeBuddyCode -- npx @cloudbase/cloudbase-mcp@latest

或者将以下配置添加到 .mcp.json:

或手动配置:

或者将以下配置添加到 .mcp.json:

json
1{
2  "mcpServers": {
3    "cloudbase": {
4      "type": "stdio",
5      "command": "npx",
6      "args": ["@cloudbase/cloudbase-mcp@latest"],
7      "env": {
8        "INTEGRATION_IDE": "CodeBuddyCode"
9      }
10    }
11  }
12}
需要帮助？查看 CodeBuddy Code 文档

步骤 2：和 AI 对话

在 AI 对话中依次输入以下内容:

prompt
阅读 https://docs.cloudbase.net/skill.md，帮我介绍可以做什么
使用 CloudBase Skills： 帮我给 CloudBase 云函数配置一个 CPU 使用率告警

常见问题​

Q: 有腾讯云账号还需要 API Key 登录吗？
A: 不需要。对话时按提示完成 Device 登录即可。

Q: MCP 连接失败？
A: 检查 .mcp.json 文件格式是否正确，确认 npx 命令可用，重启 CodeBuddy Code，并确认已完成登录。

Q: 工具数量显示为 0？
A: 请参考常见问题。

更多问题请查看：完整 FAQ

相关资源