본문 바로가기
claudecode.to
문서 목록
시작하기

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

Claude Code 로그인은 claude 명령을 실행하면 브라우저로 자동 안내됩니다. Claude.ai 구독과 Claude Console(API 종량제) 계정의 차이, 인증 정보 저장 위치, /login 계정 전환을 정리합니다.

8분2026-08-22 갱신

Claude Code 로그인은 터미널에서 claude를 실행하면 브라우저가 열리며 자동으로 안내되는 절차입니다. 복잡한 설정은 없지만, 어느 계정으로 로그인하느냐에 따라 과금 방식이 달라지므로 "매일 쓴다면 Claude.ai 구독, 가끔 쓴다면 Claude Console 종량제"라는 기준만 먼저 잡아 두면 됩니다.

핵심 요약

  • 로그인은 claude 실행 시 자동 안내되며, 대화 모드에서는 /login으로도 열 수 있습니다.
  • 개인은 Claude.ai(월 구독)와 Claude Console(API 종량제) 중에서 고릅니다.
  • 같은 이메일 주소로 두 계정을 모두 가질 수 있습니다.
  • 한 번 로그인하면 인증 정보가 저장돼 다음부터는 재로그인이 필요 없습니다.
  • 계정 전환은 /login으로 합니다.

처음 로그인은 어떻게 하나

설치가 끝났다면 터미널에서 아래 명령을 실행합니다. 설치 자체는 설치와 초기 설정을 참고하세요.

claude

처음 실행하면 브라우저가 열리고 로그인 페이지로 이동합니다. 브라우저를 쓸 수 있는 환경이라면 별도 준비는 필요 없습니다.

이미 Claude Code를 실행해 대화 모드에 있다면 /login 커맨드로도 로그인 화면을 열 수 있습니다.

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

로그인에는 브라우저가 필요합니다. SSH로 원격 서버에 접속해 있는 등 터미널에서 브라우저를 열 수 없는 환경에서는, 터미널에 표시되는 URL을 직접 복사해 다른 기기의 브라우저에 붙여 넣으면 됩니다.

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

용도에 따라 네 가지 경로가 준비돼 있습니다.

계정 종류요금 체계특징
Claude.ai (Pro / Max)월 구독웹판 Claude.ai와 공통 플랜
Claude ConsoleAPI 종량제쓴 만큼만 지불
Claude for Teams / Enterprise조직 단위 계약조직에서 배포·관리
클라우드 프로바이더 경유각 클라우드의 과금Amazon Bedrock, Google Vertex AI, Microsoft Foundry

개인이 쓸 때의 선택지는 사실상 위의 두 가지, Claude.ai와 Claude Console입니다.

Claude.ai — 월 구독

Claude.ai는 웹판 Claude(https://claude.ai)와 같은 계정을 쓰는 서비스입니다. Pro 또는 Max 플랜에 가입돼 있으면 Claude Code도 추가 요금 없이 쓸 수 있습니다. 월 정액으로 일정 한도 안에서 자유롭게 쓸 수 있어 Claude Code를 일상적으로 쓰는 사람에게 맞습니다.

2026년 8월 기준 Pro는 월 $20, Max는 Pro의 5배 한도인 Max 5x가 월 $100, 20배 한도인 Max 20x가 월 $200입니다. 요금은 바뀔 수 있으니 최신 정보는 공식 사이트에서 확인하세요. 플랜별 상세 비교는 요금제 — Pro / Max / API에 정리돼 있습니다.

Claude Console — API 종량제

Claude Console(https://platform.claude.com)은 API를 쓰기 위한 개발자용 계정입니다. 미리 크레딧을 충전해 두고 사용한 토큰 수만큼 차감됩니다. Claude Code에서 처음 로그인하면 "Claude Code"라는 이름의 워크스페이스가 자동으로 만들어집니다.

쓴 만큼만 내는 구조라 가끔만 쓰는 경우, 또는 스크립트나 CI에서 Claude Code를 호출하는 자동화를 만드는 경우에 맞습니다. 자동화 쪽은 비대화 모드(-p)에서 다룹니다. 다만 요금 관리가 번거롭게 느껴진다면 Claude.ai 구독 쪽이 편합니다.

어느 계정을 골라야 하나

판단 기준은 단순합니다. 아래 중 어느 쪽에 해당하는지로 정하면 됩니다.

이런 경우추천 계정
매일 Claude Code를 쓸 예정이다Claude.ai
웹판 Claude.ai도 함께 쓰고 싶다Claude.ai
월 정액으로 예산을 관리하고 싶다Claude.ai
가끔만 쓴다Claude Console
CI/CD나 스크립트에서 자동 실행하고 싶다Claude Console
사용량을 세밀하게 추적하고 싶다Claude Console

둘 중 하나만 골라야 하는 것은 아닙니다. 일상 작업은 Claude.ai, 자동화 용도는 Claude Console로 나눠 쓰는 구성도 실무에서 자주 씁니다.

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

Claude.ai와 Claude Console은 같은 이메일 주소로 양쪽 계정을 만들 수 있습니다. 로그인할 때 어느 계정으로 이용할지 고르는 화면이 표시되므로 그 시점에 용도를 정하면 됩니다.

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

한 번 로그인하면 인증 정보가 시스템에 저장되고, 다음에 claude를 실행할 때는 재로그인 없이 바로 시작됩니다. 저장 방식은 OS에 따라 다릅니다.

OS저장 위치
macOS암호화된 시스템 Keychain
Linux·Windows평문 JSON 파일 (~/.claude/.credentials.json 등)

공용 PC나 서버에서 Claude Code를 쓸 때는 주의가 필요합니다. 인증 정보가 그 머신에 남으므로, 다른 사용자가 접근할 수 있는 환경에서는 파일 권한을 적절히 관리하세요.

다른 계정으로 바꾸려면

이미 로그인된 상태에서 다른 계정으로 바꾸려면 대화 모드 안에서 /login을 실행합니다.

> /login

브라우저가 열리고 로그인 흐름이 다시 진행됩니다. Claude.ai에서 Claude Console로, 또는 그 반대로 바꾸는 것도 같은 명령으로 됩니다.

정리

  • 로그인은 claude 실행 시 자동 안내되며, 브라우저가 없는 환경에서는 표시된 URL을 복사해 씁니다.
  • 매일 쓴다면 Claude.ai(월 정액), 가끔 쓰거나 자동화라면 Claude Console(종량제)을 고릅니다.
  • 같은 이메일로 두 계정을 모두 만들어 용도별로 나눠 쓸 수 있습니다.
  • 인증 정보는 저장되어 재로그인이 필요 없지만, Linux·Windows는 평문 파일이라 공용 환경에서는 권한 관리가 필요합니다.
  • 계정 전환은 /login 하나로 끝납니다. 로그인이 끝났다면 첫 세션 실전으로 이어가세요.

자주 묻는 질문

로그인인증Claude ConsoleAPI 키계정

팀에 Claude Code를 도입하려면 실제 코드베이스에 맞춘 설계가 필요합니다.

무료 상담 신청