Hermes Agent 接入
Hermes Agent 支持自定义 API 接入点，配合 ClaudeAPI.com 国内直连，无需代理即可在国内稳定使用 Claude 全系模型。
什么是 Hermes Agent？
前置条件
| 平台 | 要求 |
|---|---|
| macOS / Linux | 安装 Git 即可，其余依赖由安装脚本自动处理 |
| Windows | 需先安装 WSL2，在 WSL2 终端内执行后续所有命令 |
Hermes 暂不支持原生 Windows 环境，Windows 用户请参阅 WSL2 安装指南。
Step 1：安装 Hermes Agent
Step 2：配置 code0 接入点
方式一：hermes model 交互式配置（推荐新手）
| 提示项 | 填写内容 |
|---|---|
| API base URL | https://hk.code0.ai |
| API Key | 你的 API Key（sk- 开头） |
| Model name | claude-sonnet-4-6（或其他模型，见下方列表） |
~/.hermes/config.yaml，立即生效。还没有 ClaudeAPI.com API Key？访问 code0.ai 注册，支持支付宝 / 微信充值，无需境外信用卡。
方式二：直接编辑 config.yaml（推荐有经验的用户）
model: 部分，修改为：hermes 自动读取新配置。Step 3：验证配置
LLM provider: OK 即表示连接正常。可用模型列表
config.yaml 的 default 字段填写对应 Model ID：| 模型 | Model ID | 适用场景 |
|---|---|---|
| Claude Opus 4.6 | claude-opus-4-6 | 复杂推理、长上下文、高质量生成 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 | 通用开发、Agent 工作流（默认推荐） |
| Claude Haiku 4.5 | claude-haiku-4-5-20251001 | 轻量请求、快速响应 |
config.yaml 中的 default 字段，或重新运行 hermes model。进阶：配置 Fallback 模型
config.yaml 中添加：常用命令速查
| 命令 | 说明 |
|---|---|
hermes | 启动交互式对话 |
hermes model | 切换 LLM 提供商和模型 |
hermes setup | 运行完整配置向导 |
hermes doctor | 诊断连接和配置问题 |
hermes update | 更新到最新版本 |
hermes tools | 配置启用的工具 |
hermes --continue | 继续上一次对话 |
常见问题
hermes 后提示 connection error，怎么排查？hermes doctor 查看详细错误。最常见原因是 base_url 填写有误，确认填写的是 https://hk.code0.ai（不带结尾斜杠）。api_mode: anthropic_messages 是必填的吗？api_mode: anthropic_messages，否则 Hermes 会默认用 OpenAI Chat Completions 格式请求，导致报错。~/.hermes/config.yaml，修改 api_key 字段保存即可，无需重新运行 hermes setup。