인증

Claude Code에 로그인하고 개인, 팀, 조직을 위한 인증을 구성합니다.

Claude Code는 설정에 따라 여러 인증 방법을 지원합니다. 개인 사용자는 Claude.ai 계정으로 로그인할 수 있으며, 팀은 Claude for Teams 또는 Enterprise, Claude Console, 또는 Amazon Bedrock, Google Vertex AI, Microsoft Foundry와 같은 클라우드 프로바이더를 사용할 수 있습니다.

Claude Code 로그인

Claude Code를 설치한 후 터미널에서 claude를 실행합니다. 처음 실행하면 Claude Code가 로그인을 위한 브라우저 창을 엽니다.

브라우저가 자동으로 열리지 않으면 c를 눌러 로그인 URL을 클립보드에 복사한 다음 브라우저에 붙여넣으세요.

다음 계정 유형 중 하나로 인증할 수 있습니다:

• Claude Pro 또는 Max 구독: Claude.ai 계정으로 로그인합니다. claude.com/pricing에서 구독하세요.
• Claude for Teams 또는 Enterprise: 팀 관리자가 초대한 Claude.ai 계정으로 로그인합니다.
• Claude Console: Console 자격 증명으로 로그인합니다. 관리자가 먼저 사용자를 초대해야 합니다.
• 클라우드 프로바이더: 조직에서 Amazon Bedrock, Google Vertex AI, 또는 Microsoft Foundry를 사용하는 경우 claude를 실행하기 전에 필요한 환경 변수를 설정하세요. 브라우저 로그인은 필요하지 않습니다.

로그아웃하고 다시 인증하려면 Claude Code 프롬프트에서 /logout을 입력하세요.

로그인에 문제가 있는 경우 인증 문제 해결을 참조하세요.

팀 인증 설정

팀과 조직의 경우 다음 방법 중 하나로 Claude Code 접근을 구성할 수 있습니다:

• Claude for Teams 또는 Enterprise, 대부분의 팀에 권장
• Claude Console
• Amazon Bedrock
• Google Vertex AI
• Microsoft Foundry

Claude for Teams 또는 Enterprise

Claude for Teams와 Claude for Enterprise는 Claude Code를 사용하는 조직에 최적의 경험을 제공합니다. 팀 구성원은 중앙 집중식 청구 및 팀 관리와 함께 Claude Code와 웹에서의 Claude에 모두 접근할 수 있습니다.

• Claude for Teams: 협업 기능, 관리 도구, 청구 관리를 갖춘 셀프 서비스 플랜입니다. 소규모 팀에 적합합니다.
• Claude for Enterprise: SSO, 도메인 캡처, 역할 기반 권한, 컴플라이언스 API, 조직 전체 Claude Code 구성을 위한 관리형 정책 설정이 추가됩니다. 보안 및 컴플라이언스 요구 사항이 있는 대규모 조직에 적합합니다.

Step 1: 구독

Claude for Teams를 구독하거나 Claude for Enterprise에 대해 영업팀에 문의하세요.

Step 2: 팀 구성원 초대

관리 대시보드에서 팀 구성원을 초대합니다.

Step 3: 설치 및 로그인

팀 구성원이 Claude Code를 설치하고 Claude.ai 계정으로 로그인합니다.

Claude Console 인증

API 기반 청구를 선호하는 조직의 경우 Claude Console을 통해 접근을 설정할 수 있습니다.

Step 1: Console 계정 생성 또는 사용

기존 Claude Console 계정을 사용하거나 새 계정을 생성합니다.

Step 2: 사용자 추가

다음 방법 중 하나로 사용자를 추가할 수 있습니다:

• Console 내에서 사용자 일괄 초대: Settings -> Members -> Invite
• SSO 설정

Step 3: 역할 할당

사용자를 초대할 때 다음 중 하나를 할당합니다:

• Claude Code 역할: 사용자가 Claude Code API 키만 생성할 수 있습니다
• Developer 역할: 사용자가 모든 종류의 API 키를 생성할 수 있습니다

Step 4: 사용자 설정 완료

초대받은 각 사용자는 다음을 수행해야 합니다:

• Console 초대 수락
• 시스템 요구 사항 확인
• Claude Code 설치
• Console 계정 자격 증명으로 로그인

클라우드 프로바이더 인증

Amazon Bedrock, Google Vertex AI, 또는 Microsoft Foundry를 사용하는 팀의 경우:

Step 1: 프로바이더 설정 따르기

Bedrock 문서, Vertex 문서, 또는 Microsoft Foundry 문서를 따르세요.

Step 2: 구성 배포

사용자에게 환경 변수와 클라우드 자격 증명 생성 지침을 배포합니다. 여기에서 구성 관리 방법에 대해 자세히 알아보세요.

Step 3: Claude Code 설치

사용자가 Claude Code를 설치할 수 있습니다.

자격 증명 관리

Claude Code는 인증 자격 증명을 안전하게 관리합니다:

• 저장 위치: macOS에서는 자격 증명이 암호화된 macOS Keychain에 저장됩니다.
• 지원되는 인증 유형: Claude.ai 자격 증명, Claude API 자격 증명, Azure Auth, Bedrock Auth, Vertex Auth.
• 사용자 정의 자격 증명 스크립트: apiKeyHelper 설정을 API 키를 반환하는 셸 스크립트를 실행하도록 구성할 수 있습니다.
• 갱신 간격: 기본적으로 apiKeyHelper는 5분 후 또는 HTTP 401 응답 시 호출됩니다. 사용자 정의 갱신 간격을 위해 CLAUDE_CODE_API_KEY_HELPER_TTL_MS 환경 변수를 설정하세요.