Hermes使用
版本 Hermes 0.17.0 + ccswitch 3.14.6 （2026年6月29日 22:42:20）
Hermes配置模型（包括中转）
核心命令
- 测试Hermes是否安装成功：
hermes --version - 运行完整设置向导（一次性配置所有内容）：
hermes setup - 单独配置某一个profile：
hermes setup --profile xxx_profile - 输入
hermes默认进入指定的profile：hermes profile use xxx_profile - 单独配置某一项：最直接的方法是先查看配置文件路径
hermes config path，然后打开那个config.yaml手动改。或者：
hermes config set model.base_url https://baseurl地址/v1
hermes config set model.provider
hermes config set model.api_key
设置步骤
- 模型提供商：选 Custom (OpenAI-compatible endpoint)（绝对不能选 OpenAI 官方选项）
- API Base URL：完整粘贴官方地址 api.stepfun.com/step_plan/v…
- API Key：粘贴你的密钥
- 默认模型：先填官方推荐的验证模型 step-3.7-flash（跑通后再换其他型号）
- 后续可选配置保持默认
- 配置完成后验证：
-
检查配置健康状态
hermes --profile stepfun_profile doctor -
测试聊天调用
hermes --profile stepfun_profile chat
-
- 手动编辑配置文件，打开对应 profile 配置：
hermes config edit --profile stepfun_profile
🍎后面不用看，ccswitch当前版本对Hermes支持不够，bug也多，暂时先不要用css去下载安装Hermes
Hermes对接CCSwitch【未支持】
2026年6月29日 22:44:34 当前3.14.6版本不支持，未来一定会有
验证网络
- 先测试网络是否正常
- 验证端口确在监听：netstat -ano | findstr "LISTENING" | findstr "7890"
- 验证能否正常转发：Invoke-WebRequest -Uri "www.google.com" -Method Head
设置步骤
- 打开ccs的hermes入口，自定义配置中填好相应baseurl和key
- 找个目录右键打开powershell，输入 hermes model，选择 Custom endpoint (enter URL manually)
- Base URL 填：
http://127.0.0.1:15721/v1（和你 Codex 用的本地代理端口一致），少了v1后缀会 404 - API Key 随便填：比如填 ccswitch（本地代理不需要真实鉴权，占位即可）
- 默认模型名填：gpt-5.5，如果报错模型不存在就是这里出的问题
- 确认设为默认提供商，完成配置
- 验证：执行 hermes 启动会话，发一句 hello，不再弹配置提示、能正常回复就是通了。此时去 CC Switch 「使用统计」里能看到 Hermes 应用产生了调用记录，就是走代理成功了。 8.注意：走 CC Switch 代理时，必须保持 CC Switch 后台运行，关了代理就断了。修改配置后，要关闭 Hermes 会话重新启动才会生效
