치지직 개발자 센터 API 키 발급, 화면별 안내 — 애플리케이션 등록부터 Client ID까지

아인만 쓰려는 분은 이 글이 필요 없습니다. 아인은 설치하고 방송 계정으로 로그인하면 바로 시작되고, 키 발급 단계가 없습니다. 이 글은 직접 발급한 키로 연결하고 싶은 분과, 치지직 API로 프로그램을 직접 만드는 분을 위한 글입니다.

치지직에 직접 만든 프로그램이나 공식 API를 쓰는 도구를 붙이려면, 또는 설치형 채팅봇에 내 키를 넣어 쓰려면 치지직 개발자 센터에서 API 키를 발급받아야 합니다. 무료이고 한 번만 하면 되는데, 처음 보는 화면이라 어디에 뭘 넣어야 하는지 막히는 분이 많습니다.

이 글은 그 과정을 화면 순서대로 적은 글입니다. 입력값 예시는 제가 만든 채팅봇 '아인' 기준이지만, 다른 프로그램도 순서는 같고 프로그램이 알려 주는 값만 다릅니다. 아인은 2.3부터 키 없이 방송 계정 로그인만으로 쓸 수 있고, 직접 발급한 키로 연결하고 싶을 때 이 순서를 따르면 됩니다.

이 글이 필요한 경우

• 설치형 채팅봇에 직접 발급한 키를 넣어 쓰려는 경우 (아인은 2.3부터 키 없이도 됩니다)
• 직접 만든 프로그램으로 치지직 채팅을 읽거나 쓰려는 경우
• 공식 API를 쓰는 오버레이·위젯 도구를 붙이는 경우

뚜봇, 빵떡, 한봇처럼 웹에서 로그인해 쓰는 봇은 봇 회사가 이미 발급받아 두었기 때문에 이 과정이 필요 없습니다.

준비

방송하는 네이버 계정 하나면 됩니다. 개발자 센터는 방송 계정으로 로그인해야 합니다. 부계정으로 등록하면 나중에 프로그램이 "다른 계정"이라고 알려 줍니다.

1. 개발자 센터 로그인

developers.chzzk.naver.com 에 들어가 네이버로 로그인합니다. 처음이면 이용 약관 동의 화면이 나옵니다.

2. 애플리케이션 등록

 

[애플리케이션 등록]을 누르면 입력 화면이 나옵니다. 여기서 넣을 것은 세 가지입니다.

애플리케이션 이름
자유롭게 짓되, "치지직", "네이버", "chzzk", "naver"는 넣을 수 없습니다. 넣으면 앱이 정지될 수 있습니다. "내 방송 봇" 정도면 됩니다. 이 이름은 로그인 창에 표시될 뿐 채팅에 나오지 않습니다.

로그인 리디렉션 URL
쓰려는 프로그램이 알려 주는 값을 그대로 붙여 넣습니다. 한 글자라도 다르면 로그인이 안 됩니다. 아인은 아래 값입니다.

http://localhost:3000/callback

API Scopes (권한)
프로그램이 요구하는 항목을 체크합니다. 아인은 다음 4 개입니다.

• 유저 조회
• 채팅 메시지 조회
• 채팅 메시지 쓰기
• 후원 조회 (치즈 후원 인사에 필요)

권한은 처음 등록할 때 한 번에 체크하세요. 등록 뒤에 권한을 바꾸면 치지직 검수를 거쳐야 반영돼서 며칠이 걸립니다. 빠뜨렸다면 아인은 어떤 권한이 빠졌는지 화면에 알려 주니 그때 추가하면 됩니다.

3. Client ID와 Client Secret 복사

등록을 마치면 Client ID와 Client Secret 두 값이 나옵니다. 이걸 프로그램의 해당 칸에 붙여 넣습니다. 아인은 설정 → 치지직 연결 → "직접 발급한 API 키로 연결하기 (고급)"의 두 칸입니다. Client Secret은 눈 모양 [보기]를 누르면 보이는데, 칸보다 길어서 끝까지 끌어 모두 골라 복사합니다.

Client Secret은 비밀번호와 같습니다. 방송 화면에 띄우거나 캡처에 남기지 마세요. 새어 나간 것 같으면 개발자 센터에서 그 애플리케이션을 지우고 새로 등록하면 됩니다.

4. 프로그램에서 로그인

프로그램이 여는 로그인 창에서 방송 계정으로 로그인하고 [동의]를 누르면 연동이 끝납니다. 동의 화면에 방금 체크한 권한 목록이 그대로 나옵니다.

아인은 로그인이 끝나면 화면에 연동된 채널 이름을 보여 줍니다. 여기까지 3분 정도입니다.

알아 둘 것

• 치지직 개발자 문서 기준으로 최근 90일 동안 API 사용이 없는 애플리케이션은 삭제됩니다. 봇을 몇 달 안 켰다가 다시 켤 때 로그인이 안 되면 이 경우이니 새로 등록하면 됩니다.
• 애플리케이션은 계정당 여러 개 만들 수 있습니다. 프로그램마다 따로 등록해도 됩니다.
• 개발자 센터 정책과 화면은 치지직이 바꿀 수 있습니다. 공식 문서는 chzzk.gitbook.io 에 있습니다.

막힐 때

로그인 창에서 오류가 나요
리디렉션 URL 오타가 대부분입니다. 프로그램이 알려 준 값과 글자 단위로 비교하세요. http와 https, 마지막 슬래시까지요.

"권한이 빠졌습니다"라고 나와요
API Scopes에서 빠진 항목을 체크하고 저장하세요. 검수 후 반영되고, 반영되면 프로그램을 껐다 켜면 됩니다.

연동된 채널이 다른 채널이에요
개발자 센터나 로그인 창에서 부계정으로 로그인한 경우입니다. 로그아웃하고 방송 계정으로 다시 하세요.

아인 설치 순서는 여기에 있습니다. 2.3부터는 개발자 센터 단계 없이 로그인만 하면 되고, 직접 발급한 키로 연결하는 방법은 같은 글 아래쪽에 있습니다.
https://einbot.kr/guide/install/

아인 공식 사이트: https://einbot.kr

아인은 개인이 만든 프로그램이며, 네이버·치지직의 공식 서비스가 아닙니다. 개발자 센터 내용은 2026년 10월 기준입니다.