Hermes Agent
Hermes Agent 是一款开源的终端 AI 编程助手，支持通过自定义模型接入进行智能对话与代码辅助。
配置步骤
- CC Switch 配置
- CLI 交互式向导
- 手动修改配置文件
CC Switch 是一款开源的桌面应用，统一管理多个 AI 编程工具的供应商配置。安装方式参考 CC Switch 配置文档。
- 打开 CC Switch，添加云开发供应商
| 字段 | 说明 |
|---|---|
| API Key | 在 AI 控制台 中获取 |
| Base URL | https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase |
| API 格式 | Chat Completions |
- 切换启用云开发供应商即可使用
通过命令行交互菜单，系统会引导你一步步输入 API Key 和模型名称，推荐首次配置使用。
- 在终端运行以下命令，启动配置向导
hermes model
- 选择 Custom endpoint (enter URL manually)，按照表格填写如下交互表单
| 字段 | 说明 |
|---|---|
| API Base URL | 大模型 API 的请求地址，在 AI 控制台中获取，格式为 https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase |
| API Key | 调用大模型的密钥，在 AI 控制台中获取 |
| API compatibility mode | 选择 "1" Auto-detect |
| Model Name | 大模型标识，在 AI 控制台 模型列表中复制已启用的模型 ID 填入，如 hy3 |
- 配置完成后即可开始使用
Hermes Agent 的核心设置保存在 ~/.hermes/config.yaml 文件中，你可以直接修改该文件来接入自定义模型。
- 打开配置文件
备注
如果通过您文件浏览器找到文件，文件浏览器默认会隐藏掉以"."开头的文件名的文件，您可能需要打开文件浏览器的隐藏文件选项才能看到。
Mac 通过访达快捷键 Command + Shift + . 打开，Windows 可以通过勾选 "文件资源管理器 - 查看 - 显示 - 隐藏项目"
打开。
- Mac/Linux 配置路径
~/.hermes/config.yaml
- Windows 配置路径
C:\Users\<你的用户名>\.hermes\config.yaml
- 填入配置
在 config.yaml 中填入自定义模型配置，各字段含义如下：
| 字段 | 说明 |
|---|---|
| model.default | 默认使用的模型名称，在 AI 控制台 模型列表中复制已启用的模型 ID 填入 |
| model.provider | 提供商类型，填写 custom 表示自定义接入 |
| model.base_url | 大模型 API 的请求地址（Base URL），在 AI 控制台中获取 |
| model.api_key | 调用大模 型的密钥（API Key），在 AI 控制台中获取 |
配置示例：
model:
default: hy3
provider: custom
base_url: https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
api_key: eyJhbGciOiJSUzI1N...
- 配置完成后即可开始使用
常见错误排查
| 报错信息 | 解决方法 |
|---|---|
404 AI_MODEL_NOT_FOUND | Base URL 填写不正确，请前往 AI 控制台中复制正确的 Base URL |
401 认证失败 | API Key 填写错误，或者可能被删除 |
429 Token usage exceeded quota | 配置了错误的大模型名称，或者大模型未在 AI 控制台 中启用 |