安装
CloudBase CLI 是云开发官方提供的命令行工具，帮助您快速管理和部署云开发资源
安装 CLI
使用您熟悉的包管理工具，全局安装 CloudBase CLI：
- npm
- yarn
- pnpm
npm i -g @cloudbase/cli
yarn global add @cloudbase/cli
pnpm add -g @cloudbase/cli
安装问题排查
如果安装过程中遇到网络超时错误（如 ETIMEOUT、network request failed 等），可以临时指定腾讯云 npm 镜像源：
- npm
- yarn
npm i -g @cloudbase/cli --registry=http://mirrors.cloud.tencent.com/npm/
yarn global add @cloudbase/cli --registry=http://mirrors.cloud.tencent.com/npm/
登录认证
安装完成后，您需要登录才能使用 CloudBase CLI。根据使用场景选择合适的登录方式：
- 云开发控制台授权
- 云 API 密钥授权
- CI 环境登录
- 临时密钥登录
💡 推荐方式，适合个人开发者日常使用：
tcb login
CLI 会自动打开云开发控制台获取授权。在浏览器中点击同意授权按钮即可完成登录。
💡 提示：如果浏览器未自动打开，请手动复制终端中显示的授权链接到浏览器访问。
适合需要更高权限控制的场景：
tcb login --key
按提示输入云 API 密钥的 SecretId 和 SecretKey 即可完成登录。
⚠️ 安全提示：腾讯云 API 密钥可以操作您名下的所有腾讯云资源，请妥善保存和定期更换密钥。更换密钥后，请及时删除旧密钥。
获取密钥：前往 云 API 密钥管理 页面创建或查看密钥。
适合在持续集成（CI/CD）环境中使用，无需交互式输入：
tcb login --apiKeyId xxx --apiKey xxx
适合敏感场景，使用短期有效的临时密钥：
tcb login --apiKeyId xxx --apiKey xxx --token xxx
💡 提示：临时密钥具有时效性，过期后需要重新获取。
开始使用
登录完成后即可开始使用 CloudBase CLI
AI 辅助开发
使用 AI 功能快速开发云开发应用：
tcb ai
查看所有命令
查看 CLI 支持的完整命令列表：
tcb -h
子账号授权
如果您需要使用腾讯云子账号访问云开发资源，需要主账号先为子账号授予相应权限。
授权步骤
- 登录 腾讯云访问管理控制台
- 在左侧菜单选择用户 > 用户列表
- 点击新建用户按钮
- 填写用户信息并完成创建
- 在策略列表中选择 TCB 预设授权策略
- 点击完成，完成子账号创建
💡 提示：您也可以为已有子账号关联策略，具体操作请参见 授权管理 文档。
可用的预设策略
CloudBase 提供以下预设策略供您选择：
| 策略名称 | 说明 |
|---|---|
QcloudAccessForTCBRole | 授予云开发对云资源的访问权限 |
QcloudAccessForTCBRoleInAccessCloudBaseRun | 授予云开发访问 VPC、CVM 等云服务资源的权限（用于云托管） |
上述策略包含对象存储、云函数、日志、监控、VPC 等资源的全读写权限。授予子账号这些策略后，子账号将拥有这些资源的完全控制权，并自动获得后续新增资源的访问权限。请谨慎授权。
CLI 登录相关策略
如需子账号使用 CLI 工具的网页授权登录方式，需要额外授予 CAM 只读权限：
| 策略名称 | 说明 |
|---|---|
QcloudCamReadOnlyAccess | 授予访问管理（CAM）只读访问权限 |
💡 提示：如果未授予此策略，子账号只能使用 API 密钥方式登录 CLI。
高级配置
配置网络代理
如果您的终端无法直接访问公网，可以通过设置 HTTP 代理使 CLI 正常工作。CLI 会自动读取 http_proxy 或 HTTP_PROXY 环境变量。
临时设置代理（当前终端会话有效）：
export HTTP_PROXY=http://127.0.0.1:8000
http://127.0.0.1:8000 仅为示例，请根据您的实际网络环境配置正确的代理地址和端口。
永久设置代理：
将上述命令添加到终端配置文件中（如 ~/.bashrc、~/.zshrc 等），使代理配置在每次打开终端时自动生效。