클로드코드 03-authentication

3. 인증

Claude Code에 로그인하고 개인, 팀, 조직별 인증을 설정하는 방법

3.1. 로그인

설치 후 터미널에서 claude를 실행하면 첫 실행 시 브라우저가 열리며 로그인을 요청한다.

claude

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

브라우저가 로그인 후 리다이렉트되지 않고 코드를 보여주면, 해당 코드를 터미널의 Paste code here if prompted 프롬프트에 입력한다. 이는 WSL2, SSH 세션, 컨테이너에서 흔히 발생한다.

3.1.1. 지원하는 계정 유형

- Claude Pro/Max/Team/Enterprise: Claude.ai 계정으로 로그인
- Claude Console: API 기반 과금. 콘솔 초대를 받은 사용자 사용 가능
- Cloud provider: Amazon Bedrock, Google Vertex AI, Microsoft Foundry

로그아웃하려면 /logout을 입력한다.

3.2. 팀 인증 설정

3.2.1. Claude for Teams / Enterprise

팀 관리를 위한 최적의 옵션이다.

- Teams: 협업 기능, 관리 도구, 과금 관리가 포함된 셀프서비스 플랜
- Enterprise: SSO, 도메인 캡처, 역할 기반 권한, 컴플라이언스 API, 관리 정책 설정 추가

설정 단계:

1. Claude for Teams 구독 또는 Enterprise 영업팀 문의
2. 관리 대시보드에서 팀원 초대
3. 팀원이 Claude Code 설치 후 Claude.ai 계정으로 로그인

3.2.2. Claude Console

API 기반 과금을 선호하는 조직용이다.

1. Claude Console 계정 생성/사용
2. Settings -> Members -> Invite에서 사용자 대량 초대
3. 역할 할당:
   - Claude Code: Claude Code API 키만 생성 가능
   - Developer: 모든 종류의 API 키 생성 가능
4. 초대받은 사용자가 Console 초대 수락 후 설치 및 로그인

3.2.3. Cloud Provider 인증

Amazon Bedrock, Google Vertex AI, Microsoft Foundry 사용 시 환경 변수를 설정하고 브라우저 로그인 없이 사용한다. 각 provider 문서를 참조한다.

3.3. Credential 관리

Claude Code는 인증 정보를 안전하게 저장한다.

- macOS: 암호화된 macOS Keychain
- Linux: ~/.claude/.credentials.json (파일 모드 0600)
- Windows: %USERPROFILE%\.claude\.credentials.json

3.3.1. 인증 우선순위

여러 인증 정보가 있을 때 다음 순서로 선택한다.

1. Cloud provider 환경 변수 (CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX, CLAUDE_CODE_USE_FOUNDRY)
2. ANTHROPIC_AUTH_TOKEN (Bearer 토큰, LLM gateway/proxy용)
3. ANTHROPIC_API_KEY (Claude Console API 키)
4. apiKeyHelper 설정의 스크립트 출력 (동적/순환 credential)
5. CLAUDE_CODE_OAUTH_TOKEN (장기 OAuth 토큰)
6. /login으로 얻은 구독 OAuth credential (기본값)

참고: 활성 구독이 있으면서도 ANTHROPIC_API_KEY가 설정되어 있으면 API 키가 우선한다. 문제가 발생하면 unset ANTHROPIC_API_KEY로 구독 인증으로 fallback할 수 있다. /status로 현재 활성화된 방법을 확인한다.

3.4. 장기 토큰 생성

CI 파이프라인이나 스크립트 등 브라우저 로그인이 불가능한 환경에서는 claude setup-token으로 1년짜리 OAuth 토큰을 생성한다.

claude setup-token

토큰은 터미널에 출력되며 어디에도 저장되지 않는다. 복사하여 환경 변수로 설정한다.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

참고: 이 토큰은 Pro, Max, Team, Enterprise 플랜이 필요하며 inference 전용으로 Remote Control 세션은 설정할 수 없다. --bare 모드에서는 사용할 수 없으므로 대신 ANTHROPIC_API_KEY나 apiKeyHelper를 사용한다.