Skip to content

Hermes Agent ​

在 Nous Research 的 Hermes Agent 里用 CodexZH 套餐额度跑 GPT / Grok 模型。

开始前先完成 购买套餐,并装好 CC Switch。

1. 安装 Hermes Agent ​

按 Hermes Agent 官方文档 安装:

bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

2. 在控制台导入到 Hermes Agent ​

登录 CodexZH 控制台 →「CC Switch 一键导入」,客户端选 Hermes Agent,默认模型选 GPT 或 Grok 模型(如 gpt-6.1-sol),点 导入到 Hermes Agent。

控制台选择 Hermes Agent

3. 在 CC Switch 里确认导入 ​

浏览器询问是否打开 CC Switch 时点 打开,CC Switch 会弹出「确认导入供应商配置」:

  1. 核对应用类型是 Hermes Agent、供应商是 CodexZH、API 端点是 https://api.codexzh.com/v1
  2. 确认弹窗底部的开关已打开(如「导入后立即添加到 Hermes Agent 配置」,一般默认已开)
  3. 点 导入

没勾这个开关的:在 CC Switch 左侧选你正在配置的客户端,点 CodexZH 那一行的 ▷ 启用。下图以 Codex 为例,其他客户端操作相同。

在 CC Switch 中启用 CodexZH

4. 开始使用 ​

重启 Hermes 网关,选 CodexZH 的模型发一句话测试:

bash
hermes gateway restart
hermes status

CC Switch 会把 CodexZH 写进 Hermes Agent 的供应商列表,导入后在 Hermes Agent 里选 CodexZH 的模型即可。

没有桌面环境?手动配置

主配置文件在 ~/.hermes/config.yaml,密钥放 ~/.hermes/.env。

  1. 在 ~/.hermes/.env 写入密钥:
bash
CODEXZH_API_KEY=sk-你的密钥
  1. 在 ~/.hermes/config.yaml 写入最小可用配置(api_mode 必须填 codex_responses):
yaml
model:
  default: gpt-6.1-sol
  provider: custom
  base_url: https://api.codexzh.com/v1
  api_key: ${CODEXZH_API_KEY}
  api_mode: codex_responses
  context_length: 272000

fallback_model:
  provider: custom
  model: gpt-6.1-terra
  base_url: https://api.codexzh.com/v1
  key_env: CODEXZH_API_KEY
  api_key: ${CODEXZH_API_KEY}
  api_mode: codex_responses

compression:
  enabled: true
  threshold: 0.72
  target_ratio: 0.3
  protect_last_n: 32

agent:
  reasoning_effort: medium
  max_turns: 60
  gateway_timeout: 1800
  restart_drain_timeout: 20

display:
  streaming: true
  show_reasoning: false
  tool_progress: all
  1. 重启并检查状态:
bash
hermes config check
hermes gateway restart
hermes status