Skip to main content

Claude Code Setup Guide

Claude Code can install the CloudBase plugin from the plugin marketplace to get MCP tool connectivity and AI Skills in one go, or connect manually via MCP configuration. The plugin marketplace approach is recommended.

After setup, you can operate CloudBase services directly from Claude Code’s chat.

Examples:

  • "Build a WeChat Mini Program ordering system with CloudBase" — AI scaffolds pages, creates the cloud database, writes cloud functions, and guides preview
  • "Build a reservation management system that lets users place orders and admins update status" — AI models it with CloudBase PostgreSQL, configures permissions, and wires up frontend and backend
  • "Add phone-number login to a Web app" — AI enables the auth method and integrates the CloudBase SDK

No need to switch to the Cloud console — you can do everything in Claude Code with natural language.

Prerequisites​

Before you start, make sure you have:

Node.js and a CloudBase environment ready

Node.js: Install Node.js v18.15.0 or later:

node --version

If you don’t have it installed, download it from the Node.js website.

CloudBase environment: See Create a CloudBase environment. New users on the domestic site can start for free.

Git installed (required for the plugin marketplace)

Adding the marketplace makes Claude Code run git clone to fetch the marketplace repository, so a machine without git fails outright (on Windows the usual error is program not found):

git --version

On Windows, install Git for Windows. After installing, reopen your terminal or Claude Code so the new process picks up the updated PATH.

The MCP configuration approach (Method 2) does not require Git.

The plugin marketplace installs both MCP tools and AI Skills — one installation provides full capabilities.

Claude Code can install plugins from a marketplace. After installation, MCP connections and Skills are available automatically:

# Add the CloudBase plugin marketplace
claude plugin marketplace add TencentCloudBase/CloudBase-MCP

# Install the CloudBase plugin
claude plugin install cloudbase@tencent-cloudbase

After installation, run /reload-plugins in Claude Code to activate the plugin. Default --scope user makes it globally available; use --scope project to share within a team.

Method 2: Connect via MCP Configuration​

If you only need MCP tool connectivity, you can also configure it manually:

Client
Connection
Site

Remote needs only a URL — your client walks you through browser authorization, so no keys land in config files.

Configure your AI tool to connect with CloudBase capabilities. Supports local and remote connection. See connection modes.

Step 1: Install / Configure CloudBase

Or add this configuration to .mcp.json:

json
1{
2  "mcpServers": {
3    "cloudbase": {
4      "type": "http",
5      "url": "https://tcb-api.cloud.tencent.com/mcp/v1"
6    }
7  }
8}
Need help?View Claude Code docs

Step 2: Chat with AI

Enter the following in your AI chat in order:

prompt
Read https://docs.cloudbase.net/skill.md and tell me what it can do
Use CloudBase Skills: 更新 CloudBase 云函数的环境变量

FAQ​

Q: Adding the plugin marketplace fails with program not found? A: No usable git was found on the machine. Install Git for Windows, reopen your terminal, then run claude plugin marketplace add again.

Q: MCP connection failed? A: Check your .mcp.json format, ensure npx is available, and restart Claude Code.

Q: Tool count shows 0? A: See the FAQ.

More questions: Full FAQ

相关资源