Claude Code 시리즈 튜토리얼 6: 인증 방법 - 브라우저 로그인 및 수동 API 키 구성

인증 프로세스: 브라우저 로그인과 수동 API 키 구성

Claude Code를 설치한 후에는 인증을 완료해야 사용할 수 있습니다. 이 도구를 Anthropic 계정과 연결해야 합니다. 연결 방법은 두 가지입니다: 브라우저 로그인과 수동 API 키 구성. 두 방법의 최종 효과는 동일하므로 편리한 방법을 선택하세요.

방법 1: 브라우저 로그인 (권장)

Claude Code는 자동 인증 명령어 claude login을 제공합니다. 이 명령어는 브라우저를 열어 웹 페이지에서 권한을 부여하도록 한 후, 자격 증명을 터미널에 자동으로 기록합니다.

작업 단계:

터미널에 입력:

bash claude login

시스템이 일련의 안내 메시지를 출력하고, 기본 브라우저에서 Anthropic 권한 부여 페이지를 자동으로 엽니다.
자동으로 열리지 않으면 터미널에 링크가 출력되므로, 수동으로 복사하여 브라우저에서 열면 됩니다.
브라우저에서 Anthropic 계정에 로그인합니다 (이미 로그인한 경우 이 페이지에서 직접 권한 부여를 요청합니다).
"허용" 또는 "권한 부여"를 클릭하면 브라우저 페이지에 "권한 부여 성공, 이 페이지를 닫아도 됩니다"라고 표시됩니다.
터미널로 돌아가면 인증 완료 메시지가 표시됩니다. 이제 claude 명령어를 실행하면 계정과 연결됩니다.

방법 2: 수동 API 키 구성

그래픽 인터페이스가 없는 서버나 컨테이너를 사용하거나 브라우저 권한 부여를 원하지 않는 경우, Anthropic 콘솔에서 직접 API 키를 가져와 Claude Code에 구성할 수 있습니다.

단계:

브라우저를 열고 https://console.anthropic.com에 접속하여 Anthropic 계정에 로그인합니다.
API Keys 페이지로 이동합니다 (보통 설정 또는 개발자 옵션 아래에 있음). "Create API Key"를 클릭합니다.
키에 이름을 지정하고 (예: claude-code-local), 생성 후 즉시 복사합니다.
참고: 이 키는 한 번만 표시되며, 페이지를 닫으면 다시 볼 수 없습니다. 저장하지 못한 경우 기존 키를 삭제하고 다시 생성하면 됩니다.
터미널로 돌아가 두 가지 방법으로 키를 Claude Code에 전달할 수 있습니다:

A. 환경 변수 방법:

bash export ANTHROPIC_API_KEY=당신의-api-key

이 줄을 ~/.bashrc 또는 ~/.zshrc에 추가하면 이후 자동으로 적용됩니다.

B. 파일에 구성 작성:

Claude Code는 자체 구성 파일도 읽습니다. ~/.claude/config.json을 수동으로 편집하고 (없으면 새로 생성), 다음을 작성합니다:

json { "apiKey": "당신의-api-key" }

참고: 이 파일의 권한은 600(chmod 600 ~/.claude/config.json)으로 설정하여 다른 사용자가 읽지 못하도록 하는 것이 좋습니다.

연결 테스트:

bash claude "안녕하세요, 'OK'라고 답해주세요"

정상적인 응답을 받으면 키가 올바르게 구성된 것입니다.

수동 구성 시 흔한 실수:

키가 sk-ant- 또는 sk-로 시작하지 않아야 하나요? 아니요, Anthropic의 API 키는 실제로 sk-ant-api03-로 시작하는 긴 문자열입니다. 복사할 때 문자를 빠뜨리지 마세요.
환경 변수와 파일을 동시에 설정한 경우, 환경 변수의 우선순위가 더 높습니다. 혼란을 피하기 위해 하나만 유지하세요.
키는 요금이 부과되는 자격 증명이므로 Git 저장소에 커밋하지 마세요. .gitignore를 사용하여 ~/.claude 디렉토리나 구성 파일 전체를 무시하는 것이 좋습니다.

계정 전환 또는 로그아웃

계정을 변경하거나 로컬 자격 증명을 제거하려면:

claude login을 사용한 경우: claude logout을 실행한 후, 다시 claude login을 실행하면 됩니다.
키를 수동으로 구성한 경우: 환경 변수나 구성 파일에서 기존 키를 삭제하고 새 키로 교체합니다.

인증 확인

claude "현재 디렉토리가 무엇을 하는지 설명해줘"

프로젝트 개요를 읽을 수 있다면 환경이 준비된 것입니다.