跳到主要内容

CloudBase CLI 配置指南

CloudBase CLI 是一个集成多种主流 AI 编程工具的统一命令行工具，支持项目级配置，同时内置了 CloudBase MCP 和 AI 开发规则。

核心优势：

  • 统一管理：一个命令管理多种 AI 编程 CLI 工具，无需在多个工具间切换
  • 内置 MCP 和规则：开箱即用，无需手动配置 MCP 服务器和 AI 规则
  • 项目级配置：支持项目级别的配置，团队协作更方便
  • 多模型支持：支持内置和自定义各种大模型，包括 Kimi K2、智谱 GLM-4.5 等

例如：

  • "用云开发做一个微信小程序点餐系统" - AI 搭页面、建云数据库、写云函数并引导预览
  • "做一个预约管理系统，支持用户下单和后台改状态" - AI 用 CloudBase PostgreSQL 建模、配权限并接好前后端
  • "给 Web 应用加上手机号登录" - AI 启用认证方式并接入 CloudBase SDK

无需切换到云控制台，所有操作都可以在命令行中用自然语言完成。

前置条件​

在开始配置之前，请确保满足以下条件：

已准备好Node.js 环境和云开发环境

Node.js 环境： 确保已安装 Node.js v18.15.0 或更高版本：

node --version

如果未安装，请从 Node.js 官网 下载安装。

云开发环境： 请参考文档 开通云开发环境。新用户可以免费开通体验。

安装 CloudBase CLI​

使用 npm/yarn/pnpm 全局安装：

npm i -g @cloudbase/cli

或者使用 Yarn 1.x：

yarn global add @cloudbase/cli

或者 Pnpm:

pnpm add -g @cloudbase/cli

如果访问官方 npm 源有问题，可以使用国内镜像源：

npm i -g @cloudbase/cli --registry=http://mirrors.cloud.tencent.com/npm/

初始化 AI 配置​

使用终端运行 CloudBase AI CLI：

# 启动配置向导
tcb ai

首次启动（未检测到 AI 配置）时，配置向导会引导你完成：

  • 选择默认 AI 工具（CodeBuddy Code、Claude Code、OpenAI Codex、aider、Qwen Code）
  • 完成该 AI 工具的配置（支持自定义 LLM 或使用云开发环境中的 LLM）
  • 可选配置 MCP / Skill

完成后即可开始使用 AI 工具进行辅助开发。后续可以运行 tcb ai --setup 重新配置当前工具，并按需更新默认工具、MCP / Skill 及配置范围（--scope project|global|custom）。

使用 --setup 一键配置 MCP 和 Skill​

tcb ai --setup 会在配置向导中自动完成 MCP 和 Skill 的安装与配置。

# 交互式配置（推荐）
tcb ai --setup

# CodeBuddy + 项目级
tcb ai --setup -a codebuddy --scope project -y

常用参数（用于 tcb ai --setup 配置 AI 工具、MCP 和 Skill）：

  • --setup：启动配置向导（配置 AI 工具、MCP 和 Skills）
  • -a, --agent <agent>：指定要配置的 AI 工具，可选 claude、qwen、codex、aider、codebuddy、cursor
  • --scope <scope>：指定 MCP/Skills 配置写入范围，可选 project、global、custom
  • --dir <dir>：指定 MCP/Skills 配置目录；当 --scope custom 时必填
  • -y, --yes：非交互模式，自动使用默认选项
Client

配置你的 AI 工具以连接 CloudBase 能力 支持本地与托管两种连接方式，详见 连接方式。

步骤 1：安装 / 配置 CloudBase

使用项目模板（推荐） - 模板已内置 MCP 配置和 AI 规则查看模板

安装 CloudBase CLI：

bash
npm i -g @cloudbase/cli

初始化配置：

bash
tcb ai

配置向导会引导你完成 AI 工具的配置。CloudBase CLI 内置了 MCP 和 AI 开发规则，无需手动配置。

开始使用：

bash
tcb ai
需要帮助？查看 CloudBase CLI 文档

步骤 2：和 AI 对话

在 AI 对话中依次输入以下内容:

prompt
安装 CloudBase Skills：命令 npx skills add tencentcloudbase/cloudbase-skills -y
使用 CloudBase Skills： 创建一个美观的登录页面，集成 CloudBase Auth

开始使用​

# 启动 AI 工具
tcb ai

# 或预设提示词
tcb ai -- "帮我创建一个订单管理系统"

# 或使用非交互式模式
tcb ai -- -p "你好"

# 查看所有可用命令
tcb ai --help

支持的 AI 工具​

CloudBase CLI 支持以下 AI 编程工具：

AI 工具命令参数
CodeBuddy Code-a codebuddy
Claude Code-a claude
OpenAI Codex-a codex
aider-a aider
Qwen Code-a qwen

项目级配置​

CloudBase CLI 支持项目级配置，配置文件会自动保存在项目根目录。这样可以让团队成员共享相同的配置，提升协作效率。

常见问题​

Q: 如何切换 AI 工具？ A: 运行 tcb ai --setup 重新运行配置向导，选择不同的 AI 工具。

Q: 如何查看当前配置？ A: 运行 tcb ai --config 查看当前配置信息。

Q: 如何重置配置？ A: 运行 tcb ai --reset 重置所有配置。

更多问题请查看：完整 FAQ

相关资源