习惯了控制台点击的新用户,在资源多起来以后,会想用命令行批量查询或操作。腾讯云提供的命令行工具叫 TCCLI。大麦云建议先把“密钥放在哪里”想清楚再动手安装,下面按官方文档的顺序把安装、配置和验证说明一遍。
安装与版本确认
官方安装文档给出的方式是通过 Python 包管理器安装国际站对应的命令行包,安装完成后用查看版本的命令确认是否成功。国际站和国内站的安装包名称不同,需要按自己所用站点选择文档,不要混用。安装前建议准备一个独立的 Python 环境,避免与系统工具冲突。

配图为流程示意,非控制台截图或交易凭据。
配置凭证与默认地域
官方的配置文档说明,可以用交互方式配置,依次输入 SecretId、SecretKey 和默认地域;也可以用非交互方式一次性写入,字段包括 secretId、secretKey、region 和输出格式。配置完成后,工具会把配置保存在当前用户的本地配置目录中。
| 配置项 | 含义 | 建议 |
|---|---|---|
| secretId / secretKey | 调用 API 的身份凭证 | 使用子用户密钥,不使用主账号密钥 |
| region | 默认地域,例如 ap-guangzhou | 与实际资源所在地域一致 |
| output | 输出格式,常用 json | 脚本处理时保持 json |
| 配置文件权限 | 保存在本地 | 限制只有当前用户可读 |
| 多套凭证 | 区分不同环境 | 为测试与生产分别命名并核对当前使用的是哪一套 |
第一条命令选什么
建议第一条命令选择只读接口,比如查询实例列表或地域列表,确认密钥有效、地域正确、权限足够,再逐步尝试写操作。如果返回“无权限”,说明子用户的 CAM 策略还没有授予该接口,需要回到访问管理里补充,而不是换成权限更大的密钥。

配图为流程示意,非控制台截图或交易凭据。
示例:避免命令行误操作生产环境
一位开发者为测试账号和生产账号各配置一套凭证,并给每套凭证起了清晰的名字。每次执行变更前,他会先运行一条只读查询,看返回的实例是不是自己预期的环境。这样即使切换窗口,也不会把测试脚本跑到生产账号上。
命令行里的密钥会不会被泄露?
密钥存放在本机配置文件里,只要电脑被他人使用或配置文件被误上传,就有风险。建议限制文件权限,并不要把配置目录提交到代码仓库。
命令行工具要收费吗?
命令行工具本身是调用 API 的客户端,产生费用的是被调用的云产品。具体计费以对应产品的官方计费页面为准。
延伸阅读与办理
可继续阅读腾讯云开户后用 COS 托管静态网站:首页、404 与域名。需要办理时,先查看腾讯云开户服务说明,再通过大麦云咨询入口说明用途与待核对事项。
官方资料
腾讯云:安装 TCCLI;腾讯云:TCCLI 配置方法;腾讯云:子账号 API 密钥管理;腾讯云:定期轮换访问密钥的安全建议。资料核对日期:2026-11-06。文中清单为操作准备建议;产品条件、实际收费和可用功能以相应账号的官方页面及有效订单为准。
