코딩 없이 Claude API 키를 앱에서 쓰는 방법

시작 전에 준비할 것

본인 키로 앱을 통해 Claude를 쓰는 데 필요한 것은 세 가지입니다. Claude Console 계정, 그 계정에 충전한 API 크레딧, Anthropic 키를 받아들이는 앱. 어느 것도 프로그래밍을 요구하지 않습니다. 전체 설정은 보통 10분이면 끝나고, 시간의 대부분은 결제 양식에 쓰입니다.

어떤 Anthropic 계정을 쓰는지 분명히 하면 도움이 됩니다. claude.ai의 Claude 앱(Free, Pro, Max)은 소비자용 구독입니다. platform.claude.com의 Claude Console은 API 키와 API 요금을 다루는 개발자 플랫폼입니다. Anthropic 공식 도움말은 유료 Claude 구독에 Claude API나 Console 접근권이 포함되지 않으며 둘은 따로 구매한다고 안내합니다. 같은 이메일로 둘 다 로그인할 수는 있지만 요금 체계는 별개입니다.

1단계: Claude API 키 만들기

Anthropic은 "Claude API 키 발급" 문서 페이지에 절차를 정리해 두었습니다. 키는 한 번 만들어지고 이후에는 다시 볼 수 없으므로, 비밀번호 관리자 같은 안전한 보관 장소를 미리 준비해 두세요.

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

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

Claude API 사용료는 선불 크레딧으로 냅니다. Console에서 Settings → Billing을 열어 크레딧을 구매하면 구매가 끝나는 대로 쓸 수 있습니다. 자동 충전을 켜면 잔액이 정한 기준 아래로 내려갈 때 크레딧을 더 사지만, 사용량을 파악하는 동안에는 자동 충전을 꺼 두는 것이 선불한 금액 안으로 지출을 제한하는 가장 간단한 방법입니다.

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

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의 청구서입니다.

3단계: Oriveo에 키 연결하기

Oriveo는 본인 키로 동작하는 iPhone, Android, 웹용 멀티모델 채팅 앱입니다. Anthropic은 공식 제공업체 15곳 중 하나이며 Direct AI Providers 아래에 표시됩니다. 아래 표의 이름은 앱 화면에 표시되는 메뉴 이름입니다.

Oriveo는 진행하는 즉시 Anthropic에 키로 쓸 수 있는 모델 목록을 조회해 키를 확인하고, 그 목록을 동기화합니다. 확인에 실패하면 오류가 표시되므로 대화를 시작하기 전에 키를 고칠 수 있습니다. 원인은 대개 키를 잘못 복사했거나 크레딧이 없는 Console 계정입니다. iPhone에서는 저장되었지만 검증되지 않은 키에 표시를 달아 두어 제공업체 설정에서 나중에 점검할 수 있습니다.

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

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

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

키를 안전하게 지키기

Anthropic 키는 본인 크레딧을 쓸 수 있으므로 비밀번호처럼 다루세요. Oriveo는 제공업체 키를 계정 레코드로 저장하지 않고 기기나 브라우저에 보관합니다. iPhone·Android 앱은 Claude 요청을 Anthropic으로 직접 보내고, 웹 앱은 키나 BYOK 대화 내용을 남기지 않는 실시간 중계 엔드포인트를 씁니다. Oriveo는 Anthropic 가격에 수수료를 붙이지 않습니다.

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

자주 겪는 문제와 해결법

설정 문제의 원인은 몇 가지로 좁혀지고, 오류 메시지가 대개 어느 것인지 알려 줍니다.

• 설정 중 인증 오류: 키가 불완전하게 복사되었거나 폐기된 키입니다. 다시 복사하거나 새 키를 만드세요.
• 결제·크레딧 오류: Console 계정에 크레딧이 없습니다. Settings → Billing에서 크레딧을 구매하세요.
• 속도 제한 오류: 짧은 시간에 요청을 많이 보내거나 아주 긴 메시지를 보냈을 때입니다. 잠시 기다리거나 Console에서 본인 등급의 한도를 확인하세요.
• 새 Claude 모델이 안 보임: Anthropic이 출시한 뒤 앱에서 해당 제공업체의 모델 목록을 새로 고치세요.
• Claude Pro 요금제로 충당될 거라고 기대했다면: 그렇지 않습니다. API 사용료는 항상 Console을 통해 청구됩니다.