跳到主要内容

常见问题

基础使用​

无法登录，CLI 工具没有响应​

请检查您的终端能否访问网络。

云函数​

函数部署失败的常见原因​

  • package.json 中依赖不存在

AI CLI 相关​

什么是 CLI？为什么这很重要？​

CLI（命令行界面）是一种通过文本命令与计算机交互的接口方式。与图形用户界面（GUI）相比，CLI 提供了更直接、更高效的交互方式。

GUI vs CLI 的核心差异：

  • GUI：基于图形元素和鼠标操作，适合直观交互和可视化操作
  • CLI：基于文本命令和键盘输入，适合自动化、批处理和远程操作

CLI 的重要性在于：

  • 可编程性：让 AI 编程能力可以被脚本、CI/CD、自动化流程调用
  • 可集成性：可以嵌入到现有的开发工具链和工作流中
  • 可扩展性：不受 GUI 限制，可以在任何环境中运行
  • 效率提升：支持批量处理、远程操作和自动化工作流

CloudBase AI CLI 的价格是多少？​

CloudBase AI CLI 本身完全免费。新用户可获得丰富的免费体验额度：

云开发环境：

  • 云函数调用次数、数据库存储空间等基础服务免费额度
  • 详细定价请参考腾讯云开发官方定价页面

AI 模型体验：

  • 新环境赠送 100 万 token，支持 DeepSeek、Kimi K2 等主流模型快速体验
  • 支持用户自定义配置模型和 API Key
  • 可按需选择不同模型，灵活控制成本

付费服务：

  • 超出免费额度后按实际使用量计费
  • 支持多种付费方式，价格透明

CloudBase AI CLI 是如何工作的？​

CloudBase AI CLI 是一个统一的集成工具，不是独立的 AI 编程工具。它通过统一的命令行界面集成多种 AI 编程 CLI 工具，如 Claude Code、OpenAI Codex、aider、Qwen Code 等。开发者可以通过 tcb ai -a [工具名] 选择不同的 AI 工具，支持交互式对话和非交互式脚本模式。CLI 集成了腾讯云开发平台，支持一键开发部署生成的代码到云端，让 AI 编程能力真正成为可编程的基础设施。

应用场景包括：

  • 小程序开发者工具：在微信开发者工具中直接运行，实现小程序开发调试部署一体化
  • VS Code 终端：在 VS Code 集成终端中使用，与现有开发工作流无缝集成
  • GitHub Actions：在 CI/CD 流水线中自动执行，实现代码生成和部署的自动化
  • 任意终端环境：支持在服务器、容器、本地开发环境等任何地方运行

为什么现在 AI 编程工具都在推出 CLI 版本？​

这是一个重要的技术趋势，原因包括：

  1. 从"工具"到"基础设施"的转变：

    • 传统 AI 编程工具只是独立的应用程序
    • CLI 让 AI 编程能力变成可编程的基础设施
    • 可以被脚本、自动化流程、CI/CD 系统调用

  2. 提高开发效率：

    • 无需在多个 GUI 工具间切换
    • 支持批量处理和自动化
    • 可以集成到现有开发工作流中
    • 大幅减少编码量

  3. 适应现代开发环境：

    • 云原生开发、容器化部署
    • 远程开发、服务器环境
    • 持续集成/持续部署（CI/CD）
    • 推动 AI 从"生成代码"到"全流程协作"的进化

CLI 和 GUI 有什么区别？我应该选择哪个？​

两者各有优势，最佳实践是结合使用：

GUI（图形界面）的优势：

  • 直观的交互体验，适合探索和调试
  • 丰富的视觉反馈，便于理解复杂任务
  • 提高一次成功率，适合学习和实验

CLI（命令行界面）的价值：

  • 可编程和自动化，适合批处理和 CI/CD
  • 不受环境限制，可在任何地方运行
  • 结构化输出，便于集成到现有工作流

最佳实践：GUI 探索方案，CLI 固化流程。先用 GUI 工具探索和调试，找到最佳方案后，用 CLI 将流程固化和自动化。

我需要学习命令行才能使用 CloudBase AI CLI 吗？​

CloudBase AI CLI 设计为渐进式学习曲线：

基础使用（最小学习成本）：

# 安装
npm i @cloudbase/cli -g

# 启动 AI 助手
tcb ai

# 直接描述需求
tcb ai -- -p "帮我创建一个用户管理系统"

详细安装说明请参考 CloudBase CLI 安装文档。

高级功能（按需学习）：

  • 自动化脚本编写
  • CI/CD 集成
  • 批量处理
  • 自定义工作流

我们提供详细的技术文档和最佳实践指南，支持从入门到精通的完整学习路径。

我如何获得帮助和客户支持？​

我们提供多种支持渠道：

我在哪里可以下载 CloudBase AI CLI？​

CloudBase AI CLI 是免费工具，可以通过以下方式获取：

npm i @cloudbase/cli -g

详细安装方式和说明请参考：

CloudBase AI CLI 与 CloudBase AI Toolkit 的关系​

CloudBase AI CLI 内置了 CloudBase AI Toolkit 的全部功能，并提供了 CLI 形态的产品体验。如果你之前使用过 CloudBase AI Toolkit，可以继续使用，同时通过安装 CloudBase AI CLI 获得更强大的功能。CloudBase AI Toolkit 将继续维护，为需要轻量级集成的用户提供服务。

详细介绍可参考 CloudBase AI Toolkit 文档