跳到主要内容

Codex 配置指南

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

例如：

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

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

前置条件​

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

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

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

node --version

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

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

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

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

通过 Codex App 的图形界面添加 CloudBase 插件市场并安装插件。

1
打开插件目录

在 Codex App 中点击右上角的 + 按钮。

2
添加插件市场

在菜单中选择 添加插件市场。

3
填写市场信息

在弹窗中填写以下信息：

来源：TencentCloudBase/CloudBase-MCP
Git 引用：main
稀疏路径：留空
4
点击添加市场

添加成功后，在插件列表中找到 Tencent CloudBase 市场。

5
安装 CloudBase 插件

点击 cloudbase 插件旁的安装按钮。

6
新开线程验证

安装后建议新开一个 Codex 线程，让插件、技能和 MCP 工具完整加载。

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

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

Client

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

步骤 1：安装 / 配置 CloudBase

前置步骤：

bash
npm i @cloudbase/cloudbase-mcp -g

根据运行系统在终端中运行指令：

MacOS, Linux, WSL:

bash
codex mcp add cloudbase --env INTEGRATION_IDE=CodeX -- cloudbase-mcp

Windows Powershell:

bash
codex mcp add cloudbase --env INTEGRATION_IDE=CodeX -- cmd /c cloudbase-mcp
需要帮助？查看 OpenAI Codex CLI 文档

步骤 2：和 AI 对话

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

prompt
安装 CloudBase Skills：命令 npx skills add tencentcloudbase/cloudbase-skills -y
使用 CloudBase Skills： 更新 CloudBase 云函数的环境变量

常见问题​

Q: MCP 连接失败？ A: 检查命令是否正确执行，重启 Codex，确认网络连接正常。

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

更多问题请查看：完整 FAQ

相关资源