Skip to content
CC Switch WikiUnofficial Community Wiki

Hermes does not take effect; configuration must be copied manually

Quick fix

On Windows, upgrade to v3.16.5 or later. This version makes CC Switch write to the configuration directory actually read by Hermes.

Symptom

Section titled “Symptom”
Error output
导致在ccswitch保存后hermes不生效，需要手动再复制配置文件内容
English translation

After saving in ccswitch, Hermes does not take effect, and the configuration file contents must be copied manually again.

Cause

Section titled “Cause”

On Windows, CC Switch previously always wrote the Hermes configuration directory to `~/.hermes`, while Hermes first reads `HERMES_HOME`, or `%LOCALAPPDATA%\hermes` otherwise. As a result, Hermes did not read the configuration written by CC Switch, so provider switching did not take effect.

The maintainer stated that this was fixed in v3.16.5: the configuration directory resolution order now matches Hermes. #3168 reported that the configuration was not recognized after switching and mentioned using `~/herms/.env`; the original post did not provide a verifiable fix, and its path description differs from the Windows path issue in #3406.

Fix

Section titled “Fix”

  1. Upgrade CC Switch to v3.16.5 or later, then switch again and verify that the Hermes configuration takes effect.

  2. If the issue still occurs after upgrading, add reproduction details in the relevant source issue; the original post for #3168 does not yet provide a verifiable fix.

Affected Versions

Section titled “Affected Versions”
ToolHermes
Version已于 v3.16.5 修复
PlatformsWindowsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”

(No FAQ yet)

Section titled “Related problems”
All models mapped to reasoning model (Thinking) value Claude CodeUpgrade CC Switch to v3.13.0 or later to use the fixed proxy-mode model mapping logic.1 issues mergedConfiguration overwritten, Claude Code manual settings lostRead “Why did my plugin configuration disappear?” in the cc-switch README. If using v4.0, upgrade and provide the version and reproduction steps if the issue…2 issues merged1M Context Configuration Not Taking Effect Claude CodeRevert the Opus route in the cc-switch database from claude-opus-4-8 to claude-opus-4-6, then restart Claude Desktop.1 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.