Making a request

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

환경 설정하기

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

먼저, Jupyter 노트북에 필요한 종속성을 설치하세요:

%pip install anthropic python-dotenv

다음으로, API 키를 안전하게 저장하기 위해 노트북과 같은 디렉터리에 .env 파일을 생성하세요:

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-sonnet-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

이렇게 하면 다음과 같이 깔끔하고 읽기 쉬운 출력을 얻을 수 있습니다: "Quantum computing is a type of computation that leverages quantum mechanics principles like superposition and entanglement to process information using quantum bits (qubits), potentially solving certain complex problems exponentially faster than classical computers."

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