Source: https://aiprimetech.io/vi/learn/run-hermes-agent-with-claude-api/ [Trang chủ](/vi/) / [Tìm hiểu](/vi/learn/) / 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 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 / WSL2Sao chép ``` curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` WindowsSao chép ``` 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/.envSao chép ``` AIPRIME_API_KEY=your_gateway_key ``` ~/.hermes/config.yamlSao chép ``` 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_messages | Sử 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_env | Tên của biến trong .env chứa khóa | catalog_provider: anthropic | Cá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:aiprime | Chọn nhà cung cấp có tên; /model custom:aiprime: 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ượt | auxiliary.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..provider và .model để gửi chúng đến một mô hình rẻ hơn | Tác vụ theo lịch | cron.model cho tất cả tác vụ; hermes cron pause 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)Sao chép ``` 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-5 | Lự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-5 | Suy 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-1 | Năng lực cao nhất và đắt nhất; dành cho các tác vụ khó nhất. | claude-haiku-4-5 | Rẻ 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ên | Tên mô hình không khớp với ID mô hình của cổng kết nối | Dù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 Anthropic | provider: anthropic với URL cơ sở của bên thứ ba | Sử dụng nhà cung cấp tùy chỉnh có tên | Phản hồi vô nghĩa hoặc trống | Phương thức truyền tải không phù hợp với URL | transport: anthropic_messages cho Claude | Vượt quá độ dài ngữ cảnh | Phiên lớn hơn cửa sổ ngữ cảnh đã cấu hình | Đặt model.context_length; /compress | 403 Your request was blocked | Tường lửa phía trước điểm cuối từ chối ứng dụng khách | Thêm extra_headers với User-Agent giống trình duyệt | Thiếu thiết lập sau khi cập nhật | Lược đồ cấu hình đã thay đổi | hermes config check, sau đó hermes config migrate | Bot không phản hồi trên Telegram hoặc Discord | Cổng không chạy hoặc người gửi không được phép | hermes 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](/vi/learn/run-openclaw-with-claude-api/). ## 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:. 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](/register) 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 API](/vi/learn/how-to-get-a-claude-api-key/)[Giải thích giá API Claude](/vi/learn/claude-api-pricing-explained/)[Cách tiết kiệm nhất để sử dụng Claude API](/vi/learn/cheapest-way-to-use-claude-api/)[Cursor không giới hạn với Claude API](/learn/use-claude-api-with-cursor/)[Truy cập Claude Code không giới hạn](/vi/learn/use-claude-api-with-claude-code/)[Cổng Claude API so với truy cập trực tiếp Anthropic](/vi/learn/claude-api-vs-anthropic-direct/)[Dù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ạn](/vi/learn/openai-compatible-claude-api/)[Giả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)](/vi/learn/claude-api-models-compared/)[Thanh toán Claude API bằng tiền mã hóa](/vi/learn/claude-api-with-crypto-payment/)[Truy cập Claude API không cần vào danh sách chờ](/vi/learn/claude-api-without-waitlist/)[Cách giảm lượng token sử dụng với Claude](/vi/learn/how-to-reduce-claude-token-usage/)[Cline không giới hạn với Claude API](/vi/learn/use-claude-api-with-cline/)[Roo Code không giới hạn với Claude API](/vi/learn/use-claude-api-with-roo-code/)[Claude không giới hạn trong các IDE JetBrains](/vi/learn/use-claude-api-with-jetbrains/)[Aider 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ỗi](/vi/learn/use-claude-api-with-aider/)[Claude không giới hạn trong VS Code](/vi/learn/use-claude-api-with-vscode/)[Cấu hình OpenCode cho Claude: thiết lập opencode.json, mô hình và các lỗi thường gặp](/vi/learn/use-claude-api-with-opencode/)[Chạy OpenClaw không giới hạn trên Claude](/vi/learn/run-openclaw-with-claude-api/)[API tương thích với Anthropic có nghĩa là gì](/vi/learn/anthropic-compatible-api/)[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ế](/vi/learn/claude-code-api-key-setup/)[Chi phí API Claude Code — Giá và cách cắt giảm](/vi/learn/claude-code-api-costs/)[Giả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ỗi](/vi/learn/claude-api-errors-troubleshooting/)[Cá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"](/vi/learn/buy-claude-api-credits/)[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?](/vi/learn/claude-api-free-trial/)[Claude API so với gói thuê bao Claude Pro/Max — Nên chọn loại nào](/vi/learn/claude-api-vs-subscription/)[Codex 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ỗi](/vi/learn/use-claude-api-with-codex/)[Kết nối Claude với n8n](/vi/learn/use-claude-api-with-n8n/)[Định tuyến LiteLLM tới Claude](/vi/learn/use-claude-api-with-litellm/)[Sử dụng Claude trong Kilo Code](/vi/learn/use-claude-api-with-kilo-code/)[GitHub 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ỗi](/vi/learn/use-claude-api-with-github-copilot/)[Kết nối Zed với Claude qua cổng API](/vi/learn/use-claude-api-with-zed/)[Kết nối Cherry Studio với Claude](/vi/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic trong LangChain: nhập, base_url, truyền dữ liệu dạng luồng, công cụ và lỗi](/vi/learn/use-claude-api-with-langchain/)[SDK 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ỗi](/vi/learn/anthropic-python-sdk/)[Claude 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ỗi](/vi/learn/use-claude-api-with-vercel-ai-sdk/)[Chạy Factory Droid với Claude](/vi/learn/use-claude-api-with-factory-droid/)[Giải thích API của Claude Code](/vi/learn/claude-code-api/)[Tích hợp API Claude vào ứng dụng của bạn](/vi/learn/claude-api-integration/)[Cách sử dụng Claude không giới hạn — và vì sao không có "Claude Code bẻ khóa"](/vi/learn/get-unlimited-claude-usage/)