Claude API 키 발급 방법

Claude API 키 발급 방법과 앱에서 쓰는 법

Claude Console에서 Claude API 키를 발급받는 방법, API 크레딧이 포함된 Claude 요금제, 코드 없이 iPhone·Android·웹에서 Claude를 쓰는 방법입니다.

Oriveo Team게시일 수정일 약 8분
  • Claude API 키(API key)는 platform.claude.com의 Claude Console에 로그인해 Settings → API keys(platform.claude.com/settings/keys)에서 Create key를 누르고 복사하면 발급됩니다. 키는 "sk-ant-"로 시작하며 한 번만 표시됩니다. Billing에서 크레딧을 충전한 뒤 Oriveo처럼 본인 키를 넣을 수 있는 채팅 앱에 붙여 넣으세요.
  • Claude Pro에는 API 사용량이 포함되지 않습니다. 2026년 11월 18일 기준 Claude Max, Ultra, Team 요금제에는 월간 API 크레딧이 포함되며, 요금제를 Console 조직에 연결해 받습니다.
  • 2026년 9월 28일 기준 Claude Sonnet 5는 입력 토큰 100만 개당 $2, 출력 토큰 100만 개당 $10이므로, 전형적인 채팅 메시지 하나의 예상 비용은 약 1센트입니다.
iPhone용 Oriveo의 대화 목록. 각 대화 오른쪽에 예상 비용이 표시됩니다.

시작 전에 준비할 것

본인 키로 앱에서 Claude를 쓰려면 세 가지가 필요합니다. Claude Console 계정, 그 계정에 충전한 API 크레딧, 그리고 Anthropic 키를 넣을 수 있는 앱입니다. 어느 것도 프로그래밍이 필요하지 않습니다. 전체 설정은 보통 10분이면 끝나며, 그중 대부분은 결제 정보를 입력하는 시간입니다.

어떤 Anthropic 계정을 쓰는지 분명히 해 두면 도움이 됩니다. claude.ai의 Claude 앱(Free, Pro, Max, Ultra, Team)은 소비자용 구독입니다. platform.claude.com의 Claude Console은 API 키와 API 요금을 다루는 개발자 플랫폼입니다. Anthropic은 둘을 따로 청구합니다. 2026년 11월 18일 기준 Free, Pro, Enterprise 요금제에는 API 사용량이 포함되지 않고, Max, Ultra, Team 요금제에는 매달 일정액의 API 크레딧이 제공됩니다(아래 참고). 같은 이메일로 둘 다 로그인할 수 있습니다.

1단계: Claude API 키 만들기

Anthropic은 "Get your Claude API key" 페이지에 절차를 정리해 두었습니다. 키는 만든 뒤에는 다시 볼 수 없으므로, 비밀번호 관리자 같은 안전한 보관 장소를 미리 준비해 두세요.

  • platform.claude.com에 접속해 로그인하거나 Console 계정을 만듭니다.
  • Settings → API keys(platform.claude.com/settings/keys)를 엽니다.
  • Create key를 누르고 나중에 알아볼 수 있는 이름(예: "휴대폰의 Oriveo")을 붙인 뒤 만료 기간을 고릅니다.
  • 키를 복사합니다. 키는 "sk-ant-"로 시작하며, Console은 전체 키를 만드는 순간 한 번만 보여 줍니다.
  • 키를 잃어버리면 복구할 수 없습니다. 새 키를 만들고 기존 키를 폐기하세요.

2단계: 크레딧 충전과 한도 설정

Claude API 사용료는 선불 크레딧으로 냅니다. Console에서 Settings → Billing을 열어 크레딧을 구매하면 구매가 끝나는 대로 쓸 수 있습니다. 원하면 자동 충전(auto-reload)을 켤 수 있습니다. 잔액이 정해 둔 기준 아래로 내려가면 크레딧을 자동으로 더 구매하는 기능입니다. 사용량을 파악하는 동안에는 자동 충전을 꺼 두는 것이 지출을 미리 낸 금액 안으로 묶어 두는 가장 간단한 방법입니다.

조직은 사용량 등급에 자동으로 배정되며, 등급마다 속도 제한(분당 요청 수와 토큰 수)과 월 지출 한도가 붙습니다. 둘 다 Console의 Rate limits와 Billing 페이지에서 볼 수 있습니다. 개인 채팅 용도라면 시작 한도가 걸리는 일은 드물지만, 긴 메시지를 연달아 보낼 때 가끔 "속도 제한" 오류가 나는 이유가 바로 이것입니다.

Claude Max, Ultra, Team 요금제에 API 크레딧이 포함되나요?

네, 2026년 11월 18일 기준으로 포함됩니다. Anthropic은 이 요금제에 매달 API 크레딧을 줍니다. Max는 $100, Ultra는 $200, Team은 좌석당 $20 또는 $100(Standard 또는 Premium)이며, 팀 전체 합계는 최대 $500입니다. Free, Pro, Enterprise 요금제에는 포함되지 않습니다.

크레딧을 쓰려면 claude.ai의 요금제를 Claude Console 조직에 연결하세요. 신규 구독은 7일이 지나야 크레딧을 받을 수 있고, 남은 크레딧은 다음 결제 주기로 이월되지 않습니다. Anthropic에 따르면 이 크레딧은 Claude API, Managed Agents, Agent SDK, Console Playground 비용에 쓰이며, Claude Code나 Claude 앱의 추가 사용량에는 쓰이지 않습니다.

Oriveo는 Claude API를 쓰므로, 연결된 Console 조직에서 만든 키라면 이 크레딧을 쓸 수 있습니다. 크레딧을 다 쓰면 평소처럼 조직에 선불 크레딧이 있어야 합니다.

API로 쓰는 Claude의 비용

API 가격은 토큰 단위이며, 보내는 토큰(입력)과 Claude가 써 내는 토큰(출력)의 요율이 따로입니다. 표에는 2026년 9월 28일 기준 현재 모델들의 Anthropic 공개 요율과, 입력 2,000토큰·출력 600토큰의 전형적인 채팅 메시지 하나에 대한 예상 비용을 함께 적었습니다. 입력에는 매 메시지마다 앱이 다시 보내는 이전 대화가 포함됩니다.

Sonnet 5의 계산은 2,000 × $2 / 1,000,000 + 600 × $10 / 1,000,000 = $0.010입니다. 본인 메시지는 다를 것이므로 마지막 열은 대략적인 규모를 가늠하는 용도로만 읽으세요. 최종 금액은 어떤 예상치가 아니라 Anthropic의 청구서입니다.

API로 쓰는 Claude의 비용
모델입력(USD / 100만 토큰)출력(USD / 100만 토큰)전형적인 메시지 1개 예상 비용
Claude Haiku 4.51.005.00약 $0.005
Claude Sonnet 52.0010.00약 $0.010
Claude Opus 5.54.0020.00약 $0.020
Claude Fable 5.110.0050.00약 $0.050

3단계: Oriveo에 키 연결하기

Oriveo는 본인 키로 동작하는 iPhone, Android, 웹용 멀티모델 채팅 앱입니다. Anthropic은 공식 제공업체 15곳 중 하나이며, 직접 연결 AI 제공업체(웹: 직접 AI 제공업체) 항목에 있습니다. 아래 표의 이름은 한국어 화면에 표시되는 이름입니다.

계속을 누르는 즉시 Oriveo가 Anthropic에 키로 쓸 수 있는 모델 목록을 요청해 키를 확인하고, 그 목록을 동기화합니다. 대개 복사·붙여 넣기 실수 때문에 Anthropic이 키를 거부하더라도 Oriveo는 키를 저장하고 "저장했지만 키가 유효하지 않은 것 같습니다. 나중에 제공업체 설정에서 확인할 수 있습니다."라고 표시하므로, 대화를 시작하기 전에 키를 고칠 수 있습니다.

3단계: Oriveo에 키 연결하기
단계iPhoneAndroid웹
제공업체 목록 열기제공업체 탭제공업체 탭사이드바의 제공업체
설정 시작제공업체 추가제공업체 추가제공업체 추가
제공업체 선택직접 연결 AI 제공업체 아래의 Anthropic직접 연결 AI 제공업체 아래의 Anthropic직접 AI 제공업체 아래의 Anthropic
키 붙여 넣기"Anthropic 연결" 아래의 API Key 입력란"Anthropic 연결" 아래의 API 키 입력란"Anthropic 연결" 아래의 키 입력란. "Claude에서 키 받기" 링크가 Console로 연결됨
확인계속계속계속
확인 대기"연결 확인 및 모델 동기화 중...""연결을 확인하고 모델을 동기화하는 중…""연결 확인 및 모델 동기화 중..."

4단계: 모델 고르고 대화 시작하기

Anthropic이 연결되면 모델 선택기에 모델이 나타납니다. 작업에 맞는 것을 고르세요. 가벼운 일상 질문에는 Haiku, 무난한 기본값은 Sonnet, 가장 어려운 추론과 글쓰기에는 Opus나 Fable입니다. 대화 도중에 모델을 바꿀 수 있고, 연결해 둔 다른 제공업체의 모델로도 바꿀 수 있으며, 대화는 새 모델로 이어집니다.

iPhone·Android 앱에서는 제공업체에 처음 메시지를 보낼 때 짧은 안내가 표시됩니다. "Anthropic을(를) 사용하려고 합니다."라는 안내로, 메시지가 답변 생성을 위해 Anthropic으로 전송된다는 점을 알려 줍니다. 모든 플랫폼에서 각 메시지 옆에 Anthropic 공개 가격과 응답이 보고한 토큰으로 계산한 예상 비용이 표시됩니다.

iPhone과 Android에서 Claude 키 쓰기

위 순서는 휴대폰에서도 똑같습니다. iPhone이나 Android용 Oriveo 앱에서 제공업체 탭을 열고 +를 누른 뒤 Anthropic을 고르고, 키를 붙여 넣고 계속을 누르세요. 긴 키는 비밀번호 관리자를 통해 휴대폰으로 옮기는 것이 가장 편합니다. 이메일이나 메신저로 나에게 보내는 방법은 피하세요.

iPhone·Android 앱은 메시지를 Anthropic으로 바로 보내고, 키는 휴대폰의 보안 저장소(iPhone은 키체인, Android는 Keystore)에 보관됩니다. 클라우드 동기화는 API 키를 업로드하지 않으므로 두 번째 기기는 동기화로 키를 받지 못합니다. 그 기기에도 키를 붙여 넣거나 기기마다 별도 키를 만드세요.

키를 안전하게 지키기

Anthropic 키는 본인 크레딧을 쓸 수 있으므로 비밀번호처럼 다루세요. Oriveo는 제공업체 키를 계정 기록으로 저장하지 않고 기기나 브라우저에 보관합니다. iPhone·Android 앱은 Claude 요청을 Anthropic으로 직접 보내고, 웹 앱은 Oriveo 서버의 실시간 중계를 거쳐 요청을 보냅니다. 키는 그 요청에만 쓰이고 계정 기록으로 저장되지 않으며, BYOK 대화는 채팅 로그로 저장되지 않습니다. Oriveo는 Anthropic 가격에 수수료를 붙이지 않습니다.

  • 앱이나 기기마다 키를 하나씩 만듭니다. 하나를 폐기해도 나머지에 영향이 없습니다.
  • 사용량을 파악하는 동안에는 자동 충전 없는 선불 크레딧을 쓰거나 충전 기준을 낮게 둡니다.
  • 며칠 뒤 Console의 사용량 페이지를 확인해 앱의 예상치와 비교해 봅니다.
  • 키가 공개된 곳에 붙여 넣어졌다면 Console에서 폐기하고 새 키로 교체합니다.

작동하지 않나요? 자주 보는 Claude API 키 오류

설정 문제는 대개 몇 가지 원인 중 하나이며, 오류가 어느 것인지 알려 줍니다. 아래는 2026년 11월 18일 기준 Anthropic 오류 페이지를 따릅니다.

  • 401 authentication_error: 키가 불완전하게 복사되었거나, 폐기되었거나, 만료되었습니다. 다시 복사하거나 새 키를 만드세요.
  • "Your credit balance is too low to access the Anthropic API": Console 조직에 크레딧이 남아 있지 않습니다. Settings → Billing에서 크레딧을 구매하거나 자동 충전을 켜세요.
  • 402 billing_error: 결제 정보에 문제가 있습니다. Console에서 확인하세요.
  • 403 permission_error: 키가 해당 리소스를 쓸 권한이 없습니다. Console에서 조직과 워크스페이스 설정을 확인하세요.
  • 429 rate_limit_error: 짧은 시간에 요청을 많이 보냈거나 아주 긴 메시지를 보냈습니다. 1분쯤 기다렸다가 다시 시도하세요. 세부 내용에 enforced_spend_limit_reached가 있다면 조직이 등급의 월 지출 한도에 도달한 것이며, Console의 Rate limits 페이지에서 더 높은 등급을 요청하지 않으면 다음 달 1일(00:00 UTC)까지 요청이 계속 실패합니다.
  • 지출 한도를 언급하는 400 invalid_request_error: 직접 정한 한도에 도달했습니다. Console에서 한도를 올리세요.
  • 529 overloaded_error: Anthropic 서버가 일시적으로 과부하 상태입니다. 잠시 뒤 다시 시도하세요.
  • 새 Claude 모델이 안 보임: Anthropic이 출시한 뒤 앱에서 해당 제공업체의 모델 목록을 새로 고치세요.
  • Claude Pro 요금제로 충당될 거라고 기대했다면: 그렇지 않습니다. Pro에는 API 크레딧이 없고, Max, Ultra, Team 요금제에는 있습니다.
  • Anthropic이 거부한 키는 Oriveo의 iPhone·Android 앱에서 "잘못된 API 키"로 표시되며, 웹 앱에서는 대신 "액세스가 만료됨"으로 표시될 수 있습니다.

자주 묻는 질문

Claude API 키는 어디서 발급받나요?
platform.claude.com의 Claude Console에서 Settings → API keys로 받습니다. Create key를 누르고 이름을 붙인 뒤 바로 복사하세요. "sk-ant-"로 시작하는 전체 키는 한 번만 표시됩니다.
Claude Pro에 API 사용이 포함되나요?
포함되지 않습니다. 2026년 11월 18일 기준 Free, Pro, Enterprise 요금제에는 API 사용량이 포함되지 않고, API 사용료는 Claude Console의 선불 크레딧으로 냅니다. Max, Ultra, Team 요금제는 다릅니다. 매달 API 크레딧이 제공됩니다.
Claude Max 구독을 API에 쓸 수 있나요?
일부는 가능합니다. 2026년 11월 18일 기준 Max에는 매달 $100의 API 크레딧이 포함됩니다(Ultra $200, Team 좌석당 $20 또는 $100, 최대 $500). 요금제를 Console 조직에 연결해 받으며, 남은 크레딧은 이월되지 않고 Claude Code나 Claude 앱의 추가 사용량에는 쓸 수 없습니다.
무료 Claude API 키가 있나요?
2026년 11월 18일 기준 Anthropic은 신규 Console 계정의 무료 제공량을 밝히지 않습니다. Max, Ultra, Team 요금제에 딸린 월간 크레딧을 제외하면 API는 선불 크레딧으로 결제합니다.
본인 API 키로 Claude를 쓰면 얼마가 드나요?
토큰 단위로 냅니다. 2026년 9월 28일 기준 Claude Sonnet 5는 입력 토큰 100만 개당 $2, 출력 토큰 100만 개당 $10이어서, 전형적인 채팅 메시지 하나에 약 1센트(예상)가 듭니다. 무거운 모델은 메시지당 더 듭니다.
iPhone이나 Android 휴대폰에서 Claude API 키를 쓸 수 있나요?
네, 본인 키를 넣을 수 있는 앱이면 됩니다. Oriveo에서 제공업체를 열어 제공업체 추가를 누르고 Anthropic을 고른 뒤 키를 붙여 넣고 계속하세요. 네이티브 앱은 요청을 Anthropic으로 직접 보냅니다.
Claude API를 쓰려면 코드를 짜야 하나요?
아니요. Console 계정, 크레딧, 키만 있으면 되고 API 요청은 BYOK 채팅 앱이 대신 보냅니다. 코드가 필요한 시점은 본인 소프트웨어를 API 위에 만들고 싶을 때입니다.
Claude API 키를 Oriveo에 넣어 두어도 안전한가요?
Oriveo는 키를 계정 기록이 아니라 기기나 브라우저에 보관하고, 네이티브 앱은 Anthropic에 직접 연결합니다. 그래도 위험은 줄여 두세요. 앱마다 키를 따로 쓰고, 선불 크레딧을 쓰고, 키가 노출되면 바로 폐기하세요.

함께 읽기

본인 키로 Claude와 대화하기

iPhone, Android, 웹의 Oriveo에 Anthropic 키를 연결하고, Claude를 포함한 700+ 모델 사이를 오가며 모든 메시지의 예상 비용을 확인해 보세요.