import IDESelector from '../components/IDESelector';
import RelatedResources from '../components/RelatedResources';

# Claude Code 配置指南

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

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

**例如：**

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

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

## 前置条件

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

<details>
<summary><strong>已准备好Node.js 环境和云开发环境</strong></summary>

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

```bash
node --version
```

如果未安装，请从 [Node.js 官网](https://nodejs.org/en/download) 下载安装。

**云开发环境：** 请参考文档 [开通云开发环境](../../quick-start/create-env)。新用户可以免费开通体验。

</details>

---

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

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

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

```bash
# 添加 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 工具连接，也可以手工配置：

<IDESelector defaultIDE="claude-code" showInstallButton={false} />

## 常见问题

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

**Q: 工具数量显示为 0？**
A: 请参考[常见问题](../faq#mcp-显示工具数量为-0-怎么办)。

更多问题请查看：[完整 FAQ](../faq)

<RelatedResources ideName="Claude Code" ideDocUrl="https://docs.anthropic.com/en/docs/claude-code/mcp#project-scope" />
