Claude API 키 받기
Claude Console에서 Claude API용 API 키를 찾고, 생성하고, 관리하세요.
Claude API용 API 키(Anthropic API 키라고도 함)는 Claude Console에 있습니다. 기존 키를 보거나 새 키를 생성하려면 Settings → API keys로 이동하세요.
키 유형 선택
키를 생성할 때 키의 유형을 선택하며, 이 유형은 키가 무엇을 할 수 있는지, 어디에서 작동하는지, 언제 작동을 멈추는지를 결정합니다. **개인 키(personal key)**는 사용자 본인으로서 동작하며, 사용자가 조직을 떠나면 작동을 멈춥니다. **서비스 계정 키(service account key)**는 CI 파이프라인, 프로덕션 서비스 또는 에이전트와 같은 워크로드에서 사용할 수 있는 서비스 계정을 나타냅니다. 본인의 개발 작업에는 개인 키를 사용하고, 공유되는 모든 것에는 서비스 계정 키를 사용하세요.
소유자가 없는 레거시 키인 **워크스페이스 키(workspace key)**를 생성할 수도 있습니다. 이 키는 생성된 워크스페이스에 속하며 생성자가 떠난 후에도 계속 작동합니다. 개인 키 또는 서비스 계정 키는 연결된 계정이 조직에서 제거되면 자동으로 작동을 멈추므로, 이러한 키를 사용하는 것이 바람직합니다.
API 키 생성
Claude Console에 로그인
platform.claude.com으로 이동하여 로그인하거나, 아직 계정이 없다면 계정을 생성하세요.
API 키 페이지 열기
Settings → API 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에는 API 키 조회 및 API 키 목록과 같이 조직의 API 키를 프로그래밍 방식으로 관리하기 위한 엔드포인트가 포함되어 있습니다. 이러한 엔드포인트는 키 관리를 자동화하는 조직 관리자를 위한 것입니다. 이 엔드포인트는 Admin API 키, org:admin 범위를 가진 OAuth 토큰, 또는 특정 워크스페이스로 범위가 지정되지 않은 개인 키나 서비스 계정 키를 허용하며, 워크스페이스 키는 여기서 작동하지 않습니다. 이 엔드포인트는 키의 시크릿 값을 절대 반환하지 않으며, 부분적으로 가려진 힌트만 반환합니다.
Was this page helpful?