跳到主要内容

Claude Code 配置指南

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

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

例如：

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

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

前置条件​

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

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

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

node --version

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

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

已安装 Git（插件市场方式需要）

添加插件市场时，Claude Code 会用 git clone 拉取市场仓库；机器上找不到 git 会直接失败（Windows 常见报错 program not found）：

git --version

Windows 用户请安装 Git for Windows。安装后请重新打开终端或 Claude Code，新进程才会读到更新后的 PATH。

只做 MCP 配置（方式二）不需要 Git。

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

插件市场方式会同时安装 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.json:

json
1{
2  "mcpServers": {
3    "cloudbase": {
4      "type": "http",
5      "url": "https://tcb-api.cloud.tencent.com/mcp/v1"
6    }
7  }
8}
需要帮助？查看 Claude Code 文档

步骤 2：和 AI 对话

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

prompt
阅读 https://docs.cloudbase.net/skill.md，帮我介绍可以做什么
使用 CloudBase Skills： 配置 CloudBase 云函数的 HTTP 访问

常见问题​

Q: 添加插件市场时报 program not found？ A: 机器上没有可用的 git。安装 Git for Windows 后重新打开终端，再执行 claude plugin marketplace add。

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

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

更多问题请查看：完整 FAQ

相关资源