[Claude] Claude API 시작하기 - API 키 발급부터 첫 호출까지 완벽 가이드 (2026)

Anthropic의 Claude API를
처음 시작하는 분들을 위한 완벽 가이드입니다.
API 키 발급, 개발 환경 설정, Python으로 첫 API 호출까지
단계별로 따라할 수 있도록 정리했습니다.

Claude API란?

Claude API는 Anthropic이 개발한 AI 모델 Claude를 프로그래밍 방식으로 사용할 수 있게 해주는 인터페이스입니다.

ChatGPT의 OpenAI API와 비슷하게, 개발자들은 Claude API를 통해 자신만의 AI 애플리케이션을 만들 수 있습니다.

Claude API의 주요 특징은 다음과 같습니다.

RESTful API: https://api.anthropic.com에서 제공되는 표준 REST API
Messages API: 대화형 상호작용을 위한 핵심 API (POST /v1/messages)
다양한 모델: Opus, Sonnet, Haiku 등 용도별 모델 선택 가능
SDK 지원: Python, TypeScript, Java 등 다양한 언어 지원

Claude API 모델 종류와 요금

Claude API를 사용하기 전에 어떤 모델을 사용할지 결정해야 합니다.

2026년 현재 사용 가능한 주요 모델과 요금은 다음과 같습니다.

Claude 최신 모델 요금표 (2026년 2월 기준)

모델	입력 토큰 (MTok)	출력 토큰 (MTok)	컨텍스트	특징
Claude Opus 4.6	$5	$25	1M (베타)	최신 플래그십, 에이전트/코딩 최강
Claude Opus 4.5	$5	$25	200K	복잡한 추론 및 분석 작업
Claude Sonnet 4.5	$3	$15	1M	균형 잡힌 성능과 비용, 일반 개발 권장
Claude Haiku 4.5	$1	$5	200K	빠른 속도, 단순 작업에 적합

MTok: Million Tokens의 약자로, 100만 토큰당 가격을 의미합니다.
영어 기준 1토큰은 약 0.75단어, 한국어는 1글자당 약 1~2토큰입니다.

Long Context 프리미엄 요금

200K 토큰을 초과하는 긴 컨텍스트를 사용할 경우 프리미엄 요금이 적용됩니다.

모델	입력 (>200K)	출력 (>200K)
Claude Opus 4.6	$10	$37.50
Claude Sonnet 4.5	$6	$22.50

어떤 모델을 선택해야 할까?

입문자/일반 개발: Claude Sonnet 4.5 - 성능과 비용의 균형이 가장 좋음
복잡한 코딩/에이전트: Claude Opus 4.6 - 최신 플래그십 모델, Terminal-Bench 65.4% 달성
간단한 작업/대량 처리: Claude Haiku 4.5 - 가장 빠르고 저렴

1단계: Anthropic 계정 만들기

Claude API를 사용하려면 먼저 Anthropic Console 계정이 필요합니다.

Anthropic Console 접속
Sign Up 클릭하여 회원가입
이메일 인증 완료
결제 정보 등록 (신용카드 필요)

팁: 신규 가입 시 소액의 무료 크레딧이 제공되어 테스트해볼 수 있습니다.

2단계: API 키 발급받기

계정을 만들었다면 이제 API 키를 발급받아야 합니다.

Console에 로그인
좌측 메뉴에서 API Keys 클릭
Create Key 버튼 클릭
키 이름 입력 (예: "my-first-key")
생성된 API 키 복사하여 안전한 곳에 저장

⚠️ 중요: API 키는 생성 시 한 번만 표시됩니다. 반드시 복사해서 안전하게 보관하세요.
키가 유출되면 요금이 부과될 수 있으니 절대 공개 저장소에 올리지 마세요.

3단계: 개발 환경 설정 (Python)

Python을 사용해 Claude API를 호출하는 방법을 알아보겠습니다.

Python SDK 설치

터미널에서 다음 명령어를 실행합니다.

pip install anthropic

환경 변수 설정

API 키를 환경 변수로 설정하면 코드에 직접 키를 넣지 않아도 됩니다.

Mac/Linux:

export ANTHROPIC_API_KEY="your-api-key-here"

Windows (PowerShell):

$env:ANTHROPIC_API_KEY="your-api-key-here"

영구적으로 설정하려면 .bashrc, .zshrc 또는 시스템 환경 변수에 추가하세요.

4단계: 첫 번째 API 호출하기

이제 실제로 Claude API를 호출해보겠습니다.

Python 코드 예제

from anthropic import Anthropic

# 클라이언트 생성 (환경 변수에서 API 키 자동 로드)
client = Anthropic()

# 메시지 생성
message = client.messages.create(
    model="claude-sonnet-4-5-20250929",  # 또는 "claude-opus-4-6" (최신 플래그십)
    max_tokens=1024,                      # 최대 출력 토큰
    messages=[
        {"role": "user", "content": "안녕하세요! 자기소개 해주세요."}
    ]
)

# 응답 출력
print(message.content[0].text)

모델 ID 참고:
claude-opus-4-6 - 최신 플래그십 (2026년 2월 출시)
claude-sonnet-4-5-20250929 - 범용 추천
claude-haiku-4-5-20251001 - 빠른 응답용

실행 결과

안녕하세요! 저는 Anthropic이 만든 AI 어시스턴트 Claude입니다.
다양한 주제에 대해 대화하고, 글쓰기, 분석, 코딩 등을 도와드릴 수 있습니다.
무엇을 도와드릴까요?

5단계: cURL로 API 호출하기

Python 없이 터미널에서 직접 API를 호출할 수도 있습니다.

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-4-5-20250929",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

API 응답 구조 이해하기

Claude API의 응답은 다음과 같은 JSON 구조를 가집니다.

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Claude의 응답 내용"
    }
  ],
  "model": "claude-sonnet-4-5-20250929",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 45
  }
}

주요 필드 설명

id: 요청의 고유 식별자
content: 실제 응답 내용 배열
stop_reason: 응답 종료 이유 (end_turn, max_tokens 등)
usage: 사용된 토큰 수 (비용 계산에 활용)

시스템 프롬프트 사용하기

Claude에게 특정 역할이나 지침을 부여하고 싶다면 시스템 프롬프트를 사용합니다.

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    system="당신은 친절한 한국어 튜터입니다. 모든 답변을 쉽고 친근하게 설명해주세요.",
    messages=[
        {"role": "user", "content": "Python의 리스트와 튜플의 차이점이 뭐야?"}
    ]
)

시스템 프롬프트는 Claude의 행동 방식을 정의하는 데 매우 유용합니다.

다만 시스템 프롬프트도 입력 토큰으로 계산되니 비용을 고려해서 작성하세요.

멀티턴 대화 구현하기

연속적인 대화를 구현하려면 이전 메시지들을 함께 전달해야 합니다.

messages = [
    {"role": "user", "content": "내 이름은 철수야"},
    {"role": "assistant", "content": "안녕하세요 철수님! 만나서 반갑습니다."},
    {"role": "user", "content": "내 이름이 뭐라고 했지?"}
]

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=messages
)

print(message.content[0].text)
# 출력: "철수라고 하셨습니다!"

비용 절감 팁

Claude API 비용을 효율적으로 관리하는 방법들입니다.

1. 적절한 모델 선택

모든 작업에 Opus를 사용할 필요는 없습니다.

간단한 작업은 Haiku, 일반 작업은 Sonnet, 복잡한 작업만 Opus를 사용하세요.

2. max_tokens 최적화

필요한 만큼만 max_tokens를 설정하세요. 불필요하게 높은 값은 비용 낭비입니다.

3. Batch API 활용

대량 요청이 필요하다면 Batch API를 사용하면 50% 할인을 받을 수 있습니다.

4. Prompt Caching 활용

반복되는 시스템 프롬프트는 캐싱하면 최대 90% 비용 절감이 가능합니다.

에러 처리하기

API 호출 시 발생할 수 있는 에러를 적절히 처리해야 합니다.

from anthropic import Anthropic, APIError, RateLimitError

client = Anthropic()

try:
    message = client.messages.create(
        model="claude-sonnet-4-5-20250929",
        max_tokens=1024,
        messages=[{"role": "user", "content": "Hello!"}]
    )
except RateLimitError:
    print("요청 한도 초과! 잠시 후 다시 시도하세요.")
except APIError as e:
    print(f"API 에러 발생: {e}")

주요 에러 코드는 다음과 같습니다.

에러 코드	설명
400	잘못된 요청 (파라미터 오류)
401	인증 실패 (API 키 오류)
429	Rate Limit 초과
500	서버 오류

자주 묻는 질문 (FAQ)

Q: Claude API 무료 체험이 가능한가요?

A: 네, 신규 가입 시 소액의 무료 크레딧이 제공됩니다. 다만 지속적인 무료 티어는 없으며, 크레딧 소진 후에는 결제가 필요합니다.

Q: API 키가 유출되면 어떻게 하나요?

A: 즉시 Console에서 해당 키를 삭제하고 새 키를 발급받으세요. 유출된 키로 발생한 요금은 청구될 수 있습니다.

Q: Rate Limit이 있나요?

A: 네, 사용량에 따라 티어가 나뉘며 각 티어별로 분당 요청 수(RPM)와 분당 토큰 수(TPM) 제한이 있습니다. 사용량이 늘면 자동으로 상위 티어로 승급됩니다.

Q: OpenAI API와 무엇이 다른가요?

A: Claude API는 더 긴 컨텍스트 윈도우(최대 100만 토큰), 안전성 중시 설계, 코딩/에이전트 작업에서의 강점 등이 차별점입니다.

Q: AWS나 Google Cloud에서도 사용할 수 있나요?

A: 네, Amazon Bedrock, Google Vertex AI, Microsoft Azure를 통해서도 Claude를 사용할 수 있습니다. 기존 클라우드 인프라가 있다면 이 방법도 고려해보세요.

다음 단계

이제 Claude API의 기본 사용법을 익혔습니다.

다음 글에서는 Claude API 모델 비교 - Opus vs Sonnet vs Haiku 선택 가이드를 다룰 예정입니다.

이 시리즈의 다른 글

1편: Claude API 시작하기 - API 키 발급부터 첫 호출까지 (현재 글)
2편: Claude API 모델 비교 - Opus vs Sonnet vs Haiku 선택 가이드
3편: Claude API Python SDK 사용법 완벽 가이드
4편: Claude API 요금제 & 비용 절감 팁
5편: Claude API Tool Use (Function Calling) 구현하기

참고 자료

이 글이 도움이 되셨다면 댓글과 공유 부탁드립니다!

저작자표시 비영리 변경금지 (새창열림)

'개발&프로그래밍' 카테고리의 다른 글

[Claude] Claude API Python SDK 사용법 완벽 가이드 (0)	2026.02.09
[Claude] Claude API 모델 비교 - Opus vs Sonnet vs Haiku 선택 가이드 (1)	2026.02.09
[AI] 2025년 12월 제미나이 3 vs GPT-5.2, 나에게 맞는 AI는? 완벽 비교 (1)	2025.12.15
[AI] GPT-5.2 사용기 전문가보다 일 잘하는 AI 직접 확인해보니 (1)	2025.12.14
JWT 토큰 인증이란? 쿠키, 세션과의 차이점 완벽 비교 (0)	2025.12.07

재아군의 관찰 인생

[Claude] Claude API 시작하기 - API 키 발급부터 첫 호출까지 완벽 가이드 (2026)

Claude API란?

Claude API 모델 종류와 요금

Claude 최신 모델 요금표 (2026년 2월 기준)

Long Context 프리미엄 요금

어떤 모델을 선택해야 할까?

1단계: Anthropic 계정 만들기

2단계: API 키 발급받기

3단계: 개발 환경 설정 (Python)

Python SDK 설치

환경 변수 설정

4단계: 첫 번째 API 호출하기

Python 코드 예제

실행 결과

5단계: cURL로 API 호출하기

API 응답 구조 이해하기

주요 필드 설명

시스템 프롬프트 사용하기

멀티턴 대화 구현하기

비용 절감 팁

1. 적절한 모델 선택

2. max_tokens 최적화

3. Batch API 활용

4. Prompt Caching 활용

에러 처리하기

자주 묻는 질문 (FAQ)

Q: Claude API 무료 체험이 가능한가요?

Q: API 키가 유출되면 어떻게 하나요?

Q: Rate Limit이 있나요?

Q: OpenAI API와 무엇이 다른가요?

Q: AWS나 Google Cloud에서도 사용할 수 있나요?

다음 단계

이 시리즈의 다른 글

참고 자료

'개발&프로그래밍' 카테고리의 다른 글

댓글

티스토리툴바

[Claude] Claude API 시작하기 - API 키 발급부터 첫 호출까지 완벽 가이드 (2026)

Claude API란?

Claude API 모델 종류와 요금

Claude 최신 모델 요금표 (2026년 2월 기준)

Long Context 프리미엄 요금

어떤 모델을 선택해야 할까?

1단계: Anthropic 계정 만들기

2단계: API 키 발급받기

3단계: 개발 환경 설정 (Python)

Python SDK 설치

환경 변수 설정

4단계: 첫 번째 API 호출하기

Python 코드 예제

실행 결과

5단계: cURL로 API 호출하기

API 응답 구조 이해하기

주요 필드 설명

시스템 프롬프트 사용하기

멀티턴 대화 구현하기

비용 절감 팁

1. 적절한 모델 선택

2. max_tokens 최적화

3. Batch API 활용

4. Prompt Caching 활용

에러 처리하기

자주 묻는 질문 (FAQ)

Q: Claude API 무료 체험이 가능한가요?

Q: API 키가 유출되면 어떻게 하나요?

Q: Rate Limit이 있나요?

Q: OpenAI API와 무엇이 다른가요?

Q: AWS나 Google Cloud에서도 사용할 수 있나요?

다음 단계

이 시리즈의 다른 글

참고 자료

'개발&프로그래밍' 카테고리의 다른 글

관련글

댓글

티스토리툴바