Claude Code 인증 초기화 방법: Authentication failed 오류 해결까지
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 파일을 삭제하면 됩니다. 삭제 후 재실행하면 깨끗한 상태로 다시 로그인할 수 있습니다.
클로드 코드 인증 초기화 과정에서 추가 오류가 발생한다면 공식 트러블슈팅 문서에서 최신 해결법을 확인하세요.
