discord.errors.PrivilegedIntentsRequired: Shard ID None is requesting privileged intents that have not been explicitly enabled in the developer portal. It is recommended to go to https://discord.com/developers/applications/ and explicitly enable the privileged intents within your application's page. If this is not possible, then consider disabling the privileged intents instead.

pip install discord.py

import discord
from discord.ext import commands

# 봇의 접두사 설정 (명령어 앞에 사용할 문자열)
intents = discord.Intents.default()
intents.messages = True
intents.message_content = True  # 메시지 내용 접근 권한
bot = commands.Bot(command_prefix='/', intents=intents)

# 봇이 준비되었을 때 실행되는 이벤트
@bot.event
async def on_ready() -> None:
    print(f'봇이 실행되었습니다. 이름: {bot.user}')

# 메시지 명령어 처리
@bot.command()
async def hello(ctx) -> None:
    await ctx.send(f'안녕하세요, {ctx.author.name}님!')

# 에코 기능 (입력한 메시지를 그대로 반환)
@bot.command()
async def echo(ctx, *, content: str) -> None:
    await ctx.send(content)

# 봇 실행
bot.run('YOUR_BOT_TOKEN')

project/
│
├── bot.py           # 메인 봇 실행 파일
├── cogs/            # 기능별 Cog 모듈 폴더
│   ├── __init__.py  # 패키지 초기화 파일 (비워둬도 됨)
│   ├── general.py   # 일반 명령어를 관리하는 Cog
│   └── ...          # 다른 기능별 Cog 파일 추가 가능
└── requirements.txt # 설치할 패키지 리스트 (선택사항)

import discord
from discord.ext import commands

class General(commands.Cog):
    def __init__(self, bot) -> None:
        self.bot = bot

    # General Cog 실행
    @commands.Cog.listener()
    async def on_ready(self) -> None:
        print("General is going ...")

    # hello 명령어
    @commands.command()
    async def hello(self, ctx) -> None:
        await ctx.send(f'안녕하세요, {ctx.author.name}님!')

    # echo 명령어
    @commands.command()
    async def echo(self, ctx, *, content: str) -> None:
        await ctx.send(content)

# Cog를 등록하는 함수
async def setup(bot) -> None:
    await bot.add_cog(General(bot))

import os
import discord
import sys
import asyncio
from discord.ext import commands

# 봇의 접두사 설정 (명령어 앞에 사용할 문자열)
intents = discord.Intents.default()
intents.messages = True
intents.message_content = True  # 메시지 내용 접근 권한
bot: commands.Bot = commands.Bot(command_prefix="/", intents=intents)

# 봇 준비 이벤트
@bot.event
async def on_ready() -> None:
    print(f"봇이 실행되었음: {bot.user}")

# Cog 로드 함수
async def load_cogs() -> None:
    if not os.path.exists("./cogs"):
        print(f"cogs/ 디렉토리가 존재하지 않습니다!")
        sys.exit()

    for filename in os.listdir("./cogs"):
        if filename.endswith(".py"):
            no_ext_filename, ext = os.path.splitext(filename)
            await bot.load_extension(
                name=f"cogs.{no_ext_filename}"
            )  # 확장자 제외하고 로드

# 토큰 지정
_TOKEN: str = ""

# 봇 실행
async def main() -> None:
    async with bot:
        await load_cogs()  # cog 로드
        await bot.start(token=_TOKEN)

if __name__ == "__main__":
    # 비동기 메인 실행
    asyncio.run(main=main())

import discord
from discord.ext import commands
from discord import app_commands

class SlashCommand(commands.Cog):
    def __init__(self, bot: commands.Bot) -> None:
        super().__init__()
        self.bot = bot

    @commands.Cog.listener()
    async def on_ready(self) -> None:
        print(f"{self.__class__.__name__} Cog is ready.")

    @app_commands.command(
        name="sayhello", description="사용자에게 인사를 건네는 명령어입니다!"
    )
    async def say_hello(self, interaction: discord.Interaction):
        await interaction.response.send_message(f"Hello, {interaction.user.name}!")

# Cog 등록 함수
async def setup(bot: commands.Bot):
    await bot.add_cog(SlashCommand(bot=bot))

...
# 봇 준비 이벤트
@bot.event
async def on_ready() -> None:
    print(f"봇이 실행되었음: {bot.user}")
    await bot.tree.sync()  # tree 동기화
...

import discord
from discord.ext import commands
from discord import app_commands

class EmbedCommand(commands.Cog):
    def __init__(self, bot: commands.Bot) -> None:
        super().__init__()
        self.bot = bot

    @commands.Cog.listener()
    async def on_ready(self) -> None:
        print(f"{self.__class__.__name__} Cog is ready.")

    @app_commands.command(
        name="embed", description="embed를 테스트하기 위한 명령어입니다."
    )
    async def pretty_embed(self, interaction: discord.Interaction):
        embed = discord.Embed(
            title="봇 정보",
            description="이 봇은 다양한 기능을 제공합니다",
            color=discord.Color.blue(),
        )
        embed.add_field(name="버전", value="1.0", inline=True)
        embed.add_field(name="개발자", value="Jaehyo Lee", inline=True)
        embed.set_footer(text="이 메시지는 임베드로 작성되었습니다")
        await interaction.response.send_message(embed=embed)


# Cog 등록 함수
async def setup(bot: commands.Bot):
    await bot.add_cog(EmbedCommand(bot=bot))

import discord
from discord.ext import commands, tasks
from discord import app_commands


class TaskCommand(commands.Cog):
    def __init__(self, bot: commands.Bot) -> None:
        super().__init__()
        self.bot = bot
        self.test_task.start()  # task 시작

    @commands.Cog.listener()
    async def on_ready(self) -> None:
        print(f"{self.__class__.__name__} Cog is ready.")

    @tasks.loop(seconds=10)
    async def test_task(self) -> None:
        channel_id: int = 0
        channel = self.bot.get_channel(channel_id)
        if channel:
            await channel.send("10초마다 실행되는 작업이에요~")

    @test_task.before_loop
    async def before_test_task(self) -> None:
        await self.bot.wait_until_ready()


# Cog 등록 함수
async def setup(bot: commands.Bot):
    await bot.add_cog(TaskCommand(bot=bot))

# 봇 준비 이벤트
@bot.event
async def on_ready() -> None:
    ...
    activity = discord.Game(name="게임") # 또는 discord.Activity(type=discord.ActivityType.watching, name="YouTube")
    await bot.change_presence(status=discord.Status.online, activity=activity)

import discord
from discord.ext import commands
from discord import app_commands, ButtonStyle
from discord.ui import Button, View


class ButtonView(View):
    def __init__(self) -> None:
        super().__init__()

    @discord.ui.button(label="button1", style=ButtonStyle.green, custom_id="button1")
    async def button_callback1(
        self, interaction: discord.Interaction, button: discord.ui.Button
    ) -> None:
        button.callback = self.button_callback1
        await interaction.response.send_message(content="버튼1 클릭됨")

    @discord.ui.button(label="button2", style=ButtonStyle.green, custom_id="button2")
    async def button_callback2(
        self, interaction: discord.Interaction, button: discord.ui.Button
    ) -> None:
        button.callback = self.button_callback2
        await interaction.response.send_message(content="버튼2 클릭됨")


class ButtonSet(commands.Cog):
    def __init__(self, bot: commands.Bot):
        super().__init__()
        self.bot = bot

    @commands.Cog.listener()
    async def on_ready(self) -> None:
        print(f"{self.__class__.__name__} Cog is ready.")

        channel_id: int = 0
        channel = self.bot.get_channel(channel_id)
        if channel:
            await channel.send("버튼을 클릭해보세요.", view=ButtonView())


# Cog 등록 함수
async def setup(bot: commands.Bot):
    await bot.add_cog(ButtonSet(bot=bot))

import discord
from discord.ui import Modal, TextInput
from discord.ext import commands
from discord import app_commands


class MyModal(Modal):
    def __init__(self) -> None:
        super().__init__(title="Form Test")
        self.name = TextInput(label="이름", placeholder="당신의 이름을 입력하시오.")
        self.age = TextInput(label="나이", placeholder="당신의 나이를 입력하시오.")
        self.add_item(self.name)
        self.add_item(self.age)

    async def on_submit(self, interaction: discord.Interaction) -> None:
        await interaction.response.send_message(
            f"이름: {self.name.value}, 나이: {self.age.value}"
        )

class FormCommand(commands.Cog):
    def __init__(self, bot: commands.Bot) -> None:
        super().__init__()
        self.bot = bot

    @commands.Cog.listener()
    async def on_ready(self) -> None:
        print(f"{self.__class__.__name__} Cog is ready.")

    @app_commands.command(
        name="form", description="Form를 테스트하기 위한 명령어입니다."
    )
    async def test_form(self, interaction: discord.Interaction):
        await interaction.response.send_modal(MyModal())


# Cog 등록 함수
async def setup(bot: commands.Bot):
    await bot.add_cog(FormCommand(bot=bot))

@discord.app_commands.command(name="secret")
async def secret_message(interaction: discord.Interaction):
    await interaction.response.send_message("이 메시지는 당신에게만 보입니다.", ephemeral=True)

@commands.command(name="tempmsg")
async def temp_message(ctx):
    await ctx.send("이 메시지는 5초 후에 삭제됩니다.", delete_after=5)

class Button(commands.Cog):
    def __init__(self, bot: commands.Bot):
        super().__init__()
        self.bot = bot

    @commands.Cog.listener()
    async def on_ready(self) -> None:
        print(f"{self.__class__.__name__} Cog is ready.")
        channel_id: int = 0

        # 체널 가져오기
        channel = self.bot.get_channel(channel_id)

        # 채널 메시지 전송하기
        if channel:
            # 채널의 최근 메시지 삭제하기
            try:
                async for message in channel.history(limit=3):
                    await message.delete()
            except discord.Forbidden:
                print("Bot lacks permission to delete message.")
            except discord.HTTPException as e:
                print(f"Failed to delete message: {e}")

            # 메시지 전송
            await channel.send("거래소 관련 채널입니다.", view=MarketButtonView())
        else:
            print(f"{self.__class__.__name__}: Channel Error")

# Cog 등록 함수
async def setup(bot: commands.Bot):
    await bot.add_cog(Button(bot=bot))

import discord
from discord.ext import commands

class General(commands.Cog):
    def __init__(self, bot) -> None:
        self.bot = bot

    # ctx 매개변수 타입 확인을 위해 /hello 입력 시 타입이 출력되도록 코드 수정
    @commands.command()
    async def hello(self, ctx) -> None:
        print(f"ctx -> {type(ctx)})

    # echo 명령어
    @commands.command()
    async def echo(self, ctx, *, content: str) -> None:
        await ctx.send(content)

# Cog를 등록하는 함수
async def setup(bot) -> None:
    await bot.add_cog(General(bot))

봇이 실행되었음: DevBot#0737
General is going ...
<discord.ext.commands.context.Context object at 0x000001D175995040> # 출력된 ctx 매개변수의 타입

import discord
from discord.ext import commands


class General(commands.Cog):
    ...
    @commands.command()
    async def hello(self, ctx: commands.Context) -> None:
        ctx.send(f"안녕하세요, {ctx.author.name}님!")
    ...