启动 Hermes：按这 5 步走
开始前：先完成上面的准备事项：安装 CC Switch → 创建 API Key → 导入到 CCS。完成后，再按下面步骤启动 Hermes。
- 打开终端。
- 复制 Hermes 官方一键安装命令，粘贴到终端，按回车。
- 安装完成后关闭终端，再重新打开一次。
- 运行
hermes setup，或手动设置 fululai 的 Base URL / Key / 模型。 - 运行
hermes启动，复制本页第一个任务模板测试。
第一步：终端是什么？
终端就是电脑里的“命令输入框”。本教程里的命令不是让你写代码，只是复制一段安装/配置指令，让电脑自动完成操作。
macOS
按 Command + 空格，输入「终端」或 Terminal，回车打开。
Windows
普通方式：按 Windows 键，搜索「PowerShell」或「终端 / Windows Terminal」，回车打开。
更稳方式：如果教程写的是 WSL2，就先打开「Ubuntu」这个应用，再在里面复制命令。不会区分的话，先按普通方式尝试；不行再切换 WSL2。
第二步：安装 Hermes Agent
根据你的系统复制对应命令。
macOS / Linux / WSL2
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Windows PowerShell（官方早期 Beta）
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
不要下载 Source code.zip
GitHub 页面里的 Source code 是源码包，不是小白直接双击安装的软件。优先复制上面的官方安装命令。
GitHub 页面里的 Source code 是源码包，不是小白直接双击安装的软件。优先复制上面的官方安装命令。
安装结束后：关闭终端再重新打开，或者按提示执行
source ~/.bashrc / source ~/.zshrc。这样系统才能识别 hermes 命令。第三步：配置 fululai API
Hermes 需要知道三件事：API Key、Base URL、模型名。
方式 A：用 Hermes 向导配置
复制下面命令，按提示选择模型/供应商。如果看到自定义 API 地址，就填 fululai 的 Base URL。
hermes setup
方式 B：手动写入 fululai 配置
如果你已经拿到了 Key，可以直接用下面命令。把 sk-你的Key 换成你自己的 API Key。
hermes config set model.provider custom
hermes config set model.base_url https://api.fululai.cn/v1
hermes config set model.api_key sk-你的Key
hermes config set model.default gpt-5.5
安全提醒：API Key 不要发群里、不要截图外泄。教程里出现的
sk-你的Key 是占位符，不是真的 Key。第四步：启动 Hermes 并检查是否成功
配置完成后，输入：
hermes
如果想先检查环境，输入：
hermes doctor
doctor 是什么？
它是 Hermes 的检查工具，会告诉你依赖、配置、模型连接是否正常。
它是 Hermes 的检查工具，会告诉你依赖、配置、模型连接是否正常。
第五步：复制第一个任务模板测试
不要一开始就问很复杂的问题。先让它确认能读懂当前目录和你的目标：
请用小白能听懂的话检查当前目录结构，告诉我这个项目可能是做什么的，并给我 3 个下一步建议。不要修改文件，先只分析。
为什么这个任务适合测试？
它不会改文件，风险低；同时能测试 Hermes 是否能正常调用工具、读取目录、输出建议。
它不会改文件，风险低；同时能测试 Hermes 是否能正常调用工具、读取目录、输出建议。
常见问题：看到这些不要慌
| 问题/报错 | 是什么意思 | 怎么解决 |
|---|---|---|
| hermes: command not found | 终端还没识别 Hermes 命令。 | 关闭终端重新打开；或执行安装结束提示里的 source 命令。 |
| 401 / Unauthorized | API Key 没填、填错或多复制了空格。 | 回 fululai 控制台重新复制 Key，再配置一次。 |
| 余额不足 | fululai 账号没有可用余额。 | 去充值页小额充值后再试。 |
| model not found | 模型名填错或当前模型不可用。 | 先用 gpt-5.5 测试。 |
| 连接失败 / timeout | Base URL 填错，或网络临时不通。 | 确认是 https://api.fululai.cn/v1。 |
| Windows 安装卡住 | 原生 Windows 支持还在 Beta，环境差异较多。 | 优先使用 WSL2；如果不会 WSL2，先使用 PowerShell 方式；不行再切换 WSL2。 |