TCCLI 是什么
腾讯云命令行工具 TCCLI（Tencent Cloud Command Line Interface）是管理腾讯云资源的统一工具。通过 TCCLI，开发者可以在终端中直接调用腾讯云 API 来管理云产品，无需登录控制台。它特别适合自动化脚本、CI/CD 流水线和批量运维场景。
TCCLI 目前由 GitHub 开源维护（TencentCloud/tencentcloud-cli），基于 Python 开发，支持全平台运行。
快速安装与配置
安装 TCCLI
TCCLI 依赖 Python 2.7+ 和 pip 工具，安装命令在所有平台（Windows、macOS、Linux）上一致：
pip install tccli
安装后执行 tccli --version 验证是否成功。如果已有旧版本，pip 会自动处理依赖升级。macOS 用户也可通过 Homebrew 安装：
brew tap tencentcloud/tccli
brew install tccli
配置密钥
使用 TCCLI 前需要配置腾讯云 API 密钥。推荐使用交互式配置模式：
tccli configure
按提示输入 SecretId、SecretKey 和默认地域即可。也支持命令行模式用于自动化脚本，以及多账户配置方便在不同项目间切换。
基础使用
查询云服务器列表
tccli cvm DescribeInstances
输出格式
TCCLI 支持三种输出格式，通过 --output 参数切换：
- text —— 文本形式输出，每行一条记录、空格隔开，适合保存成文本文件
- JSON —— 结构化 JSON 输出，适合二次开发解析
- table —— 表格形式输出，可视化好，适合人工查看
查看帮助
tccli help # 查看所有支持的产品
tccli cvm help # 查看 CVM 产品的所有接口
tccli cvm DescribeInstances help --detail # 查看接口详细参数
高级功能
多账号管理
TCCLI 支持配置多个账号，通过 --profile 参数快速切换，适合同时管理多个腾讯云账号的场景。
结果过滤
使用 --filter 参数可以从 JSON 返回中提取特定字段，减少数据量：
tccli cvm DescribeInstances --filter "TotalCount"
结果轮询
某些异步操作（如开启云服务器）需要等待状态变更。TCCLI 的 --waiter 参数可以自动轮询，直到资源达到期望状态：
tccli cvm StartInstances --InstanceIds.0=ins-xxxxx --waiter InstanceRunning
通用参数
TCCLI 提供丰富的通用参数，包括认证参数（--secretId、--secretKey）、区域参数（--region）、网络代理（--https-proxy）、调试日志等。所有服务和接口均可使用这些参数。
应用场景
自动化运维
将 TCCLI 命令写入 Shell 脚本，实现定时备份、批量创建资源、日志采集等运维任务的自动化。例如，每天凌晨备份所有云硬盘：
tccli cbs DescribeDisks --output json | 解析提取硬盘ID → 创建快照
CI/CD 集成
在 Jenkins、GitLab CI 等流水线中使用 TCCLI 完成部署、回滚、环境创建等操作，配合 --output json 模式使输出机器可读。
多账户资源管理
通过 --profile 在不同腾讯云账号间切换，统一管理开发环境、测试环境和生产环境的云资源。
CloudBase CLI V3：面向 AI Agent 的命令行工具
除 TCCLI 外，腾讯云还有一个面向云开发场景的命令行工具 CloudBase CLI（命令名 tcb）。2026 年发布的 V3 版本专门为 AI Agent 做了重新设计：
- 15 个顶层命令模块：覆盖环境管理、云函数、数据库、静态托管、日志检索等全流程
- 自解释命令：所有命令内置
-h/--help，Agent 可自主发现命令功能 - 结构化输出：统一
--json模式，输出纯机器可读的结构化数据，配合 6 个结构化退出码 - 文档内查：
tcb docs命令直接在终端查询官方文档
安装方式：
npm install -g @cloudbase/cli
tcb login
TCCLI 与 CloudBase CLI 定位不同：前者面向全量云产品 API 调用，后者专注于云开发平台的应用全生命周期管理，两者可配合使用。
常见问题
提示错误码 10060 怎么办？
通常是网络连接问题，检查网络是否通畅，或使用 --https-proxy 配置代理。
接口鉴权如何实现？
TCCLI 支持多种鉴权方式：交互式配置、命令行传参、环境变量、CVM 角色授权等。生产环境推荐使用角色授权避免密钥泄露。