AI로 Discord 봇 만들기 — 명령어·알림 봇 1시간 완성

Discord 봇은 커뮤니티 운영의 기본 도구입니다. 서버 알림, 자동 응답, 명령어 처리, 외부 API 연동 같은 기능을 코드 한 줄도 직접 짜지 않고 AI에게 부탁해서 만들 수 있습니다. 이 글은 Claude나 ChatGPT를 활용해 Discord 봇을 1시간 안에 만드는 흐름을 단계별로 정리합니다.

Discord 봇이 동작하는 원리

Discord 봇은 Discord Developer Portal에서 등록한 봇 계정이 서버에 참여해서 메시지를 읽고 보내는 구조입니다. 사용자는 별도 프로그램으로 봇 코드를 실행하고, 그 프로그램이 Discord 서버와 WebSocket으로 연결됩니다. 메시지 수신, 명령어 처리, 응답 발신 모두 이 연결을 통해 이뤄집니다.

핵심 구성 요소는 세 가지입니다. 봇 토큰(인증 키), 봇 코드(이벤트 처리 로직), 호스팅 환경(코드를 24시간 실행할 서버)입니다. 봇 토큰은 Discord Developer Portal에서 발급받고, 코드는 AI에게 요청해서 받고, 호스팅은 무료 옵션부터 유료까지 다양합니다.

1단계 — 봇 등록

discord.com/developers/applications 에 접속해 새 애플리케이션을 만듭니다. Bot 탭에서 "Add Bot"을 클릭하면 봇 계정이 생성되고, 토큰을 확인할 수 있습니다. 이 토큰은 절대 공개하면 안 됩니다 — 노출 시 즉시 재발급해야 합니다.

OAuth2 탭에서는 봇이 서버에 참여할 때 받을 권한을 설정합니다. 메시지 읽기·보내기, 슬래시 명령어 사용, 임베드 링크 등 필요한 권한만 체크합니다. 생성된 초대 URL을 클릭하면 자신이 관리자인 서버에 봇을 추가할 수 있습니다.

2단계 — AI에게 코드 요청

Claude나 ChatGPT에 "Discord.js v14 기준으로 슬래시 명령어 /hello를 처리하는 Node.js 봇 코드를 작성해줘. 토큰은 환경변수에서 읽어와줘"처럼 구체적으로 요청합니다. AI가 코드 전체를 출력하면 그대로 복사해 index.js 같은 파일로 저장합니다.

프롬프트가 구체적일수록 결과 품질이 높아집니다. 라이브러리 버전, 명령어 종류, 응답 형식을 명시하면 AI가 정확한 코드를 만듭니다. 또한 npm 패키지 설치 명령어도 함께 요청하면, 의존성 정리가 한 번에 됩니다.

3단계 — 로컬 실행

Node.js 18 이상을 설치한 환경에서 npm install discord.js dotenv를 실행해 패키지를 설치합니다. .env 파일에 DISCORD_TOKEN=발급받은_토큰을 적고, node index.js로 실행합니다. 콘솔에 "Logged in as 봇이름" 메시지가 나오면 성공입니다. 봇이 참여한 Discord 서버에서 슬래시 명령어를 입력해 동작을 확인합니다.

오류가 나면 그 메시지를 그대로 복사해서 AI에게 붙여넣습니다. AI가 수정 코드를 제안하면 다시 적용합니다. 이 반복 과정이 AI 바이브코딩의 핵심이며, 직접 디버깅하지 않아도 대부분의 문제가 해결됩니다.

4단계 — 24시간 호스팅

로컬 실행은 PC를 켜둔 동안만 봇이 동작합니다. 24시간 운영하려면 호스팅 서비스가 필요합니다. Railway, Fly.io, Render 같은 서비스가 무료 또는 저가 플랜으로 Node.js 봇을 호스팅합니다.

Git 저장소에 코드를 푸시하고 호스팅 서비스에 연결하면 자동으로 배포됩니다. 환경변수에 DISCORD_TOKEN을 설정하는 것을 잊지 말아야 합니다. 무료 플랜은 일정 시간 비활성 시 슬립에 빠질 수 있어, 항상 깨어있는 상태가 필요한 경우 유료 플랜을 검토합니다.

확장 시나리오

기본 슬래시 명령어 봇이 동작하면 다음 단계는 외부 API 연동입니다. 날씨 알림, 환율 조회, 뉴스 요약 같은 기능은 외부 API + Discord 봇 조합으로 1~2시간 안에 만들 수 있습니다. AI에게 "OpenWeather API를 연동해서 /weather 도시명 명령어로 현재 날씨를 보여주는 봇으로 확장해줘"처럼 추가 요청하면 됩니다.

운영 단계에서는 봇 토큰 보안, 명령어 레이트 리밋, 권한 관리가 중요합니다. 토큰을 코드에 직접 박지 않기, 사용자별 호출 제한 두기, 관리자 명령어는 별도 권한으로 분리하기 같은 기본 원칙을 지키면 안전한 봇을 운영할 수 있습니다.