Claude API를 쓰려면 Anthropic Console에서 API 키를 먼저 발급받아야 하고, 코드를 작성하기 전에 콘솔 안의 Workbench에서 프롬프트를 미리 테스트해볼 수 있습니다. API 키는 발급 직후 한 번만 전체가 노출되므로 반드시 안전한 곳에 보관해야 하며, 코드에서는 직접 입력하는 대신 환경 변수로 불러오는 방식이 권장됩니다. 아래 내용은 Anthropic Console 접속부터 키 발급, Workbench 활용, 첫 API 요청 실행까지의 순서를 정리한 것입니다.
Anthropic Console 접속과 API 키 발급
API 키를 받는 경로는 두 가지입니다. anthropic.com/api에 접속해 Get API Access 버튼을 누르거나, console.anthropic.com으로 바로 들어가면 됩니다. 콘솔에 진입한 뒤 Get API Key 버튼을 클릭하면 키가 생성됩니다.
발급 과정에서 미리 챙겨둘 점은 다음과 같습니다.
- 키는 생성 시점에만 전체 문자열이 보이므로 복사해 두어야 합니다.
- 키 정보는 보안을 위해 별도로 안전하게 보관합니다.
- 코드에 키를 그대로 적어 넣는 방식은 피하고, 환경 변수로 분리하는 편이 안전합니다.
코드를 쓰기 전에 Workbench부터 여는 이유
Anthropic Console에는 Workbench라는 공간이 있어서, 실제 API 요청 코드를 작성하기 전에 프롬프트를 미리 작성하고 결과를 확인할 수 있습니다. 요청을 보내기 전 단계에서 프롬프트를 검증하고 테스트할 수 있다는 점이 이 도구의 목적입니다.
코드를 한 줄도 쓰지 않은 상태에서 프롬프트 문장을 다듬고 응답 품질을 가늠할 수 있으니, 반복 수정이 잦은 작업일수록 Workbench에서 먼저 정리해두는 편이 효율적입니다.
Python 환경 준비와 확인 항목
API 요청 코드를 실행하려면 Python이 설치되어 있어야 합니다. 터미널(macOS) 또는 명령 프롬프트(Windows)를 열고 버전 확인 명령을 입력했을 때 버전이 표시되면 준비가 된 상태입니다. 표시되지 않는다면 Python 공식 웹사이트에서 최신 버전을 내려받아 설치합니다.
| 준비 항목 | 확인 방법 |
|---|---|
| Python 설치 | 터미널에서 버전 확인 |
| 가상 환경 | 프로젝트별 생성 |
| API 키 | 환경 변수로 설정 |
가상 환경을 만들면 종속성 관리가 수월해지고 프로젝트 간 충돌을 막을 수 있습니다. 환경 변수에 API 키를 넣어두면 이후 Claude를 쓰는 프로젝트마다 같은 키를 다시 불러올 수 있습니다.
첫 API 요청 실행 순서
준비가 끝났다면 claude_test.py 같은 새 Python 파일을 만들고 요청 코드를 추가합니다. 실행은 터미널 또는 명령 프롬프트에서 python claude_test.py를 입력하는 방식입니다. 정상적으로 동작하면 Claude로부터 Yoda 스타일의 응답을 확인할 수 있습니다.
실행이 확인된 뒤에는 API 참조 문서를 살펴보거나 Anthropic 쿡북을 활용하고, 기타 리소스를 확인하는 방향으로 범위를 넓힐 수 있습니다.
자주 헷갈리는 부분
Q. API 키를 코드에 바로 써도 되나요?
키 정보는 보안을 위해 잘 보관해야 하는 값입니다. 환경 변수로 설정해두면 모든 Claude 프로젝트에서 같은 키를 사용할 수 있으면서 코드에는 노출되지 않습니다.
Q. Workbench는 코드 작성 후에도 쓸 수 있나요?
Workbench는 API 요청을 보내기 전에 프롬프트를 미리 확인하고 테스트하기 위한 용도로 소개된 기능입니다. 프롬프트를 먼저 정리한 다음 코드로 옮기는 순서가 자연스럽습니다.
Q. 응답이 나오지 않으면 무엇을 확인해야 하나요?
Python 버전 확인이 되지 않았다면 공식 사이트에서 최신 버전을 설치해야 하고, 키를 환경 변수로 설정했다면 해당 환경에서 코드를 실행하고 있는지도 함께 확인해야 합니다.
다음에 살펴볼 자료
첫 요청이 성공한 뒤에는 API 참조 문서를 탐색하고, Anthropic 쿡북을 활용하며, 기타 리소스를 확인하는 단계로 넘어갈 수 있습니다. 콘솔에는 Claude API 및 콘솔 사용법, Claude API 사용 및 모범 사례, 가격 및 청구 관련 자료가 모아져 있으니 필요한 항목부터 찾아보면 됩니다.