二、安装
npm i -g @cloudbase/cli
也可通过 yarn 或 pnpm 安装：
yarn global add @cloudbase/clipnpm add -g @cloudbase/cli
安装完成后，执行 tcb –version 验证安装。
更多请参考：安装文档
三、登录认证
·控制台授权（推荐）：tcb login，自动打开浏览器完成授权
·云 API 密钥授权：tcb login –key，按提示输入 SecretId 和 SecretKey
·CI 环境登录：tcb login –apiKeyId xxx –apiKey xxx
·临时密钥登录：tcb login –apiKeyId xxx –apiKey xxx –token xxx
更多请参考：登录方式
五、环境管理
管理云开发环境的完整生命周期，包括创建、切换、续费、销毁及资源用量查询。
·tcb env list — 查看环境列表
·tcb env use <envId> — 设置默认环境
·tcb env create — 创建环境
·tcb env info — 查看环境详情
·tcb env usage — 查询资源用量
·tcb env modify — 修改环境配置
·tcb env renew — 环境续费
·tcb env delete — 销毁环境
更多请参考：环境管理
六、云函数
部署和管理云函数，支持普通云函数和 HTTP 云函数。
·tcb fn deploy [name] — 部署云函数
·tcb fn deploy –httpFn — 部署为 HTTP 云函数
·tcb fn deploy –all — 部署全部云函数
·tcb fn list — 查看已部署的函数列表
更多请参考：部署云函数
七、数据库
管理文档型数据库和 MySQL 数据库，支持数据模型、索引和原生命令执行。
·tcb db model list — 查看数据模型列表
·tcb db model pull — 拉取数据模型到本地
·tcb db model push — 推送数据模型到云端
·tcb db nosql execute — 执行 NoSQL 命令
·tcb db mysql execute — 执行 MySQL 语句
八、云存储
管理云端文件，支持上传、下载、删除、复制和搜索。
·tcb storage upload — 上传文件
·tcb storage download — 下载文件
·tcb storage rm — 删除文件
·tcb storage cp — 复制或移动文件
·tcb storage list — 查看文件列表
·tcb storage search — 搜索文件
更多请参考：云存储
九、静态网站托管
部署和管理静态网站，适合纯静态内容的上传与同步。如项目包含构建步骤（React/Vue 等），建议使用 tcb app deploy。
·tcb hosting deploy — 部署静态文件
·tcb hosting list — 查看文件列表
·tcb hosting delete — 删除文件
更多请参考：静态网站托管
十、云应用
管理前端应用部署，支持自动构建。
·tcb app deploy — 部署云应用
·tcb app list — 获取部署云应用列表
·tcb app info — 获取云应用部署详情
·tcb app versions list — 查看应用版本历史列表
·tcb app versions detail — 查看应用指定版本的详细信息，默认显示最新版本
·tcb app delete — 删除云应用
更多请参考：应用部署
十一、云托管
管理容器化部署的后端服务，支持函数型和容器型两种模式。
·tcb cloudrun init — 初始化项目
·tcb cloudrun deploy — 部署服务
·tcb cloudrun list — 查看服务列表
·tcb cloudrun delete — 删除服务
·tcb cloudrun traffic — 灰度流量分配与回滚
更多请参考：云托管部署
十二、HTTP 访问服务
管理 HTTP 访问服务的路由规则、自定义域名和安全域名（CORS）配置。
·tcb routes add — 添加路由规则
·tcb routes list — 查看路由列表
·tcb domains add — 绑定自定义域名
·tcb domains list — 查看域名列表
·tcb cors add — 添加安全域名
·tcb cors list — 查看安全域名列表
更多请参考：HTTP 服务路由管理
十三、权限管理
统一管理数据库集合、存储桶、SQL 表、云函数的访问权限。
·tcb permission set — 设置资源权限
·tcb permission list — 查看权限规则
十四、用户与角色
管理终端用户及角色。
·tcb user list — 查看用户列表
·tcb user create — 创建用户
·tcb role list — 查看角色列表
·tcb role update — 更新角色
十五、日志检索
统一检索云函数、云托管、数据库等资源的运行日志。
·tcb logs search — 搜索日志
更多请参考：日志检索
十六、AI 智能体
管理 AI Agent 相关能力。
·tcb agent — AI Agent 管理
十七、文档检索
在终端内直接检索和阅读 CloudBase 产品文档。
·tcb docs list — 列出所有文档模块
·tcb docs read — 读取指定文档
·tcb docs search — 关键词搜索文档
十八、通用 API 调用
在命令行中直接调用腾讯云 API，自动处理鉴权。
·tcb api <service> <action> — 调用腾讯云 API
更多请参考：通用云 API 调用
十九、配置文件
CLI 使用项目根目录下的 cloudbaserc.json 作为配置文件，用于定义环境、云函数、部署参数等。可通过 tcb init 初始化生成，也可通过 –config-file 指定自定义路径。
环境 ID 解析优先级：命令行 –env-id > 项目 cloudbaserc.json > tcb env use 全局设置。
更多请参考：配置文件
20、全局选项
以下选项适用于所有命令：
·–help — 查看命令帮助
·–env-id <envId> — 指定环境 ID
·–region <region> — 指定地域
·–json — 以 JSON 格式输出，便于脚本解析
·–yes — 跳过确认提示，适用于 CI/CD
·–verbose — 打印详细运行信息
·–config-file <path> — 指定配置文件路径
更多请参考：全局选项
21、注意事项
·V3 命令统一为空格分隔（如 tcb fn deploy），旧版冒号格式（如 tcb functions:deploy）仍兼容但不推荐
·子账号需在访问管理控制台关联 QcloudAccessForTCBRole 等预设策略后方可使用
·如终端无法直接访问公网，可通过 HTTP_PROXY 环境变量配置代理
·从旧版本升级请参考：从 v1/v2 升级到 v3