Trang chủ / Tìm hiểu / Hermes Agent với Claude thông qua cổng kết nối: thiết lập nhà cung cấp tùy chỉnh, kiểm soát chi phí và khắc phục lỗi
Hermes Agent. Một thông điệp bằng giấy gấp hình cánh bay qua một vòm cổng nhỏ hướng tới không gian làm việc với mã ngăn nắp, tượng trưng cho việc định tuyến tác tử.

Hermes Agent với Claude qua cổng API: thiết lập nhà cung cấp tùy chỉnh, kiểm soát chi phí và cách khắc phục lỗi

Hermes Agent lưu thông tin bí mật trong ~/.hermes/.env và mọi thứ khác trong ~/.hermes/config.yaml. Cách đáng tin cậy để chạy nó trên Claude thông qua cổng kết nối là dùng một nhà cung cấp tùy chỉnh có tên sử dụng định dạng Anthropic Messages. Cách làm tắt, provider: anthropic với một URL cơ sở khác, trông có vẻ đúng nhưng lại gửi yêu cầu đến Anthropic đối với mọi máy chủ mà nó không nhận diện được.

Cài đặt

Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

hermes setup chạy toàn bộ trình hướng dẫn; hermes model chỉ xử lý nhà cung cấp và mô hình; hermes doctor kiểm tra bản cài đặt hiện có.

Thêm cổng kết nối làm nhà cung cấp tùy chỉnh

~/.hermes/.env
AIPRIME_API_KEY=your_gateway_key
~/.hermes/config.yaml
providers:
  aiprime:
    api: https://aiprimetech.io/v1
    key_env: AIPRIME_API_KEY
    transport: anthropic_messages
    catalog_provider: anthropic

model:
  provider: custom:aiprime
  default: claude-sonnet-5
Khóa Lý do
transport: anthropic_messagesSử dụng định dạng Messages của Anthropic. Nếu thiếu thiết lập này, Hermes sẽ chuyển sang định dạng OpenAI Chat Completions
key_envTên của biến trong .env chứa khóa
catalog_provider: anthropicCác mô hình Claude của cổng kết nối kế thừa siêu dữ liệu về ngữ cảnh và thị giác của Anthropic
provider: custom:aiprimeChọn nhà cung cấp có tên; /model custom:aiprime:<model> chuyển đổi trong cuộc trò chuyện

Trình hướng dẫn thực hiện tương tự: hermes model, rồi **Điểm cuối tùy chỉnh**, sau đó chọn chế độ API **Anthropic Messages**. Nếu chọn Chat Completions, hãy giữ /v1 trong URL.

Vì sao provider: anthropic với URL cơ sở không hoạt động

Thiết lập provider: anthropic và base_url: https://aiprimetech.io trông có vẻ đúng nhưng không có tác dụng: trong mã nguồn Hermes hiện tại, việc ghi đè URL cơ sở trên nhà cung cấp Anthropic tích hợp sẵn chỉ được chấp nhận với các máy chủ Anthropic, Claude và Azure, nên yêu cầu vẫn được gửi đến Anthropic. Hãy dùng nhà cung cấp tùy chỉnh có tên ở trên.

ANTHROPIC_BASE_URL được ghi trong tài liệu là cách ghi đè URL cơ sở của Anthropic, nhưng một lỗi Hermes chưa được khắc phục khiến bộ chọn mô hình bỏ qua thiết lập này. Nhà cung cấp tùy chỉnh tránh được cả hai vấn đề.

Những yếu tố làm tăng mức sử dụng token và các thiết lập để giới hạn

Hermes thực hiện công việc ngoài cuộc trò chuyện bạn nhìn thấy, và tất cả đều được tính phí vào cùng một khóa trừ khi bạn định tuyến chúng sang nơi khác.

Nguồn phát sinh mức sử dụng Thiết lập
Subagents (delegation)delegation.max_concurrent_children (mặc định 10), delegation.max_iterations (mặc định 250), delegation.max_spawn_depth (mặc định 1); một giá trị rẻ hơn cho delegation.model
Xử lý bộ nhớ và rà soát kỹ năng ở chế độ nền sau mỗi lượtauxiliary.background_review.enabled: false, hoặc giá trị thấp hơn cho max_input_tokens
Các tác vụ phụ trợ (nén, tiêu đề, thị giác)auxiliary.<task>.provider và .model để gửi chúng đến một mô hình rẻ hơn
Tác vụ theo lịchcron.model cho tất cả tác vụ; hermes cron pause <id> hoặc hermes pause
Cổng kết nối nhắn tin (Telegram, Discord và các dịch vụ khác)Các danh sách cho phép như TELEGRAM_ALLOWED_USERS; tránh GATEWAY_ALLOW_ALL_USERS=true
~/.hermes/config.yaml (phần bổ sung)
delegation:
  max_concurrent_children: 3
  model: claude-haiku-4-5
auxiliary:
  background_review:
    enabled: false
cron:
  model: claude-haiku-4-5

hermes prompt-size cho biết chi phí cố định của mỗi lần gọi; /usage và /compress hữu ích trong một phiên dài.

Đăng nhập Claude Pro hoặc Max thay cho khóa

Hermes có thể đăng nhập vào tài khoản Claude, nhưng tài liệu của Hermes cho biết cách này chỉ hoạt động với gói Max đã mua tín dụng sử dụng bổ sung và người đăng ký Pro không thể dùng. Với khóa API từ cổng kết nối, không có khung thời gian sử dụng theo gói đăng ký; mức sử dụng được tính phí theo từng token và trừ vào số dư của bạn.

Mô hình

ID mô hình Dùng cho
claude-sonnet-5Lựa chọn mặc định cho lập trình và tác vụ của tác nhân: nhanh, mạnh, giá tầm trung.
claude-opus-5-5Suy luận khó hơn, tái cấu trúc mã quy mô lớn, tác nhân chạy trong thời gian dài.
claude-fable-5-1Năng lực cao nhất và đắt nhất; dành cho các tác vụ khó nhất.
claude-haiku-4-5Rẻ và nhanh: tiêu đề, tóm tắt, phân loại, các bước nhỏ.

Hermes cần cửa sổ ngữ cảnh tối thiểu 64K token; mọi mô hình trong bảng đều đáp ứng yêu cầu.

Khắc phục sự cố

Những gì bạn thấy Nguyên nhân Cách khắc phục
HTTP 400 trong lần chạy đầu tiênTên mô hình không khớp với ID mô hình của cổng kết nốiDùng một ID trong bảng phía trên
Yêu cầu được gửi đến Anthropic hoặc thất bại với lỗi xác thực Anthropicprovider: anthropic với URL cơ sở của bên thứ baSử dụng nhà cung cấp tùy chỉnh có tên
Phản hồi vô nghĩa hoặc trốngPhương thức truyền tải không phù hợp với URLtransport: anthropic_messages cho Claude
Vượt quá độ dài ngữ cảnhPhiên lớn hơn cửa sổ ngữ cảnh đã cấu hìnhĐặt model.context_length; /compress
403 Your request was blockedTường lửa phía trước điểm cuối từ chối ứng dụng kháchThêm extra_headers với User-Agent giống trình duyệt
Thiếu thiết lập sau khi cập nhậtLược đồ cấu hình đã thay đổihermes config check, sau đó hermes config migrate
Bot không phản hồi trên Telegram hoặc DiscordCổng không chạy hoặc người gửi không được phéphermes gateway status; kiểm tra ~/.hermes/logs/gateway.log

Bạn đang so sánh các framework tác nhân? Xem hướng dẫn thiết lập OpenClaw.

Câu hỏi thường gặp

Làm cách nào để sử dụng Hermes Agent với điểm cuối Claude tùy chỉnh?
Thêm một nhà cung cấp có tên trong ~/.hermes/config.yaml với api được đặt thành URL của cổng, key_env trỏ đến một biến trong ~/.hermes/.env và transport: anthropic_messages, sau đó đặt model.provider: custom:<name>.
Tại sao Hermes bỏ qua base_url Anthropic của tôi?
Với provider: anthropic, Hermes chỉ chấp nhận ghi đè URL cơ sở cho các máy chủ Anthropic, Claude và Azure, nên URL của bên thứ ba bị loại bỏ. Thay vào đó, hãy sử dụng nhà cung cấp tùy chỉnh có tên.
Làm cách nào để giảm mức sử dụng token của Hermes Agent?
Giới hạn các tác nhân con (thiết lập ủy nhiệm), chuyển các tác vụ phụ trợ và tác vụ cron sang mô hình rẻ hơn, tắt việc rà soát nền và kiểm tra hermes prompt-size.
Hermes Agent có thể sử dụng gói đăng ký Claude Pro không?
Theo tài liệu của Hermes, không: phương thức đăng nhập Claude chỉ hoạt động với gói Max có tín dụng sử dụng bổ sung. Khóa API giúp tránh hoàn toàn các giới hạn của gói đăng ký.
Bắt đầu sử dụng Claude chỉ trong vài phút

Lấy khóa API — không cần tài khoản Anthropic hay đăng ký danh sách chờ.

Lấy khóa API của bạn

AI Prime Tech là một cổng API độc lập. AI Prime Tech không liên kết với, không được Anthropic chứng thực và không phải là đại lý bán lại của Anthropic. Claude và các tên mô hình liên quan là nhãn hiệu của chủ sở hữu tương ứng.

Các hướng dẫn khác về Claude API

Cách lấy khóa Claude APIGiải thích giá API ClaudeCách tiết kiệm nhất để sử dụng Claude APICursor không giới hạn với Claude APITruy cập Claude Code không giới hạnCổng Claude API so với truy cập trực tiếp AnthropicDùng Claude với SDK OpenAI: điểm cuối tương thích OpenAI, truyền luồng, công cụ và giới hạnGiải thích các mô hình Claude: so sánh Claude Opus, Sonnet, Haiku và Fable — tất cả mô hình API Claude, tên mô hình Anthropic và giá (2026)Thanh toán Claude API bằng tiền mã hóaTruy cập Claude API không cần vào danh sách chờCách giảm lượng token sử dụng với ClaudeCline không giới hạn với Claude APIRoo Code không giới hạn với Claude APIClaude không giới hạn trong các IDE JetBrainsAider với Claude qua cổng API: ANTHROPIC_API_BASE, tệp cấu hình, chế độ architect và cách khắc phục lỗiClaude không giới hạn trong VS CodeCấu hình OpenCode cho Claude: thiết lập opencode.json, mô hình và các lỗi thường gặpChạy OpenClaw không giới hạn trên ClaudeAPI tương thích với Anthropic có nghĩa là gìKhóa API Claude Code — ANTHROPIC_API_KEY: cách lấy, thiết lập và khi nào nên dùng claude setup-token thay thếChi phí API Claude Code — Giá và cách cắt giảmGiải thích các lỗi API Claude: lỗi máy chủ 500, quá tải 529, giới hạn tốc độ 429, yêu cầu không hợp lệ 400 — và cách khắc phục từng lỗiCách mua tín dụng Claude API — và vì sao tín dụng Claude tốt hơn mọi lời chào mời "mua tài khoản Claude"API Claude miễn phí: có khóa API Claude miễn phí không, và điều gì thực sự miễn phí trong 2026?Claude API so với gói thuê bao Claude Pro/Max — Nên chọn loại nàoCodex CLI với nhà cung cấp tùy chỉnh: config.toml, mô hình GPT và Claude, tiện ích mở rộng IDE và cách khắc phục lỗiKết nối Claude với n8nĐịnh tuyến LiteLLM tới ClaudeSử dụng Claude trong Kilo CodeGitHub Copilot Chat với Claude qua cổng API: thiết lập Custom Endpoint, chế độ tác tử và cách khắc phục lỗiKết nối Zed với Claude qua cổng APIKết nối Cherry Studio với ClaudeChatAnthropic trong LangChain: nhập, base_url, truyền dữ liệu dạng luồng, công cụ và lỗiSDK Python của Anthropic: cài đặt, thiết lập base_url, truyền dữ liệu dạng luồng và xử lý lỗiClaude với Vercel AI SDK: baseURL của createAnthropic, truyền dữ liệu dạng luồng và cách khắc phục lỗiChạy Factory Droid với ClaudeGiải thích API của Claude CodeTích hợp API Claude vào ứng dụng của bạnCách sử dụng Claude không giới hạn — và vì sao không có "Claude Code bẻ khóa"