2026/07/27

Claude API 키를 발급하는 방법과 필요한 때

Claude API 키는 4번의 클릭으로 생성됩니다. 만료 기한과 작업 공간은 생성 시 한 번만 선택되고 이후 변경할 수 없으며, 여러 공급업체를 호출하면 계산이 달라집니다.

Claude API 키를 발급받는 데 걸리는 시간은 약 1분입니다. 키를 생성할 때 선택하는 2가지 설정이 키 자체보다 더 중요한데, 대부분의 사람들은 둘 다 건너뜁니다.

또한 시작하기 전에 한 가지 생각해 볼 만한 질문이 있습니다. Anthropic 키가 정말 필요한지, 아니면 구축 중인 것이 여러 공급업체를 호출하는지에 대한 질문입니다.

TL;DR

키는 Console에서 생성됩니다. platform.claude.com의 계정 설정에서^[1].
키를 생성할 때 만료 기한을 선택합니다. 이 선택은 생성 시 한 번만 이루어집니다^[1].
작업 공간은 키를 분리하고 사용 사례별로 지출을 제어합니다^[1].
인증은 x-api-key 헤더 또는 Authorization입니다. SDK는 환경에서 ANTHROPIC_API_KEY를 읽습니다^[1]^[2].
Workbench를 사용하면 코드를 작성하지 않고도 브라우저에서 API를 시도할 수 있습니다^[1].
Claude를 GPT나 Gemini와 함께 호출하는 경우, 하나의 게이트웨이 키가 3가지를 모두 커버합니다.

키 생성

API는 Web Console을 통해 제공됩니다^[1].

**platform.claude.com**에서 로그인합니다.
Workbench에서 먼저 브라우저에서 API를 시도합니다. platform.claude.com/playground에 접속하세요. 코드가 필요하지 않습니다.
계정 설정에서 키를 생성합니다. platform.claude.com/settings/keys에 접속하세요.
생성할 때 만료 기한을 선택합니다.
선택적으로 작업 공간에 배치합니다. platform.claude.com/settings/workspaces에 접속하세요.

4단계와 5단계는 시간을 들여서 생각해 볼 만한 가치가 있습니다.

건너뛰기 쉬운 2가지 설정

만료 기한은 생성할 때 선택됩니다. 키를 만들 때 각 키의 수명을 설정합니다^[1]. 수명이 긴 키는 내년에 오래된 .env 파일에서 여전히 찾을 수 있는 키입니다. 장기 본운영 인프라가 아닌 모든 경우에 짧은 만료 기한은 비용이 적게 드는 최상의 보안 제어입니다.

작업 공간은 키를 분리하고 사용 사례별로 지출을 제어합니다^[1]. 이것은 "누군가의 스크립트가 밤새 실행됨"을 청구 놀라움에서 제한된 것으로 바꾸는 기능입니다. 프로젝트당 또는 환경당 하나의 작업 공간을 가지면 폭주 루프가 계정이 아닌 해당 작업 공간의 예산을 소모함을 의미합니다.

둘 다 한 번만 하는 결정이며, 둘 다 본운영 중인 키를 회전하지 않고는 나중에 수정할 수 없습니다.

키 사용

두 가지 헤더가 허용됩니다. 그 중 하나를 전송하세요^[1]:

헤더	값
`x-api-key`	Console의 API 키
`Authorization`	Bearer 형식 대안

SDK는 환경에서 키를 자동으로 읽습니다^[2]:

export ANTHROPIC_API_KEY="sk-ant-..."

import anthropic

client = anthropic.Anthropic()   # ANTHROPIC_API_KEY를 읽습니다

resp = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize this changelog."}],
)

이것이 단일 공급업체 설정 전체의 통합입니다.

Anthropic 키가 필요 없을 때

공급업체별 키와 하나의 게이트웨이 키 비교: 각각 고유한 키, 청구, 속도 제한 및 회전이 있는 3개의 별도 콘솔 대 공급업체를 전환하는 것이 모델 문자열을 변경하는 단일 클라이언트

위의 Console 흐름은 Claude가 호출하는 유일한 모델일 때 올바른 답입니다.

제품이 두 개의 공급업체를 호출하는 순간 더 이상 올바른 답이 아닙니다. 그러면 하나의 기능을 실행하기 위해 Anthropic 계정, OpenAI 계정, Google Cloud 프로젝트, 3개의 청구 관계, 3개의 속도 제한 집합, 3개의 키 회전 일정을 유지하고 있습니다. 네 번째 모델을 추가한다는 것은 네 번째 모든 것을 추가한다는 의미입니다.

게이트웨이는 이를 축소합니다. reAPI는 Claude를 OpenAI 호환 /v1/chat/completions 엔드포인트를 통해 노출하므로, 동일한 클라이언트와 동일한 키가 Claude, GPT, Gemini에 도달하고 이들을 전환하는 것은 모델 문자열 변경입니다:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_REAPI_KEY",
    base_url="https://api.reapi.ai/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "Summarize this changelog."}],
    max_tokens=16000,
)

기본 Anthropic /v1/messages 표면도 사용 가능하므로 Anthropic 형식에 대해 이미 작성된 SDK는 기본 URL을 변경한 후 작동합니다.

요율은 reapi.ai/models에 있으며, 현재 Opus 참고는 reapi.ai/docs/claude-opus-5에 있습니다.

reAPI에서 올바르게 수행할 한 가지

두 개의 별도 자격 증명이 있으며, 이를 혼합하는 것이 가장 일반적인 첫 번째 호출 오류입니다.

키	생성 위치	호출 대상
게이트웨이 키	`api.reapi.ai` console	채팅 모델: Claude, GPT, Gemini
미디어 키	`reapi.ai` account	이미지 및 비디오 생성

게이트웨이 키를 미디어 엔드포인트로 전송하면 실패하고, 그 반대도 실패합니다. 첫 번째 호출이 인증 오류를 반환하고 키가 올바르게 보이면, 두 가지 중 어느 것을 보유하고 있는지 확인하세요.

Anthropic. API overview — Console, Workbench, key creation, expiration, workspaces, and authentication headers. Retrieved July 2026 from docs.claude.com/en/api/overview
Anthropic. Get started — setting the API key and first request. Retrieved July 2026 from docs.claude.com/en/docs/get-started