Anthropic API 키 발급 방법｜Claude API 사용 준비하기

 

Claude API를 사용하려면 먼저 Anthropic Console에서 계정을 만들고, 결제 수단을 등록한 뒤 API 키를 발급받아야 합니다.

API 키는 Claude 모델을 외부 서비스, 자동화 도구, 개발 프로젝트, 챗봇 등에 연결할 때 필요한 인증키입니다. Anthropic API는 Claude.ai 유료 구독과 별개로 API 사용량 기준 과금 방식으로 운영됩니다. Anthropic 공식 문서에서도 Claude API는 Anthropic Console을 통해 직접 접근하고, Anthropic billing을 사용한다고 안내하고 있습니다.

 

➡ Claude API Docs

API Overview

 

1. Anthropic Console 접속 및 가입

먼저 아래 사이트에 접속합니다.

console.anthropic.com

사이트에 접속한 뒤 Google 계정 또는 이메일로 회원가입을 진행합니다.

가입 후에는 이메일 인증이나 추가 인증 절차가 나올 수 있습니다. 화면에 안내되는 절차에 따라 계정 설정을 완료하면 됩니다.

2. 결제 수단 등록

API를 사용하려면 결제 수단을 등록해야 합니다.

왼쪽 메뉴에서 Billing 메뉴로 이동한 뒤 카드를 등록합니다.

 

이미 Claude 유료 플랜을 사용하고 있더라도 API 사용료는 별도로 결제해야 합니다. Claude 구독은 웹/앱에서 Claude를 사용하는 요금제이고, API는 외부 서비스나 개발 프로젝트에 Claude를 연결할 때 사용하는 별도 과금 서비스입니다.

 

처음 테스트용으로 사용할 경우에는 큰 금액을 충전할 필요 없이 소액으로 시작하는 것이 좋습니다. 다만 최소 충전 금액이나 결제 방식은 계정, 지역, 시점에 따라 달라질 수 있으므로 실제 Console 화면에 표시되는 금액을 기준으로 확인하는 것이 안전합니다.

Anthropic API 요금은 모델별 사용량에 따라 달라지며, 공식 문서에서는 모든 가격이 USD 기준으로 표시된다고 안내하고 있습니다. 최신 가격은 Anthropic 공식 가격 페이지에서 확인하는 것이 좋습니다.

➡ Claude API Docs

 

Pricing

 

3. API 키 발급하기

결제 설정이 완료되었다면 왼쪽 메뉴에서 API Keys로 이동합니다.

그다음 Create Key 버튼을 클릭합니다.

API 키가 생성되면 화면에 긴 문자열 형태의 키가 표시됩니다. 이 키를 복사해서 안전한 곳에 저장해둡니다.

중요한 점은 API 키는 보통 생성 직후에만 전체 값을 확인할 수 있다는 것입니다. 나중에 다시 전체 키를 볼 수 없을 수 있으므로 반드시 처음 발급받았을 때 따로 저장해두는 것이 좋습니다.

4. API 키 관리 시 주의사항

API 키는 비밀번호와 비슷한 역할을 합니다. 외부에 노출되면 다른 사람이 내 계정의 API 사용량을 발생시킬 수 있습니다.

따라서 API 키는 절대 블로그, 깃허브, 노션 공개 문서, 단체 채팅방 등에 그대로 올리면 안 됩니다.

개발 프로젝트에서 사용할 때는 코드 안에 직접 입력하기보다 환경변수로 관리하는 방식이 안전합니다. Anthropic 공식 문서에서도 API 키를 환경변수로 설정하는 예시를 안내하고 있습니다.

➡ Claude API Docs

 

Agent SDK overview - Claude Code Docs

 

예를 들어 터미널에서는 아래처럼 설정할 수 있습니다.

export ANTHROPIC_API_KEY=your-api-key

여기서 your-api-key 부분에 본인이 발급받은 API 키를 넣으면 됩니다.

정리

Anthropic API 키 발급 과정은 크게 3단계입니다.

1. console.anthropic.com 접속 후 가입
2. Billing 메뉴에서 결제 수단 등록
3. API Keys 메뉴에서 Create Key 클릭 후 키 저장

처음 사용하는 경우에는 소액으로 테스트하면서 사용량과 비용을 확인하는 것이 좋습니다. Anthropic Console에서는 사용량과 비용을 확인할 수 있으며, 필요하다면 비용 제한도 설정할 수 있습니다. 공식 문서에 따르면 Claude Console의 Settings > Limits 메뉴에서 사용 한도를 관리할 수 있습니다. 

➡ Claude API Docs

 

Rate limits

 

API 키는 한 번 노출되면 보안 문제가 생길 수 있으니 반드시 안전하게 보관하세요.