Claude와 대화만 하고 싶으신가요? claude.ai를 방문하세요!

바로 API를 이해하고 싶으신가요? 자세한 내용은 API 참조 문서로 이동하세요.

Claude를 빠르게 시작해봅시다! 이 가이드에서는 환경 설정, 필요한 라이브러리 설치, Claude에 첫 번째 API 요청 보내기 과정을 안내합니다. 시작해봅시다!

이 가이드에서는 Python SDK를 사용하지만, TypeScript SDK도 제공하며 직접 HTTP 통합도 지원합니다. 자세한 내용은 클라이언트 SDK와 API 참조 문서를 참조하세요.

​
사전 준비 사항

시작하기 전에 다음 사항을 확인하세요:

​
1단계: 환경 설정

환경 설정 없이 바로 시작하려면 빠른 시작 Google Colab 노트북 사본을 만드세요!

먼저 Python이 설치되어 있는지 확인하세요. 터미널(macOS)이나 명령 프롬프트(Windows)를 열고 다음을 입력하세요:

Shell
python --version

“Python 3.12.2”와 같은 버전 번호가 표시되면 준비가 된 것입니다. 그렇지 않다면 공식 Python 웹사이트를 방문하여 최신 버전을 다운로드하세요.

​
(선택 사항) 가상 환경 생성

필수는 아니지만 Claude 프로젝트용 가상 환경을 만드는 것이 좋습니다. 이렇게 하면 종속성을 체계적으로 관리하고 다른 프로젝트와의 충돌을 방지할 수 있습니다. 가상 환경을 만들려면 다음을 실행하세요:

Shell
python -m venv claude-env

그런 다음 활성화하세요:

  • macOS 또는 Linux: source claude-env/bin/activate
  • Windows: claude-env\Scripts\activate

​
2단계: Anthropic Python SDK 설치

환경이 설정되었으니 이제 Claude Python 라이브러리를 설치할 차례입니다. 간단히 다음을 실행하세요:

Shell
pip install anthropic

이 명령은 필요한 종속성과 함께 라이브러리의 최신 버전을 설치합니다.

​
3단계: (선택 사항) API 키 설정

Claude를 사용하려면 API 키를 제공해야 합니다. 환경 변수를 설정하여 모든 Claude 프로젝트에서 API 키를 사용할 수 있습니다. 방법은 다음과 같습니다:

  • macOS 또는 Linux:
    1. 터미널을 열고 다음을 입력하세요: nano ~/.bash_profile (최신 버전의 macOS를 사용하는 경우 nano ~/.zshrc)
    2. 파일에 다음 줄을 추가하고, your-api-key-here를 실제 API 키로 바꾸세요: export ANTHROPIC_API_KEY='your-api-key-here'
    3. 파일을 저장하고 편집기를 종료하세요 (Ctrl+O를 누른 다음 Enter를 누르고 Ctrl+X를 누름)
    4. 다음을 실행하여 업데이트된 프로필을 로드하세요: source ~/.bash_profile (또는 source ~/.zshrc)
  • Windows:
    1. 명령 프롬프트를 열고 다음을 입력하세요: setx ANTHROPIC_API_KEY "your-api-key-here", your-api-key-here를 실제 API 키로 바꾸세요
    2. 이 변경 사항을 영구적으로 만들려면 다음 단계를 따르세요:
      • ‘내 PC’ 또는 ‘내 컴퓨터’를 마우스 오른쪽 버튼으로 클릭하고 ‘속성’을 선택하세요
      • ‘고급 시스템 설정’을 클릭하세요
      • ‘환경 변수’ 버튼을 클릭하세요
      • ‘시스템 변수’ 섹션에서 ‘새로 만들기…’를 클릭하고 변수 이름으로 ANTHROPIC_API_KEY를, 변수 값으로 API 키를 입력하세요

​
4단계: 첫 번째 API 요청 보내기

거의 다 왔습니다! 이제 Claude에 첫 번째 API 요청을 보내봅시다. 새 Python 파일(예: claude_test.py)을 만들고 다음 코드를 추가하세요:

Python
import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)

message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0.0,
    system="요다 말투로만 응답하세요.",
    messages=[
        {"role": "user", "content": "오늘 기분이 어때?"}
    ]
)

print(message.content)

여기서 무슨 일이 일어나는지 살펴봅시다:

  • anthropic 라이브러리를 가져옵니다. 이 라이브러리는 Claude API와 상호 작용하는 편리한 방법을 제공합니다.
  • API 키를 전달하여 Anthropic 클라이언트의 인스턴스를 만듭니다(환경 변수를 설정한 경우 생략 가능).
  • messages.create() 메서드를 호출하여 Claude에 메시지를 보냅니다. 사용할 모델(claude-3-opus-20240229), 응답의 최대 토큰 수(max_tokens=1000), 온도(출력의 무작위성을 제어하며 temperature=0.0은 최소 무작위성을 의미), 시스템 메시지(대화의 맥락을 설정)를 지정합니다.
  • 마지막으로 Claude의 응답을 출력합니다.

코드를 실행하려면 터미널이나 명령 프롬프트에 python claude_test.py를 입력하기만 하면 됩니다. Claude의 격언 같은 응답이 표시되어야 합니다!

더 많은 예제 API 호출 구조는 Messages API 예제를 참조하세요. API 매개변수에 대한 자세한 내용은 Messages API 참조 문서를 확인하세요.

​
다음 단계

축하합니다! 첫 번째 API 요청을 Claude에 성공적으로 보냈습니다! 여정을 계속하기 위한 몇 가지 다음 단계가 있습니다.

​
API 리소스

사용 가능한 엔드포인트와 매개변수에 대한 자세한 내용은 API 문서를 참조하세요.

Claude를 애플리케이션에 더 쉽게 구축하고 통합할 수 있는 도구 모음인 클라이언트 SDK를 확인하세요.

​
Anthropic 쿡북

Anthropic 쿡북에는 Jupyter 노트북 형태의 레시피 모음이 있습니다. 이 노트북에는 PDF 업로드, 도구 사용 및 함수 호출, 임베딩 등 더 고급 시나리오에서 Claude를 효과적으로 사용하는 방법을 보여주는 복사 가능한 코드가 포함되어 있습니다.

​
기타 리소스

  • 사용 사례를 Claude로 전환하는 방법을 알아보려면 마이그레이션 가이드를 참조하세요.
  • AI, LLM, Claude 생태계에서 사용되는 용어에 익숙해지려면 용어 사전을 살펴보세요.
  • 개발자 Discord 서버에 가입하여 다른 개발자와 교류하고, 질문하고, 프로젝트를 공유하세요.
  • 다양한 작업에 대한 영감과 바로 사용할 수 있는 프롬프트를 얻으려면 프롬프트 라이브러리를 방문하거나, 프롬프팅 소개를 확인하여 프롬프트 엔지니어링에 발을 담그세요.

Claude로 만드실 작품이 기대됩니다. 즐거운 코딩 되세요!

Claude에 오신 것을 환영합니다Claude 액세스 권한 얻기