카카오맵 API 키 발급받고, 가이드대로 코드 넣었는데 안 됩니다. 에러 메시지는 kakao is not defined. 이게 끝이에요. 원인 추측도 안 되는 에러.
결론부터 말하면, 카카오맵 활성화 설정을 켜지 않아서 그렇습니다.
해결법 (30초)
Kakao Developers > 내 앱 > 제품설정 > 카카오맵 > 활성화 설정에서 상태를 Off → On으로 바꿔주면 귀신같이 됩니다.
이게 전부예요. 진짜로.
어쩌다 알게 됐냐면
최근 Clawers라는 인형뽑기 매니아들을 위한 커뮤니티를 만들고 있는데요, 가장 중요한 지도 기능이 동작을 안 해서 골머리를 앓고 있었습니다.
카카오맵을 쓰기로 했고, API 키까지 야무지게 발급받아서 넣었는데 — kakao is not defined라는 아주 간단한 에러만 나왔습니다. Claude Code한테 에러를 복사해서 물어봐도 헛수고만 할 뿐 에러는 사라지지 않더라고요.
체념하고 구글맵으로 전환할까 하던 찰나에, 구글에 직접 검색을 해봤습니다. 결국 원인을 찾아냈는데, 정말 어이가 없었습니다.
인프런에서 아래 댓글을 통해 알게 됐어요.
진짜 문제는 가이드에 없다는 것
이전에는 안 이랬다는 걸 보면 카카오 측에서 의도적으로 추가한 것 같습니다. 만든 건 괜찮은데, 정작 공식 가이드에는 이 설정에 대한 언급이 없습니다.
실제 가이드를 보면 이렇게 키 발급 과정만 간단하게 나와 있어요. 에러 메시지로도 유추할 수가 없으니 답답해 미칠 노릇이었습니다.
바이브코딩할 때 특히 주의
요즘 AI한테 코드 짜달라고 하는 바이브코딩 많이 하잖아요. 이런 경우에 특히 위험합니다. AI는 공식 가이드 기준으로 답변하는데, 가이드에 없는 설정이니까 절대 못 찾아줍니다. 저도 Claude한테 계속 물어봤지만 헛수고였어요.
이 글이 검색에 걸려서 같은 문제로 시간 낭비하는 분이 한 명이라도 줄었으면 좋겠습니다.