团队里每来一个新人，装完阿里云百炼的 CLI（bl）之后问的第一批问题基本是同一批：我的 Key 生效了没有、要的模型叫什么名字、能跑的代码在哪、这么多模型该选哪个。这四个问题各有一条命令能回答，五条命令里四条不需要鉴权，也就是说新人可以在等 Key 审批的同时把前三件事查完。

我把这套动作整理成了一份第一小时自检清单，下面是它的依据和我自己踩过的坑。所有输出都是 2026-10-12 我在自己电脑上敲出来的，bl 2.1.0，会变的读数都带了日期。

一、四问与五条命令的对应关系

先说清楚缩写：CLI 是命令行工具，不开网页，在终端里敲一行字让平台干活；配置档（profile）是一组存好的地址和凭证；base_url 是请求发往哪个地址；SDK 是替你把 HTTP 请求包好的代码库；OCR 是把图片里的文字识别出来。

还没装的话，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，背后真的在调模型做意图分析，只调一次、量很小。返回两块：意图理解块和排名候选块。

我用同一段话问了两次，两块都变了：

同一段话问两次，理解和第一名都变了，两次的第一名都不是"能读图的中文对话模型"。这里只报现象，不猜成因。

给新人的读法是一句话：排名当参考，理解块当需求说明书。 理解块把一句大白话翻译成四个字段，输入模态、输出模态、能力码、预算档，拿这四个字段回到第 2 步的 search 当过滤条件，比直接信排名可靠得多。

七、可复制的自检清单

新人第一小时照着走一遍，六项全过再开始写调用代码：

前五项不要 Key，可以和 Key 申请并行做完。

八、写进文档的三条口径纪律

第一，读数带日期。模型目录、advisor 的排名（同一段需求描述问两次就会不同）、控制台额度都会变，任何抄进团队文档的读数都要写清取数日期，过期快照不复用。

第二，额度以控制台为准。用量和额度那几条命令走控制台会话，我的会话过期了，跑出来是登录提示，所以这篇没有给任何用量或额度数字。新人要查自己的额度，去控制台的额度页看当天读数，不要引用任何文章里的数字。

第三，单价不进文档。advisor 给的推荐理由原文里带单价数字，价格随时间动，抄进文档就是错的。看到理由里的金额，以控制台价格页为准。

九、这份自检的重跑口径

清单里每一项都有可核对的读数，新人跑完对一遍就知道自己是不是同一状态：

会变的三项是模型目录、advisor 的排名、控制台额度。前两项让新人重跑一遍取当天读数，额度只能去控制台的额度页看。鉴权口径也能自己核：每条命令的 --help 里都有一行 Authentication，上面表里这些命令只有 advisor recommend 写的是 API Key，其余写的都是 No Auth（bl 2.1.0）。

十、这份自检不覆盖的部分

跑通第一句不在里面。拿到样例代码之后怎么设环境变量、怎么发出第一次调用、第一次调用会花多少，我写在另一篇《第一次调用大模型，卡住我的不是代码》里，可以作为新人第二小时的读物。

三个入口留给需要的人：CLI 安装页、API Key 签发页、阿里云百炼首页。