手把手教你安装配置阿里云百炼CLI：全链路命令一站覆盖，轻松高效开发多模态AI应用

2026年10月12日10:01:43 发表评论

阿里云百炼 CLI（Bailian CLI）是专为 AI Agent 生态打造的命令行工具，旨在解决多模态 AI 任务运维碎片化、工具切换频繁及 Agent 接入难度高的问题。通过极简的安装与配置流程，开发者可将百炼平台的文本、图像、视频、语音、知识库检索等 10+ 项核心能力无缝集成至 Claude Code、Cursor、Qoder 等主流开发环境中，实现从模型调用、应用管理到记忆存储的全链路自动化调度。

以下是关于阿里云百炼 CLI 的安装、鉴权配置及核心功能使用的详细指南。

一、环境前置要求

在开始安装之前请确保本地环境满足以下条件：

‌Node.js 版本‌：建议 ≥ 22.12.0（部分文档指出最低需 Node.js 18+，但为了获得最佳兼容性及最新特性，推荐使用较新版本）。
‌包管理器‌：npm（官方推荐仅通过 npm 安装，避免使用 yarn 或 pnm 全局安装导致的路径异常）。

可通过以下命令检查当前环境版本：

bash

node -v npm -v

二、安装步骤

百炼 CLI 支持两种安装方式：‌AI Agent 自动安装‌（推荐）和‌手动命令行安装‌。

方式一：AI Agent 自动安装（推荐）

如果您正在使用支持 Tool Use 的 AI Agent（如 Cursor、Claude Code 等），可以直接向 Agent 发送以下指令，让其自动阅读文档并完成安装：

“请阅读 https://bailian.aliyun.com/cli/install.md 并按照说明为我安装阿里云百炼 CLI。”

方式二：手动命令行安装

若选择手动安装，请按顺序执行以下三步：

‌全局安装 CLI 本体‌
bash

npm install -g bailian-cli
‌安装 Skills 插件（关键步骤）‌
此步骤将百炼的能力描述文件注册到各 Agent 的 Skills 目录，使 Agent 能够识别并调用百炼能力。

bash

npx skills add modelstudioai/cli --all -g

注：部分最新文档中技能包名称可能更新为 modelstudioai/skills，若上述命令失效，可尝试 npx skills add modelstudioai/skills --all -g。
‌验证安装‌
执行版本查询命令，若输出版本号则代表安装成功。

bash

bl --version

三、鉴权与配置

使用百炼 CLI 前必须完成身份认证。平台支持多种认证方式，可根据场景灵活选择。‌控制台登录‌与 ‌API Key‌ 可同时配置，互不覆盖。

1. 控制台登录（推荐）

适用于需要同时使用模型调用和应用管理功能的场景。该方式会拉起浏览器完成 OAuth 登录。

bash

bl auth login --console

2. API Key 配置

适用于纯模型调用场景（文本、图像、视频、语音等），或在无界面环境（如 CI/CD）中使用。

‌交互式配置‌：
bash

bl auth login --api-key sk-xxxxxxxxxxxx
‌配置文件持久化‌：
bash

bl config set --key api_key --value sk-xxxxxxxxxxxx
‌环境变量配置‌（适合 CI/CD）：
在系统环境变量中设置 BAILIAN_API_KEY。

3. Token Plan 专属配置

如果您是 Token Plan 个人版订阅用户，需指定配置以享受套餐权益：

bash

# 登录时指定配置 bl auth login --config token-plan --api-key sk-sp-xxx # 切换默认配置 bl config use --name token-plan # 或在单次命令中指定 bl text chat --config token-plan --message "你好"

4. 临时传入（单次调用）

适用于测试或单次调用，密钥不落盘：

bash

bl text chat --api-key sk-xxx --message "你好"

四、核心功能与命令集概览

百炼 CLI 将原本复杂的 HTTP 请求封装为标准化的命令行指令，覆盖以下七大核心模块：

表格

能力模块	典型命令示例	说明
‌文本对话‌	bl text chat --message "..."	支持 Qwen-Max 等旗舰模型，支持长文本、代码生成及结构化 JSON 输出。
‌图像生成/编辑‌	bl image generate --prompt "..."	支持文生图、图生图、智能编辑，集成 Qwen-Image 系列模型。
‌视频生成‌	bl video generate ...	支持图生视频 (HappyHorse 系列)、文生视频，输出高质量动态画面。
‌语音处理‌	bl speech synthesize ... bl speech recognize ...	集成 CosyVoice（语音合成）与 Fun-ASR（语音识别），支持多音色克隆及多方言识别。
‌视觉理解‌	bl vision analyze ...	支持 Qwen-VL 系列，具备空间感知、超长视频理解及 OCR 解析能力。
‌知识库/RAG‌	bl rag upload ... bl rag search ...	终端直接上传文档、构建索引并检索，无需访问网页控制台。
‌联网搜索‌	bl search web --query "..."	为 Agent 补充实时外部信息，解决大模型知识截止问题。
‌运维监控‌	bl monitor bl log	查看模型调用量、Token 消耗、耗时、失败率及审计日志。

买阿里云服务器相关活动直达：

1.阿里云服务器ECS相关活动：https://www.aliyun.com/daily-act/ecs/activity_selection

2.阿里云上云抵扣金、无门槛优惠券、迁云补贴优惠券：https://www.aliyun.com/benefit

3.云小站平台（云产品通用代金券优惠券、云服务器秒杀优惠）：https://www.aliyun.com/minisite/goods

五、实战场景示例

完成安装与鉴权后，您可以直接向 AI Agent 下发自然语言需求，CLI 将自动调度相应能力。

‌场景 1：电商素材生成‌

‌用户指令‌：“帮我生成一套电商主图，6 张图，产品是纯黑色夏日男装 T 恤。”
‌后台执行‌：Agent 自动调用 bl image generate 及相关参数，批量产出符合语义的图片。

‌场景 2：新闻播客制作‌

‌用户指令‌：“根据今天的科技新闻，生成一段双人对话的播客音频。”
‌后台执行‌：Agent 依次调用 bl search web 获取新闻 -> bl text chat 撰写脚本 -> bl speech synthesize 生成角色音频。

‌场景 3：自动化运维监控‌

‌用户指令‌：“查看过去 24 小时的 Token 用量和错误率。”
‌后台执行‌：Agent 调用 bl monitor 或 bl log 命令，返回结构化数据供开发者分析。

六、常见问题与注意事项

‌鉴权失败提示‌：若控制台登录后执行命令仍提示“缺少 API Key”，请运行 bl update 升级至最新版本，或单独配置 API Key。
‌计费模式‌：CLI 工具本身免费开源，实际费用按调用的模型及服务用量计费。新用户通常享有免费额度，同时也支持 Token Plan、Coding Plan 等订阅套餐以降低成本。
‌兼容性‌：百炼 CLI 原生适配 Windows、macOS、Linux，并兼容 OpenAI 协议接口，原有基于 OpenAI SDK 的代码可低成本迁移。
‌安全建议‌：请勿将 API Key 硬编码在公开代码库中，建议使用环境变量或配置文件进行管理，并定期轮换密钥。

通过阿里云百炼 CLI，开发者只需关注业务逻辑与自然语言指令，即可高效构建复杂的多模态 AI 应用，显著降低集成成本与技术门槛。