Claude Code 配置指南

Claude Code 可以通过 插件市场 安装 CloudBase 插件，一次性获得 MCP 工具连接和 AI Skills；也可以通过 MCP 配置 手工连接。推荐使用插件市场方式。

配置后，你可以在 Claude Code 的对话中直接操作 CloudBase 服务。

例如：

"创建用户表" - AI 自动创建数据库集合
"部署这个函数" - AI 自动上传并配置云函数
"部署前端到 CDN" - AI 自动上传文件并配置托管

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

前置条件

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

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

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

node --version

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

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

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

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

Claude Code 支持从 marketplace 安装插件，安装后自动获得 MCP 连接和 Skills：

# 添加 CloudBase 插件市场
claude plugin marketplace add TencentCloudBase/cloudbase-mcp

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

安装完成后在 Claude Code 内运行 /reload-plugins 激活插件。默认 --scope user 全局可用，使用 --scope project 可在团队中共享。

方式二：通过 MCP 配置连接

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

Client

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

步骤 1：安装 / 配置 CloudBase

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

将以下配置添加到项目目录下的 .mcp.json:

json

1{
2  "mcpServers": {
3    "cloudbase": {
4      "command": "npx",
5      "args": ["@cloudbase/cloudbase-mcp@latest"],
6      "env": {
7        "INTEGRATION_IDE": "ClaudeCode"
8      }
9    }
10  }
11}

需要帮助？查看 Claude Code 文档

步骤 2：和 AI 对话

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

prompt

安装 CloudBase Skills：命令 npx skills add tencentcloudbase/cloudbase-skills -y

使用 CloudBase Skills：在 Web 应用中使用 CloudBase 关系型数据库 SDK 实现数据查询和操作

常见问题

Q: MCP 连接失败？ A: 检查 .mcp.json 文件格式是否正确，确认 npx 命令可用，重启 Claude Code 应用。

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

更多问题请查看：完整 FAQ

前置条件​

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

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