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

访问地址：https://koalaapi.com（OpenAI 兼容接口在末尾加 /v1）。

配置速查

配置项	填写内容
Base URL	`https://koalaapi.com`；OpenAI 兼容接口填 `https://koalaapi.com/v1`
API Key	控制台 → 令牌管理创建的令牌，形如 `sk-...`
模型名称	与控制台【模型广场】完全一致；不同令牌分组可用的模型不同

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

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

一、准备工作

开始前，请准备好：

可正常登录的 KoalaAPI 账号。

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

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

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

处于国内网络时，URL 用 https://koalaapi.com/v1。

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

二、安装 Hermes CLI

打开 PowerShell，执行安装命令：

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

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

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

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

三、配置 KoalaAPI

打开 CC Switch，进入 Hermes 的配置页面，点击添加供应商

（截图待补）

选择自定义配置

（截图待补）

填写 KoalaAPI 地址、令牌以及 获取模型列表 并添加，对于 API 格式，国产模型推荐使用 OpenAI Chat Completions，Claude 模型使用 Anthropic Messages 格式，GPT 模型使用 OpenAI Chat 或者 Responses 格式，配置完成最后点击保存。

（截图待补）

点击启用。

（截图待补）

四、验证 Hermes CLI

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

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

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

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

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

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

（截图待补）

如果 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 当前配置。

添加后无法连通

请检查：

KoalaAPI 令牌是否已启用。

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

CC Switch 中是否已点击启用。

API Key 是否复制完整。

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

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

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

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

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

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

Hermes CLI 提示上下文长度不足

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

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

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

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

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

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

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

更新于 2026-11　官方文档：https://hermes-agent.nousresearch.com/

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

Hermes Agent CLI 安装与配置 KoalaAPI（CC Switch）#

一、准备工作#

二、安装 Hermes CLI#

三、配置 KoalaAPI#

四、验证 Hermes CLI#

九、常见问题#

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

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

添加后无法连通#

运行 hermes 后提示需要登录#

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

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

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

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

一、准备工作

二、安装 Hermes CLI

三、配置 KoalaAPI

四、验证 Hermes CLI

九、常见问题

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

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

添加后无法连通

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

Hermes CLI 提示上下文长度不足

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

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