Claude Code 인증 초기화로 Authentication failed 오류를 해결합니다. Soft Reset(로그아웃)부터 Hard Reset(설정 파일 삭제)까지 OS별 명령어와 언제 어떤 방법을 써야 할지, 재로그인 방법까지 정리했습니다.
Claude Code 인증 오류, 왜 생길까?
Claude Code를 쓰다 보면 어느 순간 갑자기 로그인이 풀리거나, 터미널에 Authentication failed 메시지가 반복해서 뜨는 경험을 하게 됩니다. 원인은 크게 세 가지입니다.
흔한 원인 3가지
- API 키와 구독 계정이 동시에 설정되어 충돌하는 경우
- 터미널 창을 그냥 닫아버려 세션 정보가 꼬인 경우
- 계정을 바꾸거나 재설치했는데 이전 인증 토큰이 남아 있는 경우
이 중 하나라도 해당된다면 인증 정보를 초기화하면 바로 해결됩니다. 방법은 두 가지고, 순서대로 시도하면 됩니다.
방법 1 — 명령어로 로그아웃하기 (Soft Reset)
가장 먼저 시도해야 할 방법입니다. Claude Code가 제공하는 공식 로그아웃 명령어를 사용하는 것으로, 인증 토큰을 안전하게 삭제해 줍니다.
대화형 모드(REPL)에서 로그아웃
Claude Code 실행 후 입력창이 열린 상태라면 아래 명령어를 입력하세요.
/logout슬래시(/) 로 시작하는 내장 명령어로, 현재 세션의 인증 정보를 깔끔하게 종료합니다.
터미널에서 직접 로그아웃
REPL에 진입하지 않고 터미널에서 바로 실행하려면 아래 명령어를 사용합니다.
claude auth logout이 명령어를 실행하면 로컬에 저장된 인증 정보가 삭제되고, 다음에 claude를 실행했을 때 로그인 화면이 새로 뜨게 됩니다. 대부분의 경우 이것만으로 문제가 해결됩니다.
방법 2 — 설정 파일 직접 삭제하기 (Hard Reset)
명령어 로그아웃으로 해결이 안 된다면, 인증 파일이 저장된 폴더를 직접 삭제해야 합니다. “Permission denied” 오류가 함께 뜰 때도 이 방법을 사용하세요.
Claude Code의 인증 토큰은 운영체제별로 다른 위치에 저장됩니다.
macOS / Linux / WSL
터미널을 열고 아래 두 줄을 순서대로 입력합니다.
rm -rf ~/.claude
rm -f ~/.claude.json~/.claude— 설정 폴더 전체~/.claude.json— 인증 토큰이 담긴 JSON 파일
둘 다 삭제해야 완전히 초기화됩니다. 하나만 지우면 일부 설정이 남아 같은 오류가 반복될 수 있습니다.
Windows (CMD)
윈도우에서는 인증 정보가 AppData 폴더 아래 숨어 있습니다. 명령 프롬프트(CMD)를 열고 아래 명령어를 실행하세요.
rmdir /s %USERPROFILE%\.claude
del %USERPROFILE%\.claude.json파일 삭제 후 claude를 다시 실행하면 처음 설치한 것처럼 새 로그인 화면이 뜹니다. 여기서 계정을 새로 인증하면 됩니다.
Soft Reset vs Hard Reset — 언제 어떤 방법을 써야 할까?
| 상황 | 권장 방법 |
|---|---|
| 평소와 다른 계정으로 바꾸고 싶을 때 | Soft Reset (명령어 로그아웃) |
| Authentication failed 오류가 반복될 때 | Soft Reset 먼저, 안 되면 Hard Reset |
| Permission denied 오류가 함께 뜰 때 | Hard Reset (파일 직접 삭제) |
| 완전히 초기 상태로 되돌리고 싶을 때 | Hard Reset |
| API 키와 구독 계정 충돌이 의심될 때 | Hard Reset |
원칙은 간단합니다. Soft Reset을 먼저 시도하고, 해결이 안 되면 Hard Reset으로 넘어가면 됩니다.
초기화 후 재로그인 방법
인증 정보를 삭제한 뒤 터미널에서 claude를 실행하면 로그인 방식을 선택하는 화면이 나타납니다.
로그인 방식 2가지
- Claude.ai 구독 계정 — Pro, Max 플랜을 구독 중이라면 이 방법으로 로그인
- API 키 — Anthropic Console에서 발급한 API 키를 직접 입력
둘 중 하나만 설정해야 합니다. 두 방식을 동시에 설정하면 또 충돌이 발생할 수 있으니 주의하세요.
클로드 코드 인증 초기화 — 핵심 정리
Claude Code 인증 오류는 대부분 인증 토큰이 꼬인 것이 원인입니다. claude auth logout 명령어로 먼저 시도하고, 해결이 안 되면 OS에 맞는 경로의 .claude 폴더와 .claude.json 파일을 삭제하면 됩니다. 삭제 후 재실행하면 깨끗한 상태로 다시 로그인할 수 있습니다.
자주 묻는 질문
Q. 로그아웃했는데도 Authentication failed가 또 떠요.
Soft Reset으로 안 되면 인증 파일이 꼬인 것이라 Hard Reset이 필요합니다. OS에 맞게 ~/.claude 폴더와 ~/.claude.json(Windows는 %USERPROFILE%\.claude)을 삭제한 뒤 재실행해 새로 로그인하세요. API 키와 구독 계정을 동시에 설정하지 않는 것도 중요합니다.
Q. 인증 초기화하면 그동안 설정이나 대화 기록도 사라지나요?
Hard Reset으로 ~/.claude 폴더를 통째로 지우면 인증 토큰뿐 아니라 커스텀 설정·세션 기록도 함께 삭제됩니다. 설정을 보존하려면 삭제 전 폴더를 백업하거나, 가능한 경우 Soft Reset(claude auth logout)부터 시도하세요. 단, 계정·크레딧은 영향받지 않습니다.
