openai-codex-cli.md

CloudBase AI Toolkit + OpenAI Codex CLI

🚀 OpenAI Codex CLI + 云开发 = 几分钟内从想法到上线的全栈应用

💡 为什么选择 OpenAI Codex CLI + CloudBase AI Toolkit？
OpenAI Codex CLI 是一个强大的命令行 AI 编程工具，支持 MCP (Model Context Protocol) 集成。结合 CloudBase AI Toolkit，让你通过自然语言描述需求，AI 自动生成并部署全栈应用到腾讯云开发平台。特别适合需要命令行操作和自动化部署的开发者。

✨ 核心优势

🎯 开发效率	⚡ 部署速度	🛡️ 稳定可靠
AI 自动生成代码和架构 内置云开发最佳实践规则 智能错误修复和优化	一键部署到腾讯云开发 国内 CDN 加速访问 Serverless 架构免运维	330万开发者验证的平台 企业级安全和稳定性 完善的监控和日志系统

🚀 5分钟快速开始

方式一：使用项目模板（推荐）

选择预配置的项目模板，开箱即用：

📦 查看所有项目模板

方式二：现有项目集成

如果你已有项目，只需 3 步集成：

# 1. 配置 MCP（具体配置见下方详细步骤）
# 2. 下载 AI 规则
# 3. 开始使用

配置完成后，对 AI 说："登录云开发" 即可开始！

🔧 详细配置指南

步骤 1：安装 OpenAI Codex CLI

从 OpenAI Codex CLI 官网 下载并安装 OpenAI Codex CLI。

步骤 2：配置 CloudBase MCP

Tip

如果安装以后工具数量一直为 0，请参考常见问题

如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 ~/.codex/config.toml 文件中添加：

# IMPORTANT: the top-level key is `mcp_servers` rather than `mcpServers`.
[mcp_servers.cloudbase]
command = "npx"
args = ["-y", "@cloudbase/cloudbase-mcp@latest"]

步骤 3：启用 AI 规则

模板中已包含 CLAUDE.md 文件，OpenAI Codex CLI 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则：

在当前项目中下载云开发 AI 规则

步骤 4：开始开发

在 OpenAI Codex CLI 中与 AI 对话：

登录云开发

🎯 开始使用

配置完成后，对 AI 说：

登录云开发

然后就可以开始开发了，例如：

创建一个在线投票系统，支持创建投票、参与投票、结果统计，使用云数据库存储，最后部署

OpenAI Codex CLI 支持 MCP 协议，可以直接调用 CloudBase AI Toolkit 的所有工具来完成云开发相关操作。

🌟 CloudBase AI Toolkit 开源项目

🔥 加入开源社区

⭐ Star 项目 | 🤝 贡献代码 | 💬 技术交流

🛠️ 故障排除

常见问题

Q: MCP 连接失败？ A:

1. 检查 ~/.codex/config.toml 文件格式是否正确
2. 确认 npx 命令可用：npx --version
3. 重启 OpenAI Codex CLI
4. 检查网络连接状态

Q: 项目规则未生效？ A:

1. 确认 CLAUDE.md 文件在项目根目录
2. 检查文件内容格式是否正确
3. 重新加载项目或重启 OpenAI Codex CLI

Q: AI 生成的代码不符合预期？ A:

1. 详细描述功能需求和技术要求
2. 使用项目模板确保规范一致性
3. 分模块逐步实现复杂项目

更多问题请查看：完整 FAQ

📚 相关资源

• 📖 开发指南 - 深入了解开发最佳实践
• 🎯 使用案例 - 查看实际应用案例
• 🔧 MCP 工具 - 了解所有可用工具
• ❓ 常见问题 - 查看常见问题解答
• OpenAI Codex CLI 官方文档 - OpenAI Codex CLI 官方文档

💬 技术交流

微信技术交流群

扫码加入微信技术交流群

---

🚀 立即开始使用 OpenAI Codex CLI + CloudBase AI Toolkit

开始使用 | 查看模板 | GitHub 仓库