CloudBase AI Toolkit + OpenAI Codex CLI
💡 为什么选择 OpenAI Codex CLI + CloudBase AI Toolkit? OpenAI Codex CLI 是基于 OpenAI Codex 模型的命令行工具,支持 MCP (Model Context Protocol) 协议,具有强大的代码生成和理解能力。结合 CloudBase AI Toolkit,让你通过自然语言描述需求,AI 自动生成并部署全栈应用到腾讯云开发平台。特别适合命令行开发者和需要高效 AI 辅助开发的场景。
✨ 核心优势
🎯 开发效率 | ⚡ 部署速度 | 🛡️ 稳定可靠 |
---|---|---|
AI 自动生成代码和架构 内置云开发最佳实践规则 命令行高效交互方式 | 一键部署到腾讯云开发 国内 CDN 加速访问 Serverless 架构免运维 | 330万开发者验证的平台 企业级安全和稳定性 完善的监控和日志系统 |
🚀 5分钟快速开始
方式一:使用项目模板(推荐)
选择预配置的项目模板,开箱即用:
方式二:现有项目集成
如果你已有项目,只需 3 步集成:
# 1. 安装 OpenAI Codex CLI
# 2. 配置 MCP(具体配置见下方详细步骤)
# 3. 启动 Codex CLI 并开始使用
配置完成后,对 AI 说:"登录云开发" 即可开始!
🔧 详细配置指南
步骤 1:安装 OpenAI Codex CLI
npm install -g @openai/codex
步骤 2:配置 CloudBase MCP
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,有两种配置方式:
方式一:使用项目配置文件(推荐)
在项目根目录创建 .codex/config.toml
文件:
[mcp_servers.cloudbase]
command = "npx"
args = ["-y", "@cloudbase/cloudbase-mcp@latest"]
然后启动时指定配置文件:
codex --config .codex/config.toml
方式二:全局配置
在用户主目录创建 ~/.codex/config.toml
文件:
[mcp_servers.cloudbase]
command = "npx"
args = ["-y", "@cloudbase/cloudbase-mcp@latest"]
步骤 3:启用 AI 规则
模板中已包含 AGENTS.md
文件,OpenAI Codex CLI 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则:
在当前项目中下载云开发 AI 规则
步骤 4:开始开发
启动 OpenAI Codex CLI:
codex
如果使用项目配置文件:
codex --config .codex/config.toml
在 Codex CLI 中与 AI 对话:
登录云开发
🎯 常用命令
配置完成后,就可以开始开发了,例如:
创建一个在线投票系统,支持创建投票、参与投票、结果统计,使用云数据库存储,最后部署
OpenAI Codex CLI 具有强大的代码理解能力,能够深度分析项目结构并生成高质量的代码。
🌟 CloudBase AI Toolkit 开源项目
🛠️ 故障排除
常见问题
Q: MCP 连接失败? A:
- 检查
.codex/config.toml
文件格式是否正确 - 确认 npx 命令可用:
npx --version
- 重启 Codex CLI 应用
- 检查网络连接状态
Q: 项目规则未生效? A:
- 确认
AGENTS.md
文件在项目根目录 - 检查文件内容格式是否正确
- 重新启动 Codex CLI
Q: AI 生成的代码不符合预期? A:
- 详细描述功能需求和技术要求
- 使用项目模板确保规范一致性
- 分模块逐步实现复杂项目
Q: 如何使用项目配置文件? A:
- 在项目根目录创建
.codex/config.toml
文件 - 启动时使用
codex --config .codex/config.toml
- 这样可以为不同项目使用不同的配置
更多问题请查看:完整 FAQ
📚 相关资源
- 📖 开发指南 - 深入了解开发最佳实践
- 🎯 使用案例 - 查看实际应用案例
- 🔧 MCP 工具 - 了解所有可用工具
- ❓ 常见问题 - 查看常见问题解答
- OpenAI Codex CLI 官方文档 - OpenAI Codex CLI 官方文档
💬 技术交流
微信技术交流群

扫码加入微信技术交流群