Hermes Agent CLI 安装接入147AI-CC Switch

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

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

一、准备工作

开始前，请准备好：

可正常登录的 147AI 账号。

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

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

可访问 https://api.147ai.cn 的网络。

一个包含可用模型的 147AI 令牌分组。

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

二、安装 Hermes CLI

windows

mac

打开 PowerShell，执行安装命令：

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

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

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

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

三、配置 CC Switch

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

四、复制令牌密钥

在令牌列表中找到已创建好的令牌。

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

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

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

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

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

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

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

：

供应商名称：可随意填写。

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

官网链接：填写 https://api.147ai.cn/。

API Key：粘贴刚才复制的 147AI 令牌密钥。

请求地址：填写 https://api.147ai.cn/v1。如果 147AI 页面或客服给出的地址不同，以实际地址为准。

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

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

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

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

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

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

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

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

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

七、验证 Hermes CLI

重新打开终端，进入你的项目目录。

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

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

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

Hi

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

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

八、常见问题

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

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

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

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

请检查：

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

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

启用配置后，已经重新打开终端。

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

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

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

添加后无法连通

请检查：

147AI 令牌是否已启用。

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

CC Switch 中是否已点击启用。

API Key 是否复制完整。

请求地址 是否填写为 147AI 的 OpenAI 兼容地址。

模型 ID 是否和 147AI 后台展示的一致。

当前网络是否可以访问 https://api.147ai.cn。

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

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

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

Hermes CLI 提示上下文长度不足

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

可以从 147AI 官网一键导入 Hermes 配置吗

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

147AI 官网只用于创建令牌和复制密钥。

Hermes Agent CLI 安装接入147AI-CC Switch

一、准备工作#

二、安装 Hermes CLI#

三、配置 CC Switch#

四、复制令牌密钥#

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

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

七、验证 Hermes CLI#

八、常见问题#

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

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

添加后无法连通#

运行 hermes 后提示需要登录#

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

可以从 147AI 官网一键导入 Hermes 配置吗#