外接

Hermes 配置教程

外接使用说明

为了获得更稳定、完整的体验，我们优先推荐在模型提供方的官方客户端中使用对应模型。

第三方客户端的更新进度与接口适配存在差异，可能遇到缓存未命中（掉缓存）、工具无法调用或请求报错等兼容性问题。遇到问题时，可先检查客户端版本、配置及模型支持情况。

本教程以简单、快捷的基础接入为目标。进阶功能与自定义玩法欢迎自行探索，但通常需要一定技术基础，且不属于常规售后支持范围。售后会视具体情况尽力提供建议，无法承诺逐项排查或解决。

本教程通过编辑 Hermes 的 config.yaml，接入 CCTQ 的 GPT 和 Claude 模型。开始前，请先安装 Hermes，并准备自己的 令牌 Key。

一、找到 Hermes 配置文件

不同系统的 HERMES_HOME 默认位置不同，配置文件均为该目录下的 config.yaml：

系统	HERMES_HOME 默认位置	config.yaml 位置
Windows 原生版	%LOCALAPPDATA%\hermes	%LOCALAPPDATA%\hermes\config.yaml
Linux	~/.hermes	~/.hermes/config.yaml
macOS	~/.hermes	~/.hermes/config.yaml

打开对应系统的 config.yaml。如果文件还不存在，可以先启动一次 Hermes，让它生成配置目录和文件。

二、将配置追加到文件末尾

把下面整段内容追加到 config.yaml 的最底部：

# ===== 自定义第三方模型 =====

providers:
  # GPT / Codex
  cctq:
    api: https://www.cctq.ai/v1
    api_key: sk_xxxx
    transport: codex_responses
    models:
      gpt-6-astra:
        context_length: 272000
      gpt-5-sol:
        context_length: 272000

  # Claude
  cctq_claude:
    api: https://www.cctq.ai
    api_key: sk_xxxx
    transport: anthropic_messages
    models:
      claude-opus-5:
        context_length: 272000
      claude-sonnet-5:
        context_length: 272000

# 默认启动模型
model:
  default: gpt-6-astra
  provider: custom:cctq

# ==== 自定义配置结束 ====

请注意：

• 只能追加到文件最后，不要删除 config.yaml 原有的任何配置项。
• sk_xxxx 是占位符，请替换为自己在 CCTQ 创建的令牌 Key。
• gpt-6-astra、gpt-5-sol、claude-opus-5 和 claude-sonnet-5 只是示例模型，请以当前令牌实际支持的模型为准。
• 保存文件后，重新启动 Hermes，让配置生效。

三、配置字段说明

模型与服务商字段

字段	含义
providers	自定义模型服务商的总配置区域。
cctq	GPT / Codex 服务商的自定义名称，名称可以保持不变。
cctq_claude	Claude 服务商的自定义名称，和 GPT 使用不同名称。
api	模型接口地址。GPT / Codex 使用带 /v1 的地址，Claude 使用不带 /v1 的地址。
api_key	访问 CCTQ 接口的令牌 Key。示例中的 sk_xxxx 需要替换为自己的 Key。
transport	Hermes 使用的接口协议。codex_responses 对应 GPT / Codex，anthropic_messages 对应 Claude。
models	当前服务商下可使用的模型列表。
context_length	模型支持的上下文长度，示例值为 272000；实际以模型支持情况为准。

默认模型字段

字段	含义
model.default	Hermes 启动时默认选择的模型，示例为 gpt-6-astra。
model.provider	默认模型所属的服务商。custom:cctq 表示使用上方 cctq 服务商。

四、在 Hermes 中选择模型

重新启动 Hermes，在模型列表中选择需要使用的模型。截图中选择的是 gpt-6-astra。

五、发送消息测试

发送一句 你好。收到正常回复，说明图形界面的基础配置已经生效。

如果你同时使用 Hermes 命令行，也可以启动 Hermes 后发送测试消息；终端显示当前模型和正常回复，说明命令行配置已生效。

若请求失败，先检查 config.yaml 是否保存、配置是否确实追加在文件末尾，以及接口地址、令牌 Key、协议和模型名称是否对应。请勿公开真实令牌 Key。