요청 보내기

기본 설정과 구조를 이해하고 나면 Anthropic API에 첫 요청을 보내는 것은 간단합니다. 이 가이드에서는 Python을 사용하여 Claude가 프롬프트에 응답하도록 만드는 데 필요한 핵심 단계를 살펴봅니다.

환경 설정하기

API를 호출하기 전에, 필요한 패키지를 설치하고 API 키를 안전하게 구성해야 합니다.

먼저, Jupyter 노트북에 필요한 종속성을 설치합니다:

%pip install "anthropic<1" python-dotenv

다음으로, 노트북과 같은 디렉터리에 .env 파일을 만들어 API 키를 안전하게 저장합니다:

ANTHROPIC_API_KEY="your-api-key-here"

이 방법을 사용하면 API 키가 코드에 노출되지 않으며, 실수로 버전 관리 시스템에 커밋되는 것을 방지할 수 있습니다. 항상 .env를 .gitignore 파일에 추가하세요.

환경 변수를 불러오고 API 클라이언트를 생성합니다:

from dotenv import load_dotenv
load_dotenv()

from anthropic import Anthropic

client = Anthropic()
model = "claude-haiku-4-5"

Create 함수

API 요청을 보내는 핵심은 client.messages.create() 함수입니다. 이 함수에는 세 가지 핵심 매개변수가 필요합니다:



• model - 사용하려는 Claude 모델의 이름
• max_tokens - 응답 길이에 대한 안전 한도(목표치가 아님)
• messages - Claude에 전송하는 대화 기록

max_tokens 매개변수는 안전장치 역할을 합니다. 이를 1000으로 설정하면, Claude는 더 할 말이 있더라도 1000 토큰 이후에는 생성을 멈춥니다. Claude는 이 한도에 도달하려고 시도하지 않습니다. 단지 적절하다고 생각하는 내용을 작성하고, 최대치에 도달하면 멈출 뿐입니다.

메시지 이해하기

메시지는 채팅 애플리케이션과 유사하게, 사용자와 Claude 간의 대화를 나타냅니다. 메시지에는 두 가지 유형이 있습니다:



• 사용자 메시지 - Claude에 보내고자 하는 콘텐츠(사람이 작성)
• 어시스턴트 메시지 - Claude가 생성한 응답

각 메시지는 role("user" 또는 "assistant")과 content(실제 텍스트)로 구성된 딕셔너리입니다.

첫 요청 보내기

다음은 Claude에 요청을 보내는 완전한 예시입니다:

message = client.messages.create(
    model=model,
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What is quantum computing? Answer in one sentence"
        }
    ]
)

이 코드를 실행하면, Claude는 요청을 처리하고 생성된 텍스트와 요청에 대한 메타데이터가 포함된 응답 객체를 반환합니다.

응답 추출하기

응답 객체에는 많은 정보가 담겨 있지만, 보통은 생성된 텍스트만 필요합니다. 다음과 같이 접근할 수 있습니다:

message.content[0].text

이렇게 하면 다음과 같이 깔끔하고 읽기 쉬운 출력을 얻을 수 있습니다: "양자 컴퓨팅은 중첩과 얽힘 같은 양자역학 원리를 활용하여 양자 비트(큐비트)를 사용해 정보를 처리하는 계산 방식으로, 특정 복잡한 문제를 고전 컴퓨터보다 기하급수적으로 빠르게 해결할 수 있는 잠재력을 가지고 있습니다."

이러한 기본 사항을 익혔다면, 다양한 프롬프트를 실험하고 Claude와 더 복잡한 상호작용을 구축해 나갈 수 있습니다.