바로 답: Hermes Agent에서 The model provider is rate-limiting requests가 반복되면 API 키를 바꾸기 전에 /status와 /usage부터 확인해야 합니다. ChatGPT 구독으로 Codex를 쓰는 환경에서는 API 잔액이 아니라 계정의 Codex 사용 한도에 걸린 경우도 있습니다. 다만 같은 오류 문구가 일시적인 제공자 제한을 뜻할 수도 있으므로, 한 줄 메시지만 보고 원인을 확정하면 안 됩니다.
확인일: 2026년 9월 16일. 아래 명령은 현재 Hermes Agent 공식 문서와 이 사이트 운영 중 실제로 확인한 오류 사례를 기준으로 정리했습니다. 표시 항목은 설치 버전과 연결한 제공자에 따라 달라질 수 있습니다.
제가 실제로 확인한 환경과 결과
- Windows PC에서 Hermes Agent를 Telegram과 연결해 사용했습니다.
- 모델 제공자는
openai-codex였습니다. The model provider is rate-limiting requests. Please wait a moment and try again.메시지가 잠시 기다린 뒤에도 반복됐습니다./usage를 확인했을 때 제 사례에서는 Codex 사용량 한도가 원인이었습니다.
이 결과를 모든 계정에 그대로 적용할 수는 없습니다. 제공자 장애, 짧은 시간의 요청 집중, 계정별 한도, 인증 상태가 비슷한 문구로 나타날 수 있기 때문입니다.
가장 먼저 입력할 두 명령
1. /status로 현재 연결을 확인합니다
/status는 현재 세션, 모델, 컨텍스트 정보를 확인할 때 씁니다. 여기서 모델 제공자가 생각한 것과 다르면 사용량을 잘못된 계정에서 확인하고 있을 수 있습니다. 화면에 표시되는 숫자는 진단 정보이지 곧바로 결제 금액을 뜻하지 않습니다.
/status2. /usage로 제공자 한도를 확인합니다
Hermes 공식 명령 문서는 /usage가 세션의 토큰 사용량과 비용 추정치를 보여 주며, 연결한 제공자가 지원하면 남은 할당량이나 플랜 사용량도 함께 표시한다고 설명합니다. Account limits 또는 남은 사용량 항목이 보이면 오류가 발생한 시각과 함께 기록합니다.
/usage/usage reset은 모든 사용자가 언제든 한도를 초기화하는 명령이 아닙니다. 공식 문서상 사용할 수 있는 banked Codex limit reset이 있을 때 이를 적용하는 기능입니다. 화면에서 사용할 수 있다고 확인된 경우에만 실행해야 합니다.
오류 문구별로 나누는 진단표
| 확인 결과 | 가능성이 큰 원인 | 다음 행동 |
|---|---|---|
/usage에 남은 한도가 없다고 표시됨 |
Codex 계정 사용량 소진 | 표시된 갱신 시각을 기다리거나, 제공되는 reset 옵션을 확인합니다. |
| 남은 한도가 있는데 여러 요청이 동시에 실패함 | 짧은 시간의 요청 제한 또는 제공자 장애 | 반복 재시도를 멈추고 잠시 뒤 한 번만 다시 확인합니다. |
/status의 제공자가 예상과 다름 |
다른 모델·계정·인증 경로 사용 | 현재 모델과 로그인 계정을 먼저 바로잡습니다. |
| 긴 대화에서 답변이 느려지거나 앞 내용을 놓침 | 컨텍스트 압박 | /compress 또는 새 세션을 검토합니다. 이것은 사용량 한도 초기화가 아닙니다. |
| 예약 작업만 결과가 오지 않음 | 크론 실행·Gateway·전송 문제 | Hermes Agent 크론 점검 순서로 실행과 전송을 분리합니다. |
/compress와 /new는 언제 쓰나
사용량 한도와 대화 컨텍스트는 별개입니다. /compress는 긴 대화의 이전 내용을 요약해 활성 컨텍스트를 줄입니다. /new는 새 대화를 시작합니다. 두 명령 모두 이미 소진된 제공자 할당량을 되살리는 우회 수단은 아닙니다.
새 세션으로 옮기기 전에는 프로젝트 폴더에 짧은 인계 문서를 남겨 두면 편합니다. 아래 템플릿은 설명용 예시입니다.
# 작업 인계
## 확인된 현재 상태
- 완료한 작업:
- 실제로 다시 읽어 확인한 결과:
## 남은 문제
- 재현 조건:
- 정확한 오류 문구:
## 다음 작업
- 첫 번째 확인 대상:
- 변경하면 안 되는 항목:
세션과 파일의 역할이 헷갈리면 SOUL·USER·MEMORY 구분 작업 노트를, 일반 채팅과 실행형 에이전트의 차이가 필요하면 Hermes Agent와 일반 AI 채팅 비교를 함께 볼 수 있습니다.
실패하기 쉬운 접근
- 오류가 보일 때마다 연속 재시도: 짧은 시간의 요청 제한이라면 상황을 더 악화시킬 수 있습니다.
- 바로 API 키를 새로 만들기: ChatGPT·Codex 구독 한도 문제라면 해결되지 않습니다.
- 컨텍스트 숫자를 실제 청구액으로 해석: 세션 상태와 제공자 과금은 같은 값이 아닙니다.
/new를 한도 우회로 사용: 새 대화는 컨텍스트만 분리하며 계정 할당량을 바꾸지 않습니다.- 프로젝트 상태를 대화에만 보관: 새 세션을 시작하면 중요한 결정과 다음 작업을 다시 찾기 어려워집니다.
복사해서 쓰는 점검 기록
발생 시각:
정확한 오류 문구:
/status의 모델·제공자:
/usage의 남은 한도와 갱신 시각:
같은 계정의 다른 짧은 요청 결과:
마지막으로 성공한 작업:
재시도 전 기다린 시간:
조치 후 다시 확인한 결과:
보안과 개인정보
진단 화면을 공유할 때는 이메일, 사용자 ID, 결제 정보, 세션 식별자, API 키를 가립니다. /status나 /usage 화면 전체를 그대로 공개하지 말고 오류 판단에 필요한 항목만 남깁니다. 회사 자료를 다루는 세션이라면 인계 문서에도 고객명과 원문을 복사하지 않습니다.
이번 글의 한계
이 글은 실제로 반복된 rate-limit 오류와 /usage 확인 결과를 바탕으로 했지만, 모든 제공자와 모든 요금제에서 같은 화면을 재현한 것은 아닙니다. 계정별 한도와 reset 제공 여부는 현재 계정 화면을 우선해야 합니다.
공식 자료
- Hermes Agent Slash Commands Reference
- Hermes Agent Sessions
- Hermes Agent: Troubleshooting Agent Quality
최종 확인: 2026년 9월 16일. 공식 명령 문서에서 /status, /usage, /compress, /new의 현재 설명을 다시 대조했습니다.