Skip to main content
开始使用

安装与鉴权

安装百炼 CLI 与 Skills，完成鉴权配置并校验。

本页介绍如何安装百炼 CLI、安装配套 Skills，以及完成鉴权配置。

前置条件

  • 能访问网络（npm registry 或 bailian.aliyun.com，取决于下方选择的安装方式）。
  • 若选择 npm 安装：Node.js ≥ 18.17.0（执行 node -v 确认）与 npm（执行 npm -v 确认）。若本机没有 Node.js 或版本过低，可直接用下方的二进制安装脚本，无需装 Node。

安装 CLI

  • npm（已有 Node.js 环境）
  • 二进制脚本（无需 Node.js）
npm install -g bailian-cli
即使本机已安装 pnpm / yarn，安装 bailian-cli 时仍需使用 npm；不要改用 pnpm / yarn 安装 CLI。
安装成功后，PATH 中会新增两个命令：bl（短别名）与 bailian（全名）。校验： 
bl --version
which bl   # Windows 可用 where bl
后续可随时执行 bl update 检查并更新 CLI 到最新版本。
若提示 command not found，检查全局 bin 目录是否在 PATH 中：npm 安装执行 npm config get prefix，其下的 bin 目录需加入 PATH；二进制安装按脚本输出提示的路径加入 PATH。

安装 Skills

CLI 校验通过后，安装配套 Skills，让 Agent 具备完整的百炼能力调度。首选内置的一键安装命令： 
bl skill init
该命令一次装齐 registry 中全部 bailian-* Skills（含共享协议 bailian-protocol），是官方推荐的安装方式。如需更细粒度地按需安装（例如只装某一个 Skill），可改用降级方案： 
npx skills add modelstudioai/cli --all -g

鉴权配置

安装后必须完成鉴权才能调用 API。根据环境选择下列任一方式。
  • 控制台登录（推荐）
  • 普通 API Key
  • Token Plan
  • AK/SK 临时令牌
  • 环境变量
适用于本机交互式安装，无需手动复制 API Key。命令会拉起浏览器完成阿里云控制台登录授权：
bl auth login --console
此方式同时打通 app list、usage free 等控制台能力，并自动配置 API Key 调用所需的鉴权信息。

校验配置

登录命令本身已完成可用性测试，通过后只需确认配置状态： 
bl auth status --output json
无需再执行重复的模型调用测试。若登录失败，可根据输出中的 hint 或 message 排查（网络、Key 无效、base_url 等）。
汇报鉴权状态时只使用 masked 字段，切勿回显完整 API Key，也不要把真实 Key 写入仓库、日志或聊天记录的可公开部分。

退出登录

需要清除本地凭证、退出登录状态时，执行： 
bl auth logout

常见问题

全局 bin 目录不在 PATH 中。执行 npm config get prefix，将其下的 bin 目录加入 PATH 后重试。
Node.js 版本过低。升级到 ≥ 18.17.0 后重新安装。
未登录或 API Key 无效。按 Key 类型重新执行对应的登录命令（普通 API Key 或 Token Plan）。
需配置镜像或代理。配置 registry 或代理后再安装。
改用二进制安装脚本（无需 Node.js/npm）：curl -fsSL https://bailian.aliyun.com/cli/install.sh | bash；也可以先安装或修复 npm 再用 npm install -g bailian-cli，但不要改用 pnpm / yarn 安装 CLI。
开始使用
能力参考
更新日志