---
title: Claude API 키 받기
url: https://platform.claude.com/docs/ko/get-api-key
description: Claude Console에서 Claude API용 API 키를 찾고, 생성하고, 관리하세요.
---

Claude API용 API 키(Anthropic API 키라고도 함)는 Claude Console에 있습니다. 기존 키를 확인하거나 새 키를 생성하려면 Console의 [API 키](https://platform.claude.com/settings/keys) 페이지(`platform.claude.com/settings/keys`)로 이동하세요.

## 키 유형 선택

키를 생성할 때 키의 유형을 선택하며, 이 유형은 키가 무엇을 할 수 있는지, 어디에서 작동하는지, 언제 작동을 멈추는지를 결정합니다. **개인 키(personal key)**는 사용자 본인으로서 동작하며, 사용자가 조직을 떠나면 작동을 멈춥니다. **서비스 계정 키(service account key)**는 CI 파이프라인, 프로덕션 서비스 또는 에이전트와 같은 워크로드에서 사용할 수 있는 [서비스 계정](https://platform.claude.com/docs/ko/manage-claude/workload-identity-federation#service-accounts)을 나타냅니다. 본인의 개발 작업에는 개인 키를 사용하고, 공유되는 모든 것에는 서비스 계정 키를 사용하세요.

소유자가 없는 레거시 키인 **워크스페이스 키(workspace key)**를 생성할 수도 있습니다. 이 키는 생성된 워크스페이스에 속하며 생성자가 떠난 후에도 계속 작동합니다. 개인 키 또는 서비스 계정 키는 연결된 계정이 조직에서 제거되면 자동으로 작동을 멈추므로, 이러한 키를 사용하는 것이 바람직합니다.

## API 키 생성

<Steps>
  <Step title="Claude Console에 로그인">
    [platform.claude.com](https://platform.claude.com/)의 Claude Console로 이동하여 로그인하거나, 아직 계정이 없다면 계정을 생성하세요.
  </Step>

  <Step title="API 키 페이지 열기">
    Claude Console에서 [API 키](https://platform.claude.com/settings/keys) 페이지(`platform.claude.com/settings/keys`)로 이동하세요.
  </Step>

  <Step title="키 생성">
    **Create key**를 클릭하고, 키 이름을 지정하고, [만료 기간](https://platform.claude.com/docs/ko/manage-claude/authentication#key-expiration)을 선택한 다음, **Linked account**를 본인 또는 서비스 계정으로 설정하세요. Console에서 키의 범위를 지정할 [워크스페이스](https://platform.claude.com/settings/workspaces)를 선택할 수도 있습니다.
  </Step>

  <Step title="키 복사 및 저장">
    Console은 `sk-ant-`로 시작하는 전체 키를 생성 시 단 한 번만 표시합니다. 키를 복사하여 시크릿 관리자와 같은 안전한 곳에 저장하세요. 키를 분실하면 Console에서 다시 볼 수 없습니다. 대신 새 키를 생성하세요.
  </Step>
</Steps>

API 키 페이지의 **Create key** 버튼이 비활성화되어 있다면, 사용자의 역할이 해당 페이지에서 키를 생성하는 것을 허용하지 않을 수 있습니다. 조직 관리자에게 역할 변경을 요청하거나, 워크로드용 서비스 계정 키 생성을 요청하세요.

## API 키 사용

키를 환경 변수로 설정하세요:

```bash
export ANTHROPIC_API_KEY="sk-ant-api03-..."
```

[클라이언트 SDK](https://platform.claude.com/docs/ko/cli-sdks-libraries/overview)는 `ANTHROPIC_API_KEY`를 자동으로 읽습니다. 직접 HTTP 요청을 보낼 때는 `x-api-key` 헤더에 키를 담아 전송합니다. API 키가 여러 워크스페이스에서 작동하는 경우, [워크스페이스 선택](https://platform.claude.com/docs/ko/manage-claude/authentication#select-a-workspace)에 나와 있는 것처럼 각 Claude API 요청에 `anthropic-workspace-id` 헤더도 함께 전송해야 합니다. Admin API에 대해서는 [API 키와 Admin API](https://platform.claude.com/docs/ko/get-api-key#api-keys-and-the-admin-api)를 참조하세요.

첫 번째 요청을 보내려면 [빠른 시작](https://platform.claude.com/docs/ko/get-started)을 따르세요. Workload Identity Federation을 사용한 단기 자격 증명을 포함한 전체 내용은 [인증](https://platform.claude.com/docs/ko/manage-claude/authentication)을 참조하세요.

## API 키와 Admin API

[Admin API](https://platform.claude.com/docs/ko/api/organization)에는 [Retrieve API Key](https://platform.claude.com/docs/ko/api/organization/api_keys/retrieve) 및 [List API Keys](https://platform.claude.com/docs/ko/api/organization/api_keys/list)와 같이 조직의 API 키를 프로그래밍 방식으로 관리하기 위한 엔드포인트가 포함되어 있습니다. 이러한 엔드포인트는 키 관리를 자동화하는 조직 관리자를 위한 것입니다. 이 엔드포인트는 [Admin API 키](https://platform.claude.com/docs/ko/manage-claude/admin-api-keys), `org:admin` 범위를 가진 OAuth 토큰, 또는 특정 워크스페이스로 범위가 지정되지 않은 개인 키나 서비스 계정 키를 허용하며, 워크스페이스 키는 작동하지 않습니다. 이 엔드포인트는 키의 시크릿 값을 절대 반환하지 않으며, 일부가 가려진 힌트만 반환합니다.

<Note>
  Admin API로는 분실한 키를 복구하거나 Claude API 호출에 사용할 키를 받을 수 없습니다. 사용 가능한 API 키를 얻으려면 Claude Console의 [API 키](https://platform.claude.com/settings/keys) 페이지(`platform.claude.com/settings/keys`)에서 키를 생성하세요.
</Note>