本文介绍如何安装 ve、把它放入系统 PATH，并完成一次最小可用的 API 调用。
- Go 版本推荐使用 1.12+。
- 从 v1.0.20 开始，命令前缀由
volcengine-cli更新为ve。低版本不受影响；升级到 v1.0.20 及以后版本后，请同步更新脚本中的命令前缀。
CLI 已发布为 npm 包 @volcengine/cli。如果本机已有 Node.js >= 14，可以直接全局安装：
npm install -g @volcengine/cli安装后会提供 ve 命令入口：
ve version
ve --help如需升级到最新版本：
npm update -g @volcengine/cli- 打开 https://github.com/volcengine/volcengine-cli/releases 获取最新版本。
- 下载对应操作系统和架构的压缩包。
- 解压后得到
ve，Windows 下为ve.exe。
仓库提供 build.sh，可自动识别当前系统和架构，也支持显式指定目标平台。
# 按当前机器 OS 和架构编译
sh build.sh
# 指定 OS，架构仍自动探测
sh build.sh darwin
sh build.sh linux
sh build.sh windows
# 交叉编译，第二个参数指定架构：amd64 / arm64 / 386 / arm
sh build.sh linux amd64
# 查看帮助
sh build.sh -h构建产物为 ve，Windows 产物为 ve.exe。
通过 npm 全局安装时，npm 会把 ve 安装到全局 bin 目录；如果命令不可用，请检查 npm global bin 是否在 PATH 中：
npm bin -g通过 Release 或源码编译时，需要确保 ve 所在目录在系统 PATH 中。常见做法是复制到 /usr/local/bin：
sudo cp ve /usr/local/bin检查是否生效：
ve version
ve --help如果 /usr/local/bin 不在 $PATH 中，请按你的 shell 环境配置 PATH。
最直接的方式是创建一个 AK/SK profile：
ve configure set --profile default --region cn-beijing --access-key AK --secret-key SK也可以不写配置文件，临时使用环境变量：
export VOLCENGINE_ACCESS_KEY=AK
export VOLCENGINE_SECRET_KEY=SK
export VOLCENGINE_REGION=cn-beijing更多认证方式见 认证与登录。
查看支持的服务：
ve --help查看某个服务的接口：
ve ecs --help查看接口参数：
ve ecs DescribeRegions --help调用接口：
ve sts GetCallerIdentity临时指定 region：
ve sts GetCallerIdentity ---region cn-beijing---region 是 CLI 内部固定参数，和 API 参数的 --Param value 不冲突。更多调用示例见 使用指南。