Hermes Agent의 base_url은 /v1로 끝나야 하나요?

아니요. base_url은 https://api.wokey.ai로, provider는 custom으로 설정하세요.

api_mode: codex_responses는 언제 추가하나요?

gpt-6-sol 같은 GPT 모델에서만 추가하세요. 이 경우 캐시 적중률이 가장 높습니다. Claude 등 다른 모델에서는 추가하지 마세요.

API 키는 어디에 넣나요?

~/.hermes/config.yaml의 model 아래 api_key 필드에 키만 넣습니다.

클라이언트/Hermes Agent

Hermes Agent에서 Wokey API 사용하기

Wokey API 키를 발급받고 Hermes Agent의 Base URL을 Wokey로 지정한 뒤 curl 요청 한 번으로 연결을 확인하세요.

업데이트 2026-11-10

이 페이지 내용expand_more

준비
설정
형식
상시 실행 에이전트
확인
문제 해결
자주 묻는 질문

API 키와 Base URL 준비link

모든 클라이언트는 같은 Wokey API 키와 같은 Base URL을 사용합니다.

API 키 만들기

로그인한 뒤 API 페이지에서 플랫폼 키를 만드세요. 같은 계정의 키는 잔액을 공유합니다.

API 키 만들기key

Wokey Base URL 사용

클라이언트의 Base URL에 게이트웨이 도메인을 입력하세요. /v1을 붙일지는 아래 설정을 참고하세요.

클라이언트 설정link

Hermes Agent는 모델, 사용자 지정 공급자, Base URL, API 키를 지정하는 처음 다섯 줄의 설정만 있으면 됩니다. GPT 모델(gpt-6-sol 등)에서는 최고의 캐시 적중률을 위해 api_mode: codex_responses를 추가하고, Claude 등 다른 모델에서는 넣지 마세요.

Hermes Agent

# ~/.hermes/config.yaml
model:
  default: claude-opus-5-5
  provider: custom
  base_url: https://api.wokey.ai
  api_key: YOUR_API_KEY
  # GPT 모델(gpt-6-sol 등) 전용 — 최고의 캐시 적중률을 원하면 주석을 해제하세요:
  # api_mode: codex_responses

API 형식과 Base URLlink

같은 클라이언트라도 API 형식을 바꾸면 Base URL 끝에 /v1을 붙일지가 달라질 수 있습니다.

형식	Base URL	용도
OpenAI Chat Completions	https://api.wokey.ai	DeepSeek, GLM, Kimi 등 기타 모델

설정 위치: ~/.hermes/config.yaml

Opus 5.5로 Hermes Agent를 상시 실행 에이전트로 운영하기: Claude Duet과의 비교link

Anthropic은 2026-10-21에 Claude Duet 리서치 프리뷰를 공개했습니다. Claude Opus 5.5 기반의 능동형 에이전트로, 아침마다 브리핑을 보내고, 연결된 앱을 백그라운드에서 지켜보며, 행동하기 전에 사용자에게 확인을 받습니다. Duet은 Claude 계정 로그인으로만 사용할 수 있고 API 키나 사용자 지정 base URL이 없으므로 Wokey를 통해 실행할 수 없습니다. Hermes Agent는 직접 호스팅하는 오픈 소스 상시 실행 에이전트로, Wokey에 연결하면 대기자 명단이나 지역 제한 없이 같은 Opus 5.5 모델을 사용합니다.

	Claude Duet	Hermes Agent + Wokey
모델	Claude Opus 5.5, 변경 불가	claude-opus-5-5 또는 Wokey의 다른 모든 모델
사용 대상	미국의 Claude Pro 및 Max 구독자(대기자 명단); Team과 Enterprise는 아직 미지원	직접 설치합니다. Wokey API 키만 있으면 되고 지역 제한이 없습니다
비용	프리뷰 기간에는 추가 요금이 없지만, 채팅 및 Claude Code와 요금제의 사용량 한도를 공유하며 백그라운드 확인도 포함됩니다	Wokey 잔액에서 토큰당 과금되며, 확인 빈도는 직접 정합니다
실행 위치	Anthropic 클라우드에 있는 자체 브라우저가 달린 가상 머신; 휴대폰과 노트북이 꺼져 있어도 계속 작동합니다	본인의 컴퓨터나 서버; 24시간 작동하려면 항상 켜져 있는 머신에 호스팅하세요
대화 방법	Duet 앱(iOS 및 Android)과 claude.ai	Telegram, Slack 등의 채팅 앱
메모리와 도구	Claude 계정의 메모리, skills, 커넥터를 그대로 이어받습니다	메모리, skills, 도구가 로컬에 있으며 직접 설치하고 관리합니다
실행 전 승인	메시지 전송, 결제, 서명, 삭제 전에 확인을 요청하며, 증권 거래와 계좌 간 이체는 절대 허용되지 않습니다	권한과 승인 규칙은 직접 설정합니다. 필요한 계정에만 접근 권한을 주세요

토큰당 과금에서는 확인이 잦을수록 비용이 커집니다. 확인할 때마다 시스템 프롬프트와 메모리를 다시 보내기 때문입니다. 정기 확인에는 더 저렴한 모델(예: claude-sonnet-5-5 또는 deepseek-v4.1-flash)을 쓰고, 판단과 실행이 필요할 때 Opus 5.5로 전환하세요.
Chat Completions를 통해 호출하면 Opus 5.5는 쓰기 전에 먼저 생각하므로 첫 토큰이 늦게 나옵니다. 백그라운드에서 작동하는 에이전트는 이를 거의 체감하지 못합니다.
위 설정은 이미 claude-opus-5-5를 기본값으로 사용하므로 변경할 필요가 없습니다.

Duet 정보 확인일 2026-10-22 · Duet 정보 출처: Introducing Claude Duet · Claude Duet FAQ

curl로 확인link

클라이언트에서 오류가 나면 먼저 curl로 API 키와 Base URL 문제가 아닌지 확인하세요.

Hermes Agent는 기본적으로 OpenAI Chat Completions 형식을 사용합니다. 이 요청이 200을 반환하면 API 키와 Base URL이 올바른 것입니다. 보내기 전에 YOUR_API_KEY를 내 키로 바꾸세요.

cURL

curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

오류 및 문제 해결link

먼저 인증, 잔액, 속도 제한, 모델 사용 가능 여부, 업스트림 타임아웃 중 어느 경우인지 구분하세요.

401

invalid api key

키가 없거나, 잘못 입력되었거나, 삭제되었거나, Authorization과 x-api-key 헤더가 서로 다릅니다.

402

insufficient balance

계정 잔액이 부족합니다. 요청을 더 보내기 전에 충전하세요.

403

model_denylisted / account_restricted

반복된 위반으로 해당 모델 또는 계정의 모든 모델에 대한 호출이 일시 중지되었습니다. 위반 처리 수수료 및 제한을 참고하세요.

403

request_blocked

이 요청은 업스트림에 도달하기 전에 차단되었으며 과금되지 않습니다. 예를 들어 모델이 방금 거부한 요청을 그대로 다시 보냈거나, 일시 중지된 최종 사용자(X-End-User-Id)인 경우입니다. 오류 메시지에 무엇이 차단되었는지 나와 있으니 안내에 따라 요청을 수정하거나 나중에 다시 시도하세요. 다른 요청에는 영향이 없습니다.

429

rate limited

요청이 너무 잦습니다. 나중에 다시 시도하거나 동시 실행 수를 줄이세요. 특정 모델 하나 또는 특정 최종 사용자(X-End-User-Id) 하나만 계속 429를 반환한다면 위반 후의 일시적인 제한일 수 있습니다.

499

client disconnected

응답이 끝나기 전에 클라이언트가 연결을 닫았습니다(코드 downstream_aborted). 기본적으로 무료입니다. 계정에서 지난 24시간 동안 클라이언트 연결 끊김이 50회 이상 발생하고 그것이 요청의 10% 이상을 차지하면, 이후 연결이 끊긴 요청은 업스트림이 보고한 사용량으로 과금됩니다. 대상은 캐시 읽기와 쓰기를 포함한 처리된 입력, 그리고 업스트림이 집계한 경우에만 출력입니다. 업스트림이 사용량을 보고하기 전에 끊긴 경우는 계속 무료입니다. 과금이 시작되면 계정에 알림이 가며, 연결 끊김 비율이 정상으로 돌아오면 1시간 안에 과금이 자동으로 중지됩니다. 흔한 원인은 클라이언트나 프록시의 타임아웃이 너무 짧거나, 프로그램이 완료 전에 요청을 취소하는 경우입니다.

502

upstream unavailable

업스트림 모델 서비스를 일시적으로 사용할 수 없습니다. 모델을 바꾸거나 나중에 다시 시도하세요.

504

upstream timeout

업스트림 응답 시간이 초과되었습니다. 컨텍스트를 줄이거나 max_tokens를 낮추거나 다시 시도하세요.

529

upstream overloaded

업스트림 모델이 일시적으로 과부하 상태이며, Wokey는 이미 다른 경로로 재시도했습니다(코드 upstream_overloaded). 잔액과는 관계가 없습니다. 잠시 후 다시 시도하거나 모델을 바꾸세요.

자주 묻는 질문link

Hermes Agent의 base_url은 /v1로 끝나야 하나요?: 아니요. base_url은 https://api.wokey.ai로, provider는 custom으로 설정하세요.
api_mode: codex_responses는 언제 추가하나요?: gpt-6-sol 같은 GPT 모델에서만 추가하세요. 이 경우 캐시 적중률이 가장 높습니다. Claude 등 다른 모델에서는 추가하지 마세요.
API 키는 어디에 넣나요?: ~/.hermes/config.yaml의 model 아래 api_key 필드에 키만 넣습니다.