Claude Code 로그인 오류 — 자꾸 풀릴 때 확인할 세 가지

로그인이 자꾸 풀립니다. 어제까지 잘 되던 게 오늘 갑자기 안 되고, 뜨는 문구는 매번 조금씩 다릅니다. 공식 에러 안내 문서를 세어보니 인증 관련 항목만 서른 개가 넘었습니다. 그런데 하나하나 읽어보면 해법은 사실상 세 갈래뿐이었습니다. 대부분은 명령 한 줄로 끝나고, 일부는 두 단계를 밟아야 하고, 일부는 내가 아무리 해도 안 됩니다. 문구를 정확히 해독하는 것보다 지금 어느 갈래인지 아는 게 빠릅니다.

📌 30초 요약

• 절반 이상은 로그인 명령 한 줄로 해결됩니다.
• 원격으로 쓰던 거라면 한 단계 더 있습니다 — 로그인만으론 안 돌아옵니다.
• ⚠️ 회사 정책으로 막힌 것은 못 고칩니다 — 관리자에게 가야 합니다.
• 지금 무엇으로 로그인돼 있는지 먼저 확인하세요 — 명령이 따로 있습니다.
• 열쇠를 걸어뒀으면 그게 먼저 잡힙니다 — 로그인해도 안 바뀝니다.
• 계정을 바꾸면 원격 연결이 끊깁니다 — 다시 이어야 합니다.

대부분은 한 명령으로 끝납니다

문서를 훑으면 금방 눈에 띕니다. "로그인 명령을 실행하라"가 해법인 항목이 압도적으로 많습니다. 토큰이 만료됐든, 회수됐든, 세션이 끝났든, 갱신에 실패했든, 권한 범위가 모자라든 — 문구는 다 다른데 할 일은 같습니다.

그래서 문구를 해독하느라 시간을 쓸 필요가 없습니다. 인증 비슷한 말이 보이면 일단 로그인부터 다시 하는 게 확률적으로 맞습니다. 그러고도 안 되면 그때 나머지 두 갈래를 의심하면 됩니다.

갈래	어떤 경우	누가 푸나
① 다시 로그인	만료·회수·갱신 실패·범위 부족	나
② 로그인 + 재연결	원격으로 쓰던 세션, 계정 변경	나(두 단계)
③ 관리자에게	조직 정책으로 차단·계정 정지	내가 못 함
그전에	지금 무엇으로 인증 중인지부터 확인

원격은 두 단계입니다

다른 기기에서 내 세션에 붙어 쓰던 경우는 로그인만으로 돌아오지 않습니다. 문서에 나오는 이 계열 항목들이 하나같이 "로그인한 다음, 원격 연결 명령을 다시 실행하라"고 두 단계를 적어뒀습니다. 로그인만 하고 왜 안 되냐고 하기 쉬운 자리죠.

끊기는 이유도 여러 가지입니다. 토큰 갱신 실패, 웹 로그인 만료, 토큰 거부, 로그아웃 — 그리고 재미있는 게 하나 있는데 이 컴퓨터에서 로그인한 계정이나 조직이 바뀌면 그것만으로 끊깁니다. 회사 계정과 개인 계정을 오가며 쓴다면 바꿀 때마다 원격 연결이 떨어진다고 보시면 됩니다. 폰에서 세션을 이어 붙이는 방식 자체는 원격 조종을 다뤘던 글에 정리돼 있습니다.

내가 못 고치는 것들

이 갈래를 아는 게 시간을 가장 많이 아껴줍니다. 조직 차원에서 막아둔 것은 내 쪽에서 뭘 해도 안 풀립니다. 문서에 나오는 유형이 넷입니다 — 조직 계정 자체가 정지된 경우, 열쇠 방식 인증을 금지한 경우, 구독 계정 접근을 금지한 경우, 예약 실행 기능을 금지한 경우. 각각의 해법이 전부 "관리자에게 요청하라"입니다.

다만 둘 중 하나가 막힌 거라면 다른 쪽으로 우회가 됩니다. 열쇠 방식이 막혔으면 로그인 방식으로, 구독 접근이 막혔으면 열쇠 방식으로 — 둘 다 막힌 게 아니라면요. 회사 장비에서 안 될 때 이 구분부터 해보시면 "설정을 잘못 건드렸나" 하고 몇 시간 헤매는 일을 피할 수 있습니다.

그전에 확인할 것 하나

🔑 열쇠를 걸어뒀으면 그게 먼저 잡힙니다

가장 자주 헛수고하는 자리입니다. 환경에 열쇠 값을 걸어뒀다면, 아무리 로그인을 다시 해도 도구는 그 열쇠를 씁니다. 예전에 시험 삼아 넣어둔 값이 설정 파일 어딘가에 남아 있는 경우가 흔하죠. 문서도 열쇠가 거부될 때 오타·회수 여부와 함께 "설정 파일에 오래된 값이 남아 있는지"를 확인 목록에 넣어뒀습니다. 해법은 간단합니다 — 그 값을 지우고 로그인을 다시 하는 것. 그리고 무엇을 쓰고 있는지 확인하는 전용 명령이 따로 있으니, 헤매기 전에 그것부터 쳐보시면 됩니다.

자격증명을 스크립트로 받아오게 해둔 경우도 짚어둘 만합니다. 그 스크립트가 실패하거나 이상한 값을 뱉으면 도구는 인증에 실패하는데, 원인이 도구가 아니라 내 스크립트에 있습니다. 문서는 스크립트를 직접 실행해보고 올바른 값이 출력되는지 확인하라고 안내합니다. 여러 서비스의 토큰을 받아 쓰는 구조라면 이런 자리가 늘어나는데, 토큰을 발급받아 쓰는 흐름 자체는 모델 저장소를 다룬 가이드에서 기본기를 정리해뒀습니다.

🔁 네 번째 갈래 — 실은 로그인 문제가 아닌 경우

로그인이 자꾸 풀릴 때 볼 세 가지를 짚었는데, 「로그인하라」는 안내가 뜨는데도 로그인 문제가 아닌 경우가 하나 더 있습니다. 도구 호출이 권한 부족으로 거절됐는데 「로그인 만료」로 알려 주던 문제가 최근에 고쳐졌거든요. 안내를 믿고 다시 로그인해 봐야 같은 자리에서 또 막힙니다. 또 같은 서버 이름을 여러 자리에 다른 주소로 적어 두면 로그인 기록이 주소별로 따로 저장돼, 한쪽에서 인증해도 다른 정의가 불려 오는 곳에서는 또 로그인해야 합니다. 「로그인하라」가 두 번 이상 반복되면 권한과 주소 쪽을 먼저 보세요.

자주 묻는 질문 (FAQ)

Q. 로그인을 다시 했는데도 그대로입니다

세 가지를 순서대로 보세요. ①환경에 열쇠 값이 걸려 있는지 — 있으면 로그인해도 그쪽이 먼저 잡힙니다. ②원격으로 쓰던 세션인지 — 그렇다면 연결 명령을 한 번 더 쳐야 합니다. ③조직 정책으로 막힌 건 아닌지 — 이건 내 쪽에서 안 풀립니다. 확인 명령으로 지금 무엇으로 인증 중인지부터 보시면 셋 중 어느 쪽인지 대개 드러납니다.

Q. 회사 계정과 개인 계정을 같이 씁니다

계정을 바꾸면 원격 연결이 끊긴다는 걸 알아두세요. 문서에 "이 컴퓨터에서 로그인한 계정이나 조직이 바뀌었다"는 항목이 따로 있고, 해법은 다시 로그인한 뒤 연결 명령을 실행하는 것입니다. 그리고 회사 계정 쪽에 정책 제한이 걸려 있을 수 있으니, 개인 계정에서 되던 기능이 회사 계정에서 안 된다면 설정이 아니라 정책을 의심하시는 게 빠릅니다.

Q. 관리자에게 뭐라고 말해야 하나요?

화면에 뜬 문구를 그대로 전달하는 게 가장 빠릅니다. 문서의 정책 계열 항목들은 무엇이 금지됐는지를 문구에 그대로 적어둡니다 — 열쇠 방식인지, 구독 접근인지, 예약 실행인지가 문장에 들어 있죠. 관리자 입장에서는 그 한 줄이면 어느 설정을 켜야 하는지 압니다. "안 돼요"보다 "이 문구가 떴어요"가 훨씬 빨리 해결됩니다.

🧾 정직하게 밝혀둘 것

• ★세 갈래 분류는 제가 만든 것입니다. 공식 문서는 항목을 나열할 뿐 이렇게 묶어 제시하지 않습니다. 해법이 같은 것끼리 모아본 결과입니다.
• 서른 개가 넘는 항목을 전부 나열하지 않았습니다. 자주 마주칠 계열 위주로 골랐으니 특이한 문구는 원문에서 찾아보셔야 합니다.
• 직접 로그인을 깨뜨려 재현해보지는 않았습니다. 문서에 적힌 원인과 해법을 정리한 것입니다.
• 조직 정책은 회사마다 다릅니다. 여기서 "관리자에게"라고 한 것도 조직에 따라 담당이 다를 수 있습니다.
• 명령과 설정 이름은 읽기 쉽게 풀어 적었습니다. 정확한 표기는 원문 문서를 확인해 주세요.

✨ 정리하면

문구가 서른 가지여도 할 일은 셋 중 하나입니다. 일단 다시 로그인하고, 원격이었으면 연결을 한 번 더 하고, 그래도 안 되면 정책으로 막힌 건 아닌지 보세요. 그전에 환경에 걸어둔 열쇠가 없는지만 확인하면 헛수고를 크게 줄입니다. 원격으로 붙어 쓰는 방식은 폰에서 내 세션 이어 코딩, 토큰 발급의 기본기는 모델 저장소 완벽 가이드, 답이 끊겼을 때의 대처는 끊긴 답을 이어받기, 도구에 드는 값을 통으로 잡는 흐름은 AI 지출 관리 허브에 모아뒀습니다.

※ 출처: Claude Code 에러 안내 공식 문서의 인증 항목(2026년 8월 27일 열람). 세 갈래 분류는 해법이 같은 항목끼리 묶어 정리한 것이며 공식이 제시한 형태가 아닙니다. 조직 정책과 관련된 부분은 소속 조직의 설정에 따라 달라집니다.