claude auth status: 로그인 상태를 코드로 확인하는 법

자동화 스크립트를 돌렸는데 "로그인이 안 돼 있어서 그냥 멈춰 버렸다"면 곤란하겠죠. 작업을 시작하기 전에 "지금 로그인 돼 있나?"를 먼저 확인할 수 있다면 이런 사고를 막을 수 있어요. 그 확인을 담당하는 명령어가 claude auth status입니다.

정의 (뭐냐면)

claude auth status는 현재 Claude Code의 로그인 상태를 확인하는 명령어예요. 결과를 JSON 형식으로 보여 줍니다.

JSON은 "JavaScript Object Notation(자바스크립트 객체 표기법)"의 줄임말로, 컴퓨터끼리 데이터를 주고받기 좋은 정해진 형식이에요. 사람이 읽기엔 조금 빽빽하지만, 스크립트(자동으로 명령을 실행하는 작은 프로그램)가 결과를 읽어 판단하기엔 아주 편한 형태죠. 그래서 이 명령어는 자동화 작업에서 "진행해도 되는지" 점검하는 용도로 자주 쓰입니다.

어떻게 쓰나 (난이도별)

기초 — 상태 확인하기

claude auth status

이 한 줄을 입력하면 현재 로그인 여부와 계정 정보를 JSON 형식으로 보여 줘요. "내가 지금 로그인 돼 있나?"를 빠르게 확인하고 싶을 때 쓰면 됩니다.

응용 — 사람이 읽기 쉽게 보기

claude auth status --text

--text 옵션을 붙이면 JSON 대신 사람이 읽기 편한 글자 형식으로 보여 줘요. 옵션은 명령어 뒤에 붙여서 동작 방식을 바꾸는 추가 설정이에요. JSON이 눈에 잘 안 들어온다면 이 옵션을 쓰는 게 편합니다.

실전 사례

자동화 스크립트의 맨 앞에 claude auth status를 넣어 두면, 로그인이 돼 있을 때만 다음 작업으로 넘어가도록 만들 수 있어요. 로그인이 안 돼 있으면 거기서 멈추고 알려 주니, 엉뚱한 상태로 작업이 진행되는 걸 막는 안전장치가 됩니다.

이렇게 더 씁니다

여러 단계로 이어지는 자동화 작업을 만들 때, 시작 지점에 상태 점검을 한 번 넣어 두는 습관을 들이면 좋아요. 사람이 매번 눈으로 확인하지 않아도 스크립트가 알아서 "로그인 됐는지" 보고 진행하니, 야간 배치 작업이나 정기 실행처럼 사람이 지켜보지 못하는 작업에서 특히 든든합니다.

정리

claude auth status는 Claude Code 로그인 상태를 JSON으로 확인하는 명령어예요. --text 옵션을 붙이면 사람이 읽기 쉬운 형식으로 볼 수 있고, 자동화 스크립트 맨 앞에 두면 로그인 여부를 점검하는 안전장치 역할을 합니다.

기준: Claude Code v2.1.154 (2026.05)