API 키

바이브코딩으로 외부 기능을 붙이다 보면 꼭 만나는 칸이 있어요. “여기에 API 키를 입력하세요.” 처음엔 여기서 다들 멈칫하죠. 키가 뭐고, 어디서 받아서, 어디에 넣으라는 건지 막막하거든요.

API 키는 외부 서비스를 쓸 때 ‘나 이거 쓸 자격 있어요’를 증명하는 비밀 문자열이에요. 회원 전용 라운지의 출입증 같은 거예요. 이게 있어야 API라는 창구가 문을 열어주고, 내가 쓴 만큼 내 계정으로 요금이 집계돼요. 보통 그 서비스에 가입하면 대시보드에서 발급받아요.

그래서 API 키는 남에게 보이면 안 돼요. 출입증을 잃어버리면 남이 내 이름으로 들어가 버리니까요.

가장 흔한 사고가 키를 코드에 그대로 적어 공개 저장소에 올리는 거예요. 그럼 남이 내 키로 요금을 태우는 일이 생겨요. 그래서 키는 코드에 직접 쓰지 말고 환경변수로 빼두는 게 기본이에요. “키는 환경변수로” 이 한 줄만 습관 들여도 사고의 절반은 막아요.