OpenAI Codex 401 오류 재인증 방법 | Hermes Agent 로그인 풀림 해결

OpenAI Codex 401 오류가 Hermes Agent에서 갑자기 나타났습니다.

조금 전까지 잘 사용하고 있었는데요. 터미널에는 HTTP 401, invalidated oauth token, token_revoked 같은 문구가 반복해서 나왔습니다.

처음에는 Hermes를 다시 실행하거나 OpenAI Codex 인증을 한 번 더 진행하면 바로 해결될 줄 알았습니다.

실제로 재인증한 뒤 바로 정상 응답이 온 적도 있었습니다. 그런데 어떤 때는 인증 상태 확인, 재인증, 모델 선택까지 다시 했는데도 같은 오류가 계속되더라고요.

결국 저는 마지막 수단으로 Hermes를 제거하고, Finder에서 숨김 파일로 남아 있던 .hermes 폴더까지 직접 삭제한 뒤 처음부터 다시 설치했습니다.

결론부터 말씀드리면, OpenAI Codex 401 오류는 우선 인증을 새로 연결해 보고, 그래도 반복될 때만 설정 초기화와 완전 재설치를 검토하는 순서가 안전합니다.

제가 실제로 확인하고 시도했던 순서와 Hermes 공식 문서를 함께 비교해 정리해 보겠습니다.

OpenAI Codex 401 오류와 token_revoked는 무슨 뜻일까?

제가 확인한 오류 메시지는 아래와 비슷했습니다.

AuthenticationError [HTTP 401]
Encountered invalidated oauth token
code: token_revoked

token_revoked는 현재 저장된 인증 토큰을 더 이상 정상적으로 사용할 수 없다는 의미로 볼 수 있습니다.

다만 이 오류 문구 하나만으로 토큰이 왜 무효화됐는지까지 정확하게 알 수 있는 것은 아닙니다.

계정 연결 변화, 인증 정보 만료나 취소, 토큰 갱신 실패 등 여러 가능성이 있을 수 있는데요. 오류 화면으로 확실히 알 수 있는 것은 기존 인증 정보를 그대로 반복 사용하기 어려운 상태라는 점입니다.

따라서 원인을 임의로 단정하기보다는 인증 상태를 확인하고 새 인증을 진행하는 것이 먼저입니다.

auth list에 보이는 device_code는 실제 입력 코드일까?

저는 OpenAI Codex 인증을 브라우저에서 진행했지만, 일회용 장치 코드를 직접 입력했다고 기억하지는 않습니다.

그런데 인증이 완료된 뒤 아래 명령을 실행해 보니 OpenAI Codex 항목에는 device_code라고 표시됐습니다.

hermes auth list

여기서 보이는 device_code는 브라우저에 입력하는 일회용 코드의 실제 값이 아닙니다.

화면 구성과 Hermes의 인증 기록 방식을 보면 인증 항목의 이름이나 OAuth 인증 출처를 표시하는 값으로 보는 편이 자연스럽습니다.

즉, auth list에 device_code가 보인다는 이유만으로 사용자가 인증 과정에서 반드시 코드를 직접 입력했다고 판단할 수는 없습니다.

저처럼 브라우저에서 로그인과 승인을 진행했지만 코드를 직접 입력하지 않은 경우에도 같은 표시가 나타날 수 있습니다. 정확한 인증 흐름은 Hermes 버전과 기존 Codex CLI 인증 가져오기 여부 등에 따라 다를 수 있습니다.

OpenAI Codex 401 오류 재인증 방법

1. 저장된 인증 항목 확인하기

Hermes 대화창에서 나온 뒤 일반 터미널에서 아래 명령을 실행합니다.

hermes auth list openai-codex

auth list는 OpenAI Codex 인증 항목이 등록되어 있는지 보여 줍니다.

다만 항목이 목록에 보인다고 해서 실제 인증이 반드시 정상이라는 뜻은 아닙니다.

2. OpenAI Codex 인증 상태 확인하기

hermes auth status openai-codex

auth status는 해당 공급자의 현재 인증 상태를 확인하는 명령입니다.

목록 확인과 상태 확인은 역할이 다르므로 둘을 함께 보는 것이 좋습니다.

3. OpenAI Codex 재인증하기

새 인증을 추가하려면 아래 명령을 실행합니다.

hermes auth add openai-codex

또는 모델 설정 화면에서 OpenAI Codex를 다시 선택하고 인증을 진행할 수 있습니다.

hermes model

Hermes 공식 문서에서는 OpenAI Codex 인증을 장치 코드 방식으로 설명합니다.

다만 제가 실제로 재설정했을 때는 브라우저에서 OpenAI 계정으로 로그인과 승인을 진행했고, 별도의 일회용 코드를 직접 입력하지 않은 상태로 현재 사용하고 있습니다.

따라서 화면이 공식 문서의 설명과 조금 다르게 진행되더라도, 브라우저에서 승인된 계정과 인증 완료 여부를 먼저 확인해 주세요.

여러 ChatGPT 계정을 사용해 어떤 계정으로 승인했는지 헷갈린다면 ChatGPT 회원가입과 로그인 방법도 함께 확인해 보셔요.

4. 모델 설정 확인하기

인증을 마친 뒤에는 아래 명령에서 OpenAI Codex 공급자와 사용할 모델을 확인합니다.

hermes model

명령	실행 위치	용도
hermes model	일반 터미널	공급자 인증과 기본 모델 설정
/model	Hermes 대화창	이미 설정된 모델 사이의 빠른 전환

5. 간단한 질문으로 정상 응답 확인하기

재인증이 끝났다면 Hermes를 다시 실행합니다.

hermes

처음부터 긴 작업을 맡기기보다 간단한 질문 하나를 보내 정상 응답이 오는지 확인합니다.

한 번 답변을 받은 뒤 두 번째 질문까지 이어지는지 보는 편이 좋습니다. 첫 응답만 나온 뒤 다시 인증 오류가 발생하는 경우도 있기 때문입니다.

여기까지 정상적으로 진행됐다면 기본적인 OpenAI Codex 401 오류 복구 과정은 끝난 것입니다.

재인증해도 오류가 반복될 때 확인할 것

저는 위 방법을 모두 실행한 뒤 바로 정상으로 돌아온 경우도 있었습니다.

그런데 어떤 때는 재인증을 마쳤는데도 OpenAI Codex 401 오류가 계속 반복됐습니다.

이때는 다음 순서로 범위를 조금씩 넓혀 확인하는 것이 좋습니다.

1. hermes doctor로 설정과 의존성 문제를 확인합니다.
2. hermes status --all로 인증·모델·서비스 상태를 함께 봅니다.
3. hermes model에서 OpenAI Codex를 다시 선택합니다.
4. 일반 재인증이 계속 실패할 때만 OpenAI Codex 인증 상태를 로그아웃하고 다시 추가합니다.

hermes auth logout openai-codex
hermes auth add openai-codex
hermes model

주의할 부분이 있습니다.

auth logout은 저장된 OpenAI Codex 인증 상태를 지우는 작업입니다. 처음부터 실행하지 말고 일반 재인증이 제대로 되지 않을 때만 사용해 주세요.

지원이 필요하다면 원시 토큰 화면을 그대로 공유하기보다 아래 명령으로 환경 요약을 먼저 확인할 수 있습니다.

hermes dump

hermes dump는 지원 요청에 사용할 수 있는 설치·환경 요약을 보여 줍니다. 그래도 외부에 올리기 전에는 사용자 이름, 프로필명과 로컬 경로가 포함됐는지 직접 확인해 주세요.

마지막 수단: .hermes 폴더 삭제 후 완전 재설치

여기부터는 기본 해결법이 아닙니다.

저는 재인증과 모델 설정을 모두 해도 오류가 계속된 적이 있었는데요.

Hermes의 제거 기능을 실행했지만 사용자 홈 폴더에 .hermes가 그대로 남아 있는 것을 확인했습니다.

Hermes의 일반 제거는 재설치를 위해 기존 설정과 사용자 데이터를 보존할 수 있습니다. 따라서 프로그램을 다시 설치해도 이전 인증이나 설정이 그대로 적용될 수 있습니다.

현재 버전에서는 전체 데이터까지 지우는 제거 옵션도 제공될 수 있으므로 먼저 아래 명령으로 지원 여부를 확인해 주세요.

hermes uninstall --help

설치된 버전에서 지원된다면 프로그램과 사용자 데이터를 함께 제거하는 방법은 다음과 같습니다.

hermes uninstall --full

저는 당시 터미널에서 폴더 삭제 명령을 사용하지 않고 Finder에서 직접 확인했습니다.

삭제 전에 Hermes 데이터 백업하기

.hermes 폴더에는 설정, 인증 정보, 세션과 각종 사용자 데이터가 포함될 수 있습니다.

필요한 세션이나 설정이 있다면 먼저 백업합니다.

hermes backup

백업 없이 .hermes 폴더를 삭제하면 기존 설정과 대화 기록 등을 되돌리지 못할 수 있습니다.

Finder에서 숨김 .hermes 폴더 확인하기

1. Finder를 엽니다.
2. Shift + Command + H를 눌러 사용자 홈 폴더로 이동합니다.
3. Command + Shift + .을 눌러 숨김 파일을 표시합니다.
4. .hermes 폴더가 있는지 확인합니다.
5. 백업과 삭제 대상을 다시 확인한 뒤 .hermes 폴더를 휴지통으로 이동합니다.
6. 작업이 끝나면 같은 단축키를 눌러 숨김 파일 표시를 다시 끌 수 있습니다.

Hermes 다시 설치하고 처음부터 설정하기

기존 데이터를 정리했다면 Hermes 공식 설치 안내에 따라 다시 설치합니다.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

설치가 끝난 뒤 새 터미널을 열거나 셸 설정을 다시 불러옵니다.

source ~/.zshrc

그다음 OpenAI Codex 공급자와 모델을 처음부터 다시 설정합니다.

hermes model

저는 이 방법으로 완전히 다시 설정한 뒤 현재 Hermes를 정상적으로 사용하고 있습니다.

하지만 이것은 제 환경에서 해결된 경험입니다. 모든 OpenAI Codex 401 오류가 반드시 .hermes 폴더 때문에 발생한다고 일반화해서는 안 됩니다.

재설치 후 정상 복구됐는지 확인하는 방법

1. hermes auth list에서 openai-codex 항목을 확인합니다.
2. hermes auth status openai-codex에서 인증 상태를 확인합니다.
3. hermes model에서 공급자와 모델을 확인합니다.
4. Hermes에서 간단한 질문을 두 번 이상 이어서 보냅니다.
5. 필요하다면 새 세션과 이전 세션 목록이 정상적으로 동작하는지 확인합니다.

재인증이나 재설치 후 세션 제목과 이전 대화가 어떻게 보이는지 헷갈린다면 Hermes Agent 세션 제목 확인 방법도 함께 확인해 보셔요.

인증 화면을 공유할 때 가려야 할 정보

• ChatGPT 계정 이메일
• 액세스 토큰과 갱신 토큰
• 장치 인증 코드
• macOS 사용자 이름과 컴퓨터 이름
• 로컬 폴더 경로
• 세션 ID와 내부 프로젝트명
• auth.json 파일의 실제 내용

이미지에서 가린 정보가 본문, 파일명, ALT와 캡션에 다시 적혀 있지 않은지도 함께 확인해 주세요.

특히 auth.json 파일을 직접 열어 블로그나 커뮤니티에 올리는 것은 피하는 편이 좋습니다.

OpenAI Codex 401 오류 해결 순서 정리

1. auth list와 auth status로 인증 상태를 확인합니다.
2. auth add 또는 hermes model에서 재인증합니다.
3. 간단한 질문을 두 번 이상 보내 정상 응답을 확인합니다.
4. 계속 실패하면 doctor, status --all과 공급자 로그아웃을 검토합니다.
5. 그래도 해결되지 않을 때만 데이터를 백업하고 완전 재설치를 검토합니다.
6. Finder에서 .hermes를 직접 삭제하는 방법은 데이터 손실 위험이 있는 마지막 수단으로만 사용합니다.

저는 처음에 단순히 로그인이 자꾸 풀리는 문제라고 생각했습니다.

그런데 여러 번 겪어 보니 재인증 한 번으로 해결되는 경우도 있었고, 이전 설정과 사용자 데이터를 완전히 정리해야 정상으로 돌아온 경우도 있었습니다.

무조건 .hermes 폴더부터 삭제하기보다는요. 작은 확인부터 시작해 한 단계씩 범위를 넓혀 가는 편이 훨씬 안전합니다.

Hermes의 OpenAI Codex 인증과 재인증 기준은 Hermes Agent 공식 AI Providers 문서에서 확인할 수 있습니다.

인증·진단·백업 명령은 Hermes Agent 공식 CLI Commands 문서, 삭제와 재설치는 Updating & Uninstalling 문서도 함께 확인해 주세요.

OpenAI Codex 401 오류에서 자주 묻는 질문

함께 보면 좋은 글

• Hermes Agent 세션 제목 확인 방법 | /title이 /sessions에 안 보이는 이유 — 재인증과 재설치 후 세션 상태를 확인할 때 참고합니다.
• ChatGPT 회원가입 로그인 방법 — OpenAI Codex 인증을 어떤 ChatGPT 계정으로 승인했는지 헷갈릴 때 참고합니다.