빠른 시작 가이드
Claude와 대화만 하고 싶으신가요? claude.ai를 방문하세요!
바로 API를 이해하고 싶으신가요? 자세한 내용은 API 참조 문서로 이동하세요.
Claude를 빠르게 시작해봅시다! 이 가이드에서는 환경 설정, 필요한 라이브러리 설치, Claude에 첫 번째 API 요청 보내기 과정을 안내합니다. 시작해봅시다!
이 가이드에서는 Python SDK를 사용하지만, TypeScript SDK도 제공하며 직접 HTTP 통합도 지원합니다. 자세한 내용은 클라이언트 SDK와 API 참조 문서를 참조하세요.
사전 준비 사항
시작하기 전에 다음 사항을 확인하세요:
- API 액세스 권한이 있는 계정 (Claude에 대한 액세스 권한 얻기 가이드 참조)
- API 키 (계정 설정에서 확인 가능)
- 컴퓨터에 Python 3.7.1 이상 버전 설치
1단계: 환경 설정
환경 설정 없이 바로 시작하려면 빠른 시작 Google Colab 노트북 사본을 만드세요!
먼저 Python이 설치되어 있는지 확인하세요. 터미널(macOS)이나 명령 프롬프트(Windows)를 열고 다음을 입력하세요:
python --version
“Python 3.12.2”와 같은 버전 번호가 표시되면 준비가 된 것입니다. 그렇지 않다면 공식 Python 웹사이트를 방문하여 최신 버전을 다운로드하세요.
(선택 사항) 가상 환경 생성
필수는 아니지만 Claude 프로젝트용 가상 환경을 만드는 것이 좋습니다. 이렇게 하면 종속성을 체계적으로 관리하고 다른 프로젝트와의 충돌을 방지할 수 있습니다. 가상 환경을 만들려면 다음을 실행하세요:
python -m venv claude-env
그런 다음 활성화하세요:
- macOS 또는 Linux:
source claude-env/bin/activate
- Windows:
claude-env\Scripts\activate
2단계: Anthropic Python SDK 설치
환경이 설정되었으니 이제 Claude Python 라이브러리를 설치할 차례입니다. 간단히 다음을 실행하세요:
pip install anthropic
이 명령은 필요한 종속성과 함께 라이브러리의 최신 버전을 설치합니다.
3단계: (선택 사항) API 키 설정
Claude를 사용하려면 API 키를 제공해야 합니다. 환경 변수를 설정하여 모든 Claude 프로젝트에서 API 키를 사용할 수 있습니다. 방법은 다음과 같습니다:
- macOS 또는 Linux:
- 터미널을 열고 다음을 입력하세요:
nano ~/.bash_profile
(최신 버전의 macOS를 사용하는 경우nano ~/.zshrc
) - 파일에 다음 줄을 추가하고,
your-api-key-here
를 실제 API 키로 바꾸세요:export ANTHROPIC_API_KEY='your-api-key-here'
- 파일을 저장하고 편집기를 종료하세요 (
Ctrl+O
를 누른 다음Enter
를 누르고Ctrl+X
를 누름) - 다음을 실행하여 업데이트된 프로필을 로드하세요:
source ~/.bash_profile
(또는source ~/.zshrc
)
- 터미널을 열고 다음을 입력하세요:
- Windows:
- 명령 프롬프트를 열고 다음을 입력하세요:
setx ANTHROPIC_API_KEY "your-api-key-here"
,your-api-key-here
를 실제 API 키로 바꾸세요 - 이 변경 사항을 영구적으로 만들려면 다음 단계를 따르세요:
- ‘내 PC’ 또는 ‘내 컴퓨터’를 마우스 오른쪽 버튼으로 클릭하고 ‘속성’을 선택하세요
- ‘고급 시스템 설정’을 클릭하세요
- ‘환경 변수’ 버튼을 클릭하세요
- ‘시스템 변수’ 섹션에서 ‘새로 만들기…’를 클릭하고 변수 이름으로
ANTHROPIC_API_KEY
를, 변수 값으로 API 키를 입력하세요
- 명령 프롬프트를 열고 다음을 입력하세요:
4단계: 첫 번째 API 요청 보내기
거의 다 왔습니다! 이제 Claude에 첫 번째 API 요청을 보내봅시다. 새 Python 파일(예: claude_test.py
)을 만들고 다음 코드를 추가하세요:
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로 만드실 작품이 기대됩니다. 즐거운 코딩 되세요!