跳到主要内容

CloudBase AI Toolkit + OpenAI Codex CLI

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

GitHub Stars 开源协议

💡 为什么选择 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 开源项目

🔥 加入开源社区

GitHub CNB社区

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

🛠️ 故障排除

常见问题

Q: MCP 连接失败? A:

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

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

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

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

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

Q: 如何使用项目配置文件? A:

  1. 在项目根目录创建 .codex/config.toml 文件
  2. 启动时使用 codex --config .codex/config.toml
  3. 这样可以为不同项目使用不同的配置

更多问题请查看:完整 FAQ

📚 相关资源

💬 技术交流

微信技术交流群

微信群二维码
扫码加入微信技术交流群

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

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