CloudBase AI CLI 使用文档
简介
CloudBase AI CLI 是一个集成多种主流 AI 编程工具的统一命令行工具，支持内置模型和自定义模型
让你能够通过一个简单的命令使用 CodeBuddy Code、Claude Code、OpenAI Codex、aider、Qwen Code 等 AI 编程助手
同时内置CloudBase MCP，支持从开发到部署的完整流程，支持在任意环境中运行
核心优势
- 🏗️ 统一管理 - 一个命令管理多种 AI 编程 CLI 工具，无需在多个工具间切换
- 🤖 多模型支持 - 支持内置和自定义各种大模型，包括 Kimi K2、智谱 GLM-4.5 等
- 🚀 一键开发部署 - 从代码生成到云端部署的完整流程，支持 Web 应用、小程序、后端服务
- 🌍 无处不在 - 可在任意环境中运行，包括小程序开发者工具、VS Code、GitHub Actions 等
应用场景
快速开始
1. 安装
使用 npm/yarn/pnpm 安装：
npm i -g @cloudbase/cli
或者使用 Yarn 1.x :
yarn global add @cloudbase/cli
或者 Pnpm:
pnpm add -g @cloudbase/cli
如果访问官方 npm 源有问题，一般安装过程中报类似 "ETIMEOUT"、"npm ERR! network request to https://registry.npmjs.org/@cloudbase%2fcli failed" 这种错误，这个时候需要临时指定一个国内 npm 镜像源：
npm i -g @cloudbase/cli --registry=http://mirrors.cloud.tencent.com/npm/
yarn global add @cloudbase/cli --registry=http://mirrors.cloud.tencent.com/npm/
2. 初始化 AI 配置
使用终端运行 CloudBase AI CLI:
# 启动配置向导
tcb ai
首次启动（未检测到 AI 配置）时，配置向导会引导你完成：
- 选择默认 AI 工具
- 完成该 AI 工具的配置（如云开发一键登录或自定义 API）
- 可选配置 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：非交互模式，自动使用默认选项
aider原生不支持 MCP，执行--setup时会自动跳过 MCP 步骤，仅安装 Skill。
3. 开始体验
tcb ai
# 或预设提示词
tcb ai -- "帮我创建一个订单管理系统"
# 或使用非交互式模式
tcb ai -- -p "你好"
# 查看所有可用命令
tcb ai --help
详细开发指引
参考详细教程： 用 CloudBase AI CLI 开发邻里闲置物品循环利用小程序
到处皆可运行，从代码生成到云端部署！
无需 API Key，新环境赠送 100 万 token，支持 DeepSeek、Kimi K2 等主流模型快速体验。
工作原理
详细使用说明
启动 AI 工具
# 使用默认配置的 AI 工具
tcb ai
# 指定 AI 工具
tcb ai -a codebuddy
tcb ai -a claude
tcb ai -a codex
tcb ai -a aider
tcb ai -a qwen
参数透传
使用 -- 分隔符将参数直接传递给目标 AI 工具：
# 传递参数给 CodeBuddy
tcb ai -a codebuddy -- --mcp-server "config.json"
# 传递参数给 Claude
tcb ai -a claude -- -p hi
# 相当于运行 codebuddy --mcp-server "config.json" 或 claude -p hi
指定模板
在 AI 开发时直接指定模板：
# 使用 AI 命令并下载模板
tcb ai --template rules
tcb ai --template miniprogram
tcb ai --template react
支持的模板
miniprogram- 微信小程序 + CloudBasereact- Web 应用 - React + CloudBasevue- Web 应用 - Vue + CloudBaseuniapp- 跨端应用 - UniApp + CloudBaserules- AI 规则和配置none- 不下载任何模板
查看当前配置
tcb ai --config
重新配置
# 重置所有配置
tcb ai --reset
# 运行配置向导
tcb ai --setup
支持的 AI 工具
| AI 工具 | 命令参数 |
|---|---|
| CodeBuddy Code | -a codebuddy |
| Claude Code | -a claude |
| Openai Codex | -a codex |
| aider | -a aider |
| Qwen Code | -a qwen |
获取帮助
命令行帮助
# 查看命令帮助
tcb ai --help
常见问题
遇到问题？查看 CloudBase CLI 常见问题解答 获取详细帮助。
技术支持
- 帮助中心：https://tcb.cloud.tencent.com/help-center - 在线咨询、工单系统、技术文档
- 官方文档：https://docs.cloudbase.net - 完整的产品文档和使用指南
- GitHub 仓库：CloudBase-AI-ToolKit - 开源代码和问题反馈
🔥 微信交流群
遇到问题或想要交流经验？加入我们的技术社区！
扫码加入微信技术交流群
为什么选择 CLI？
CLI 让 AI 编程能力变成可编程的基础设施，可以被脚本、自动化流程、CI/CD 系统调用，无需在多个 GUI 工具间切换，可以集成到现有开发工作流中
同时支持云原生开发、容器化部署、持续集成/持续部署（CI/CD），推动 AI 从"生成代码"到"全流程协作"的进化
配置说明
当前 CloudBase AI CLI 支持以下 AI 工具的配置：
- CodeBuddy Code
- Claude Code
- Openai Codex
- aider
- Qwen Code
所有工具都支持两种配置方式：
- 配置自定义的 LLM：通常需要配置自己的 API KEY 和对应的 Base URL
- 配置云开发环境中的 LLM：无需自行配置 API KEY，只需按照命令行提示登录并选择云开发环境即可
| AI 工具 | 自定义配置要求 | 云开发环境配置 | 相关文档 |
|---|---|---|---|
| CodeBuddy Code | - API KEY - 支持 OAuth 身份验证 - MCP 服务器配置 - 环境变量配置 | ✨ 一键登录，自动配置 | 配置文档 |
| Claude Code | - Base URL - API KEY - 需要配置为 Anthropic 兼容的模型 - 支持配置 Kimi-K2、智谱 GLM-4.5 | ✨ 一键登录，自动配置 | 配置文档 |
| OpenAI Codex | - Base URL - API KEY - 模型名称 - 需要配置为 OpenAI 兼容的模型 | ✨ 一键登录，自动配置 | 配置文档 |
| aider | - Base URL - API KEY - 模型名称 - 需要配置为 OpenAI 兼容的模型 | ✨ 一键登录，自动配置 | 配置文档 |
| Qwen Code | - Base URL - API KEY - 模型名称 - 需要配置为 OpenAI 兼容的模型 | ✨ 一键登录，自动配置 | 配置文档 |