duplicate entry with key "mcp_servers" Hermes 配置错误

Quick fix

升级到 cc-switch v3.16.3 或更高版本，再切换供应商以自动清理历史重复键。

Symptom

报错原文复制

配置错误: Failed to parse Hermes config as YAML: duplicate entry with key "mcp_servers"

Cause

Windows 上 CRLF 换行可能导致 CC Switch 无法识别 Hermes YAML 中已有的顶层配置段，切换供应商时便追加新段而不是替换，累积出重复的 `mcp_servers`、`model` 或 `custom_providers` 键，导致 YAML 解析失败。维护者确认这一系列问题已在 v3.16.3 修复：写入时清理重复段，读取时保留最后一份并自愈。另有一条 macOS 报告涉及 `custom_providers` 项内重复的 `base_url`，维护者无法确认其成因，建议升级后复查；不能据此认定它与顶层键重复具有相同原因。

Fix

1. 1

   升级到 cc-switch v3.16.3 或更高版本，然后再次切换供应商；维护者说明该版本会在读取和后续写入时修复历史重复段。

2. 2

   如果问题仍出现，提供 Hermes `config.yaml` 中相关配置段（先隐去密钥）和 CC Switch 版本号，以便进一步排查。

Affected Versions

ToolClaude Code、Codex（问题发生于 CC Switch 管理的 Hermes 配置）

Version3.13.0、3.14.0、3.16.2；v3.16.3 修复顶层重复键问题

PlatformsWindowsmacOSLinux

Source Issues

本页汇总自 6 个真实 issue

• #2529Bug: Hermes config YAML duplicate entry with key custom_providers
• #2973Bug: hermesConfigDir causes duplicate YAML keys (custom_providers / model) on Windows
• #3762配置错误: Failed to parse Hermes config as YAML: duplicate entry with key "mcp_servers"
• #3851"Apply <agent> config" 写入策略会产生 YAML duplicate 键
• #3929切换模型的时候报错这个是什么原因？Failed to parse Hermes config as YAML: duplicate entry with key "mcp_servers"
• #4321mac 添加供应商失败

FAQ

升级后还报重复键错误，需要提供什么信息？

贴出 `config.yaml` 中相关配置段并隐去密钥，同时提供 CC Switch 版本号。

相关问题

[DISCUSS] 支持 pi coding agent这是功能请求，维护者已将其合并至统一追踪 issue #1855，原帖未提供可验证的解法。1 issues merged无法正常启动，窗口无响应，被系统要求force quit将 CC Switch 更新到经过相关功能重构的 4.0 或最新版本后重试；若仍复现，提交完整版本、步骤、日志和截图。1 issues mergedcc-switch 用量统计与 DeepSeek 官网不一致 / 不更新先升级到 v3.19.2 或更新版本，然后在「使用统计」页执行一次「重建 Codex 用量」，历史虚增或漏记的数据才会被修正。22 issues merged