로드 중
로드 중

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

환경 설정하기

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

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

bash
%pip install "anthropic<1" python-dotenv

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

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

이 방식은 API 키를 코드에서 분리하고 실수로 버전 관리 시스템에 커밋되는 것을 방지합니다. 항상 .env를 .gitignore 파일에 추가하세요.

환경 변수를 불러오고 API 클라이언트를 생성하세요:

python
from dotenv import load_dotenv
load_dotenv()

from anthropic import Anthropic

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

이 모델과 패키지 버전을 이 코스 전체에서 유지하세요. 더 최신 버전은 temperature나 미리 채워진 어시스턴트 메시지처럼 이후 레슨에서 가르치는 설정을 거부합니다.

Create 함수

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

client.messages.create 호출을 보여주며 아래에 나열된 세 가지 매개변수, model, max_tokens, messages에 대한 설명이 달려 있는 이미지.

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

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

메시지 이해하기

메시지는 채팅 애플리케이션과 비슷하게 여러분과 Claude 간의 대화를 나타냅니다. 메시지에는 두 가지 유형이 있습니다:

사용자 메시지가 "What is quantum computing?"이라고 묻고 어시스턴트 메시지가 이를 정의하는 AI 답변인 채팅 창.

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

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

첫 요청 보내기

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

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

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

응답 추출하기

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

python
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와 더 복잡한 상호작용을 구축할 수 있습니다.