OpenAI Codex CLI Setup Guide
After setup, you can operate CloudBase services directly from OpenAI Codex CLI’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 from the CLI 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)
Codex runs git clone to fetch the marketplace repository, so a machine without git fails with program not found:
git --version
On Windows, install Git for Windows. After installing, quit Codex completely and reopen it so the new process picks up the updated PATH.
The MCP configuration approach (Method 2) does not require Git.
Method 1: Install via Plugin Marketplace (Recommended)
The plugin marketplace installs both MCP tools and AI Skills. You can also install from the Codex App UI.
Add the CloudBase plugin marketplace and install the plugin via the Codex App graphical interface.
Click the + button in the top-right corner of Codex App.
Select Add Plugin Marketplace from the menu.
Enter the following information in the dialog:
TencentCloudBase/CloudBase-MCPmainOnce added, find the Tencent CloudBase marketplace in the plugin list.
Click the install button next to the cloudbase plugin.
After installation, start a new Codex thread to let the plugin, skills, and MCP tools fully load.
After the plugin updates to a new version, remove and reinstall it once — refreshing the marketplace does not replace the copy that is already installed.
Method 2: Connect via MCP Configuration
If you only need MCP tool connectivity, you can also configure it manually:
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
Prerequisite: install the CloudBase MCP tool globally first:
npm i @cloudbase/cloudbase-mcp -gThen run the command for your platform:
MacOS, Linux, WSL:
codex mcp add cloudbase --env INTEGRATION_IDE=CodeX -- cloudbase-mcpWindows Powershell:
codex mcp add cloudbase --env INTEGRATION_IDE=CodeX -- cmd /c cloudbase-mcpStep 2: Chat with AI
Enter the following in your AI chat in order:
Read https://docs.cloudbase.net/skill.md and tell me what it can doUse CloudBase Skills: 在 CI 脚本里用 CloudBase CLI 完成一次批量部署发布FAQ
Q: Connection keeps failing with ENOTEMPTY?
A: Leftover files in the local npx cache. Fully quit the AI tool, run the cleanup commands in the FAQ, then reconnect.
Q: Adding the plugin marketplace fails with failed to run git clone ... program not found?
A: Codex uses git clone to fetch the marketplace repository, and no usable git was found on this machine. Install Git for Windows, then quit and reopen Codex.
Q: MCP connection failed? A: Confirm the command runs correctly, restart OpenAI Codex CLI, and check your network.
Q: Tool count shows 0? A: See the FAQ.
More questions: Full FAQ