Claude Code Skill对接RDS AI助手-云数据库 RDS(RDS)-阿里云帮助中心

本文指导用户如何配置Claude Skill以集成阿里云RDS AI助手，从而实现在Claude中通过自然语言直接管理数据库。

背景信息

云数据库RDS AI助手（RDS Copilot）是阿里云提供的一款智能化数据库服务。为提升开发与运维效率，可将RDS Copilot的能力通过Claude Skill进行集成。集成后，即可在Claude对话界面中，通过自然语言调用RDS Copilot，执行SQL优化、实例诊断、性能分析及数据查询等多种数据库管理任务。

以下内容将指导如何在本地环境中配置Claude Skill，实现与阿里云RDS AI助手的联动。

前提条件

已开通云数据库RDS AI助手专业版。
已创建并获取AccessKey ID和AccessKey Secret。为安全起见，建议使用RAM用户的AccessKey。具体操作，请参见查看RAM用户的AccessKey信息。
本地开发环境已安装uv。若未安装，请执行以下命令进行安装：
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```

操作步骤

步骤一：克隆项目仓库

执行以下命令，将RDS Copilot Claude Skill的项目仓库克隆到本地。

git clone https://github.com/aliyun/alibabacloud-rds-openapi-mcp-server
cd alibabacloud-rds-openapi-mcp-server/skill

步骤二：配置环境变量

为了让Skill能够调用阿里云的API，您需要配置访问凭证作为环境变量。

说明

请将命令中的 your-access-key-id 和 your-access-key-secret 替换为您自己的AccessKey ID和AccessKey Secret。

在macOS或Linux系统下

export ALIBABA_CLOUD_ACCESS_KEY_ID="your-access-key-id"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="your-access-key-secret"

在Windows系统（PowerShell）下

$env:ALIBABA_CLOUD_ACCESS_KEY_ID="your-access-key-id"
$env:ALIBABA_CLOUD_ACCESS_KEY_SECRET="your-access-key-secret"

为了方便长期使用，建议您将以上export或$env命令添加到您终端的配置文件中（如 ~/.bashrc、~/.zshrc 或Windows的环境变量设置），使其永久生效。

步骤三：部署Skill至Claude

将Skill文件部署到Claude指定的技能目录中。

在macOS或Linux系统下

# 1. 创建Claude的技能目录（如果不存在）
mkdir -p ~/.claude/skills/
# 2. 将Skill文件复制到该目录
cp -r alibabacloud-rds-copilot ~/.claude/skills/

在Windows系统（PowerShell）下

# 1. 创建Claude的技能目录（如果不存在）
New-Item -ItemType Directory -Path "$env:USERPROFILE\.claude\skills\" -Force
# 2. 将Skill文件复制到该目录
Copy-Item -Recurse ".claude\skills\aliyun-rds-copilot" "$env:USERPROFILE\.claude\skills\"

结果验证

完成部署后，启动Claude并验证Skill是否成功加载。

在终端中启动Claude。
```
claude
```
启动后，Claude应能自动识别并加载 alibabacloud-rds-copilot Skill。
在Claude对话框中，输入测试指令，例如查询您在华东1（杭州）地域的RDS实例列表。
```
/alibabacloud-rds-copilot 我在杭州有多少实例？
```

查看返回结果。如果配置成功，您将看到类似如下的输出：

[查询] 查询杭州地域的 RDS 实例列表
[地域] cn-hangzhou | [语言] zh-CN
============================================================
[RDS Copilot 回答]
<RDS Copilot 的实际回答内容>

[会话ID] conv-xxxx-xxxx-xxxx

看到 [RDS Copilot 回答] 部分包含您的真实实例信息，即表示集成成功。

如何使用

安装并验证成功后，您可以在Claude对话中通过自然语言向RDS AI助手提问，以执行数据库管理任务。

示例1：查询实例信息

你：查询杭州地域有哪些 MySQL 实例？
Claude：[调用 RDS Copilot 并返回结果]

示例2：进行SQL优化

你：针对实例 rm-bp1xxxxxxxxxxxx，帮我分析和优化这条 SQL：SELECT * FROM users WHERE status=1 ORDER BY created_at
Claude：[调用 RDS Copilot 获取 SQL 优化建议]

常见问题

1. 提示“未找到阿里云访问凭证”

问题现象：执行时出现类似如下错误。

未找到阿里云访问凭证。请设置环境变量:
  ALIBABA_CLOUD_ACCESS_KEY_ID
  ALIBABA_CLOUD_ACCESS_KEY_SECRET

解决方案：
1. 请检查您的环境变量名称是否正确拼写。
2. 请确认您已按照步骤二：配置环境变量中的指引，在当前终端会话中正确设置了ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
3. 如果是新打开的终端窗口，请重新设置环境变量或检查您的shell配置文件是否生效。

2. Claude启动后未识别或加载Skill

问题现象：在Claude中无法找到或使用 alibabacloud-rds-copilot Skill。
解决方案：请按以下步骤排查：
1. 检查目录结构：请确认 alibabacloud-rds-copilot 文件夹已完整地复制到了正确的 ~/.claude/skills/ 目录下。
2. 检查核心文件：请确保 ~/.claude/skills/alibabacloud-rds-copilot/ 目录下存在 SKILL.md 文件，这是Claude识别Skill的入口文件。
3. 重启应用：完全退出并重新启动您的Claude应用，使其重新扫描技能目录。