Claude Code login 반복 인증 버그 (업데이트 후에도 지속됨)

[aidenkorea]

Bug Report

Description
v2.1.62 최신 버전 업데이트 후에도 Claude Code 로그인이 설정이 유지되지 않고 반복적으로 인증 요청됨. GitHub에 fix가 확인되었으나 해결되지 않음.

Priority: Medium - 불편하지만 워크어라운드 가능

Environment

• OS: macOS (Darwin 22.5.0)
• Claude Code version: 2.1.62
• Related upstream issue: Frequent re-authentication required (multiple times per day) anthropics/claude-code#28302 (Frequent re-authentication required)

Steps to Reproduce

1. Update Claude Code to v2.1.62
2. Login with /login or claude auth login
3. After some time or session restart, login is required again

Expected Behavior
Authentication should persist after successful login.

Actual Behavior
Re-authentication is required repeatedly even on the latest version.

Additional Context
GitHub confirms a fix was merged (anthropics/claude-code#28302 marked COMPLETED Feb 26, 2026) but the issue persists on v2.1.62.

[GoosLab]

이슈 분류: bug | Claude Code 반복 인증 버그

@claude 이 버그를 재현하는 실험을 먼저 수행한 뒤, v2.1.62에서 반복 인증 문제의 원인을 분석하고 해결 방안을 제시해 주세요. 분석 시 anthropics/claude-code#28302 업스트림 이슈와 관련 fix가 현재 버전에 실제로 포함되어 있는지, 로컬 인증 토큰 저장/갱신 로직에 문제가 없는지 확인해 주세요.

Latte AI Triage • latte@mo.ai.kr

[claude]

Claude finished @GoosLab's task in 3m 36s —— View job

---

Claude Code v2.1.62 반복 인증 버그 분석

분석 작업 목록:

• 작업 목록 생성
• moai-adk 코드베이스에서 인증 관련 코드 탐색
• settings.json 생성 로직 분석
• GLM 모드의 인증 토큰 처리 확인
• 업스트림 이슈 #28302 관련 fix 분석
• 원인 분석 및 해결 방안 제시

---

분석 결과

이 이슈는 두 개의 독립적인 버그가 혼재되어 있습니다.

---

Bug 1: moai-adk OAuth 토큰 손실 버그 (moai GLM 사용자)

재현 경로

1. 사용자가 Claude /login → OAuth 토큰이 ~/.claude/settings.local.json 또는 
   .claude/settings.local.json에 ANTHROPIC_AUTH_TOKEN으로 저장됨
2. moai glm 실행 → injectGLMEnvForTeam()이 ANTHROPIC_AUTH_TOKEN을 GLM API 키로 덮어씀
3. moai cc 실행 → removeGLMEnv()가 ANTHROPIC_AUTH_TOKEN을 완전히 삭제
4. Claude Code 재시작 → ANTHROPIC_AUTH_TOKEN 없음 → /login 요구

근본 원인 (코드 확인됨)

internal/cli/oauth_token_preservation_test.go에 버그와 픽스가 명확히 문서화되어 있습니다:

// Root cause:
//  1. moai glm writes ANTHROPIC_AUTH_TOKEN=<GLM_KEY> to .claude/settings.local.json
//     This overwrites any pre-existing Claude OAuth token stored there.
//  2. moai cc calls removeGLMEnv() which deletes ANTHROPIC_AUTH_TOKEN entirely,
//     never restoring the original OAuth token.
//  3. On next Claude Code startup, ANTHROPIC_AUTH_TOKEN is missing => /login required.

픽스 상태: ✅ 이미 구현됨

internal/cli/glm.go:389-438 (injectGLMEnvForTeam):

// Back up any existing ANTHROPIC_AUTH_TOKEN that is not the GLM key itself.
if existing := settings.Env["ANTHROPIC_AUTH_TOKEN"]; existing != "" && existing != apiKey {
    settings.Env["MOAI_BACKUP_AUTH_TOKEN"] = existing  // OAuth 토큰 백업
}
settings.Env["ANTHROPIC_AUTH_TOKEN"] = apiKey  // GLM 키 주입

internal/cli/cc.go:106-164 (removeGLMEnv):

// OAuth token preservation: restore backed-up token
if backup, ok := settings.Env["MOAI_BACKUP_AUTH_TOKEN"]; ok && backup != "" {
    settings.Env["ANTHROPIC_AUTH_TOKEN"] = backup  // OAuth 토큰 복원
} else {
    delete(settings.Env, "ANTHROPIC_AUTH_TOKEN")
}
delete(settings.Env, "MOAI_BACKUP_AUTH_TOKEN")

검증 테스트 (4개 케이스)

TestOAuthToken_GLMOverwritesOAuthToken — GLM 주입 시 백업 생성 확인
TestOAuthToken_CCDoesNotRestoreOAuthToken — moai cc 시 복원 확인
TestOAuthToken_FullCycle — moai glm → moai cc 전체 라운드트립 검증
TestOAuthToken_NoExistingToken — 기존 토큰 없는 경우 정상 동작 확인

---

Bug 2: 업스트림 Claude Code 세션 지속 버그 (anthropics/claude-code#28302)

분석

이슈에서 언급된 업스트림 버그 #28302는 moai-adk와 독립적인 Claude Code 자체의 OAuth 세션 관리 버그입니다.

항목	내용
원인	Claude Code의 OAuth 세션 만료/갱신 처리 로직
대상 파일	Claude Code 내부 (~/.claude/) — moai-adk 외부
픽스 머지	Feb 26, 2026 (anthropics/claude-code#28302 COMPLETED)
v2.1.62 포함 여부	미포함 가능성 높음 — 픽스 머지와 릴리즈 날짜가 동일일(2026-02-26)이므로 해당 버전에 포함되지 않았을 수 있음

핵심 구분

• Claude /login은 전역 파일 ~/.claude/settings.local.json에 쓰기 (moai-adk 비관여)
• moai glm/moai cc는 프로젝트 파일 .claude/settings.local.json에만 접근
• 즉, GLM 미사용 사용자의 반복 인증은 순수 업스트림 Claude Code 버그

---

해결 방안

GLM 모드 사용자 (moai-adk 관련)

버그 픽스가 이미 현재 코드베이스에 구현되어 있으므로, 최신 버전 moai 바이너리로 업데이트하면 해결됩니다.

# 최신 버전 설치 후 확인
moai version

# 이전에 moai glm을 사용했다면 초기화
moai cc  # GLM 모드 비활성화 (OAuth 토큰 복원 포함)
moai glm  # 다시 활성화 (토큰 백업 메커니즘 작동)

순수 Claude Code OAuth 사용자 (업스트림 관련)

Claude Code 업스트림 픽스가 포함된 버전 릴리즈를 기다리거나 다음 워크어라운드 사용:

# 임시 방편: API 키를 환경 변수로 직접 설정
export ANTHROPIC_API_KEY="your-api-key"
claude

# 또는 ~/.claude/settings.local.json에 직접 설정 유지

---

추가 확인 필요 사항

clearTmuxSessionEnv()는 tmux 세션의 ANTHROPIC_AUTH_TOKEN을 백업 없이 삭제합니다 (internal/cli/glm.go:271). 현재 주석에는 "Claude 크레덴셜은 ~/.claude/에 저장되므로 tmux 환경 변수 제거는 안전"이라고 명시되어 있어 의도적인 동작입니다. 하지만 사용자가 직접 tmux에 ANTHROPIC_AUTH_TOKEN을 설정한 경우 영향받을 수 있는 엣지 케이스가 존재합니다.

---

결론

버그	원인	moai-adk 관련	현재 상태
GLM 토큰 손실	moai glm/moai cc가 OAuth 토큰 덮어씀	✅ 직접 관련	✅ 픽스 구현됨 (MOAI_BACKUP_AUTH_TOKEN 메커니즘)
반복 인증 (v2.1.62)	Claude Code 세션 관리 버그	❌ 비관련	⏳ 업스트림 픽스 대기 (anthropics/claude-code#28302)

[GoosLab]

@claude 가장 좋은 방법은 claude code 삭제 후 재설치를 강력하게 추천. 나 역시도 이 문제를 그렇게 해결하였음. 삭제 후 재설치 안내를 해드리도록 해!! npm install -g @anthropic-ai/claude-code 명령은 삭제가 되었고, 최신 문서 기준으로 답변을 해야 한다.

[claude]

Claude finished @GoosLab's task in 1m 45s —— View job

---

Claude Code 반복 인증 버그 — 완전 재설치 가이드

작업 목록:

• 최신 Claude Code 설치/제거 방법 조사
• 공식 문서 기준 재설치 가이드 작성

---

해결 방법: 완전 삭제 후 재설치 (강력 권장)

v2.1.62에서 반복 인증 문제가 지속될 경우, 완전 삭제 후 네이티브 인스톨러로 재설치하는 것이 가장 확실한 해결 방법입니다.

⚠️ 중요: npm install -g @anthropic-ai/claude-code 방식은 공식 deprecated 되었습니다. 아래 네이티브 설치 방법을 사용하세요.

---

STEP 1: 완전 삭제

네이티브 설치 제거 (macOS/Linux)

# 바이너리 및 버전 파일 삭제
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

npm 설치 제거 (기존에 npm으로 설치한 경우)

npm uninstall -g @anthropic-ai/claude-code

설정 파일 완전 삭제 (인증 정보 포함)

⚠️ 아래 명령은 모든 설정, 허용된 도구, MCP 서버 설정, 세션 히스토리를 삭제합니다.

# 사용자 설정 및 상태 삭제
rm -rf ~/.claude
rm ~/.claude.json

# 프로젝트별 설정 삭제 (프로젝트 디렉토리에서 실행)
rm -rf .claude
rm -f .mcp.json

혹시 남은 잔여 파일도 제거 (선택 사항)

rm -rf ~/.claude-code
rm -rf ~/.config/claude-code
rm -rf ~/.cache/claude-code
rm -rf ~/Library/Application\ Support/claude-code  # macOS
rm -rf ~/Library/Caches/claude-code                # macOS

---

STEP 2: 네이티브 인스톨러로 재설치 (공식 권장)

macOS / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

Homebrew (macOS)

brew install --cask claude-code

---

STEP 3: 설치 확인 및 재로그인

# 설치 버전 확인
claude --version

# 설치 상태 진단
claude doctor

# 로그인
claude

브라우저 프롬프트를 따라 인증을 진행하면 됩니다.

---

네이티브 설치의 장점

항목	npm (deprecated)	네이티브 설치 (권장)
Node.js 필요	✅ 필요	❌ 불필요
자동 업데이트	❌ 없음	✅ 백그라운드 자동 업데이트
안정성	낮음	높음
공식 지원	❌ Deprecated	✅ 공식 권장

---

Sources:

• Advanced setup - Claude Code Official Docs
• How to Uninstall Claude Code - ClaudeLog