안녕하세요
Claude Code를 통해 바이브코딩을 하다보면, Claude Code에 저장된 인증정보를 삭제하고 다시 설정해야 하는 경우가 있습니다.
예를 들면 터미널에서 Claude Code를 쓰다 보면 계정이 꼬이거나, API 키와 구독 계정이 충돌해서 "Authentication failed" 오류가 무한 반복되는 경우입니다.
오늘은 Claude Code 인증을 깔끔하게 초기화하는 방법부터, 계정을 자유자재로 변경하는 꿀팁까지 완벽하게 가이드해 드리겠습니다.
1. Claude Code 인증 초기화 & 계정 변경 완벽 가이드
1. 가장 깔끔한 방법: 명령어 로그아웃 (Soft Reset)
가장 먼저 시도해봐야 할 것은 정상적인 로그아웃입니다. 많은 분이 터미널 창을 그냥 닫아버리시는데, 그러면 세션 정보가 남아서 꼬일 수 있습니다.
- 대화형 모드(REPL)에 진입한 상태라면: 입력창에 /logout을 치세요. 가장 안전하게 세션을 종료하고 토큰을 삭제합니다.
> /logout - 터미널에서 바로 실행하려면 :이 명령어를 입력하면 로컬에 저장된 인증 정보가 삭제되고, 다시 claude를 실행했을 때 로그인 화면이 뜹니다.
$ claude auth logout
2. 안 되면 강제로 밀어버리자: 파일 삭제 (Hard Reset)
위 방법으로도 해결이 안 되거나, "권한 오류(Permission denied)" 같은 에러가 뜬다면 설정 파일을 직접 삭제해야 합니다. 운영체제별로 인증 토큰이 숨어있는 위치가 다릅니다.
2-1) macOS / Linux / WSL 사용자
터미널을 열고 아래 명령어를 입력해 인증 파일을 강제 삭제하세요.
# Claude 설정 폴더 삭제
rm -rf ~/.claude
rm -f ~/.claude.json
2-2) Windows 사용자
윈도우는 AppData 폴더에 숨어있습니다.
# Claude 설정 폴더 삭제
rmdir /s %USERPROFILE%\.claude
del %USERPROFILE%\.claude.json
이걸 지우고 다시 Claude를 실행하면, 마치 처음 설치한 것처럼 깨끗한 상태로 로그인을 시작할 수 있습니다.
3. 참조 링크
https://code.claude.com/docs/en/troubleshooting
Troubleshooting - Claude Code Docs
Discover solutions to common issues with Claude Code installation and usage.
code.claude.com
https://code.claude.com/docs/en/quickstart
Quickstart - Claude Code Docs
Welcome to Claude Code!
code.claude.com

'IT > AI' 카테고리의 다른 글
| Claude Code(클로드 코드) 필수 명령어 완벽 정리 - 개발 생산성 10배 높이는 실전 꿀팁 (0) | 2025.12.26 |
|---|---|
| Claude Code(클로드 코드) 사용 시 토큰 비용 절약 꿀팁 총정리! (0) | 2025.12.24 |
| Claude Code 요금제 완벽 정리 : Pro 구독 vs API 종량제, 개발자의 선택은? (0) | 2025.12.23 |
| Claude Code 를 활용한 바이브코딩 시작하기(클로드 코드 설치 및 실행하기) (0) | 2025.12.22 |
댓글