Claude Workbench 사용하려고 Anthropic Console에 들어갔는데, API 키부터 결제, 실제 호출까지 한 번에 정리된 글이 잘 없어서 직접 찾아보게 되더라고요. 이 글을 보고 있으면 API 키 발급부터 Workbench에서 대화를 주고받고, Python으로 연동하는 과정까지 10분이면 충분히 따라갈 수 있습니다. Workbench에서의 대화는 무료가 아니라 사용량에 따라 결제한 크레딧에서 차감되고, 작성한 프롬프트는 코드로 내보내기 기능을 통해 그대로 외부 프로젝트에 옮길 수 있습니다.
Claude API 키 발급, 결제 등록까지
먼저 Anthropic Console 웹사이트에서 구글 계정으로 회원가입을 진행합니다. 로그인 후 콘솔 화면에서 API 키를 생성하는데, 이때 주의할 점이 하나 있습니다. API 키는 생성되는 순간 단 한 번만 화면에 표시됩니다. 복사해서 안전한 곳에 보관하지 않으면 다시 확인할 수 없으니 바로 메모해 두는 게 좋습니다. 키가 유출되면 타인이 사용해 요금이 부과될 수 있으니, GitHub 같은 공개 저장소에 올리는 일은 절대 피해야 합니다.
결제 수단 등록도 필요합니다. API 사용료는 사전 충전 방식이라 Billing 섹션에서 크레딧을 충전하는데, 최초 등록 시 $5 정도를 결제하고 시작하게 됩니다. 신규 가입 시 소액의 무료 크레딧이 제공되기는 하지만, 지속적인 무료 티어는 없으니 크레딧을 소진하면 이어서 결제가 진행됩니다.
Workbench에서 Claude 3.5 Sonnet 바로 써보기
API 키를 발급받았다면 콘솔 안에 있는 Workbench에서 곧바로 Claude 모델을 테스트해볼 수 있습니다. 화면 왼쪽에는 시스템 프롬프트를 입력하는 영역이 있고, 오른쪽에는 사용자 메시지를 보내는 대화창이 구성되어 있습니다. 이 구조를 활용하면 복잡한 설정 없이도 특정 역할을 부여하거나 대화의 맥락을 잡아가며 실험할 수 있습니다.
대화 기록이 유지되기 때문에 연속성 있는 대화가 가능하고, Add message pair 버튼을 누르면 대화 항목을 추가해서 여러 턴의 시나리오를 직접 만들어볼 수도 있습니다. 예를 들어 고객 응대 챗봇을 만든다고 가정할 때, 첫 턴에는 문의를 넣고 다음 턴에는 후속 답변을 요구하는 식으로 현실적인 흐름을 재현할 수 있습니다.
| 기능명 | 설명 |
|---|---|
| System Prompt 입력 | 모델의 전반적인 행동 방식이나 역할 설정 가능 |
| 대화 히스토리 유지 | 이전 메시지를 참고한 맥락 있는 답변 생성 |
| Add message pair | 필요할 때마다 대화 턴을 추가해 시나리오 확장 |
| Get Code 내보내기 | 작성한 시스템 프롬프트와 대화 내용을 코드로 변환 |
Get Code로 Python 코드 내보내기
Workbench에서 완성한 프롬프트는 우측 상단의 Get Code 버튼을 클릭하면 외부 프로젝트에서 사용할 수 있는 Python 코드 형태로 확인할 수 있습니다. 이때 생성된 코드 안에 api_key="my_api_key"라는 부분이 있는데, 발급받은 본인의 API 키로 반드시 교체해야 합니다. 이 코드를 복사해서 VS Code 같은 편집기에서 실행하면 Workbench에서 했던 대화를 그대로 재현합니다.
이 방식을 활용하면 콘솔에서 실험한 결과를 실제 서비스 코드로 옮기는 작업이 훨씬 수월해집니다. 프롬프트를 매번 새로 작성할 필요 없이 이미 검증된 내용을 그대로 이식할 수 있다는 점이 가장 큰 장점입니다.
Claude 3.5 Sonnet, 왜 이 모델을 써야 할까
현재 Anthropic이 제공하는 모델 중에서 Claude 3.5 Sonnet은 가장 진보된 성능을 내면서도 이전 플래그십 모델인 Claude 3 Opus보다 동일 토큰 기준으로 5배 저렴합니다. 가격 부담이 크게 줄었으면서도 성능은 상위 모델에 준하는 수준을 보여주기 때문에, API를 처음 시작하는 개발자나 비용에 민감한 프로젝트에서 합리적인 선택지가 됩니다.
API 요금은 MTok(100만 토큰) 단위로 책정되는데, 토큰 계산 기준은 영어 1토큰당 약 0.75단어, 한국어는 1글자당 약 1-2토큰입니다. 한국어 서비스를 만들 때는 이 점을 감안해 대략적인 비용을 예상해볼 수 있습니다.
API 사용 전에 알아두면 좋은 제한 사항
API 사용량이 늘어나면 계정 티어가 올라가면서 분당 요청 수(RPM)와 분당 토큰 수(TPM) 제한이 완화됩니다. 처음부터 대량의 요청을 보낼 계획이라면 사용량을 조금씩 늘려가며 상위 티어로 승급되는 흐름을 고려하는 게 좋습니다.
Claude API는 Amazon Bedrock, Google Vertex AI, Microsoft Azure 같은 주요 클라우드 플랫폼을 통해서도 사용할 수 있습니다. 이미 특정 클라우드 인프라에 익숙하다면 굳이 Anthropic Console을 거치지 않고 해당 플랫폼에서 바로 연동하는 방법도 검토해볼 만합니다.
Q. API 키가 유출된 것 같다면 어떻게 해야 하나요?
즉시 콘솔에서 해당 키를 삭제하고 새 키를 발급받아야 합니다. 유출된 키로 발생한 요금은 원칙적으로 청구될 수 있으니 빠른 조치가 필요합니다.
Q. 모델별로 어떤 차이가 있나요?
최신 플래그십 모델은 opus 계열이고, 범용 추천은 sonnet, 빠른 응답이 필요할 때는 haiku 계열을 선택하면 됩니다. 작업의 목적과 응답 속도, 비용을 비교해서 고르게 됩니다.
Q. Claude API는 다른 AI API와 무엇이 다른가요?
최대 100만 토큰까지 지원하는 긴 컨텍스트 윈도우와 안전성 중심 설계, 코딩 및 에이전트 작업에서의 강점이 주요 차별점입니다. 장문 문서 분석이나 복잡한 코드 생성 작업에서 특히 유용합니다.