安装

CloudBase CLI 是云开发官方提供的命令行工具，帮助您快速管理和部署云开发资源

安装 CLI

使用您熟悉的包管理工具，全局安装 CloudBase CLI：

npm

npm i -g @cloudbase/cli

# 如果安装过程中遇到网络超时错误（如 `ETIMEOUT`、`network request failed` 等），可以临时指定腾讯云 npm 镜像源
npm i -g @cloudbase/cli --registry=http://mirrors.cloud.tencent.com/npm/

yarn

yarn global add @cloudbase/cli

# 如果安装过程中遇到网络超时错误（如 `ETIMEOUT`、`network request failed` 等），可以临时指定腾讯云 npm 镜像源
yarn global add @cloudbase/cli --registry=http://mirrors.cloud.tencent.com/npm/

pnpm

pnpm add -g @cloudbase/cli

# 如果安装过程中遇到网络超时错误（如 `ETIMEOUT`、`network request failed` 等），可以临时指定腾讯云 npm 镜像源
pnpm add -g @cloudbase/cli --registry=http://mirrors.cloud.tencent.com/npm/

登录认证

安装完成后，运行以下命令登录：

tcb login

CLI 会自动打开云开发控制台获取授权。在浏览器中点击同意授权按钮即可完成登录。

设备码登录

在 Agent、远程服务器、容器、无头环境等无法直接打开浏览器的环境中，tcb login 会自动使用设备码授权流程：

1. 执行 tcb login 后，CLI 会输出一个授权链接（verification_uri）和用户码（user_code）
2. 在任意可访问浏览器的设备上，打开授权链接，输入用户码并完成授权确认
3. CLI 自动轮询授权状态，完成登录后保存本地登录态

💡 该流程适用于 AI 编程助手（如 Claude Code、OpenAI Codex）通过 MCP 工具或脚本调用 CloudBase CLI 的场景。

其他登录方式

云 API 密钥授权

适合需要更高权限控制的场景：

tcb login --key

按提示输入云 API 密钥的 SecretId 和 SecretKey 即可完成登录。

⚠️ 安全提示：腾讯云 API 密钥可以操作您名下的所有腾讯云资源，请妥善保存和定期更换密钥。更换密钥后，请及时删除旧密钥。

获取密钥：前往 云 API 密钥管理 页面创建或查看密钥。

CI 环境登录

适合在持续集成（CI/CD）环境中使用，无需交互式输入：

tcb login --apiKeyId xxx --apiKey xxx

临时密钥登录

适合敏感场景，使用短期有效的临时密钥：

tcb login --apiKeyId xxx --apiKey xxx --token xxx

💡 提示：临时密钥具有时效性，过期后需要重新获取。

自定义 Endpoint

适合企业用户自建授权服务，将 CLI 的登录认证指向私有 Device Flow 授权端点：

tcb login --endpoint https://your-auth-server.example.com

CLI 将使用指定的 Endpoint 完成授权流程，依次调用 /device/code 和 /token 接口获取凭证。

💡 提示：该选项仅在 flow=device 时生效。自建授权服务需遵循 CloudBase CLI Device Flow 协议规范，详见 设备码授权概览 和 企业自建设备码授权服务对接 CloudBase CLI。

开始使用

登录完成后即可开始使用 CloudBase CLI

AI 辅助开发

使用 AI 功能快速开发云开发应用：

tcb ai

查看所有命令

查看 CLI 支持的完整命令列表：

tcb -h

子账号授权

如果您需要使用腾讯云子账号访问云开发资源，需要主账号先为子账号授予相应权限。

授权步骤

1. 登录 腾讯云访问管理控制台
2. 在左侧菜单选择用户 > 用户列表
3. 点击新建用户按钮
4. 填写用户信息并完成创建
5. 在策略列表中选择 TCB 预设授权策略
6. 点击完成，完成子账号创建

💡 提示：您也可以为已有子账号关联策略，具体操作请参见 授权管理 文档。

可用的预设策略

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 等），使代理配置在每次打开终端时自动生效。