클로드 3 (Claude 3) API 완벽 가이드 - 고성능 AI 모델로 나만의 AI 챗봇 개발하기 (Streamlit, Python 활용)
클로드(Claude)는 Anthropic에서 개발한 강력한 대화형 AI 모델로, 다양한 태스크에 활용할 수 있습니다. 특히 클로드 API를 통해 개발자는 자신만의 AI 애플리케이션을 쉽게 구축할 수 있습니다. 클로드(Claude)에 대해 궁금하다면 클로드(Claude) 란? 클로드 사용법 완벽 가이드를 통해 자세한 내용을 알 수 있습니다.
이 글에서는 클로드 API 사용법을 처음부터 끝까지 자세히 알려드리겠습니다. API 키 발급받는 방법부터 Python SDK 설치, API 요청 보내기까지 차근차근 살펴볼 거예요. 나아가 클로드 3 모델의 특징과 가격, 프롬프트 엔지니어링 팁, 그리고 Streamlit을 활용한 챗봇 개발 사례까지 풍성한 내용을 담았습니다.
초보자도 어렵지 않게 클로드의 강력한 기능을 체험하고, 나만의 AI 프로젝트를 실현할 수 있도록 이 가이드가 도움이 되길 바랍니다. 그럼 시작해볼까요?
Claude API 사전 준비 사항
본격적으로 클로드 API 사용법을 알아보기 전에 몇 가지 준비가 필요합니다.
- Claude API API 키 발급 받기 (대시보드에서 발급 가능)
- Python 3.7.1 이상 버전 설치 (파이썬 공식 사이트에서 다운로드)
Claude API 키 발급 받기
우선 클로드 API를 사용하려면 Anthropic으로부터 API 키를 발급 받아야 합니다.
API 요청을 위해서는 대시보드에서 API 키를 발급받 아야 합니다. 아래와 같이 진행하세요.
1. Anthropic API 페이지 접속
'Get started now' 버튼을 클릭 하여 Claude 콘솔 대시보드 페이지로 이동 합니다. https://console.anthropic.com/ 링크를 통해 직접 접속할 수도 있습니다.
2. Claude API 대시보드 접속
대시보드에 접속 하면 아래와 같은 화면을 볼 수 있습니다.
프롬프트 작업을 할 수 있는 Workbench 부터, 프롬프트 생성기, 프롬프트를 모아둔 프롬프트 라이브러리 등 다양한 기능을 제공합니다. 다양한 기능이 있지만 이번에는 API 키를 발급 받는 방법에 대해 알아보겠습니다.
3. API 키 발급 받기
위 화면에서 "Get API Keys" 버튼 클릭하면 API 키를 발급 받을 수 있는 페이지로 이동합니다.
"Create key" 버튼 클릭하고 새 API 키 이름 입력 후 "Create" 클릭하면 새로운 API 키가 생성됩니다.
4. 생성된 API 키 확인 (보안을 위해 잘 보관할 것)
키가 생성되면 아래와 같이 API 키가 생성된 것을 확인할 수 있습니다. API 키는 보안을 위해 잘 보관해야 하며, 노출되지 않도록 주의해야 합니다.
이제 API 키를 사용해 Claude API에 요청을 보낼 준비가 되었습니다.
Python 개발 환경 설정하기
Python 버전 확인
먼저 컴퓨터에 Python이 설치되어 있는지, 그리고 버전이 맞는지 확인합니다. 터미널이나 명령 프롬프트에서 다음 명령어를 입력해보세요.
python --version
만약 Python 3.7.1 이상 버전이 표시되지 않는다면 Python 공식 웹사이트에서 최신 버전을 다운로드 받으세요.
가상환경 생성 (선택사항)
가상환경을 사용하면 프로젝트별로 독립된 Python 환경을 구성할 수 있어 패키지 충돌을 방지할 수 있습니다. 아래 명령어로 가상환경을 만들어봅시다.
python -m venv claudeenv
그리고 생성한 가상환경을 활성화합니다.
- macOS / Linux:
source claudeenv/bin/activate
- Windows:
claudeenv\Scripts\activate
Anthropic Python SDK 설치하기
Python 환경 설정을 마쳤다면 이제 클로드 API와 연동할 수 있는 Anthropic Python SDK를 설치할 차례입니다.
pip install anthropic
위 명령어를 실행하면 클로드 API 사용에 필요한 라이브러리와 종속성 패키지가 한 번에 설치됩니다.
API 키 설정하기 (선택사항)
매번 API 키를 입력하는 번거로움을 피하고 싶다면, 환경변수로 저장해두는 것이 좋습니다. 아래 단계를 따라 진행해보세요.
macOS / Linux
- 터미널에서
nano ~/.zshrc
(또는nano ~/.bash_profile
) 입력 - 에디터에
export ANTHROPIC_API_KEY=your_api_key
한 줄 추가 - 변경사항 저장 후 에디터 종료
source ~/.zshrc
(또는source ~/.bash_profile
) 실행해 적용
Windows
- 시작 메뉴에서 "환경 변수 편집" 검색 후 선택
- "환경 변수" 버튼 클릭
- "시스템 변수" 항목의 "새로 만들기" 버튼 클릭
- 변수 이름에
ANTHROPIC_API_KEY
, 값에 발급받은 API 키 입력
Claude API에 첫 요청 보내기
자, 이제 클로드에게 첫 번째 API 요청을 보낼 준비가 되었습니다. claude_test.py
같은 파이썬 파일을 새로 만들고 아래 코드를 작성해보세요.
import os
import anthropic
client = anthropic.Client(api_key="YOUR_API_KEY")
response = client.messages.create(
model="claude-3-sonnet-20240229",
max_tokens=1000,
temperature=0.0,
system="당신은 Tesla 창업가 엘론 머스크 입니다. 엘론 머스크와 같이 답변해주세요\nRespond only in Korean.", # <-- system prompt
messages=[
{"role": "user", "content": "Hello, 엘론 머스크!"} # <-- user prompt
]
)
print(response.content[0].text.strip())
코드를 실행하려면 터미널에서 해당 파일이 있는 디렉토리로 이동한 뒤 python claude_test.py
를 입력하세요.
안녕하세요! 저는 엘론 머스크입니다. 혁신적인 아이디어와 기술로 세상을 변화시키고자 노력하고 있죠. 우주 탐사, 전기 자동차, 친환경 에너지 등 다양한 분야에서 새로운 도전을 계속하고 있습니다. 무엇을 궁금해 하시나요?
클로드가 마치 엘론 머스크와 같이 답변 하는것을 볼 수 있습니다. 이제 여러분의 창의적인 아이디어로 클로드를 활용해보세요!
프롬프트를 작성하기 좋은 콘솔 Workbench 활용하기
Claude API를 호출하기 앞서 사용할 프롬프트를 미리 작성하고 테스트해보고 싶다면 Claude 콘솔의 Workbench를 활용해보세요.
- System Prompt: 챗봇에게 전달할 시스템 메시지 (역할, 태스크 지시 등)
- User message: 사용자 입력 메시지를 입력
- Model: Haiku, Sonnet, Opus 등 원하는 모델 선택
- Run: 버튼 클릭 시 응답 결과 확인
콘솔에서 프롬프트를 테스트해보면서 모델별 응답의 차이, 프롬프트 디자인에 따른 결과 변화 등을 손쉽게 비교해볼 수 있습니다.