도입: 키 발급은 ‘개발’이 아니라 ‘프로젝트 셋업’입니다

API 키 발급은 개발자가 하는 일처럼 보이지만, 실제 프로젝트에서는 대표나 기획자가 먼저 준비해두면 진행 속도가 확 달라집니다. 특히 CLOVA Studio는 PoC로 시작하는 경우가 많아, 초반에 “어디서 키를 뽑는지”와 “비용·권한을 어떻게 관리할지”가 정리되지 않으면 일정이 쉽게 늘어져요. 이 글은 개발 지식이 없어도, 준비해둔 캡처만 따라가면 10분 안에 API 키 메뉴까지 도달하도록 구성했습니다.

공식 문서를 기반으로 하되, 실무에서 자주 생기는 질문(요금 폭탄, 외주 보안, 테스트/서비스 키 차이)을 함께 정리해 두었습니다. 참고한 공식 문서는 아래 링크입니다.

네이버 클로바 공식 문서 바로가기

오늘 목표(10분 컷 체크리스트)

처음부터 복잡하게 생각할 필요는 없습니다. 이번 글의 목표는 “CLOVA Studio에 들어가서 API 키 화면을 열어두는 것”까지입니다. 그 상태가 되면 개발팀과 협업이 바로 시작될 수 있고, 외주 진행이라면 권한도 안전하게 나눌 수 있습니다. 아래 체크리스트만 통과하시면 됩니다.

콘솔에서 Services → AI Services → CLOVA Studio 경로로 진입하기
처음이라면 상품 이용 신청/약관 동의를 완료하기
CLOVA Studio 좌측 메뉴에서 관리 → API 키로 이동하기
외주/협업이 있다면 Sub Account로 권한 분리 계획 세우기
테스트 단계라면 Cost Explorer 예산(Budgets)로 한도 관리 준비하기

Step 0. 시작점은 “포털”입니다

포털 화면에서 로그인한 뒤 콘솔로 들어가는 것이 가장 자연스러운 흐름입니다. 처음 접속하셨다면 “지금 내가 포털에 있는지, 콘솔에 있는지”부터 구분하면 덜 헷갈립니다. 포털은 안내·소개 중심이고, 실제 키 발급은 콘솔과 CLOVA Studio 내부에서 진행됩니다. 따라서 첫 단계는 ‘포털 → 콘솔’로 넘어가는 것부터 잡으면 됩니다.

Step 1. 콘솔 첫 화면(대시보드)까지 진입

콘솔에 들어오면 대시보드가 먼저 보입니다. 여기까지는 로그인만 하면 도달하는 구간이라 크게 어렵지 않아요. 다만 이후부터는 메뉴 구조가 꽤 넓어서, 왼쪽 상단의 메뉴 버튼을 어디서 여는지 익혀두는 것이 중요합니다. 이 화면을 확인하셨다면 다음은 “Menu(햄버거)”를 열고 Services로 들어가는 단계입니다.

Step 2. (헷갈리는 구간) 리전/플랫폼 확인: Korea + VPC

여기서부터는 “같은 콘솔인데 메뉴가 다르게 보인다”는 일이 종종 생깁니다. 보통 원인은 상단의 리전/플랫폼 설정이 다르기 때문이에요. 특히 외주 개발사나 팀원이 “저는 그 메뉴가 안 보이는데요?”라고 말할 때, 대부분 이 설정이 맞지 않는 경우가 많습니다. 따라서 본격적으로 Services로 들어가기 전, 리전과 플랫폼을 한 번 확인해두면 불필요한 왕복이 줄어듭니다.

Step 3. Menu → Services → AI Services → CLOVA Studio로 이동

이제 핵심 경로로 들어갑니다. 공식 가이드에서도 기본 경로는 Services > AI Services > CLOVA Studio로 안내되어 있습니다.

이 단계에서 중요한 건 “AI Services라는 대분류를 찾는 것”이고, 그 안에서 CLOVA Studio를 선택하면 됩니다. 여기까지 오면 ‘키 발급을 할 수 있는 공간’에 거의 도착한 셈입니다.

Step 4. 처음이면 ‘상품 이용 신청’부터 해야 합니다(1회만)

CLOVA Studio를 처음 쓰는 계정이라면, 바로 키 발급 화면으로 가지지 않고 먼저 “이용 신청”을 거치게 됩니다. 이 과정은 한 번만 하면 되고, 이후에는 동일한 계정에서 반복하지 않습니다. 화면에서 My Product 영역을 확인한 뒤 상품 이용 신청을 진행하시면 됩니다. 이 단계를 건너뛰면 다음 화면으로 넘어가지 않기 때문에, ‘키 발급이 안 된다’고 느끼는 경우가 자주 생깁니다.

Step 5. 약관 동의 → 신청 완료 → “바로가기”로 진입

이용 신청 흐름에서는 약관 동의가 포함됩니다. 체크해야 하는 항목이 보이면 필수 여부를 확인한 뒤 다음으로 넘어가면 됩니다. 신청이 완료되면 “CLOVA Studio 바로가기” 버튼이 활성화되고, 그 버튼을 통해 실제 CLOVA Studio 화면으로 들어갈 수 있습니다. 이 구간을 통과하면 ‘콘솔 안의 CLOVA Studio 영역’이 아니라, CLOVA Studio 서비스 화면으로 접속하게 됩니다.

Step 6. CLOVA Studio 접속 후, 왼쪽 메뉴에서 ‘API 키’ 클릭

이제 목적지입니다. CLOVA Studio에 들어오면 왼쪽 메뉴(관리 영역)에 API 키가 보입니다. 공식 문서에서도 API 키 메뉴에서 키를 발급하는 흐름을 안내하고 있습니다.

여기에서 테스트용/서비스용 키를 관리하게 되며, 보안상 발급 직후 보관 방식도 함께 고민해두는 편이 좋습니다. 이 화면까지 도달하셨다면, ‘키 발급을 시작할 준비’가 끝난 상태라고 보셔도 됩니다.

여기부터는 실무에서 가장 많이 묻는 질문들입니다

공식 문서는 “연결을 위한 정보”에 집중되어 있다 보니, 실제 프로젝트에서 민감한 포인트인 비용과 권한은 상대적으로 설명이 얇은 편입니다. 반면 검색자는 보통 “발급은 했는데 이걸 어떻게 안전하게 쓰지?”에서 막히곤 하죠. 그래서 아래는 외주·실무 관점에서 꼭 짚어두면 좋은 내용만 정리해두었습니다. 이 파트를 읽어두면 ‘키 발급 이후의 시행착오’를 크게 줄일 수 있습니다.

1) Test 키 vs Service 키, 무엇을 발급해야 하나요?

CLOVA Studio API 키는 상황에 따라 테스트용과 서비스용을 구분해 사용합니다. 또한 개발팀이 호출 시 헤더로 무엇을 넣어야 하는지도 함께 확인하게 됩니다. 공식 문서에서는 CLOVA Studio API 키 헤더(X-NCP-CLOVASTUDIO-API-KEY)와 API Gateway 키 헤더(X-NCP-APIGW-API-KEY)를 안내합니다.

실무에서는 “지금 만드는 형태가 서비스 앱에 해당하는지”부터 먼저 합의하는 것이 좋습니다. 애초에 목표가 다르면, 키 발급과 연동을 다시 잡느라 시간이 늘어날 수 있습니다.

2) 요금 폭탄 방지: Cost Explorer에서 ‘예산(Budgets)’을 먼저 잡아두세요

테스트 단계에서 가장 흔한 문제는, 호출이 누적되면서 비용이 예상보다 커지는 상황입니다. 그래서 가능하면 초반에 “예산/알림”을 걸어두고 진행하는 편이 안전합니다. 네이버 클라우드는 Cost Explorer에서 Budgets(예산) 기능으로 예산을 생성해 관리할 수 있습니다.

특히 PoC 단계에서는 ‘작게 시작하고, 수치가 보이면 올리는’ 방식이 리스크를 줄이는 데 도움이 됩니다.

PoC 1~2주: 월 예산을 작게(예: 3~10만 원) 잡고 알림을 받습니다.
MVP 단계: 트래픽이 보이면 예산을 상향하고, 필요하면 항목별 예산도 분리합니다.
운영 단계: 팀 내에서 “누가 어떤 목적의 호출을 하는지” 기록 기준을 정해두면 좋습니다.

3) 외주 보안: 마스터 계정 공유 대신 Sub Account로 권한을 나누는 편이 안전합니다

외주 개발이 포함되면 계정 공유 방식이 곧 보안 수준이 됩니다. 마스터 계정 로그인 정보를 그대로 전달하는 방식은 관리도 어렵고, 종료 시점에도 정리가 깔끔하지 않습니다. 네이버 클라우드는 Sub Account를 통해 서브 계정을 생성하고 권한을 부여하는 체계를 제공합니다.

권한을 최소 단위로 나눠두면, 협업은 편해지고 사고 확률은 낮아집니다.

프로젝트가 끝났을 때 권한 회수도 명확해지기 때문에, 가능한 한 이 방식으로 시작하시는 것을 권합니다.

4) “키 발급해서 뭘 할 수 있나요?” RAG/AI 에이전트로 연결하면 의사결정이 쉬워집니다

키 발급 자체는 목적이 아니라 수단입니다. 이 키가 실제로 만들어낼 가치는 대개 “문서 기반 Q&A(RAG)” 혹은 “업무 자동화 에이전트” 형태로 이어집니다. 공식 요약 문서에서도 CLOVA Studio의 기능과 활용 흐름을 확인할 수 있습니다.

예를 들어 사내 매뉴얼, FAQ, 운영 정책을 붙여 “우리 조직용 답변 시스템”을 만들거나, 문의 분류·요약·답변 초안 생성처럼 반복 업무를 자동화하는 구조로 발전시키는 식입니다. 이 관점으로 보면, API 키는 ‘개발자만의 열쇠’가 아니라 ‘사업 실험을 시작하는 출입증’에 가깝습니다.

마무리: 여기까지만 준비해도 협업이 빨라집니다

오늘 글에서는 “포털/콘솔에서 길을 잃지 않고, CLOVA Studio의 API 키 메뉴까지 들어가는 과정”을 캡처 기반으로 정리했습니다. 여기에 예산(Budgets)과 Sub Account까지 같이 준비해두면, 개발팀이나 외주사와의 소통이 훨씬 매끄러워집니다. 정리하면, 키 발급은 기술 작업이라기보다 ‘프로젝트를 안전하게 시작하는 셋업’에 가깝습니다.

다음 단계에서는 자연스럽게 “그럼 이 키로 실제 서비스를 어떤 구조로 만들지”가 고민이 됩니다. 그때부터는 RAG 설계, 데이터 연결, 운영 방식(권한·비용·로그)까지 한 번에 묶어 판단하는 편이 효율적입니다.

다음 단계: ‘키 발급 이후’의 설계와 운영이 더 중요합니다

리트머스는 AI 기능을 단순히 붙이는 수준이 아니라, 바이브코딩 기반의 실전 외주개발 프로세스로 “빠르게 만들고, 정확하게 검증하고, 운영까지 이어지는 구조”를 설계하는 팀입니다. 기획 단계에서부터 요구사항을 정리하고, 개발 단계에서는 자동화된 협업 루틴과 검증 흐름을 붙여 속도와 품질을 함께 맞춥니다.

그런데 여기서 한 가지가 더 남습니다. 키를 발급한 뒤에는 결국 “작게 시작해서 무엇을 먼저 검증할지”, 그리고 “RAG/에이전트를 어떤 순서로 고도화할지”에서 많은 팀이 막히곤 합니다.