← Tất cả ứng dụng · Mục Kết nối trên /docs
Anthropic + OpenAICấu hình tay
Hermes Agent
Còn gọi: Nous Hermes · hermes
Hermes Agent: hướng dẫn cấu hình khóa API, model và nhà cung cấp trong terminal.
Hướng dẫn đã xuất bản · Phiên bản ứng dụng: chưa xác minh
Ví dụ chat, ping, invoke hoặc tạo nội dung có thể gửi yêu cầu thật và phát sinh phí. Kiểm tra model, số dư, đơn giá và mức tối thiểu trước khi chạy; GET /v1/models chỉ kiểm tra xác thực và danh mục. Đặt biến môi trường an toàn
URL gốc phải dán
SDK OpenAI thường dùng URL kết thúc bằng /v1; SDK Anthropic dùng URL gốc. Tránh thêm /v1 hai lần. Giao thức tương thích không bảo đảm mọi tính năng của nhà cung cấp.
https://api.cadhayvn.com/v1Chuẩn bị
- Đã cài Hermes Agent (`hermes`)
- API key CadHayVN
- Không dùng OAuth Anthropic Max nếu muốn tính phí qua CadHayVN
Model khuyến nghị: claude-fable-5
Cách nhanh — lệnh / cấu hình
# ~/.hermes/config.yaml
model:
default: "claude-fable-5"
provider: "custom"
base_url: "https://api.cadhayvn.com/v1"
api_key: "sk-cad-..."
# Hoặc tách secret sang ~/.hermes/.env:
# OPENAI_API_KEY=sk-cad-...Bỏ file / điền Settings ở đâu
Filemacos
~/.hermes/config.yaml
Provider custom + base_url OpenAI-compatible CadHayVN. Không commit api_key.
Filelinux
~/.hermes/config.yaml
Giống macOS.
Filewindows
%USERPROFILE%\.hermes\config.yaml
Tạo thư mục .hermes; secrets trong .hermes\.env.
Fileany
~/.hermes/.env
Chỉ chứa key/token. chmod 600 trên Unix.
Kiểm tra đã chạy đúng
- `hermes chat` một câu ngắn với model CadHayVN.
- Dashboard → Sử dụng.
Khắc phục sự cố
| Triệu chứng | Nguyên nhân | Cách xử lý |
|---|---|---|
| Vẫn gọi OpenRouter / Nous | provider còn auto/openrouter. | Đặt provider: custom (hoặc anthropic) và base_url CadHayVN. |
| 404 | base_url thiếu /v1 với provider OpenAI-compatible. | base_url: "https://api.cadhayvn.com/v1" |
Ghi chú
- API CLI chưa có `api-cli configure hermes` — cấu hình tay theo trang này.
- Ưu tiên custom OpenAI-compatible hoặc anthropic + ANTHROPIC_BASE_URL; tránh OAuth Claude Max nếu muốn trừ ví CadHayVN.