10월 19일, 윈도우 PC에 쇼츠 영상 작업을 맡기려는데 Claude Code가 시작되지 않았어요. 화면에는 “OAuth session expired and could not be refreshed”라는 문구가 떴어요. 쉽게 말하면 로그인 기간이 끝났고, 자동으로 연장되지도 않았다는 뜻이에요.
그날은 이미 로그인돼 있던 다른 도구(Codex)로 작업을 넘겼어요. 시험 영상은 음성 만들기부터 완성까지 약 8분 걸렸어요. 다만 8분은 영상을 만든 시간이에요. Claude Code 로그인을 고친 시간이 아니고, 다시 로그인해서 정상으로 돌아왔는지도 아직 확인하지 못했어요.
로그인 만료와 명령을 못 찾는 오류는 뭐가 다른가요?
둘 다 겉으로는 “Claude Code가 안 켜져요”로 보여요. 그런데 막힌 곳이 달라요. 건물 출입에 비유하면, 로그인 만료는 출입 카드 기한이 끝난 상태예요. 문 앞까지는 왔는데 카드가 안 먹히는 거죠. 명령을 못 찾는 경우는 문이 어디 있는지부터 모르는 상태예요.
제 기록에는 두 경우가 다 있어요. 10월 19일 윈도우 PC는 로그인 만료였고, 10월 16일 맥미니는 명령을 못 찾는 쪽이었어요. 표로 나눠 보면 이래요.
| 구분 | 로그인 만료 | 명령을 못 찾음 |
|---|---|---|
| 제 기록 | 10월 19일, 윈도우 PC | 10월 16일, 맥미니 원격 접속 |
| 화면에 보인 것 | OAuth session expired 문구 | 설치된 claude 명령을 못 찾음 |
| 막힌 곳 | 계정 로그인 | 프로그램 위치(PATH) |
| 먼저 볼 것 | /status로 계정·로그인 상태 | 설치 폴더가 PATH에 있는지 |
| 제 결과 | 다른 도구로 작업만 넘김, 재로그인은 미확인 | 폴더를 PATH에 추가해 처리 |
클로드 코드 로그인이 풀리면 어떻게 하나요?
먼저 오류 문구를 그대로 적어 둬요. 문구에 expired(만료)나 OAuth가 보이면 로그인 쪽 문제일 가능성이 커요.
Anthropic 공식 안내에 따르면 Claude Code 안에서 /login을 입력해 다시 로그인할 수 있고, /status로 지금 어떤 계정으로 연결돼 있는지 볼 수 있어요. 처음 쓰는 경우에는 터미널에서 claude를 실행하면 브라우저 로그인 화면으로 넘어가요. 원격 접속처럼 브라우저가 바로 연결되지 않는 환경에서는 코드를 직접 붙여 넣으라는 안내가 나올 수 있다고 해요.
https://code.claude.com/docs/en/authentication
이 순서는 공식 안내 기준이에요. 제가 그 윈도우 PC에서 끝까지 해 보고 확인한 절차는 아니에요. 로그인 때 받는 인증 코드는 글이나 작업 기록에 남기지 않아요.
클로드 코드 로그인 계정은 어떻게 확인하나요?
/status를 먼저 보는 이유는 연결 방식이 두 가지라서예요. 구독 계정으로 로그인하는 방법이 있고, API 키로 연결하는 방법이 있어요. 어느 쪽인지 모른 채 새 키부터 만들거나 결제를 바꾸면 문제가 더 헷갈려요. 그래서 이 글에서는 새 키 발급이나 구독 변경을 해결책으로 권하지 않아요.
원격 접속에서 명령을 못 찾을 때는요?
10월 16일에는 맥미니에 Claude Code가 설치돼 있었는데, 원격 접속(SSH)으로 명령을 보내자 claude를 찾지 못했어요. 실행 파일은 ~/.local/bin 폴더에 있었어요. 그런데 그 접속 환경의 PATH, 그러니까 컴퓨터가 프로그램을 찾아보는 폴더 목록에 이 폴더가 빠져 있었어요. 당시에는 이 폴더를 PATH에 추가해서 처리했어요.
이 경우는 다시 로그인해도 풀리지 않아요. 반대로 윈도우의 로그인 만료를 PATH 설정으로 고칠 수도 없고요. 기기도 날짜도 달랐던 두 일을 한 해결법으로 묶지 않은 이유예요. 공식 문제 해결 문서도 두 문제를 따로 다뤄요.
https://code.claude.com/docs/en/troubleshooting
바꾼 설정은 어떻게 되돌리나요?
로그인만 만료된 상황이라면 설치 폴더나 설정 파일을 지울 이유가 없어요. 이 글에서도 인증 파일 삭제나 보안 설정 해제는 해결 방법으로 넣지 않았어요.
PATH를 바꿀 때는 지금 열린 터미널에서만 바꾼 건지, 설정 파일에 저장한 건지 구분해 둬요. 터미널에서만 바꿨다면 새 터미널에서는 원래 값으로 열려요. 설정 파일에 줄을 추가했다면 그 줄을 지워야 원래대로 돌아가요. 이건 일반적인 설명이고, 이 글을 쓰면서 기기 설정을 다시 바꾸지는 않았어요.
용어가 낯설다면
OAuth는 비밀번호를 직접 넘기지 않고 계정 로그인으로 접근을 허락하는 방식이에요. SSH는 다른 컴퓨터의 터미널에 원격으로 들어가는 연결이고, PATH는 명령어를 입력했을 때 컴퓨터가 프로그램을 찾아보는 폴더 목록이에요.
제게 남은 일은 윈도우 PC에서 Claude Code에 다시 로그인한 뒤 같은 영상 작업이 시작되는지 보는 거예요. 영상 8분 기록은 있지만, 로그인 복구에 걸리는 시간과 같은 오류가 다시 생기는지는 아직 몰라요.
확인 날짜 2026-10-25