从零到部署成功：我在本地 5 分钟完成 CloudBase AI CLI 安装的全记录（含踩坑提醒）

本文首发于「腾讯云开发者社区」，记录本人参加「腾讯 CloudBase AI CLI 体验官」活动时的完整安装流程、踩坑点与验证方法，供后续同学参考。

如果你也想应用这款工具，跟着本文一步步来，大概率一次通过！

一、为什么要装 CloudBase AI CLI？

官方一句话总结： “一条命令，把 AI 能力（LLM、Embedding、向量数据库）直接搬进你的云开发环境。”

对我个人来说最香的三点：

1. 本地一条命令即可调用混元、ChatGPT、Llama2 等多种模型；
2. 内置向量数据库，自动帮我做知识库索引；
3. 与 CloudBase 云托管、云函数打通，直接上线无服务器应用。

二、前置条件 checklist

三、5 步完成安装 & 部署

Step 1：一键安装 AI CLI

终端输入指令：npm install -g @cloudbase/ai-cli

验证：tcba -V （ 输出示例：@cloudbase/ai-cli/1.0.7 darwin-x64 node-v18.17.0）

Step 2：登录腾讯云

终端输入指令：Cloudbase login

浏览器会弹出授权页，扫码 -> 选择主账号 -> 允许。

⚠️ 踩坑提醒： 如果你用的是子账号，需要主账号在「访问管理 CAM」里授予 QcloudCloudBaseFullAccess 权限，否则会报 403 Unauthorized。

Step 3：创建或选择 CloudBasai-demo

cloudbase env:list

如果已有环境，记下 envId；如果没有，最简单的方式是控制台一键创建（按量付费，有免费额度）。

Step 4：初始化 AI 应用

tcba init ai-demo

cd ai-demo

目录结构长这样：

ai-demo
├── cloudbaserc.json   # 环境配置
├── src
│   ├── index.js       # 示例函数
│   └── prompt.txt     # 提示词模板
├── .env.example       # 环境变量模板
└── README.md

Step 5：部署到云端

tcba deploy --envId your-env-id

看到绿色 ✔ deploy success 即代表云端部署完成。

四、验证 AI 调用是否成功

官方提供了一个「一句话写诗」的示例函数。我们来本地调用：

tcba invoke --name poem --data '{"topic":"夏天的云"}'

返回示例：

{

"poem": "夏天的云是一封蓬松的信，\n风把心事吹成了棉花糖..."

}

如果能返回类似结果，说明 LLM、网络、权限链路全部 OK。

五、写在最后

整个流程我本地耗时 4 分 32 秒（iTerm2 + zsh + 100M 宽带）。

如果你遇到本文没覆盖的坑，欢迎留言；我会持续更新到评论区，互帮互助一起成长。

版权声明：本文为作者原创，遵循腾讯云开发者社区版权协议，转载请注明出处。