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 옵션을 붙이면 사람이 읽기 쉬운 형식으로 볼 수 있고, 자동화 스크립트 맨 앞에 두면 로그인 여부를 점검하는 안전장치 역할을 합니다.

FAQ · 자주 묻는 질문

이 명령을 실행하면 뭔가 바뀌거나 계정에 영향이 있나요?

아니요, 현재 로그인 상태를 확인만 하는 명령이라 계정이나 작업에 아무 영향이 없습니다. 실행하면 로그인 여부와 계정 정보를 JSON 형식으로 보여 줄 뿐이에요. "내가 지금 로그인 돼 있나?"가 궁금할 때 부담 없이 한 줄 쳐 보면 되고, 결과를 보고 나서 필요한 다음 행동을 정하면 됩니다.

JSON이 읽기 어려운데 쉽게 보는 방법은 없나요?

claude auth status --text를 쓰면 됩니다. --text 옵션을 붙이면 JSON 대신 사람이 읽기 편한 글자 형식으로 보여 줘요. 옵션은 명령어 뒤에 붙여 동작 방식을 바꾸는 추가 설정입니다. 기본 JSON은 스크립트가 읽어 판단하기 좋은 형태라, 눈으로 직접 확인할 때는 --text가 훨씬 편합니다.

자동화 스크립트에는 어떻게 활용하나요?

스크립트 맨 앞에 claude auth status를 넣어 두면 됩니다. 로그인이 돼 있을 때만 다음 작업으로 넘어가게 만들 수 있어서, 로그인이 안 된 상태로 작업이 진행되는 사고를 막는 안전장치가 돼요. 야간 배치 작업이나 정기 실행처럼 사람이 지켜보지 못하는 작업에서 특히 든든합니다.

기준: Claude Code v2.1.154 (2026.05)