Claude API 키 받기
Claude API 키 받기
Claude API용 API 키(Anthropic API 키라고도 불러요)는 Claude Console에 있어요. 기존 키를 보거나 새 키를 만들려면 설정 → API 키로 가세요.
출처: 문서
본문
키 유형 고르기
키를 만들 때 유형을 고르는데, 이게 키가 무엇을 할 수 있고, 어디서 동작하며, 언제 동작을 멈추는지를 결정해요. 개인 키 (personal key) 는 여러분으로서 동작하고, 조직을 떠나면 동작을 멈춰요. 서비스 계정 키 (service account key) 는 서비스 계정을 대표하며, CI 파이프라인, 프로덕션 서비스, 에이전트 같은 워크로드가 쓸 수 있어요. 자신의 개발에는 개인 키를, 공유되는 것에는 서비스 계정 키를 쓰세요.
워크스페이스 키 (workspace key) 라는 소유자가 없는 레거시 키도 만들 수 있어요. 만든 워크스페이스에 속하고, 만든 사람이 떠나도 계속 동작해요. 연결된 계정이 조직에서 제거되면 자동으로 동작을 멈추는 개인 키나 서비스 계정 키를 쓰는 편이 좋아요.
API 키 만들기
API 키 페이지의 Create key 버튼이 비활성화돼 있다면, 여러분의 역할이 거기서 키를 만들지 못하게 하는 것일 수 있어요. 조직 관리자에게 역할 변경을 요청하거나, 워크로드용 서비스 계정 키를 만들어 달라고 하세요.
API 키 사용하기
키를 환경 변수로 설정하세요:
export ANTHROPIC_API_KEY="«redacted:sk-…»..."
클라이언트 SDK는 ANTHROPIC_API_KEY를 자동으로 읽어요. 직접 HTTP 요청은 x-api-key 헤더에 키를 실어 보내요. API 키가 여러 워크스페이스에서 동작한다면, 워크스페이스 선택하기에 나온 대로 각 Claude API 요청에 anthropic-workspace-id 헤더도 보내야 해요. Admin API는 API 키와 Admin API를 참고하세요.
첫 요청을 만들려면 퀵스타트를 따라가고, Workload Identity Federation의 단기 자격 증명을 포함한 전체 그림은 인증을 참고하세요.
API 키와 Admin API
Admin API에는 조직의 API 키를 프로그래밍 방식으로 관리하는 엔드포인트가 있어요. 예를 들어 API 키 검색과 API 키 목록이 있어요. 이 엔드포인트들은 키 관리를 자동화하는 조직 관리자용이에요. Admin API 키, org:admin 범위의 OAuth 토큰, 또는 특정 워크스페이스로 범위가 지정되지 않은 개인·서비스 계정 키를 받아들여요. 워크스페이스 키는 여기서 동작하지 않아요. 그리고 키의 비밀 값은 절대 반환하지 않고 부분적으로 가린 힌트만 반환해요.