装上并登录
习惯终端的话，这是最快的路子：一行命令出图，图直接落到当前目录。
装
npm install -g museav-cli最新 v2.5.0 装完命令就叫 museav。包名与命令名一致，都是 museav（旧包 @kubor/studio-cli 已废弃） 源码在 https://github.com/webkubor/museav-cli。
装过旧版本的话
这个 CLI 改过名。如果你之前装的是老包，先卸载再装新的， 不然两个命令会打架。上面那条安装命令是从中台实时拉的，永远是对的。
三种身份，挑一种
你自己用 —— 登录就行
bash
museav login终端会显示一个验证码和一个链接。浏览器打开、登录、点批准，CLI 自动拿到凭证。
7 天有效，过期再登一次。
没有账号？去 www.museav.top 用 Google / GitHub 一键登录， 开放注册，点一下就有。
团队给了你一把 Key
bash
museav config --apiKey sk-studio-xxxxxxxxxxxxxxxxxxxxxxxx这把 Key 能出图、能查自己的额度，但管理类的操作会 403 —— 这是设计如此， 详见三种身份。
服务端 / CI 用
同样是 config --apiKey，但用的是租户 Key（组织级那把，权限最大）。
租户 Key 别放个人电脑上
它等于整个组织的钥匙 —— 能给成员开户、能看全租户的账。 个人用请让管理员发一把账户 Key给你。
配置存在哪
配置文件是 ~/.museav.json，权限 0600。
CLI 还会回落读取改名前的旧配置文件（~/.studio-cli.json、~/.studio-image.json）—— 老用户不用重新登录。
为什么要读旧文件
API Key 的明文中台只在创建时给一次。很多人唯一的一份就存在那些旧文件里。 不读等于逼人去重置密钥。
免配置文件（CI / 容器 / 沙箱）
环境变量优先级最高，而且不落盘：
bash
MUSEAV_API_KEY=$MUSEAV_API_KEY museav gen --prompt "..."| 变量 | 作用 |
|---|---|
MUSEAV_API_KEY | API Key（旧名 STUDIO_API_KEY 仍有效） |
MUSEAV_BASE_URL | 覆盖中台地址（旧名 STUDIO_BASE_URL） |
优先级：环境变量 > 配置文件里的 token（login 拿的）> 配置文件里的 apiKey。
出第一张图
bash
museav gen --skill ecom-white-backdrop --input "米白色针织衫"看有哪些技能可用：
bash
museav skills接下来
一个边界，别踩
做产品 / 后端集成不要用 CLI。
Cloudflare Workers 这类边缘运行时起不了子进程，CLI 二进制根本跑不起来。
那种场景直接调 HTTP API（同样支持技能）， 或者把 CLI 当库用：import { StudioClient } from 'museav-cli'。