Hermes Agent 配置

Hermes 原生支持大量供应商和 Custom endpoint，多数情况 不必 装 CC Switch。

官方 Providers：https://hermes-agent.nousresearch.com/docs/integrations/providers
官方 Configuration：https://hermes-agent.nousresearch.com/docs/user-guide/configuration
安装 / 向导：hermes setup

图形界面 = hermes model 交互向导（以及 Desktop 若已提供 Custom provider）。命令行 = ~/.hermes/.env + config.yaml 的 custom_providers。

快速字段

项	Chat Completions	Anthropic Messages
base_url	https://api.ashpetals.com/v1	https://api.ashpetals.com（不要 /v1）
api_mode	openai_chat	anthropic_messages（不要写成 anthropic）
Key	sk-你的APIKey，放进 .env	同左
模型示例	gpt-5.6-sol	claude-sonnet-5
分组	ChatGPT-Main / DR	Claude-Main / Pro

---

图形界面 / 交互向导（推荐）

hermes model

按提示选择：

1. Custom endpoint / OpenAI-compatible（接 GPT / 通用模型）。
2. Base URL：https://api.ashpetals.com/v1
3. API key：sk-你的APIKey
4. Model：gpt-5.6-sol（以 /v1/models 为准）

首次安装也可用：

hermes setup

Desktop 版若已开放「Custom OpenAI-compatible provider」：填同样的 Base URL + Key，保存后 开新会话（当前会话仍用旧 provider）。

Claude 分组：向导里选 Anthropic / 自定义 Anthropic 端点，Base 填 https://api.ashpetals.com，不要 /v1。

CC Switch 桌面

已用 CC Switch 管多款 CLI 时，在 Hermes 页添加供应商并启用，由工具写入 Hermes 配置目录。见 CC Switch。

---

命令行 / 配置文件

hermes config set 不能可靠写入嵌套的 custom_providers 列表。长期配置请改 ~/.hermes/config.yaml（先备份），Key 放 ~/.hermes/.env。

1. 写入 .env

# ~/.hermes/.env
ASHPETALS_API_KEY=sk-你的APIKey

key_env 必须和这个变量名一致。

2. custom_providers（OpenAI Chat）

custom_providers:
  - name: ashpetals
    base_url: https://api.ashpetals.com/v1
    api_mode: openai_chat
    key_env: ASHPETALS_API_KEY
    discover_models: true
    models:
      - gpt-5.6-sol
      - gpt-5.5
      - deepseek-v4-flash

3. Claude / Anthropic Messages（可选，第二个 provider）

  - name: ashpetals-claude
    base_url: https://api.ashpetals.com
    api_mode: anthropic_messages
    key_env: ASHPETALS_API_KEY
    discover_models: true
    models:
      - claude-sonnet-5
      - claude-opus-5

api_mode 必须是 anthropic_messages。写成 anthropic 会 HTTP 400。

4. 设为默认并同步 model.available

把 model.provider / model.default 指到刚加的供应商。config.yaml 里 两处都要有模型：custom_providers 和 model.available。只改一处，列表会脏。

model:
  provider: ashpetals
  default: gpt-5.6-sol

model.available 条目形态（缩进 4 空格）：

    - provider: ashpetals
      model: gpt-5.6-sol
      name: ashpetals-gpt-5.6-sol

不要设置全局 model.context_length 来「只放大某一个模型」——那会作用到该 profile 所有模型。

5. 检查

hermes config check
grep -A 20 'name: ashpetals' ~/.hermes/config.yaml

变更在 下一轮会话生效。

CC-Switch CLI

cc-switch --app hermes provider add
cc-switch --app hermes provider list
cc-switch --app hermes provider switch <id>

---

验证

交互：

hermes chat
# ping

一次性 CLI（以你安装的 Hermes 版本为准；常见是 -z + --cli）：

hermes -z "Reply only: PONG" --provider custom:ashpetals --model gpt-5.6-sol --cli

curl -sS https://api.ashpetals.com/v1/models \
  -H "Authorization: Bearer sk-你的APIKey" | head

---

注意事项

• Chat 用 /v1；Messages 不用 /v1。
• api_mode: anthropic 无效，必须 anthropic_messages。
• /v1/models 只证明发现，不证明推理。用 Hermes 自己发一条短消息做验收。
• discover_models: true 可在启动时拉新模型；上游列表不全时仍要在 models: 里手补。
• 切换 provider 后开新会话，避免旧进程缓存 base_url。
• 不要把 Key 提交到 Git。.env 权限建议 chmod 600。
• 推理模型请给够 max_tokens。