CloudBase AI CLI 使用文档
简介
CloudBase AI CLI 是一个集成多种主流 AI 编程工具的统一命令行界面，让你能够通过一个简单的命令使用 Claude Code、OpenAI Codex、aider、Qwen Code 等 AI 编程助手，支持开发部署后端服务。
特性
- 🏗️ 全栈开发一体化 - 支持 Web 应用、小程序、数据库和后端服务的生成、部署与托管
- ✨ 统一配置管理 - 通过交互式命令行轻松管理和切换多种 AI Agent 配置
- 🤖 模型灵活配置 - 可选用内置 Kimi K2 模型或自定义接入其他模型
- 🔄 参数无缝透传 - 完全兼容原生 AI 工具的全部参数，灵活调用
- 🌍 环境变量智能管理 - 自动识别和配置 API Key 及相关环境变量
快速开始
0.环境准备
✅ Node.js v18.19.0+ 已安装
☁️ 开通云开发环境
访问 腾讯云开发控制台 开通环境，新用户可以免费开通体验。
🚀 可选：加速配置
设置 npm 镜像源（提高下载速度）：
npm config set registry https://mirrors.cloud.tencent.com/npm/
1. 安装 CloudBase CLI
使用终端输入以下命令安装 CloudBase AI CLI：
- Mac/Linux
- Windows
# 避免全局安装的权限问题
sudo chown -R $(whoami):$(id -gn) /usr/local/lib/node_modules /usr/local/bin /usr/local/share
sudo chown -R $(whoami):$(id -gn) ~/.npm ~/.npmrc
# 安装 CLoudBase CLI
npm install -g @cloudbase/cli
npm install -g @cloudbase/cli
2. 初始化 AI 配置
使用终端运行 CloudBase AI CLI:
# 启动配置向导
tcb ai
首次启动，配置向导会引导你完成：
- 选择 AI 工具
- 完成 AI 工具的配置
完成配置后，即可开始使用 AI 工具进行辅助开发,后续可以运行 tcb ai --setup 来切换工具和模型。
详细使用说明
基础命令
启动 AI 工具
# 使用默认配置的 AI 工具
tcb ai
# 指定 AI 工具
tcb ai -a claude
tcb ai -a codex
tcb ai -a aider
tcb ai -a qwen
参数透传
使用 -- 分隔符将参数直接传递给目标 AI 工具：
# 传递参数给 Claude
tcb ai -a claude -- -p hi
# 相当于运行 claude -p hi
配置管理
查看当前配置
tcb ai --config
重新配置
# 重置所有配置
tcb ai --reset
# 运行配置向导
tcb ai --setup
支持的 AI 工具
| AI 工具 | 命令参数 |
|---|---|
| Claude Code | -a claude |
| Openai Codex | -a codex |
| aider | -a aider |
| Qwen Code | -a qwen |
获取帮助
命令行帮助
# 查看命令帮助
tcb ai --help
配置说明
当前 CloudBase AI CLI 支持以下 AI 工具的配置：
- Claude Code
- Openai Codex
- aider
- Qwen Code
所有工具都支持两种配置方式：
- 配置自定义的 LLM：通常需要配置自己的 API KEY 和对应的 Base URL
- 配置云开发环境中的 LLM：无需自行配置 API KEY，只需按照命令行提示登录并选择云开发环境即可
| AI 工具 | 自定义配置要求 | 云开发环境配置 | 相关文档 |
|---|---|---|---|
| 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 兼容的模型 | ✨ 一键登录，自动配置 | 配置文档 |