사용 기록
써 본 날2026-10-24
써 본 것디스코드 웹훅 + 클로드 코드(터미널에서 쓰는 클로드)
비용웹훅은 무료, 클로드 코드는 클로드 유료 구독이나 API 사용료
설치추가 설치 없음 (맥에 있던 파이썬 3, 표준 라이브러리만)
만든 것임베드 알림 보내기, 웹훅 이름·프사 바꾸기, 맥이 정해진 시각에 혼자 보내기
난이도터미널 조금
한 줄 결론웹훅은 채널 설정에서 몇 번 눌러 만들어요. 파이썬 urllib 기본 요청은 403(1010)으로 막혔고, User-Agent 이름표를 붙이자 통과했어요. 주소는 비밀번호처럼 다뤄야 해요.
10월 24일, 디스코드 시험 채널 하나에 웹훅을 만들고 클로드 코드에 알림을 맡겨 봤어요. 클로드 코드는 터미널에서 쓰는 클로드예요. 원하는 걸 말로 시키면 코드를 짜고 직접 실행까지 해요. 저는 원래 일하면서 생기는 알림을 이 방식으로 디스코드에 받고 있어요. 이번에는 같은 걸 빈 채널에서 처음부터 다시 해 보면서 순서를 기록했습니다.

웹훅은 어디서 만드나요?
웹훅은 바깥 프로그램이 디스코드 채널에 글을 올릴 수 있게 해 주는 주소예요. 봇을 따로 만들 필요가 없어서 알림 용도로 쓰기 쉬워요.
- 디스코드에서 알림을 받을 채널을 만들어요. 저는 “알림-시험”이라는 비공개 채널을 만들었어요
- 채널 이름 옆 톱니바퀴(채널 편집)를 눌러요
- 왼쪽 메뉴에서 ‘연동’을 고르고 ‘웹후크 만들기’를 눌러요
- 생긴 웹훅을 펼쳐 이름을 정해요. 저는 “알림봇”으로 했어요
- ‘웹후크 URL 복사’를 눌러요

복사한 주소는 비밀번호처럼 다뤄야 해요. 이 주소만 있으면 누구나 그 채널에 글을 올릴 수 있거든요. 그래서 코드에 그대로 적지 않고 맥의 키체인(비밀번호 보관함)에 넣었어요. 그러면 깃허브에 코드를 올려도 코드에는 주소가 없어요.
웹훅 주소를 키체인에 넣는 명령 (맥OS)
security add-generic-password -U -s my-webhook -a webhook -w '복사한 웹훅 주소'
클로드 코드에 뭐라고 시켰나요?
저는 대화로 몇 번에 나눠 시켰어요. 그 내용을 한 번에 붙여 넣을 수 있게 정리하면 이래요. 이 문장 그대로 넣어 본 건 아니에요. 이 프롬프트를 쓰면 클로드 코드가 내 컴퓨터에 파일을 만들고 예약 작업을 등록해요.
그대로 붙여 넣는 프롬프트 (맥OS, 클로드 코드, 2026-10-24)
디스코드 웹훅으로 알림을 보내는 파이썬 스크립트를 만들어 줘. - 웹훅 주소는 맥 키체인의 my-webhook 에서 읽고, 코드나 파일에 주소를 적지 마 - 표준 라이브러리만 써 줘 - 메시지는 임베드(제목, 내용, 색, 작은 칸 2개)로 보내 줘 - 웹훅 이름을 "알림봇"으로 바꾸고, 프사는 종 모양 그림을 하나 만들어서 API로 바꿔 줘 - 마지막으로 매일 저녁 8시에 맥이 혼자 이 알림을 보내게 걸어 줘 시험으로 한 번씩 실제로 보내 보고 결과를 알려 줘.
왜 403이 나나요?
파이썬 표준 라이브러리(urllib)로 웹훅에 글을 보내는 가장 단순한 코드를 그대로 돌리면 실패해요. 디스코드가 “403, error code: 1010″을 돌려주거든요. 403은 “거절”이라는 뜻이에요. 주소도 맞고 내용도 맞는데 막히는 겁니다.
갈린 건 요청에 붙는 이름표(User-Agent)였어요. 파이썬 urllib은 따로 정하지 않으면 “Python-urllib/버전” 이름표를 붙여 보내요. 이 상태로는 막혔어요. 이름표를 디스코드 공식 문서가 안내하는 “DiscordBot (주소, 버전)” 모양으로 바꾸자 통과했어요. 클로드 코드에 같은 주소로 두 번 보내 비교하게 한 결과예요.
같은 웹훅에 이름표만 바꿔 보낸 결과 (2026-10-24)
이름표 기본(Python-urllib) → 403 error code: 1010 이름표 DiscordBot (주소, 1.0) → 204 (성공, 채널에 글이 올라옴)
성공인데 204가 나오는 게 처음엔 낯설 수 있어요. 204는 “잘 받았고 돌려줄 내용은 없다”는 뜻이라 정상입니다.
임베드는 어떻게 생겼나요?
그냥 글자만 보내도 되지만, 저는 알림을 임베드로 받아요. 제목과 칸이 나뉘어서 눈에 잘 들어오거든요. 임베드는 위 사진처럼 왼쪽에 색 줄이 있는 카드예요. 제목, 내용, 색, 그리고 작은 칸(필드) 몇 개로 이뤄져요. 색은 16진수 색 번호를 숫자로 넣어요. 저는 초록(1F7A4D)으로 했어요.
클로드 코드가 만든 스크립트의 핵심은 이 부분이에요. 키체인에서 주소를 읽고, 임베드를 만들고, 이름표를 붙여 보냅니다. 파일 맨 위의 import(json, subprocess, urllib.request)와 실행 부분은 뺐어요.
notify.py 핵심 부분 (파이썬 3, 표준 라이브러리만)
def webhook_url():
out = subprocess.run(["security", "find-generic-password", "-s", "my-webhook", "-w"],
capture_output=True, text=True)
return out.stdout.strip()
def send(title, desc, color=0x1F7A4D, fields=()):
body = {"embeds": [{"title": title, "description": desc, "color": color,
"fields": [{"name": n, "value": v, "inline": True} for n, v in fields]}]}
req = urllib.request.Request(webhook_url(), data=json.dumps(body).encode(), method="POST",
headers={"Content-Type": "application/json",
"User-Agent": "DiscordBot (https://example.com, 1.0)"})
with urllib.request.urlopen(req, timeout=15) as r:
return r.status웹훅 프사도 코드로 바뀌나요?
바뀌어요. 웹훅 주소에 PATCH 요청으로 이름과 그림을 보내면 돼요. 그림은 파일을 base64로 바꿔 “data:image/png;base64,…” 모양 글자로 넣어요. 클로드 코드가 초록 바탕에 종을 그린 512px 그림을 만들어 바꿨고, 응답으로 200과 바뀐 이름 “알림봇”이 왔어요.
다만 채널 화면에서 새 프사는 아직 못 봤어요. 디스코드는 같은 보낸 사람이 잇달아 보낸 메시지를 한 덩어리로 묶어서 보여 줘요. 프사를 바꾼 뒤 보낸 알림들이 앞 메시지 아래에 붙어서, 위 사진처럼 처음 메시지의 기본 프사만 보였습니다.
정해진 시각에 혼자 보내게 하려면?
맥에서는 launchd를 써요. 맥에 원래 들어 있는 예약 실행 장치예요. “매일 몇 시 몇 분에 이 명령을 실행해”라는 설정 파일(plist)을 ~/Library/LaunchAgents 폴더에 넣고 등록하면 돼요. 시각은 맥에 설정된 시간대 기준이에요.
launchd 설정 핵심 부분과 등록·해제 명령 (맥OS, 설정 파일 일부)
<key>ProgramArguments</key> <array> <string>/usr/bin/python3</string> <string>/Users/나/alert/notify.py</string> </array> <key>StartCalendarInterval</key> <dict><key>Hour</key><integer>20</integer><key>Minute</key><integer>0</integer></dict> launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.example.alert.plist launchctl bootout gui/$(id -u)/com.example.alert
이번에는 확인하려고 2분 뒤 시각으로 걸어 봤어요. 그 시각에 알림이 혼자 왔고, 응답은 204였어요. 확인한 뒤 시험용 예약은 bootout 명령으로 풀고 설정 파일도 지웠어요. 시각을 바꾸려면 풀고, 설정 파일을 고치고, 다시 등록하면 돼요.
맥이 잠들어 있을 때는 어떻게 될까요? 맥 설명서(man launchd.plist)에 따르면 이 시각 예약은 잠든 사이 시각이 지나면 깨어날 때 실행해요. 여러 번 놓쳤으면 한 번으로 합쳐서 실행하고요. 맥이 꺼져 있을 때는 당연히 못 보내요.
클로드 코드 안에도 예약 기능이 있긴 해요. 그런데 그건 그 대화 세션 안에서만 살아 있어요. 세션을 닫거나 맥을 다시 켜면 사라지거든요. 그래서 저는 매일 오는 작업 알림을 맥 자체의 예약(launchd)으로 옮겼어요.
윈도우라면 어디가 달라지나요?
윈도우라면 이렇게 하면 될 거예요. 웹훅 만들기, 403 이름표, 임베드, 프사 바꾸기는 운영체제와 상관없이 같아요. 달라지는 건 두 곳이에요.
첫째는 주소 보관함이에요. 윈도우에는 security 명령이 없어요. 대신 파이썬 keyring 라이브러리를 쓰면 윈도우에서는 자격 증명 관리자에, 맥에서는 키체인에 넣어 줘요. 같은 코드가 양쪽에서 돌아가는 셈이에요. 이건 pip로 따로 깔아야 해요.
윈도우에서 주소 보관 (파이썬 keyring)
pip install keyring
import keyring
keyring.set_password("my-webhook", "webhook", "복사한 웹훅 주소") # 한 번만
url = keyring.get_password("my-webhook", "webhook") # 스크립트에서 읽기둘째는 정해진 시각 실행이에요. 맥의 launchd 자리에 윈도우는 작업 스케줄러가 있어요. 명령 프롬프트에서 schtasks 한 줄로 걸고, 한 줄로 지워요. 예약 실행에서는 python 명령을 못 찾는 경우가 있어서, python.exe 전체 경로를 적는 편이 안전해요.
윈도우 작업 스케줄러 등록·삭제
schtasks /create /tn "디스코드 알림" /sc daily /st 20:00 /tr "C:경로python.exe C:alertnotify.py" schtasks /delete /tn "디스코드 알림" /f
컴퓨터가 잠들어 있다가 시각을 놓친 경우는 맥과 다르게 기본으로 다시 실행하지 않아요. 작업 스케줄러 화면에서 그 작업의 설정 탭을 열고 “예약된 시작 시간을 놓친 경우 가능한 대로 빨리 작업 시작”을 켜 두면 될 거예요.
써 보니 어땠나요?
웹훅 만들기는 디스코드 화면에서 1분이면 끝나요. 코드 쪽에서 막힐 만한 곳은 403 하나였어요. 제가 한 일은 채널을 만들고 주소를 건네고, 결과 화면을 확인한 것뿐이에요. 스크립트, 프사 그림, 예약 등록, 시험 발송은 클로드 코드가 했어요.
다만 주소 관리는 사람이 챙겨야 해요. 저는 주소를 디스코드 대화창에 붙여 넣어 클로드 코드에 건넸어요. 편하긴 한데, 대화 기록에 주소가 남아요. 메시지를 지워도 다른 곳에 기록이 남았을 수 있으니, 시험이 끝나면 채널 설정에서 그 웹훅을 지우고 새로 만들어 쓰는 쪽이 확실해요.
함께 읽을 글
2026년 10월 24일 기준.
참고한 자료