Hermes Agent CLI 安装与配置 4sAPI（CC Switch）

配置前注意事项

处于国内网络，配置URL（API地址）时改成下面其中之一：

https://4sapi.org
https://4sapi.cn
https://4sapi.net
https://4sapi.ai
https://4stoken.com

海外网络不需要修改，可以正常使用URL https://4sapi.com 。

本文档帮助你在 Windows 上把 Hermes CLI 接入 4SAPI。完成后，可在 PowerShell 或 CMD 中运行 hermes，通过 4SAPI 调用模型。

重要：Hermes CLI 需要在 CC Switch 中手动添加配置。不要使用 4SAPI 令牌列表里的 一键 CC Switch 导入 入口。

一、准备工作

开始前，请准备好：

可正常登录的 4SAPI 账号。

已安装或准备安装的 Hermes CLI。

已安装或准备安装的 CC Switch。

可访问 https://4sapi.com/ 的网络。

处于国内网络，URL改成下面其中之一（url末尾加上 /v1）：

https://4sapi.org
https://4sapi.cn
https://4sapi.net
https://4sapi.ai
https://4stoken.com

海外网络不需要修改，可以正常使用 https://4sapi.com （url末尾加上 /v1）。

一个包含可用模型的 4SAPI 令牌分组。

建议为 Hermes CLI 选择支持较长上下文的模型。模型是否可用，以 4SAPI 后台和当前令牌分组为准。

二、安装 Hermes CLI

打开 PowerShell，执行安装命令：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

首次安装的时间可能比较久，安装完成后，关闭当前终端，再重新打开 PowerShell 或 CMD。

执行下面的命令检查安装结果：

如果能看到版本号，说明 Hermes CLI 已安装成功。

三、安装 CC Switch

请先按照 4SAPI 官方文档安装 CC Switch：

【CC Switch 安装教程】https://4sapi.apifox.cn/8463188m0

安装后打开 CC Switch。顶部应用列表中应能看到 Hermes 入口。

如果没有 Hermes 入口，请先更新 CC Switch。

四、创建 Hermes 专用令牌

打开 4SAPI 官网并登录：

https://4sapi.com/

进入 控制台 → 令牌管理 → 添加令牌。

按下面的方式填写：

名称：建议填写 Hermes令牌。

令牌分组：选择给 Hermes CLI 使用的分组。该分组中必须包含要使用的模型。

额度设置：按需要设置；不限制额度时保持默认即可。

访问限制：没有特殊网络要求时保持默认即可。

填写完成后，点击提交。页面会回到令牌列表。

五、复制令牌密钥

在令牌列表中找到刚创建的 Hermes 令牌。

点击该令牌所在行中间密钥旁边的复制按钮，然后选择 复制密钥。

注意：这里要复制的是密钥。不要选择 复制连接信息，也不要使用聊天下拉菜单里的 CC Switch 导入入口。

六、在 CC Switch 中手动添加 Hermes 配置

打开 CC Switch，点击顶部应用列表中的 Hermes 图标。

进入 Hermes 页面后，点击右上角的加号。

在添加供应商页面中，点击 自定义配置。

进入自定义配置页面后，按下面的方式填写：

供应商名称：建议填写 My Hermes。

备注：可不填，也可以写用途说明。

官网链接：填写 https://4sapi.com/。

API Key：粘贴刚才复制的 4SAPI 令牌密钥。

请求地址：填写 https://4sapi.com/v1。如果 4SAPI 页面或客服给出的地址不同，以实际地址为准。

模型 ID：填写要给 Hermes CLI 使用的模型 ID。模型 ID 必须和 4SAPI 后台展示的一致。

如果页面支持 获取模型列表，可以先点击获取。获取失败时，点击 添加模型，手动填写模型 ID。

模型添加完成后，选择要使用的模型，点击添加或保存。

七、启用配置并测试连通性

添加成功后，CC Switch 会回到 Hermes 配置列表。

找到刚添加的配置，例如 My Hermes，点击启用。

启用后，点击该配置右侧的 连通性测试。

如果页面提示 连通正常，说明 CC Switch 配置已生效。

启用配置后，请关闭所有已打开的 PowerShell 或 CMD，再重新打开终端。这样 Hermes CLI 才能读取最新配置。

八、验证 Hermes CLI

重新打开 PowerShell 或 CMD，进入你的项目目录。

执行下面的命令启动 Hermes CLI：

如果首次启动时提示选择供应商、登录或初始化，请先回到 CC Switch，确认 Hermes 配置处于 使用中 状态。

进入 Hermes CLI 后，输入一条测试消息：

请用一句话说明你已经连接成功。

如果模型可以正常回复，说明 Hermes CLI 已通过 CC Switch 接入 4SAPI。

如果 Hermes CLI 提示需要选择模型，请回到 CC Switch 检查 模型 ID，并重新做 连通性测试。

九、常见问题

输入 `hermes` 后提示命令不存在

通常是 Hermes CLI 没有安装成功，或安装目录没有加入环境变量。

请重新执行安装命令。安装完成后，关闭终端，再重新打开 PowerShell 或 CMD。

启用配置后 Hermes CLI 仍然走默认服务

请检查：

CC Switch 当前页面是 Hermes，不是 Claude Code、OpenCode 或其他应用。

刚添加的 My Hermes 配置已经处于 使用中 状态。

启用配置后，已经重新打开 PowerShell 或 CMD。

项目目录下没有旧的 .env 配置。

本机没有旧的 OPENAI_API_KEY、OPENAI_BASE_URL 等环境变量。

如果之前在 Hermes CLI 中配置过其他供应商，也请确认旧配置不会覆盖 CC Switch 当前配置。

添加后无法连通

请检查：

4SAPI 令牌是否已启用。

令牌分组中是否包含所选模型。

CC Switch 中是否已点击启用。

API Key 是否复制完整。

请求地址 是否填写为 4SAPI 的 OpenAI 兼容地址。

模型 ID 是否和 4SAPI 后台展示的一致。

当前网络是否可以访问 https://4sapi.com/。

运行 `hermes` 后提示需要登录

请先关闭所有终端窗口，再重新打开终端运行 hermes。

如果仍然提示登录，请回到 CC Switch，确认 My Hermes 处于 使用中 状态，并重新执行 连通性测试。

Hermes CLI 提示上下文长度不足

请在 4SAPI 令牌分组和 CC Switch 配置中，选择支持更长上下文的模型。模型可用性以 4SAPI 后台当前展示为准。

可以从 4SAPI 官网一键导入 Hermes 配置吗

不建议。Hermes CLI 需要在 CC Switch 中手动添加 配置。

4SAPI 官网只用于创建令牌和复制密钥。

在 WSL 中运行 Hermes CLI 无法读取配置

本文档以 Windows 原生 PowerShell 或 CMD 为例。

如果你在 WSL 中运行 Hermes CLI，请确认 WSL 能读取 CC Switch 写入的配置。无法读取时，请先在 Windows 原生终端中验证，或按 Hermes 官方方式在 WSL 内单独配置。

Hermes Agent CLI 安装与配置 4sAPI（CC Switch）

配置前注意事项#

一、准备工作#

二、安装 Hermes CLI#

三、安装 CC Switch#

四、创建 Hermes 专用令牌#

五、复制令牌密钥#

六、在 CC Switch 中手动添加 Hermes 配置#

七、启用配置并测试连通性#

八、验证 Hermes CLI#

九、常见问题#

输入 hermes 后提示命令不存在#

启用配置后 Hermes CLI 仍然走默认服务#

添加后无法连通#

运行 hermes 后提示需要登录#

Hermes CLI 提示上下文长度不足#

可以从 4SAPI 官网一键导入 Hermes 配置吗#

在 WSL 中运行 Hermes CLI 无法读取配置#