Source: https://aiprimetech.io/ko/learn/run-hermes-agent-with-claude-api/

[홈](/ko/) / [학습](/ko/learn/) / 게이트웨이를 통해 Claude와 함께 Hermes Agent 사용하기: 사용자 지정 제공자 설정, 비용 제어 및 문제 해결 

# 게이트웨이를 통해 Claude와 함께 사용하는 Hermes Agent: 사용자 지정 제공업체 설정, 비용 관리 및 문제 해결 

Hermes Agent는 비밀 정보를 다음에 저장하고 ~/.hermes/.env 그 외 모든 정보는 다음에 저장합니다 ~/.hermes/config.yaml. 게이트웨이를 통해 Claude에서 안정적으로 실행하려면 Anthropic Messages 형식을 사용하는 이름이 지정된 사용자 지정 제공자를 사용하세요. 간편 설정 방식인 provider: anthropic 에 다른 기본 URL을 지정하면 올바르게 보이지만, 인식하지 못하는 호스트의 경우 요청을 Anthropic으로 보냅니다. 

## 설치 

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 전체 마법사를 실행합니다. hermes model 제공자와 모델만 처리합니다. hermes doctor 기존 설치를 확인합니다. 

## 게이트웨이를 사용자 지정 제공자로 추가하기 

~/.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
```

  | 키  | 이유  

 | transport: anthropic_messages | Anthropic의 Messages 형식을 사용합니다. 이 설정이 없으면 Hermes는 OpenAI Chat Completions 형식으로 대체합니다 

 | key_env | 다음 파일에 있는 변수의 이름: .env 키를 저장하는 변수 

 | catalog_provider: anthropic | 게이트웨이의 Claude 모델은 Anthropic의 컨텍스트 및 비전 메타데이터를 상속합니다 

 | provider: custom:aiprime | 이름이 지정된 제공자를 선택합니다. /model custom:aiprime:<model> 채팅 중에 전환합니다  

마법사에서도 같은 방식으로 설정합니다: hermes model, 그다음 **사용자 지정 엔드포인트**, 그다음 API 모드 **Anthropic Messages**를 선택하세요. 대신 Chat Completions를 선택한다면 다음을 유지하세요: /v1 URL에 포함된 상태로. 

## provider: anthropic에 기본 URL을 지정해도 작동하지 않는 이유 

다음 설정은 provider: anthropic 및 base_url: https://aiprimetech.io 올바르게 보이지만 효과가 없습니다. 현재 Hermes 소스에서는 내장 Anthropic 제공자의 기본 URL 재정의를 Anthropic, Claude, Azure 호스트에 대해서만 허용하므로, 요청은 여전히 Anthropic으로 전송됩니다. 위의 이름이 지정된 사용자 지정 제공자를 사용하세요. 

ANTHROPIC_BASE_URL 는 Anthropic 기본 URL을 재정의하는 설정으로 문서에 안내되어 있지만, 아직 해결되지 않은 Hermes 버그로 인해 모델 선택기가 이 설정을 무시합니다. 사용자 지정 제공자를 사용하면 두 문제를 모두 피할 수 있습니다. 

## 토큰 사용량을 늘리는 요인과 이를 제한하는 설정 

Hermes는 화면에 보이는 대화 외에도 작업을 실행하며, 별도로 라우팅하지 않으면 모든 작업의 요금이 같은 키에 청구됩니다. 

  | 사용량 발생 원인  | 다음 설정은  

 | Subagents (delegation) | delegation.max_concurrent_children (기본값 10), delegation.max_iterations (기본값 250), delegation.max_spawn_depth (기본값 1); 더 저렴한 delegation.model 

 | 매 턴 이후 백그라운드에서 수행하는 메모리 및 스킬 검토 | auxiliary.background_review.enabled: false, 또는 더 낮은 max_input_tokens 

 | 보조 작업(압축, 제목, 비전) | auxiliary.<task>.provider 및 .model 이러한 작업을 더 저렴한 모델로 보내기 위해 

 | 예약 작업 | cron.model 모든 작업에 적용; hermes cron pause <id> 또는 hermes pause 

 | 메시징 게이트웨이(Telegram, Discord 등) | 다음과 같은 허용 목록: TELEGRAM_ALLOWED_USERS; 다음은 피하세요: GATEWAY_ALLOW_ALL_USERS=true  

~/.hermes/config.yaml (추가 설정)복사

```
delegation:
  max_concurrent_children: 3
  model: claude-haiku-4-5
auxiliary:
  background_review:
    enabled: false
cron:
  model: claude-haiku-4-5
```

hermes prompt-size 각 호출에 수반되는 고정 비용을 보여 줍니다. /usage 및 /compress 긴 세션 중에 도움이 됩니다. 

## 키 대신 Claude Pro 또는 Max 계정으로 로그인하기 

Hermes는 Claude 계정에 로그인할 수 있지만, 문서에 따르면 이 방식은 추가 사용 크레딧을 구매한 Max 요금제에서만 작동하며 Pro 구독자는 사용할 수 없습니다. 게이트웨이의 API 키를 사용하면 구독에 따른 사용 시간 제한이 없으며, 사용량은 토큰 단위로 잔액에서 차감됩니다. 

## 모델 

  | 모델 ID  | 권장 용도  

 | claude-sonnet-5 | 코딩과 에이전트 작업의 기본 선택: 빠르고 성능이 뛰어나며 가격은 중간 수준입니다. 

 | claude-opus-5-5 | 더 어려운 추론, 대규모 리팩터링, 장시간 에이전트 실행. 

 | claude-fable-5-1 | 성능이 가장 뛰어나고 가격도 가장 높습니다. 가장 어려운 작업에 사용하세요. 

 | claude-haiku-4-5 | 저렴하고 빠름: 제목, 요약, 분류, 간단한 단계.  

Hermes에는 최소 64K 토큰의 컨텍스트 윈도우가 필요합니다. 표의 모든 모델이 이 조건을 충족합니다. 

## 문제 해결 

  | 표시되는 내용  | 원인  | 해결 방법  

 | 첫 실행 시 HTTP 400 | 모델 이름이 게이트웨이 모델 ID와 일치하지 않음 | 위 표의 ID를 사용하세요 

 | 요청이 Anthropic으로 전송되거나 Anthropic 인증 오류로 실패함 | provider: anthropic 타사 기본 URL 사용 시 | 이름이 지정된 사용자 지정 공급자를 사용하세요 

 | 의미 없는 응답 또는 빈 응답 | URL에 맞지 않는 전송 방식 | transport: anthropic_messages Claude용 

 | 컨텍스트 길이 초과 | 설정된 컨텍스트 창보다 큰 세션 | 설정할 항목: model.context_length; /compress 

 | 403 Your request was blocked | 엔드포인트 앞단의 방화벽이 클라이언트를 차단함 | 추가 extra_headers 브라우저와 유사한 User-Agent 사용 

 | 업데이트 후 설정 누락 | 설정 스키마 변경 | hermes config check, 그다음 hermes config migrate 

 | Telegram 또는 Discord에서 봇이 응답하지 않음 | 게이트웨이가 실행 중이 아니거나 발신자가 허용되지 않음 | hermes gateway status; 확인하세요 ~/.hermes/logs/gateway.log  

에이전트 프레임워크를 비교하고 계신가요? 다음을 참고하세요: [OpenClaw 설정 가이드](/ko/learn/run-openclaw-with-claude-api/). 

## 자주 묻는 질문 

 사용자 지정 Claude 엔드포인트와 함께 Hermes Agent를 사용하려면 어떻게 해야 하나요?

~/.hermes/config.yaml에 이름이 지정된 공급자를 추가하고, api를 게이트웨이 URL로, key_env를 ~/.hermes/.env의 변수를 가리키도록, transport를 anthropic_messages로 설정한 다음 model.provider: custom:<name>을 설정하세요. Hermes가 Anthropic base_url을 무시하는 이유는 무엇인가요?

provider: anthropic을 사용하는 경우 Hermes는 Anthropic, Claude 및 Azure 호스트에 대해서만 기본 URL 재정의를 허용하므로 타사 URL은 무시됩니다. 대신 이름이 지정된 사용자 지정 공급자를 사용하세요. Hermes Agent의 토큰 사용량을 줄이려면 어떻게 해야 하나요?

하위 에이전트 수를 제한하고(위임 설정), 보조 작업과 cron 작업을 더 저렴한 모델로 라우팅하고, 백그라운드 검토를 끈 다음 hermes prompt-size를 확인하세요. Hermes Agent에서 Claude Pro 구독을 사용할 수 있나요?

Hermes 문서에 따르면 사용할 수 없습니다. Claude 로그인 방식은 추가 사용 크레딧이 있는 Max에서만 작동합니다. API 키를 사용하면 구독 제한을 완전히 피할 수 있습니다.  

몇 분 만에 Claude 사용 시작하기

API 키를 발급받으세요 — Anthropic 계정이나 대기자 명단 등록이 필요하지 않습니다.[API 키 발급받기](/register) 

AI Prime Tech는 독립적인 API 게이트웨이입니다. Anthropic과 제휴 관계가 없으며, Anthropic의 보증을 받거나 Anthropic의 리셀러로 활동하지 않습니다. Claude 및 관련 모델 이름은 각 소유자의 상표입니다.    

## 더 많은 Claude API 가이드

[Claude API 키 발급 방법](/ko/learn/how-to-get-a-claude-api-key/)[Claude API 요금 해설](/ko/learn/claude-api-pricing-explained/)[Claude API를 가장 저렴하게 사용하는 방법](/ko/learn/cheapest-way-to-use-claude-api/)[Claude API로 Cursor 무제한 사용](/learn/use-claude-api-with-cursor/)[Claude Code 무제한 이용](/ko/learn/use-claude-api-with-claude-code/)[Claude API 게이트웨이와 Anthropic 직접 이용 비교](/ko/learn/claude-api-vs-anthropic-direct/)[OpenAI SDK로 Claude 사용하기: OpenAI 호환 엔드포인트, 스트리밍, 도구 및 제한](/ko/learn/openai-compatible-claude-api/)[Claude 모델 해설: Claude Opus, Sonnet, Haiku, Fable 비교 — 모든 Claude API 모델, Anthropic 모델 이름 및 가격 (2026)](/ko/learn/claude-api-models-compared/)[암호화폐로 Claude API 요금 결제하기](/ko/learn/claude-api-with-crypto-payment/)[대기 명단 없이 Claude API 이용하기](/ko/learn/claude-api-without-waitlist/)[Claude 토큰 사용량을 줄이는 방법](/ko/learn/how-to-reduce-claude-token-usage/)[Claude API로 Cline 무제한 사용](/ko/learn/use-claude-api-with-cline/)[Claude API로 Roo Code 무제한 사용](/ko/learn/use-claude-api-with-roo-code/)[JetBrains IDE에서 Claude 무제한 사용](/ko/learn/use-claude-api-with-jetbrains/)[게이트웨이를 통해 Claude와 함께 사용하는 Aider: ANTHROPIC_API_BASE, 구성 파일, architect 모드 및 문제 해결](/ko/learn/use-claude-api-with-aider/)[VS Code에서 Claude 무제한 사용](/ko/learn/use-claude-api-with-vscode/)[Claude용 OpenCode 구성: opencode.json 설정, 모델 및 일반적인 오류](/ko/learn/use-claude-api-with-opencode/)[Claude에서 OpenClaw 무제한 실행하기](/ko/learn/run-openclaw-with-claude-api/)[Anthropic 호환 API의 의미](/ko/learn/anthropic-compatible-api/)[Claude Code API 키 — ANTHROPIC_API_KEY: 발급 및 설정 방법과 대신 claude setup-token을 사용해야 하는 경우](/ko/learn/claude-code-api-key-setup/)[Claude Code API 비용 — 요금과 절감 방법](/ko/learn/claude-code-api-costs/)[Claude API 오류 설명: 서버 오류 500, 과부하 529, 사용량 제한 429, 잘못된 요청 400 — 각 오류의 해결 방법](/ko/learn/claude-api-errors-troubleshooting/)[Claude API 크레딧 구매 방법 — 그리고 Claude 크레딧이 어떤 "Claude 계정 구매" 상품보다 나은 이유](/ko/learn/buy-claude-api-credits/)[Claude 무료 API: 무료 Claude API 키가 있나요? 2026년에 실제로 무료인 것은 무엇인가요?](/ko/learn/claude-api-free-trial/)[Claude API와 Claude Pro/Max 구독 — 어떤 것을 선택할까요](/ko/learn/claude-api-vs-subscription/)[사용자 지정 제공업체와 함께 사용하는 Codex CLI: config.toml, GPT 및 Claude 모델, IDE 확장 프로그램 및 문제 해결](/ko/learn/use-claude-api-with-codex/)[Claude를 n8n에 연결하기](/ko/learn/use-claude-api-with-n8n/)[LiteLLM을 Claude로 라우팅하기](/ko/learn/use-claude-api-with-litellm/)[Kilo Code에서 Claude 사용하기](/ko/learn/use-claude-api-with-kilo-code/)[게이트웨이를 통해 Claude와 함께 사용하는 GitHub Copilot Chat: Custom Endpoint 설정, 에이전트 모드 및 문제 해결](/ko/learn/use-claude-api-with-github-copilot/)[게이트웨이를 통해 Zed를 Claude에 연결하기](/ko/learn/use-claude-api-with-zed/)[Cherry Studio를 Claude에 연결하기](/ko/learn/use-claude-api-with-cherry-studio/)[LangChain의 ChatAnthropic: 가져오기, base_url, 스트리밍, 도구 및 오류](/ko/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: 설치, base_url 설정, 스트리밍 및 오류 처리](/ko/learn/anthropic-python-sdk/)[Vercel AI SDK로 Claude 사용하기: createAnthropic baseURL, 스트리밍 및 문제 해결](/ko/learn/use-claude-api-with-vercel-ai-sdk/)[Claude로 Factory Droid 실행하기](/ko/learn/use-claude-api-with-factory-droid/)[Claude Code API 이해하기](/ko/learn/claude-code-api/)[애플리케이션에 Claude API 통합하기](/ko/learn/claude-api-integration/)[Claude를 무제한으로 사용하는 방법 — 그리고 "Claude Code 크랙 버전"이 없는 이유](/ko/learn/get-unlimited-claude-usage/)