1. 为什么要在 HagiCode 里同时挂 GLM-5.1 和 Gemini CLI如果你正在用 Agent CLI 写代码大概率遇到过这种别扭Claude Code 跑长链路重构很稳但遇到需要看图定位 UI 错位、读截图里的报错堆栈时就得切到另一个工具Gemini CLI 在长上下文和图片理解上顺手可一旦要接国产模型做中文注释、国内网络直连又得重新配一遍环境变量。工具越多配置越碎最后每个 CLI 一套 Key、一套 base_url改一个忘一个。HagiCode 这类多模型平台的价值就在这它把不同 Agent CLI 抽象成统一的 Provider用一份配置描述「用哪个 CLI、跑哪个模型、走哪个网关」。GLM-5.1 是智谱新一代旗舰相比 GLM-5.0 推理链更长、代码理解更细而且是 GLM 系列里第一个支持图片输入的版本——意味着你可以直接截图丢给 Agent让它看报错、看界面、看图表不用再手打一大段描述。Gemini CLI 则是第十个被集成进来的 Agent CLI通过 ACP 通信协议和 Provider Registry 统一注册别名gemini和gemini-cli都能识别。这篇面向的是已经在用 Agent CLI、想把手头多模型配置收敛到一处的开发者。我会给出可复制的settings.json/config.toml骨架、TaoToken 统一 Key 的配置示例以及验证多模型切换是否真的生效的命令和排查步骤。全程按「能跟着做」来写不堆概念。2. 前置准备TaoToken 统一 Key 与 CLI 环境多模型配置最容易翻车的地方不是模型本身而是 Key 和 base_url 满天飞。我的做法是先用一个统一网关把鉴权收口TaoToken 就是干这个的它对外暴露一个兼容 Anthropic 风格的 API 端点你拿一个 Key 就能在多个模型之间切换不用为每个模型单独申请、单独记。先拿到 Key。访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后进入控制台在 API Keys 页面创建一个新 Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建时建议按用途命名比如hagicode-glm51方便后面排查是哪个 Key 出的问题。API 端点统一用 https://taotoken.net/api 注意这个地址不带任何查询参数配置里直接写死即可。环境变量层面先在你的 shell 里导出后面 HagiCode 和 Gemini CLI 都会读它export ANTHROPIC_AUTH_TOKENsk-你的TaoTokenKey export ANTHROPIC_BASE_URLhttps://taotoken.net/apiWindows PowerShell 用$env:ANTHROPIC_AUTH_TOKENsk-你的TaoTokenKey $env:ANTHROPIC_BASE_URLhttps://taotoken.net/apiCLI 侧确认可执行文件在 PATH 里。Gemini CLI 的候选名是gemini和gemini-cliHagiCode 的 Provider 会按顺序解析第一个可用的which gemini || which gemini-cli gemini --version如果两个都找不到说明 CLI 没装或没进 PATH这一步不通过后面所有配置都是白搭。装好后建议把版本号记下来排查时能快速判断是不是 CLI 自身升级导致的协议不兼容。注意环境变量里的 base_url 一定要指向网关地址不要指向某个模型厂商的原始域名。多模型切换靠的就是网关按模型名路由写死单厂商域名等于自断切换能力。3. 可复制配置settings.json 与 config.toml 骨架HagiCode 的配置分两层一层是平台级的 Provider 注册一般由AddHagiCodeLibs()自动完成另一层是你要手写的模型与 CLI 绑定配置。下面这份settings.json骨架可以直接抄重点看primaryProfessionId、secondaryProfessionId、model三个字段的配合。{ primaryProfessionId: profession-claude-code, secondaryProfessionId: secondary-glm-5-1, model: glm-5.1, reasoning: high, cliProvider: gemini, cliOptions: { executablePath: null, workingDirectory: null, model: glm-5.1, authenticationMethod: token, authenticationToken: ${ANTHROPIC_AUTH_TOKEN}, environmentVariables: { ANTHROPIC_BASE_URL: https://taotoken.net/api }, extraArguments: [], startupTimeout: 00:00:30 } }字段含义对照如下配错时对着这张表查最快字段作用常见取值primaryProfessionId主职业决定基础 Agent 行为profession-claude-codesecondaryProfessionId次职业绑定具体模型能力secondary-glm-5-1model实际请求的模型名glm-5.1 / glm-5.0reasoning推理强度low / medium / highcliProvider用哪个 Agent CLI 执行gemini / claude / codebuddyauthenticationToken鉴权令牌引用环境变量如果你更习惯 TOML 风格部分 CLI 或本地脚本会读等价骨架如下[profession] primary profession-claude-code secondary secondary-glm-5-1 model glm-5.1 reasoning high [cli] provider gemini executable gemini [cli.auth] method token token ${ANTHROPIC_AUTH_TOKEN} base_url https://taotoken.net/api [cli.pool] max_sessions 4 idle_timeout 00:05:00这里有个容易忽略的点secondary-glm-5-1和glm-5.1是两个不同层面的东西。前者是 HagiCode 内部的职业标识后者是发给网关的模型名。GLM-5.0 在平台里带 Legacy 标记、有特殊保留逻辑而 GLM-5.1 是独立新标识没有历史包袱所以两者不能混用。你把secondary写成 5.0 的 ID、model写成glm-5.1行为会不一致。图片能力由supportsImage控制GLM-5.1 在目录里是true{ id: secondary-glm-5-1, supportsImage: true }只有这个值为 true 的模型截图上传才会真正走图片通道否则你传了图也只是当文本处理Agent 看不到内容。4. 验证多模型切换是否生效配置写完不代表生效必须用命令验证。第一步先确认网关侧能正常返回绕开 HagiCode 单独打一次请求curl -s https://taotoken.net/api/v1/messages \ -H Authorization: Bearer $ANTHROPIC_AUTH_TOKEN \ -H Content-Type: application/json \ -d { model: glm-5.1, max_tokens: 64, messages: [{role: user, content: 只回复pong}] }返回里能看到content字段带pong说明 Key、base_url、模型名三者对得上。如果这里就报 401问题在 Key报 404 或 model not found问题在模型名拼写。第二步验证 HagiCode 是否真的把请求路由到了 Gemini CLI。启动一次带日志的会话观察 Provider 解析结果hagicode run --config ./settings.json --log-level debug 21 | grep -i provider\|gemini\|glm正常输出里应该能看到Resolved provider: gemini和Model: glm-5.1两行。如果只看到 provider 没有 model说明cliOptions.model没被读取检查 JSON 层级是否写错。第三步做一次真实的模型切换对比。准备两个配置一个指向 GLM-5.1一个指向 Gemini 原生模型用同一个 prompt 跑hagicode run --config ./settings-glm51.json --prompt 解释这段代码的时间复杂度 out-glm.txt hagicode run --config ./settings-gemini.json --prompt 解释这段代码的时间复杂度 out-gemini.txt diff out-glm.txt out-gemini.txt两份输出有差异且日志里模型名分别正确就说明切换链路是通的。如果两份输出完全一样八成是配置没被加载实际都在用默认模型。图片通道单独验一次。GLM-5.1 支持图片输入传一张带报错的截图hagicode run --config ./settings.json --image ./error-screenshot.png --prompt 这张图里的报错是什么原因能描述出截图里的错误信息说明supportsImage生效如果回复「我看不到图片」回到配置检查secondary-glm-5-1的supportsImage是否为 true。5. 本篇常见错排查报错一Provider gemini not found。这是 Provider Registry 没注册成功。检查AddHagiCodeLibs()是否在启动时调用以及 Gemini Provider 是否在注册列表里。别名注册那段逻辑要确保gemini-cli也被映射否则用别名调用会失败。报错二401 Unauthorized但 curl 单独测是通的。多半是 HagiCode 读到的环境变量和你 shell 里的不是同一份。GUI 启动的进程可能拿不到你终端里 export 的变量改成在settings.json的environmentVariables里显式写 base_urltoken 用绝对路径的密钥文件或直接内联注意别提交到仓库。报错三模型切换后行为没变。优先怀疑secondaryProfessionId和model不匹配。GLM-5.0 带 Legacy 保留逻辑如果你把 secondary 写成 5.0 的 ID平台可能仍按旧路径处理。统一改成secondary-glm-5-1glm-5.1。报错四图片上传后 Agent 说看不到。三个检查点模型目录里supportsImage是否为 true请求是否真的走了图片字段而不是把路径当文本CLI 版本是否支持 ACP 的图片消息类型。老版本 CLI 可能只实现了文本通道。报错五startupTimeout超时。Gemini CLI 冷启动较慢默认 30 秒在低配机器上可能不够。把startupTimeout调到00:01:00同时确认executablePath指向的是真实二进制而不是一个包装脚本。报错六会话池串味。多个模型共用同一个池时如果SessionId没隔离可能出现 A 模型的上下文泄漏到 B 模型。给每个模型配置独立的PoolSettings或显式设置不同的SessionId前缀。排查顺序建议固定成curl 直连网关 → 看 HagiCode debug 日志的 provider/model 行 → 对比两次运行的输出差异 → 单独验图片通道。按这个顺序走基本不会在错误的地方浪费时间。6. 把配置收口让多模型真正可用多模型配置的难点从来不是「支持多少个模型」而是「切换时不用重配一遍」。把 Key 收口到统一网关、把 CLI 差异收口到 Provider、把模型差异收口到secondaryProfessionId这三层分清楚之后加一个新模型基本就是改一行配置的事。如果你在接入或排障过程中卡住优先看 API Keys 和接入文档Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 接入说明在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。想先验证模型对话效果可以直接在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 里试 GLM-5.1 的图片输入。如果你是要长期跑编码 Agent、频繁切换模型Coding Plan 会更省心https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。Claude Code 相关的接入细节在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。最后留一个我踩过的坑改完配置一定要重启 HagiCode 进程热加载对 Provider 注册不生效只改文件不重启你会以为配置没写对其实是旧进程还在跑。