Claude Code 인증
Claude Code 설치 후 첫 로그인, 구독 상태 확인, 인증 문제 대응, 터미널 세션 준비를 Windows 바이브코딩 환경 기준으로 단계별 안내합니다.
핵심 요약
- PowerShell에서
claude실행 → 약관 동의 → Claude.ai 계정 선택 → 브라우저 "Allow"로 첫 로그인을 완료합니다. - Claude Code는 Pro·Max·Team·Enterprise·Console 계정이 필요하며 Free 플랜에는 포함되지 않습니다.
ANTHROPIC_API_KEY환경 변수가 있으면 API 키가 우선 사용되므로, 구독 사용량으로만 쓰려면 변수를 제거하거나/logout후 재로그인합니다.- 브라우저가 안 열리면 터미널에서
c로 로그인 URL을 복사하고, WSL2·SSH·컨테이너 환경은 로그인 코드를Paste code here if prompted에 붙여 넣습니다. - 인증 점검은 프롬프트에서
/status, 셸에서claude doctor로 확인합니다.
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를 사용하려면 Claude Pro, Max, Team, Enterprise, Console 계정 중 하나가 필요합니다. Free 플랜에는 Claude Code가 포함되지 않습니다.
구독 상태는 claude.ai/settings에서 확인할 수 있습니다.
| 상태 | 의미 |
|---|---|
| Pro 또는 Max 활성화 | Claude Code 사용 가능 |
| Free 플랜 | Claude Code 사용 불가, 업그레이드 필요 |
| Team / Enterprise 초대 | 조직 계정으로 사용 가능 |
| Console 계정 | API 기반 과금으로 사용 가능 |
구독과 API 키를 헷갈리지 않기
ANTHROPIC_API_KEY 환경 변수가 설정되어 있으면 Claude Code는 API 키를 우선 씁니다. Pro/Max 구독 사용량으로만 쓰고 싶다면 API 키 환경 변수를 지우거나, Claude Code 안에서 /logout 후 Claude.ai 계정으로 다시 로그인하세요.
브라우저가 없는 환경
브라우저가 자동으로 열리지 않으면 터미널에서 c를 눌러 로그인 URL을 복사하세요. WSL2, SSH, 컨테이너처럼 브라우저 콜백이 어려운 환경이라면 브라우저가 띄운 로그인 코드를 터미널의 Paste code here if prompted 프롬프트에 붙여 넣습니다.
초보자 기준
이 핸드북은 Windows 로컬 PowerShell을 기준으로 합니다. 원격 서버나 WSL에서 인증이 막히면 Claude Code 공식 Authentication 문서의 계정 유형별 안내를 참고하세요.
인증 문제 해결
인증 관리 CLI 명령어
Claude Code에서는 프롬프트 안에서 /login, /logout, /status를 사용할 수 있습니다. 셸에서 전체 환경을 점검하려면 claude doctor를 실행합니다:
| 명령어 | 기능 |
|---|---|
/login | Claude Code 안에서 로그인 |
/logout | Claude Code 안에서 로그아웃 |
/status | 현재 세션과 인증 상태 확인 |
claude doctor | 설치, 설정, 인증 상태 점검 |
인증 상태 확인
인증이 잘 되어 있는지 확인하려면:
/status또는 전체 환경을 점검하려면:
claude doctor인증 관련 항목에 체크 표시가 나오면 정상입니다.