@cloudbase/cli

CloudBase 命令行工具

CloudBase CLI 是一个开源的命令行界面交互工具，用于帮助用户快速、方便的部署项目，管理云开发资源。

主要功能

• 云开发资源管理：快速部署项目，管理云函数、数据库、存储等资源
• AI 开发助手：集成多种 AI 工具（Claude、Qwen、Codex、Aider 等），提升开发效率
• MCP 协议支持：内置 cloudbase-mcp 命令，支持 Model Context Protocol，无需额外安装
• 模板下载：提供多种项目模板，自动配置 IDE 和 MCP 环境

安装 CloudBase CLI

npm

npm install -g @cloudbase/cli

yarn

yarn global add @cloudbase/cli

安装完成后，你可以使用 cloudbase -v 验证是否安装成功，如果输出了类似下面的版本号，则表明 CloudBase CLI 被成功安装到您的计算机中。

2.7.8

可用命令

• cloudbase 或 tcb：主要的 CLI 命令
• cloudbase-mcp：内置的 MCP 服务器命令，支持 Model Context Protocol

CloudBase CLI 运行要求

Node.js 8.6.0+

文档

请访问教程与文档了解详细的使用方法。

退出码说明

CloudBase CLI 使用结构化退出码帮助 CI/CD 流水线和 AI Agent 精确处理错误：

退出码	含义	典型场景	应对策略
0	成功	命令正常执行	-
1	通用错误	未分类的异常	查看错误信息，手动排查
2	认证失败	未登录、token 过期、无权限	执行 tcb login 重新登录
3	参数错误	缺少必填参数、格式非法、枚举值错误	检查命令参数，参考 tcb <cmd> --help
4	资源不存在	环境 ID/函数名无效、集合不存在	确认资源名称，用 tcb env list / tcb fn list 验证
5	云 API 错误	CloudBase API 返回错误、网络超时	检查网络连接，查看 API 错误详情，必要时重试
6	本地文件错误	cloudbaserc.json 缺失/损坏、路径不存在	检查配置文件，用 tcb init 重新初始化

CI/CD 脚本示例：

# 根据退出码自动重试
tcb fn deploy || {
  code=$?
  case $code in
    2) echo "Auth failed, retrying..." && tcb login && tcb fn deploy ;;
    5) echo "API error, retrying in 30s..." && sleep 30 && tcb fn deploy ;;
    *) echo "Unrecoverable error (code $code)" && exit $code ;;
  esac
}

完整定义参见：src/exit-codes.ts

意见反馈

您可以到 GitHub Repo 新建一个 issue 反馈您在使用过程中遇到的问题或建议。