Hermes Agent 一键配置安装教程

0. 前置：先安装 Hermes Agent

一键配置脚本只负责写配置，不会自动安装 Hermes。请先手动安装：

pipx install hermes-agent

如果你没有 pipx，可以先安装：

pip install pipx
pipx ensurepath

然后重新打开终端，再执行 pipx install hermes-agent。

验证安装：

hermes --version

如果看到版本号，说明安装成功了。

1. 运行一键配置命令

第一步：打开终端

• macOS：打开 Terminal
• Linux：打开你常用的终端
• Windows：请使用 Git Bash、MSYS2 或 WSL 终端运行下面命令

第二步：执行一键配置命令

curl -sSL https://sh.flashapi.top/hermes.sh | bash

脚本启动后会按顺序引导你完成所有配置，不需要手动选菜单。

2. 这个脚本会做什么

脚本会按顺序引导你完成下面几件事：

2.1 选择 API 线路

你会看到两条线路：

• https://ai.flashapi.top：国内直连，适合中国大陆用户
• https://cdn.flashapi.top：海外 CDN，适合海外网络环境

2.2 选择模型类型

脚本会让你先选模型大类：

• GPT：走 OpenAI 接口，Base URL 自动加 /v1
• Claude：走 Anthropic 接口，Base URL 不带 /v1

这一步决定了配置文件里 type 和 base_url 的写法。

2.3 输入 API Key

输入时会用 * 遮盖，不会明文显示。

2.4 自动拉取模型列表

脚本会实时请求模型列表，再让你从返回结果里选择具体模型。

如果拉取失败，脚本会使用内置推荐列表作为备选。

2.5 写入配置文件

脚本最终写入 ~/.hermes/config.yaml。

选 Claude 时，写入的配置示例：

models:
  default: 'flashapi-claude/claude-opus-4-6'

providers:
  flashapi-claude:
    type: 'anthropic'
    base_url: 'https://ai.flashapi.top'
    api_key: '你的 API Key'
    api_key_env: 'ANTHROPIC_API_KEY'
    default_model: 'claude-opus-4-6'
    models:
      - 'claude-opus-4-6'

选 GPT 时，写入的配置示例：

models:
  default: 'flashapi-codex/gpt-5.5'

providers:
  flashapi-codex:
    type: 'openai'
    base_url: 'https://ai.flashapi.top/v1'
    api_key: '你的 API Key'
    api_key_env: 'OPENAI_API_KEY'
    default_model: 'gpt-5.5'
    models:
      - 'gpt-5.5'

如果 ~/.hermes/config.yaml 已经存在，脚本会先备份原文件（加时间戳后缀），再写入新配置。

3. 使用前你还需要准备什么

在运行一键配置前，请先准备好下面两样：

• 一个可用的闪电 API Key
• 你已经在 ai.flashapi.top 后台创建好对应的令牌分组

4. 配置完成后怎么用

脚本执行完成后，直接运行：

hermes

脚本执行结束时也会询问你是否立即启动 Hermes，选 y 即可直接进入。

常见问题

1. 脚本提示未找到 curl

解决方法：

• macOS：brew install curl
• Ubuntu/Debian：sudo apt install curl
• Windows Git Bash：通常已内置，如果没有请安装 Git for Windows

2. 模型列表拉取失败

原因：API Key 不正确，或令牌分组未创建，或网络不通。

解决方法：

1. 确认令牌分组已在 ai.flashapi.top 后台创建
2. 检查 API Key 是否复制完整
3. 尝试切换线路（国内直连 / 海外 CDN）

脚本在拉取失败时会自动使用内置推荐列表，你仍然可以完成配置。

3. 配置写入后 Hermes 还是用旧模型

解决方法：

1. 检查配置文件：cat ~/.hermes/config.yaml
2. 如果 Hermes 正在运行，退出后重新启动