Appearance
Hermes Agent
在 Nous Research 的 Hermes Agent 里用 CodexZH 套餐额度跑 GPT / Grok 模型。
1. 安装 Hermes Agent
按 Hermes Agent 官方文档 安装:
bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashpowershell
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。

3. 在 CC Switch 里确认导入
浏览器询问是否打开 CC Switch 时点 打开,CC Switch 会弹出「确认导入供应商配置」:
- 核对应用类型是 Hermes Agent、供应商是 CodexZH、API 端点是
https://api.codexzh.com/v1 - 确认弹窗底部的开关已打开(如「导入后立即添加到 Hermes Agent 配置」,一般默认已开)
- 点 导入
没勾这个开关的:在 CC Switch 左侧选你正在配置的客户端,点 CodexZH 那一行的 ▷ 启用。下图以 Codex 为例,其他客户端操作相同。

4. 开始使用
重启 Hermes 网关,选 CodexZH 的模型发一句话测试:
bash
hermes gateway restart
hermes statusCC Switch 会把 CodexZH 写进 Hermes Agent 的供应商列表,导入后在 Hermes Agent 里选 CodexZH 的模型即可。
没有桌面环境?手动配置
主配置文件在 ~/.hermes/config.yaml,密钥放 ~/.hermes/.env。
- 在
~/.hermes/.env写入密钥:
bash
CODEXZH_API_KEY=sk-你的密钥- 在
~/.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- 重启并检查状态:
bash
hermes config check
hermes gateway restart
hermes status