hermes model 接不上模型TaoToken 给的做法是把 Base URL 改成 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endKey 也从这里建。在 Windows 11 上按 Ollama、Hermes、Codex、Open WebUI 四层搭本地 Agent前两层通常十分钟就装完真正让人来回折腾的是第三步Hermes 那边模型入口没配通hermes model列不出可用模型接着 Codex CLI 又要单独配一次模型提供方Key 和地址散落在三四个地方改了一个忘了另一个。这篇就围绕这一步把 Hermes 的模型入口和 Codex CLI 的工程执行通道都指向同一个通道让 Open WebUI 那层多用户入口背后真正消耗 Token 的是 Hermes 和 Codex 调用的模型。1. Windows 11 四层体系为什么总是卡在 hermes model1.1 四层各自负责什么先把边界划清楚很多人一上来就把 Ollama、Hermes、Codex、Open WebUI 当成四个同类工具结果配置互相打架。实际职责是这样的层角色它需要的东西Ollama本地模型运行时负责把权重跑起来本地显存/内存、ollama pull下来的模型HermesAgent 调度层管工具权限、会话、任务编排一个模型入口Base URL Key 模型 IDCodex CLI工程执行层读项目、改代码、跑测试、分析报错一个模型入口可以和 Hermes 共用Open WebUI前端入口层给人点、给人聊Hermes 暴露的 OpenAI 兼容地址看清楚就会发现只有 Hermes 和 Codex 需要“模型入口”这个概念Ollama 是本地跑分词的Open WebUI 是接 Hermes 的。如果hermes model配不上怪 Ollama 没启动是找错方向了——ollama run能出字只证明本地模型活着不证明 Hermes 找到了它。1.2 报错的典型长相不是崩溃是“空”hermes model这类命令失败时很少直接抛异常更常见的是下面几种表现敲hermes model或者进交互式界面模型列表是空的或者只有一个default占位会话里提问Hermes 回一句模型不可用provider 未配置然后就没有下文明明在环境变量里写过 Keyhermes doctor却报 provider 校验失败Codex CLI 那边换了 providerHermes 这边的配置没跟着动两边模型 ID 不一致。Windows 11 上还有个高频干扰项环境变量分“用户变量”和“系统变量”你在当前 PowerShell 窗口里set的变量换一个新开的终端就没了用hermes setup写进配置文件的反而稳定。所以定位顺序建议是先确认配置文件里到底写了什么再看环境变量最后才怀疑通道本身。2. 先去 TaoToken 建一把 Key再谈改哪个文件2.1 注册、创建 API Key、确认模型 ID这一步对应原文里“准备模型入口”的位置只是入口换了个地方。打开 TaoToken 完成注册登录进控制台创建一把 API Key先复制到剪贴板旁边的记事本里——后面 Hermes 和 Codex 两处都要用同一把写成本篇统一的占位符就是YOUR_API_KEY。同时把模型 ID 抄下来。模型广场里当时列出的可用模型为准不要凭记忆写带日期后缀的名字也不要自己拼一个看起来很像的 ID。抄错 ID 是后面 404 类报错的主要来源而这类报错在 Hermes 侧经常被包装成“模型不可用”浪费排查时间。提示Key 只在创建时完整展示一次页面刷新后就看不全了。真丢了不必纠结回控制台重新建一把把 Hermes 和 Codex 两处一起替换即可比翻旧记录快。2.2 Base URL 填 https://taotoken.net/api不要带 /v1这是最容易填错、也最容易被复制粘贴坑到的一行。所有要填进工具里的地址统一用https://taotoken.net/api注意三件事末尾没有/v1不要在后面加查询参数不要把它和官网地址混着用。官网那个带参数的链接是给人点开注册、看模型广场、看用量用的填进 Hermes 或 Codex 的必须是干净的这一条。很多工具在内部会自己拼/chat/completions你在 Base URL 上再补一层/v1最终请求路径就重复了返回的通常是 404 而不是参数错误看起来特别像“模型不存在”。3. hermes model把 Hermes 的模型入口指到新通道3.1 优先走 hermes setup交互式填四项在 Windows 11 的 PowerShell 里直接跑hermes setup按提示一路选下来涉及模型入口的通常是四项Provider 选择 OpenAI 兼容 / 自定义提供方Base URL 填https://taotoken.net/apiAPI Key 填YOUR_API_KEYModel ID 填你在模型广场抄下来的那一个。填完让它写入配置文件别只在当前窗口 export 一遍就完事。如果交互式选项里没有完全对应的 provider 名称选最接近的“OpenAI Compatible / Custom”不要选某个具体厂商的名字否则它可能自带一套地址拼接规则把你的 Base URL 覆盖掉。3.2 用 hermes model 切模型用环境变量兜底配置文件写完之后日常切换模型走hermes model就行把当前会话或默认模型指到你要用的那个 ID。如果某些版本对配置文件里的 provider 字段处理不一致可以用环境变量兜一层$env:OPENAI_BASE_URL https://taotoken.net/api $env:OPENAI_API_KEY YOUR_API_KEY注意变量名以你本机hermes --help和hermes config check的输出为准不同版本命名可能不完全一样。这里的原则是 Base URL 保持https://taotoken.net/api这个形态Key 用YOUR_API_KEY对应的真实值模型 ID 跟模型广场一致。环境变量只在当前窗口有效适合临时验证长期使用还是写进配置文件否则你换个终端窗口Hermes 又“失忆”了。3.3 hermes doctor 和 hermes config check 看的是两件事这两个命令别混着用hermes config check检查配置本身——provider 有没有声明、Base URL 格式对不对、Key 是否为空、模型 ID 是否写了。它不联网所以只能排除“填错”。hermes doctor做的是连通性和工具权限体检——通道能不能通、模型能不能列出来、工具权限是否齐。它报错才说明是通道或 Key 的问题。顺序上先hermes config check再hermes doctor。如果第一步就报字段缺失第二步的结果没有参考价值。两项都过之后进 Hermes 做点最简单的活让它看一下当前时间、列一下某个目录、读一个小配置文件的内容。这三件事都不依赖复杂工具链能跑通说明模型入口这一层已经稳了再去碰真实项目。4. Codex CLI 的 config.toml工程执行通道同样指过去4.1 Windows 11 下的 ~/.codex/config.toml 怎么写Codex 不读 ANTHROPIC 系列变量它是自己的配置文件。Windows 上的路径一般是C:\Users\你的用户名\.codex\config.toml用记事本或任意编辑器打开model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat然后在同一个终端里给TAOTOKEN_API_KEY赋上真实 Key或者用系统环境变量面板写进用户变量避免每次开窗口都要重设。wire_api选哪种、字段名是否叫这个以 Codex 当前版本的文档和报错提示为准Base URL 这一项不用纠结就是不带/v1的那一条。改完之后重开一个终端跑一次最简单的任务比如让它解释某个函数、生成一段 SQL看有没有正常吐字。别一上来就丢一个几百行的重构需求配置错了你也分不清是通道问题还是任务太难。4.2 Codex 只负责生成和解释执行交给本地这一层必须说清楚Codex CLI 在读项目、改代码、跑测试、分析报错这些事上是好帮手但它不应该直接连你的生产库、生产机器去执行操作。诊断 SQL、建库脚本、编译命令、系统命令一律由你在本地或对应客户端里自己跑然后把报错原文贴回对话让它分析。正确链路Codex 生成/解释 SQL → 你在本地数据库客户端执行 → 把报错贴回 Codex → 它给修改建议 错误链路让 Codex 自己去连库执行不推荐也不符合最小权限原则同理涉及 Oracle 之类数据库的排查Codex 只能帮你写查询、读执行计划、解释错误码真正的FETCH、导入导出、诊断脚本执行都得你自己在本地确认过再动手。把边界守住这套体系才敢在真实项目里用。5. Open WebUI 连的是 Hermes不是 TaoToken5.1 连接设置里填 http://127.0.0.1:8642/v1第四层最常见的误操作就是看到“OpenAI 兼容”就把通道地址抄进 Open WebUI。这里要接的是 Hermes 暴露出来的本地地址http://127.0.0.1:8642/v1填在 Open WebUI 的“连接 / OpenAI API”设置里Key 用 Hermes 自己那套本地密钥不是YOUR_API_KEY。如果把通道地址填到这里Open WebUI 就绕开了 Hermes 直接打模型你会丢掉工具权限、会话管理和那一层编排能力——表面上还能聊天实际上第二三层白装了。5.2 多用户入口背后谁在真正消耗 Token这条链路拉直之后是这样的同事在 Open WebUI 里提问 → Open WebUI 打到本机 8642 → Hermes 用配置好的模型入口请求模型 → 需要动项目时再交给 Codex CLI。前面几层的“多用户”只是入口形态真正产生调用的是 Hermes 和 Codex 这两处。所以排查用量、排查费用的时候别盯着 Open WebUI 那一层看。回 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的控制台看调用记录能对上 Hermes 和 Codex 的请求才说明整条链路是通的。6. 配置没生效时的对照表与收尾6.1 三类报错分别往哪儿看现象大概率原因先查哪里hermes model列表为空、provider 未配置配置文件没写入或只在当前窗口设了环境变量hermes config check的输出401鉴权失败Key 写错、被截断、或两处用了不同的 Key配置文件里的 Key 与新建的那把是否一致404模型不存在Base URL 多写了/v1或模型 ID 拼错Base URL 是否为https://taotoken.net/apiID 是否照抄顺带提醒一个排查习惯改完配置先hermes config check再hermes doctor最后进 Hermes 做查看时间、检查目录、读取配置文件这三件小事。三件都过再去动 Codex 那边两边都过最后才去 Open WebUI 点一下。一次只改一层出错时才知道是哪一层的锅。6.2 跑通之后去控制台对一下这次调用Hermes 的模型入口和 Codex 的工程通道都指过去之后先在 TaoToken 模型对话 里用同一把 Key 发一条测试消息确认模型 ID 和地址都没填错如果要长期拿它写代码、跑工程任务可以打开 Coding Plan 看套餐够不够用新 Key 在 控制台 API Keys 随时补建。Claude Code 那套环境变量对照可以看 接入文档改天要把它也接进来时不用重新摸一遍。四层体系真正难的不是装是让每一层只做自己那件事——入口层接 HermesHermes 和 Codex 各自拿同一把 Key 指向同一个 Base URL剩下的就是慢慢把工具权限调顺。