团队里每来一个新人，装完阿里云百炼的 CLI（bl）之后问的第一批问题基本是同一批：我的 Key 生效了没有、要的模型叫什么名字、能跑的代码在哪、这么多模型该选哪个。这四个问题各有一条命令能回答，五条命令里四条不需要鉴权，也就是说新人可以在等 Key 审批的同时把前三件事查完。
我把这套动作整理成了一份第一小时自检清单，下面是它的依据和我自己踩过的坑。所有输出都是 2026-10-12 我在自己电脑上敲出来的，bl 2.1.0，会变的读数都带了日期。
一、四问与五条命令的对应关系
先说清楚缩写：CLI 是命令行工具，不开网页，在终端里敲一行字让平台干活；配置档（profile）是一组存好的地址和凭证；base_url 是请求发往哪个地址；SDK 是替你把 HTTP 请求包好的代码库；OCR 是把图片里的文字识别出来。
| 新人要回答的问题 | 命令 | 是否要 Key |
|---|---|---|
| 我的凭证配对了没有 | bl auth status |
不要 |
| 生效的是哪一档配置 | bl config list / bl config show |
不要 |
| 我要的模型叫什么名字 | bl model search |
不要 |
| 能直接跑的代码长什么样 | bl model code |
不要 |
| 这么多模型我该选哪个 | bl advisor recommend |
要 |
还没装的话，CLI 安装页上有一条 npm 命令；API Key 在密钥管理页签签发，领完设进环境变量或者配置文件都行。
二、第 0 步：确认生效的是哪一档配置
多人共用的开发机上，配置档往往不止一组。我电脑上有 default、image、token-plan 三档，bl config list 给清单，带星号的是当前生效的那个。
新人最常见的卡点是"Key 明明配了却不生效"，多半是生效的那档不是他刚改的那档。所以自检的第一项不是"有没有配 Key"，而是"生效档是不是配了 Key 的那档"。
三、第 1 步：读凭证来源三态
bl auth status
输出（Key 自带掩码，可以直接贴进交接文档，不用手工打码）：
Config: image
Config file: /Users/chenxiaoru/.bailian/config.json
Authentication Status:
API key (model): env sk-4...8c10
Console gateway: config 1d1b...32e1 (cn-beijing, domestic)
OpenAPI (AK/SK): not configured (run bl auth login --open-api)
三条凭证逐条报来源，不混在一起：env 是读自环境变量，config 是读自配置文件，not configured 是没配。调模型用的是第一行那条 API Key（API 是程序之间约定好的调用接口）。第二行是控制台会话凭证，用量、额度那几条命令走的是它。
再跑一条看全貌：
bl config show
它把当前档摊平成键值表：base_url、timeout、output，还有 watermark: true 这种没显式设置却存在默认值的项。让新人把这里的 base_url 抄进自己的笔记，第 3 步的排查要用它做基准。
四、第 2 步：模型检索的口径
bl model search --keyword 图像 --limit 10
bl model search --keyword 客服 --input-modality Text --output-modality Text --capability TG --limit 5
关键词会去匹配模型 ID、中文名、能力码和描述，按相关度排序返回；三个过滤器分别收窄输入模态、输出模态、能力码。
两条口径要写进新人文档：
一是关键词不能为空。bl model search --keyword "" 返回 total: 0，把过滤器全加上还是 0。这条命令是检索，不是目录浏览。翻全量目录是另一条命令 bl model list 的活，这篇不展开，两条分工不同。
二是目录有时效。已经下线并从目录移除的模型，搜索也搜不到。我拿 10 月 10 号那批下线的 qwen3-max 试过，加不加"包含已下线"的开关都是 0 条。所以文档里不要写死模型名，要写"用当天的 search 读数"。
五、第 3 步：样例代码与占位符处置
bl model code --model qwen3.8-flash
默认输出 Python 加 OpenAI 兼容写法的完整样例，流式读取的循环写在里面，深度思考模型会自动带上开启思考的参数。新人不必去网上抄代码，这条命令也不用 Key。
要提醒的是样例里的地址是模板占位符：
https://[workspace-id].cn-beijing.maas.aliyuncs.com/compatible-mode/v1
方括号那一截要替换，它与第 1 步 config show 里的真实地址不是同一个东西，整段照抄的结果是连接错误。两种处置都可以：换成自己的端点，或者删掉 base_url 这一行让 SDK 走环境变量。
换写法用参数：--sdk dashscope 切官方 SDK 写法，--api responses 切 Responses 接口。语言支持矩阵没有单独的查询命令，传一个不支持的值让报错打印出来更快：
bl model code --model qwen3.8-flash --lang rust
报错里给出完整矩阵：openai 写法支持 node、curl、python；dashscope 写法支持 curl、python、java。
六、第 4 步：选型建议怎么读
bl advisor recommend --message "我想做一个中文客服机器人，要能读用户传来的截图，回复要快、成本要低"
这条要 Key，背后真的在调模型做意图分析，只调一次、量很小。返回两块：意图理解块和排名候选块。
我用同一段话问了两次，两块都变了：
| 返回项 | 第一次 | 第二次 |
|---|---|---|
| 理解块的能力需求 | 看图 + 文本生成 | 只写了文本生成 |
| 理解块的预算档 | 低预算、成本优先 | 中等预算、均衡 |
| 排名第一 | 一个 OCR 专精模型（读图转文字） | 一个机器翻译模型 |
同一段话问两次，理解和第一名都变了，两次的第一名都不是"能读图的中文对话模型"。这里只报现象，不猜成因。
给新人的读法是一句话：排名当参考，理解块当需求说明书。 理解块把一句大白话翻译成四个字段，输入模态、输出模态、能力码、预算档，拿这四个字段回到第 2 步的 search 当过滤条件，比直接信排名可靠得多。
七、可复制的自检清单
新人第一小时照着走一遍，六项全过再开始写调用代码：
| 检查项 | 命令 | 通过标准 |
|---|---|---|
| 凭证来源可读 | bl auth status |
三条凭证各自报出 env / config / not configured |
| 生效档正确 | bl config list |
星号落在配了 Key 的那一档 |
| 真实地址已记录 | bl config show |
base_url 抄进自己的笔记 |
| 模型 ID 拿到 | bl model search --keyword <场景词> |
total 非 0，记下模型 ID |
| 样例可跑 | bl model code --model <ID> |
占位符地址已替换或删除 |
| 选型有依据 | bl advisor recommend --message <大白话> |
取理解块四字段，回填 search |
前五项不要 Key，可以和 Key 申请并行做完。
八、写进文档的三条口径纪律
第一，读数带日期。模型目录、advisor 的排名（同一段需求描述问两次就会不同）、控制台额度都会变，任何抄进团队文档的读数都要写清取数日期，过期快照不复用。
第二，额度以控制台为准。用量和额度那几条命令走控制台会话，我的会话过期了，跑出来是登录提示，所以这篇没有给任何用量或额度数字。新人要查自己的额度，去控制台的额度页看当天读数，不要引用任何文章里的数字。
第三，单价不进文档。advisor 给的推荐理由原文里带单价数字，价格随时间动，抄进文档就是错的。看到理由里的金额，以控制台价格页为准。
九、这份自检的重跑口径
清单里每一项都有可核对的读数，新人跑完对一遍就知道自己是不是同一状态：
| 读数 | 我这次的值 | 命令 |
|---|---|---|
| 凭证来源三态 | env / config / not configured | bl auth status |
| 配置档清单 | default、image、token-plan，生效 image | bl config list |
| 空关键词搜索 | total 0 | bl model search --keyword "" |
| 样例语言矩阵 | openai: node/curl/python；dashscope: curl/python/java | bl model code --lang <错值> |
| 同输入两次推荐 | 理解块与第一名均不同 | bl advisor recommend --message <同一段话> |
会变的三项是模型目录、advisor 的排名、控制台额度。前两项让新人重跑一遍取当天读数，额度只能去控制台的额度页看。鉴权口径也能自己核：每条命令的 --help 里都有一行 Authentication，上面表里这些命令只有 advisor recommend 写的是 API Key，其余写的都是 No Auth（bl 2.1.0）。
十、这份自检不覆盖的部分
跑通第一句不在里面。拿到样例代码之后怎么设环境变量、怎么发出第一次调用、第一次调用会花多少，我写在另一篇《第一次调用大模型，卡住我的不是代码》里，可以作为新人第二小时的读物。
三个入口留给需要的人：CLI 安装页、API Key 签发页、阿里云百炼首页。
