동기
최근 매우 핫해진 OpenClaw(구 Clawdbot, Moltbot)에서 내가 제일 마음에 드는 기능은 디스코드 채널을 통해 내가 쓰는 에이전트에 접근할 수 있다는 점이다. 나도 설치해서 써 봤는데, 결국 Claude Code가 아니라 OpenClaw 에이전트를 쓰게 된다. 그렇다고 Hooks, Subagents, Agent Teams 같은 Claude Code의 강점을 포기하고 싶지는 않았다.
사실 나는 디스코드로 실험을 직접 돌리고 싶다기보다는, 서버에 실험을 걸어 두고 자리를 비웠을 때 경과나 결과를 바로 받아보고 싶은 쪽에 가깝다. 연구 워크플로우의 중심이 Claude Code로 옮겨간 지금은 Claude Code 안에서 “지금 돌아가는 실험이 끝나면 결과를 디스코드로 보내줘” 한마디면 되는 게 이상적이다.
그래서 Discord webhook으로 알림을 보내는 Claude Code skill을 만들었다.
주요 기능
- 텍스트 메시지 — Markdown 지원
- Rich Embed — 제목, 설명, 색상, 필드, 타임스탬프
- 파일 첨부 — 최대 10개, 각 25MB
- Raw JSON — Discord webhook API 전체 접근
- Session Handoff — Claude Code CLI 세션을 Discord 봇에 넘기기
- 커스텀 봇 이름/아바타, 스레드 지원
사용법
Claude Code 안에서
자연어로 요청하면 자동으로 /sc:discord skill이 호출된다:
"디스코드로 결과 보내줘"
"학습 곡선 이미지 디스코드에 공유해"
"이 세션 디스코드 봇한테 넘겨줘"
Session Handoff는 현재 세션의 최근 대화를 요약해 Discord로 보내고, 세션 정보를 ~/.claude/last-handoff.json에 남긴다. Discord 쪽에서 이 세션을 이어받으려면 이 파일을 읽는 봇이 따로 있어야 한다.
CLI에서 직접
# 텍스트
discord-notify "Hello world"
# 임베드
discord-notify --embed "실험 완료" "Accuracy: 87.3%" 5793266
# 파일 첨부
discord-notify --file ./loss_curve.png "학습 결과"
# 여러 파일
discord-notify --files loss.png acc.csv -- "전체 결과"
# 파이프 입력
cat results.txt | discord-notify
ML 실험 결과 예시
discord-notify --name "Lab Bot" --rich '{
"embeds": [{
"title": "Experiment Complete",
"color": 5793266,
"fields": [
{"name": "Model", "value": "ResNet-50", "inline": true},
{"name": "Accuracy", "value": "87.3 ± 0.2%", "inline": true},
{"name": "Baseline", "value": "85.1%", "inline": true}
],
"footer": {"text": "seeds: 42,43,44 | p < 0.01"}
}]
}'
설치
git clone https://github.com/JunhyunB/claude-skill-discord.git
cd claude-skill-discord
./install.sh
Discord 서버 설정에서 webhook URL을 만든 뒤, 설치 과정에서 입력하면 끝이다.