手把手教你安装配置阿里云百炼CLI：全链路命令一站覆盖，轻松高效开发多模态AI应用
阿里云百炼 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
百炼 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
使用百炼 CLI 前必须完成身份认证。平台支持多种认证方式，可根据场景灵活选择。控制台登录与 API Key 可同时配置，互不覆盖。
1. 控制台登录（推荐）
适用于需要同时使用模型调用和应用管理功能的场景。该方式会拉起浏览器完成 OAuth 登录。
bash
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 应用，显著降低集成成本与技术门槛。