파이썬으로 디스코드 봇 만들기: 10분 만에 완성하는 초보 가이드

Q: 명령어를 쳤는데 반응이 없어요.

개발자 포털의 'Bot' 탭에서 'Message Content Intent'가 켜져 있는지, 그리고 코드 내 intents.message_content = True가 작성되어 있는지 꼭 확인하세요.

파이썬으로 디스코드 봇 만들기: 10분 만에 완성하는 초보 가이드

- 11월 25, 2025

"나만의 디스코드 봇, 상상이 현실로!" 복잡해 보이는 코딩, 파이썬(Python)이라면 누구나 할 수 있습니다. 봇 생성부터 '안녕'이라고 대답하게 만드는 코드까지, 10분 만에 끝내는 초보자 가이드를 시작합니다. 👩‍💻

서버에 들어오면 반갑게 인사해주고, 좋아하는 노래를 틀어주거나, 전적을 검색해주는 봇들! 볼 때마다 "나도 저런 거 하나 만들어보고 싶다"는 생각 해보셨죠? 😊

많은 분들이 코딩이 어려울 거라 지레짐작하고 포기하지만, 파이썬(Python)과 discord.py 라이브러리를 사용하면 생각보다 훨씬 간단하게 나만의 봇을 만들 수 있습니다. 오늘 이 글만 따라 하시면 여러분도 어엿한 '봇 개발자'가 될 수 있습니다. 차근차근 시작해 볼까요?

준비물: 파이썬과 코드 에디터 🛠️

요리를 하려면 도구가 필요하듯, 봇을 만들려면 개발 환경이 갖춰져야 합니다. 딱 두 가지만 설치하면 됩니다.

Python (파이썬): 봇을 움직이는 언어입니다. 공식 홈페이지에서 최신 버전을 다운로드하여 설치하세요. (설치 시 Add Python to PATH 체크 필수!)
VS Code (비주얼 스튜디오 코드): 코드를 작성할 공책 같은 프로그램입니다. 무료이며 가장 많이 사용됩니다.

💡 라이브러리 설치
설치가 끝났다면 VS Code의 터미널(Terminal)을 열고 아래 명령어를 입력해 디스코드 봇 제작 도구를 설치해 주세요.
pip install discord.py

개발자 포털에서 봇 생성하기 👾

이제 디스코드 본사에 "나 봇 하나 만들게!"라고 신고하고 신분증(토큰)을 받아야 합니다.

📝 단계별 등록 가이드

Discord Developer Portal 접속: 구글에 검색하여 로그인합니다.
New Application 클릭: 우측 상단 버튼을 눌러 봇의 이름(예: MyFirstBot)을 짓습니다.
Bot 메뉴 이동: 왼쪽 메뉴에서 'Bot'을 클릭하고 'Add Bot'을 누릅니다.
Token 복사: 'Reset Token'을 눌러 나오는 긴 문자열이 바로 봇의 열쇠입니다. (절대 남에게 보여주면 안 됩니다!)
Intents 설정 (중요): 같은 페이지 아래쪽의 'Privileged Gateway Intents' 항목(Message Content Intent 등)을 모두 켜주세요. 이걸 안 켜면 봇이 채팅을 못 읽습니다.

⚠️ 주의하세요!
토큰(Token)은 봇의 비밀번호와 같습니다. 깃허브(GitHub)나 커뮤니티에 실수로 올리면 해킹당할 수 있으니 메모장에만 잘 보관하세요.

복붙하면 끝! 기본 코드 작성하기 💻

이제 VS Code를 열고 main.py라는 파일을 하나 만드세요. 그리고 아래 코드를 복사해서 붙여넣기만 하면 됩니다.

        import discord

        from discord.ext import commands

        # 봇 권한 설정 (모든 권한 허용)

        intents = discord.Intents.default()

        intents.message_content = True

        # 봇 객체 생성 (명령어 접두사는 '!')

        bot = commands.Bot(command_prefix='!', intents=intents)

        # 봇이 켜졌을 때 실행되는 이벤트

        @bot.event

        async def on_ready():

            print(f'로그인 성공: {bot.user.name}')

        # '!안녕'이라고 쳤을 때 반응하는 명령어

        @bot.command()

        async def 안녕(ctx):

            await ctx.send('반가워요! 저는 봇입니다! 🤖')

        # 봇 실행 (토큰 입력)

        bot.run('여기에_아까_복사한_토큰을_붙여넣으세요')

* 마지막 줄의 '여기에_아까_복사한_토큰을_붙여넣으세요' 부분에 발급받은 토큰을 넣어야 합니다. (따옴표는 유지!)

봇 초대 및 실행 테스트 🚀

코드까지 짰으니 이제 봇을 내 서버로 데려와서 테스트해 볼 차례입니다.

초대 링크 만들기: 개발자 포털 왼쪽 메뉴의 [OAuth2] → https://www.homedepot.com/b/Outdoors-Outdoor-Power-Equipment-Generators/N-5yc1vZbx8l로 이동합니다.
권한 체크: SCOPES에서 'bot'을 체크하고, 아래 BOT PERMISSIONS에서 'Administrator'(관리자)를 체크합니다.
초대하기: 생성된 URL을 복사해서 인터넷 주소창에 넣고, 내 서버를 선택해 봇을 초대합니다.
실행하기: VS Code에서 F5를 누르거나 터미널에 python main.py를 입력합니다. 터미널에 "로그인 성공"이 뜨면 성공!

이제 디스코드 채팅창에 !안녕 이라고 쳐보세요. 봇이 대답하나요? 축하합니다! 여러분은 방금 첫 번째 봇을 완성했습니다. 🎉

마무리: 핵심 내용 요약 📝

생각보다 어렵지 않죠? 오늘 만든 봇은 아주 기초적이지만, 여기에 기능을 하나씩 더해가면 음악 봇, 전적 검색 봇, 관리 봇으로 얼마든지 확장할 수 있습니다.

🤖

디스코드 봇 제작 3단계

✨ 1단계 (준비): 파이썬 설치 후 pip install discord.py

📊 2단계 (등록): 개발자 포털에서 앱 생성 및 토큰 발급 (보안 필수!)

🧮 3단계 (코딩): 기본 코드 작성 및 실행, 서버 초대

👩‍💻 핵심 포인트: 개발자 포털에서 'Message Content Intent'를 꼭 켜야 봇이 말을 알아듣습니다.

나만의 봇으로 서버를 더욱 풍성하게 만들어보세요!

자주 묻는 질문 ❓

Q: 봇이 온라인 상태가 안 돼요.

A: 코드를 실행(Run) 시켜두었는지 확인하세요. 봇은 내 컴퓨터나 서버에서 파이썬 파일이 '실행 중'일 때만 켜져 있습니다. 터미널 창을 끄면 봇도 꺼집니다.

Q: 명령어를 쳤는데 반응이 없어요.

A: 개발자 포털의 'Bot' 탭에서 'Message Content Intent'가 켜져 있는지, 그리고 코드 내 intents.message_content = True가 작성되어 있는지 꼭 확인하세요.

Q: 봇을 24시간 켜두려면 어떻게 하나요?

A: 내 컴퓨터를 계속 켜둘 수는 없으니, AWS, Heroku, 구름IDE 같은 '호스팅 서비스'를 이용해야 합니다. 처음에는 내 컴퓨터에서 테스트하고, 나중에 호스팅을 배우는 것을 추천합니다.

이제 여러분도 봇 개발자의 첫걸음을 떼셨습니다! 코딩하다 막히는 부분이 있다면 언제든 댓글로 물어봐 주세요. 함께 해결해 봐요! 😉

이 블로그 검색

문제 해결 노트