最近在换 AI 编程工具：用 bl config agent 一条命令写配置，base url 和 Key 不用再抄一遍

一、第三次抄同一个 Key 的时候，我停手了

这个月我换了三次写代码的工具。每换一次，就要重新找一遍它的配置文件在哪、base url 填什么、Key 放哪个字段、模型名怎么写。三家的格式还都不一样，手动改错一个字符，工具就直接连不上。

第三次抄到一半我停下来想：地址是同一个，Key 是同一个，模型也还是那个模型。那我到底在重复劳动什么？

答案挺难看的：我在把同一份信息，往三种我根本不关心的文件格式里各誊一遍。字段叫什么、放在第几层、要不要加引号，每家的规矩都不一样，我每次都得现查现学，学完就忘，下次换工具又从头来一遍。这部分知识对我没有任何积累，纯消耗。

后来发现有条命令能把这件事变成一行：bl config agent。你告诉它给哪个工具配，它自己去写那个工具的配置文件，我不用碰任何 json 或 toml，也不用记那文件藏在哪个目录下面。

说白了它吃掉的就是"格式"这一层。属于我的信息还是那三条，格式的事交给它。

二、我跑出来的东西

下面这些秒数和退出码，都是我 10 月 22 号在一个隔离目录里跑出来的，Key 用的是占位符，自己电脑上的真实配置一个没动。

我做的事	结果
给第一个工具配	2.2 秒，写 1 个配置文件
换第二个工具	1.6 秒，写 2 个配置文件
换第三个工具	0.7 秒，写 2 个配置文件
看当前生效哪套	bl config list / bl config show，各 0.7 秒
漏了 --model	exit 2
地址和地域都不给	exit 2

Key 在控制台密钥管理页领一个就行，安装说明在CLI 安装页。这条子命令本身不需要登录，它不联网，纯写本地文件，云资源一个都不创建。

表里那三个我是逐个跑的，名单里另外四个这次没动。合法名字一共七个，第四节说。

三、换工具的时候，只有两个参数要动

bl config agent --agent qwen-code \
  --base-url https://dashscope.aliyuncs.com/compatible-mode/v1 \
  --api-key <你的Key> --model qwen3-coder-plus

2.2 秒。第二个工具只换 --agent 和 --model，Key 和地址原样不动，1.6 秒，写了两个文件。

第三个工具的地址要走另一个入口，不是兼容形态那个：

bl config agent --agent claude-code \
  --base-url https://dashscope.aliyuncs.com/apps/anthropic \
  --api-key <你的Key> --model qwen3-max

0.7 秒，也是两个文件。

三个工具可以同时配好并存，互不覆盖，因为每家写的是自己的文件。这点我挺在意：我不是要抛弃前一个，只是想手边多几个能用的。以前手动改的时候我总担心把上一个改坏，动之前得先复制一份出来，现在这个心理负担没有了。

配完我习惯确认一眼：

bl config list
bl config show

各 0.7 秒。换多了以后，靠这两条看当前生效的是哪套，比翻文件快，也比凭记忆可靠。

这个习惯是被手动改文件那阵子养出来的。以前改完总要打开文件从头读一遍，确认自己没把上一家的配置改坏；现在跑一条 list 就够了，几个工具各自的配置都在，谁也没盖掉谁。省下的不只是时间，还有那种"我是不是改坏了"的悬着的心。

四、几个我撞过的地方

名单是固定的七个，传错名字 exit 2，报错会把七个全列给你。想配名单外的工具，这条命令帮不上，还得手动改。

这一点我觉得比它成功的时候更值得说：它清楚自己管到哪一段，管不到的地方直接把名单摊给你看，不糊弄也不猜你想配哪个。

--model 必填，漏了 exit 2，它不会替你填默认模型。地址和地域二选一，两个都不给也是 exit 2。报错倒是直白，缺哪个说哪个。

它不校验 Key 对不对。我用的就是占位 Key，命令照样成功写入了配置，退出码 0，一句警告都没有。所以配好了不等于能用了，配完一定要打开那个工具跑一次，连不上就回头查 Key 和地址，别怀疑命令本身。

这条我一开始有点不满，后来想通了：它压根不联网，拿什么去校验。

还有一句安全提醒：它真的会往你 home 目录下各工具的配置文件里写东西。跑之前先备份一份，或者像我这样，先在临时隔离目录里用占位 Key 试一遍，看它到底写了哪几个文件、写成什么样，再动真配置。它不联网、不调模型、不需要鉴权，云资源一个都不创建，所以配错了也不会在云上留下什么，改回来重跑一次就是。

五、和"第一次配"不是一回事

十二天前我写过一篇从零配一遍的，那篇解决的是第一次怎么配进去。这篇解决的是已经在用一两个、经常换、或者想几个并存的时候，哪些参数不用动、哪些必须换、配完怎么确认。如果你现在一个工具都还没配过，先去看那篇更顺。

写这篇的私心是：换工具这件事本身不该是一项技能。工具会一直换，格式会一直变，但地址、Key、模型这三样是我自己的东西，不该每换一次就重誊一次。把这部分固定下来，换工具才真的只是"换一个工具"，而不是"重学一套配置"。

当然，只配一个工具且不打算换的话，手动改一次配置文件也就几分钟，真不必装命令行。这条命令开始划算的时机，是你第二次、第三次换工具的时候，或者你想把配置这件事写进脚本、写进新人入职文档的时候。

想先在网页上感受一下的，可以去阿里云百炼控制台。