Claude Code 인증
Claude Code에 로그인하고 구독 상태를 확인합니다
Claude Code를 설치했으면, 이제 자신의 Claude 계정으로 로그인(인증)해야 합니다. 인증을 완료해야 Claude Code를 사용할 수 있습니다.
첫 로그인
이용 약관 동의
처음 실행하면 이용 약관이 표시됩니다. 내용을 확인하고 동의합니다.
로그인 방식 선택
로그인 방식을 선택하는 화면이 나타납니다. Claude.ai 계정을 선택합니다.
로그인 옵션
- Claude.ai account: Pro/Max 구독자가 사용 (추천)
- Anthropic API key: API 키를 직접 입력하여 사용
브라우저 인증
자동으로 웹 브라우저가 열립니다. 브라우저가 열리지 않으면 터미널에서 c를 눌러 로그인 URL을 복사하세요.
Claude.ai 계정으로 로그인하고 "Allow" (허용) 버튼을 클릭하여 Claude Code의 접근을 승인합니다.
인증 완료
브라우저에서 승인하면 PowerShell로 돌아와 인증이 완료됩니다. Claude Code의 프롬프트(>)가 나타나면 성공입니다.
구독 확인
Claude Code를 사용하려면 Pro 플랜($20/월) 이상의 구독이 필요합니다.
구독 상태는 claude.ai/settings에서 확인할 수 있습니다.
| 상태 | 의미 |
|---|---|
| Pro 또는 Max 활성화 | Claude Code 사용 가능 |
| Free 플랜 | Claude Code 사용 불가, 업그레이드 필요 |
콘솔 전용 인증 (v2.1.79+)
브라우저 없이 인증해야 하는 환경(원격 서버, SSH 등)에서는 --console 플래그를 사용할 수 있습니다:
claude --console이 플래그를 사용하면 브라우저를 열지 않고, 터미널에서 직접 인증 URL과 코드를 표시합니다. 다른 기기의 브라우저에서 URL에 접속하여 인증을 완료할 수 있습니다.
인증 문제 해결
인증 관리 CLI 명령어
Claude Code 2.1.41부터 인증을 CLI에서 직접 관리할 수 있습니다:
| 명령어 | 기능 |
|---|---|
claude auth login | 로그인 |
claude auth status | 현재 인증 상태 확인 |
claude auth logout | 로그아웃 |
인증 상태 확인
인증이 잘 되어 있는지 확인하려면:
claude auth status또는 전체 환경을 점검하려면:
claude doctor인증 관련 항목에 체크 표시가 나오면 정상입니다.