Claude Code 로그인과 인증 설정: Claude.ai 구독과 Console API 계정

앞 편 설치와 초기 설정에서 claude --version까지 확인했다면 이제 로그인입니다. 이번 편은 처음 로그인하는 절차, 브라우저를 열 수 없는 환경의 대처, 로그인에 쓸 수 있는 두 종류의 계정(Claude.ai 구독과 Claude Console)의 차이, 인증 정보 저장 위치, 계정 전환 방법을 다룹니다. 읽고 나면 어떤 계정으로 로그인해야 할지 스스로 판단할 수 있고, 다음 편 첫 세션 실전으로 이어집니다.

핵심 요약

• 터미널에서 claude를 실행하면 첫 실행 때 브라우저가 열리고 로그인이 진행됩니다. 한 번 로그인하면 자격증명이 저장돼 매번 로그인하지 않습니다.
• 계정은 두 갈래입니다. Claude.ai 구독(Pro, Max, Team, Enterprise)은 월정액, Claude Console은 API 종량제입니다.
• 우리 초급 과정 권장은 Pro 구독입니다. 예산이 예측되고 한도 안에서 마음껏 연습할 수 있기 때문입니다.
• 자격증명은 Mac은 Keychain, Linux와 Windows는 .claude/.credentials.json에 저장됩니다.
• 계정을 바꾸려면 세션 안에서 /logout 뒤 /login, 또는 claude auth login을 씁니다.

처음 로그인은 어떻게 하나

설치 후 작업 폴더에서 claude를 실행하면 첫 실행 때 로그인 화면이 나오고 브라우저가 자동으로 열립니다. 브라우저에서 Claude 계정으로 로그인하면 터미널에 Login successful이 뜨고 Enter를 눌러 세션으로 들어갑니다. 우리 1주차 설치 완료 체크리스트의 마지막 항목이 바로 이 단계입니다.

cd ~/work
claude

로그인 화면에서는 Claude 구독 계정, Console 계정, 타사 플랫폼(Bedrock 등) 중 하나를 고릅니다. 개인 수강생은 첫 번째입니다. 세션 밖에서 하려면 claude auth login, Console 계정으로 바로 가려면 --console 옵션을 붙입니다.

브라우저를 열 수 없는 환경이라면

SSH로 접속한 서버, WSL2, 컨테이너에서는 브라우저가 열리지 않거나 다른 머신에서 열립니다. 이때는 터미널에서 c를 눌러 로그인 URL을 클립보드에 복사하고, 내 PC의 브라우저에 붙여 넣어 로그인합니다. 브라우저가 자동으로 돌아오지 못하면 대신 로그인 코드를 보여 주는데, 그 코드를 터미널의 Paste code here if prompted 프롬프트에 붙여 넣으면 완료됩니다. 코드가 만료됐거나 잘려서 OAuth error: Invalid code가 나오면 Enter로 다시 시도하고 브라우저가 열린 뒤 빠르게 진행합니다. 붙여넣기 자체가 터미널에서 안 먹으면 claude auth login이 표준 입력에서 코드를 읽어 줍니다.

로그인에 쓸 수 있는 계정은 무엇인가

Claude.ai 월 구독

claude.ai에서 쓰는 바로 그 계정입니다. Pro, Max 개인 플랜과 Team, Enterprise 조직 플랜이 있으며, 공식 문서는 이 방식을 "권장"으로 표시합니다. 구독 한 개로 Claude 앱(웹, 데스크톱, 모바일)과 Claude Code를 함께 쓰고, 사용량 한도도 둘이 공유합니다. 무료 플랜은 Claude Code에 로그인할 수 없습니다. 요금 세부는 요금제 편에서 다룹니다.

Claude Console API 종량제

Claude Console(platform.claude.com)은 개발자가 API 키를 발급받는 곳입니다. 선불 크레딧을 충전해 두면 쓴 토큰만큼 차감됩니다. Console 계정으로 Claude Code에 처음 로그인하면 비용 추적용 "Claude Code" 워크스페이스가 자동으로 만들어집니다. 이 워크스페이스에서는 API 키를 따로 만들 수 없고 Claude Code 인증 전용입니다. 조직에서는 관리자가 구성원을 초대하고 "Claude Code" 역할 또는 "Developer" 역할을 부여해야 로그인이 됩니다.

API 키를 ANTHROPIC_API_KEY 환경 변수로 직접 넣는 방법도 있지만 우리 과정에서는 권하지 않습니다. 키를 셸 프로필에 넣어 두고 잊으면, 나중에 구독을 결제해도 키가 우선 적용돼 "조직이 비활성화됐다"는 400 오류를 만나기 때문입니다.

어느 계정을 골라야 하나

우리 초급 8주 과정의 권장은 Pro 구독입니다. 월 요금이 고정돼 예산이 예측되고, 한도 안에서는 실패해도 추가 비용이 없어 마음껏 연습할 수 있으며, 같은 계정으로 Claude 앱 코워크까지 쓰기 때문입니다. 매일 여러 자동화를 돌리는 단계가 되면 Max로 올리고, 회사 비용으로 정확히 청구해야 하면 Console을 씁니다. 강사 원구연은 개발과 교육에는 Max 구독을, 무인 서버의 자동화 잡에는 별도 계정을 씁니다.

같은 이메일로 두 계정을 가질 수 있다

Claude.ai 계정과 Console 계정은 별개 시스템이라 같은 이메일로 둘 다 만들 수 있고, 로그인 화면에서 고른 쪽으로 청구됩니다. 우리 수업에서 실제로 있었던 혼선이 "Pro를 결제했는데 왜 크레딧이 줄어드나"였는데, Console 쪽으로 로그인돼 있었습니다. /status가 활성 인증 방법을 보여 주므로 헷갈릴 때 먼저 확인합니다.

인증 정보는 어디에 저장되나

로그인하면 자격증명이 시스템에 저장돼 다음부터는 묻지 않습니다. 저장 위치는 운영체제마다 다릅니다.

CLAUDE_CONFIG_DIR 환경 변수를 설정한 Linux, Windows에서는 그 디렉터리 아래에 저장됩니다. Mac에서 Keychain이 잠겨 있거나 비밀번호가 어긋나면 로그인이 저장되지 않아 매번 다시 묻습니다. claude doctor가 Keychain 접근을 점검해 주고, security unlock-keychain ~/Library/Keychains/login.keychain-db로 잠금을 풀 수 있습니다.

여러 인증 수단이 있으면 환경 변수 ANTHROPIC_API_KEY가 /login으로 저장한 구독 자격증명보다 우선합니다. 구독을 쓰려는데 예상과 다르게 동작하면 환경 변수부터 지웁니다.

unset ANTHROPIC_API_KEY
claude

로그인 만료 5일 전부터 시작 시 run /login to renew 경고가 뜹니다. 무인 자동화 세션은 만료되면 멈추므로 미리 갱신합니다. 브라우저를 쓸 수 없는 CI나 서버에서는 claude setup-token으로 1년짜리 OAuth 토큰을 만들어 CLAUDE_CODE_OAUTH_TOKEN에 넣습니다.

다른 계정으로 바꾸려면

세션 안에서 /logout을 입력하면 로그아웃되고 첫 실행 설정 상태도 초기화됩니다. 다음에 claude를 실행하면 로그인부터 다시 진행합니다. 로그아웃 없이 다시 인증만 하려면 /login입니다. 세션 밖에서는 claude auth logout과 claude auth login이 같은 역할을 하고, claude auth status는 현재 로그인 여부를 JSON으로 보여 줍니다. 원인 불명의 로그인 문제는 /logout 후 Claude Code를 완전히 닫고 다시 시작하는 것이 공식 첫 처방입니다.

정리

• 첫 로그인은 claude 실행 후 브라우저에서 계정 인증, 한 번이면 끝입니다.
• 브라우저가 안 열리는 환경은 c로 URL 복사 후 코드를 붙여 넣습니다.
• Claude.ai 구독은 월정액, Console은 종량제이며 같은 이메일로 둘 다 만들 수 있습니다.
• 자격증명은 Mac Keychain 또는 .claude/.credentials.json에 저장되고 환경 변수 키가 있으면 그것이 우선합니다.
• 계정 전환은 /logout 뒤 /login, 현재 상태 확인은 /status입니다.

자주 묻는 질문