Claude API 키 받기
Claude Console에서 Claude API용 API 키를 찾고, 생성하고, 관리하세요.
Claude API용 API 키(Anthropic API 키라고도 함)는 Claude Console에 있습니다. 기존 키를 확인하거나 새 키를 생성하려면 Console의 API 키 페이지(platform.claude.com/settings/keys)로 이동하세요.
키 유형 선택
키를 생성할 때 키의 유형을 선택하며, 이 유형은 키가 무엇을 할 수 있는지, 어디에서 작동하는지, 언제 작동을 멈추는지를 결정합니다. 개인 키(personal key)는 사용자 본인으로서 동작하며, 사용자가 조직을 떠나면 작동을 멈춥니다. 서비스 계정 키(service account key)는 CI 파이프라인, 프로덕션 서비스 또는 에이전트와 같은 워크로드에서 사용할 수 있는 서비스 계정을 나타냅니다. 본인의 개발 작업에는 개인 키를 사용하고, 공유되는 모든 것에는 서비스 계정 키를 사용하세요.
소유자가 없는 레거시 키인 워크스페이스 키(workspace key)를 생성할 수도 있습니다. 이 키는 생성된 워크스페이스에 속하며 생성자가 떠난 후에도 계속 작동합니다. 개인 키 또는 서비스 계정 키는 연결된 계정이 조직에서 제거되면 자동으로 작동을 멈추므로, 이러한 키를 사용하는 것이 바람직합니다.
API 키 생성
Claude Console에 로그인
platform.claude.com의 Claude Console로 이동하여 로그인하거나, 아직 계정이 없다면 계정을 생성하세요.
API 키 페이지 열기
Claude Console에서 API 키 페이지(
platform.claude.com/settings/keys)로 이동하세요.키 복사 및 저장
Console은
sk-ant-로 시작하는 전체 키를 생성 시 단 한 번만 표시합니다. 키를 복사하여 시크릿 관리자와 같은 안전한 곳에 저장하세요. 키를 분실하면 Console에서 다시 볼 수 없습니다. 대신 새 키를 생성하세요.
API 키 페이지의 Create key 버튼이 비활성화되어 있다면, 사용자의 역할이 해당 페이지에서 키를 생성하는 것을 허용하지 않을 수 있습니다. 조직 관리자에게 역할 변경을 요청하거나, 워크로드용 서비스 계정 키 생성을 요청하세요.
API 키 사용
키를 환경 변수로 설정하세요:
export ANTHROPIC_API_KEY="sk-ant-api03-..."클라이언트 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에는 Retrieve API Key 및 List API Keys와 같이 조직의 API 키를 프로그래밍 방식으로 관리하기 위한 엔드포인트가 포함되어 있습니다. 이러한 엔드포인트는 키 관리를 자동화하는 조직 관리자를 위한 것입니다. 이 엔드포인트는 Admin API 키, org:admin 범위를 가진 OAuth 토큰, 또는 특정 워크스페이스로 범위가 지정되지 않은 개인 키나 서비스 계정 키를 허용하며, 워크스페이스 키는 작동하지 않습니다. 이 엔드포인트는 키의 시크릿 값을 절대 반환하지 않으며, 일부가 가려진 힌트만 반환합니다.
Was this page helpful?