프로그램에서 클로드 호출하기
— Claude API

1. API가 필요한 경우

채팅과 Claude Code는 사람이 직접 쓰는 도구입니다. API는 내가 만든 프로그램이 클로드를 부르게 하는 방법입니다. 이런 경우에 필요합니다.

• 매일 자동으로 도는 스크립트 안에서 요약·분류를 시키고 싶을 때
• 사내 도구·웹서비스에 AI 기능을 넣고 싶을 때
• 수백 건의 데이터를 일괄 처리하고 싶을 때

요금 체계도 다릅니다. 채팅·Claude Code는 월 구독제, API는 쓴 만큼 내는 종량제입니다.

2. 키 발급

1. console.anthropic.com 접속 → 계정 로그인 (클로드 계정과 별도로 콘솔 가입이 필요할 수 있습니다)
2. 결제 수단 등록 후 크레딧 충전 (소액으로 시작. 최소 충전 금액은 콘솔에서 확인)
3. API Keys 메뉴 → Create Key → 키 이름 입력 → 생성
4. 생성 직후 한 번만 표시되는 키(sk-ant-...)를 복사해 안전한 곳에 보관

3. 첫 호출 (파이썬)

SDK 설치:

pip install anthropic

키는 코드에 넣지 않고 환경 변수로 설정합니다. (PowerShell 기준, 현재 창에서만 유효)

$env:ANTHROPIC_API_KEY = "sk-ant-여기에-발급받은-키"

호출 코드:

import anthropic

client = anthropic.Anthropic()  # 환경 변수의 키를 자동 사용

message = client.messages.create(
    model="claude-sonnet-5",     # 모델명은 공식 문서에서 최신 확인
    max_tokens=1000,
    messages=[
        {"role": "user", "content": "아래 문장을 한 줄로 요약해줘: ..."}
    ],
)
print(message.content[0].text)

실행해서 답변이 출력되면 성공입니다. 이 코드가 모든 API 활용의 기본형이고, 여기에 반복문을 붙이면 일괄 처리가 됩니다.

TIP — 이 예제 코드를 이해하거나 변형하고 싶으면 Claude Code에게 시키면 됩니다. "이 코드에 CSV를 읽어서 행마다 요약을 붙이는 기능 추가해줘" 같은 식입니다.

4. 비용 구조: 토큰 종량제

• 요금은 토큰(텍스트 조각) 단위로 계산됩니다. 한국어는 대략 글자 1~2자가 토큰 1개 수준입니다.
• 입력(내가 보낸 글)과 출력(답변)에 각각 단가가 붙고, 출력이 더 비쌉니다.
• 모델 등급에 따라 단가가 다릅니다. 간단한 분류·요약은 작은 모델로도 충분하며 훨씬 쌉니다.
• 사용량과 청구액은 콘솔 대시보드에서 실시간 확인할 수 있고, 월 사용 한도를 걸어둘 수 있습니다.

주의 — 반복문으로 대량 호출하는 코드는 먼저 5~10건으로 테스트해서 건당 비용을 확인한 뒤 전체를 돌리세요. 한도 설정도 걸어두세요.

5. 키 관리 규칙

1. 키는 환경 변수 또는 별도 설정 파일로 관리하고, 소스코드에 직접 쓰지 않습니다.
2. git 저장소에 키가 들어가지 않게 설정 파일을 .gitignore에 등록합니다.
3. 키가 노출됐다면 콘솔에서 즉시 폐기(Revoke)하고 새로 발급합니다.
4. 용도별로 키를 나눠 만들면(실험용/서비스용) 문제 시 추적과 폐기가 쉽습니다.

6. 자주 묻는 질문