v0.14.0 ra mắt một câu lệnh một dòng âm thầm nuốt trọn cả một lớp câu hỏi tích hợp mà cộng đồng đã hỏi suốt nhiều tháng. Chạy hermes proxy và bạn có một endpoint cục bộ http://localhost:port mà nói API OpenAI, đứng sau là OAuth provider mà bạn đang đăng nhập qua Hermes — Claude Pro, ChatGPT Pro, hay SuperGrok.
Hệ quả thực tế: các công cụ chỉ biết nói API OpenAI — Aider, Cline, Codex CLI, Continue và một cái đuôi dài các plugin editor — giờ có thể nói chuyện với Claude Pro, ChatGPT Pro và SuperGrok qua chính gói bạn đang có, mà bạn chưa từng phải tạo một API key nào.
Đây là điểm quan trọng: phần lớn các tool này đòi quan hệ billing với từng provider. Aider với Claude → tài khoản Anthropic console kèm phương thức thanh toán. Cline với GPT-5 → tài khoản billing OpenAI. Codex CLI → cũng vậy. hermes proxy ép tất cả thứ đó lại thành một endpoint trên localhost, xác thực bằng session OAuth bạn đã có sẵn.
Đây là workflow chính xác.
0. Điều kiện cần
- •Hermes Agent v0.14.0 trở lên đã cài và cấu hình (
hermes --versionđể kiểm tra) - •Ít nhất một gói OAuth đã được liên kết qua
hermes model— Claude Pro, ChatGPT Pro, hay SuperGrok
Nếu bạn chưa từng đăng nhập vào provider OAuth nào, lần đầu chạy hermes model nó sẽ dắt bạn qua luồng OAuth của từng provider. Chọn gói bạn thực sự trả tiền.
1. Khởi động proxy
hermes proxy
Mặc định nó bind vào một port rảnh trên localhost. Log khởi động hiện URL — copy lại. Để ghim port:
hermes proxy --port 11500
Chạy nó như một process sống lâu — giữ nó sống chừng nào các tool ở dưới còn dùng. systemd, launchd, tmux, hay đơn giản là một tab terminal đều được.
2. Trỏ tool ở dưới vào proxy
Aider
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy # chuỗi nào không rỗng cũng được
aider --model claude-sonnet-4-6
Cờ --model của Aider tham chiếu tên model theo cách proxy phân giải từ config provider Hermes của bạn. Nếu bạn đăng nhập qua Claude Pro, model Claude mặc định của bạn có sẵn; tương tự cho ChatGPT Pro và SuperGrok.
Cline (VS Code)
Trong settings của Cline, chọn OpenAI Compatible làm provider. Đặt:
- •Base URL:
http://localhost:11500/v1 - •API Key:
hermes-proxy(giá trị nào không rỗng cũng được) - •Model ID: tên model từ config Hermes của bạn (ví dụ
claude-sonnet-4-6,gpt-5.1)
Save. Cline giờ route request qua Hermes; auth gói của bạn lo phần còn lại.
Codex CLI
Codex CLI thường chờ OPENAI_API_BASE và OPENAI_API_KEY. Cùng hình dạng với Aider:
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy
codex --model gpt-5-codex
Nếu bạn đăng nhập ChatGPT Pro qua Hermes, model gpt-5-codex ló qua proxy và Codex CLI có quyền truy cập đầy đủ, mà bạn không bao giờ phải tạo quan hệ billing với OpenAI.
Continue (JetBrains / VS Code)
Sửa config Continue (~/.continue/config.json hay qua UI):
{
"models": [{
"title": "Claude via Hermes",
"provider": "openai",
"model": "claude-sonnet-4-6",
"apiBase": "http://localhost:11500/v1",
"apiKey": "hermes-proxy"
}]
}
Cùng mẫu. "provider" vẫn là openai vì với Continue, nó đang đập vào một endpoint OpenAI.
3. Kiểm chứng nó chạy
Test curl nhanh:
curl http://localhost:11500/v1/models -H "Authorization: Bearer hermes-proxy"
Bạn nên nhận lại danh sách model mà config provider Hermes phơi ra. Nếu nhận 401 hay danh sách rỗng, proxy đang chạy nhưng Hermes không thấy session OAuth sống nào — chạy lại hermes model và chọn provider mà bạn có gói còn hiệu lực.
4. Khắc phục sự cố
- •"Connection refused" — proxy chưa chạy. Khởi động đi.
- •"401 unauthorized" — model bạn yêu cầu không nằm trong gói bạn đã liên kết. Chạy
hermes modelxem provider nào đang sống. - •"Model not found" — tên model trong tool ở dưới không khớp với cái provider Hermes phơi ra. Dùng tên từ
hermes model list. - •Bị rate-limit — bạn đang đập vào giới hạn rate của chính gói (Claude Pro khoảng ~50 tin nhắn mỗi 5 giờ trên Sonnet; ChatGPT Pro có quota riêng; SuperGrok cũng vậy). Proxy không thêm rate limiter; nó chuyển tiếp quota mà provider cấp cho bạn.
Vì sao chuyện này quan trọng
API OpenAI là lingua franca của hệ sinh thái tool AI. Gần như mọi plugin editor và code assistant đều hỗ trợ OpenAI trước, rồi mới đến "endpoint OpenAI-compatible". Cái bẫy là "endpoint compatible" gần như luôn nghĩa là "bạn cần API key, nghĩa là cần tài khoản billing, nghĩa là gói 20 đô/tháng của bạn biến thành tài khoản trả-theo-dùng trên dashboard của ai đó".
hermes proxy ép vấn đề đó lại. Gói OAuth của bạn ở yên chỗ cũ. Proxy nói OpenAI trên localhost. Aider, Cline, Codex CLI, Continue — chúng không biết mình đang nói chuyện với Claude hay Grok. Chúng chỉ thấy một endpoint OpenAI hoạt động.
Một gói, mọi tool, không API key. Toàn bộ pitch nằm gọn trong đó.