GitHub

동기

최근 매우 핫해진 Clawdbot, Moltbot, OpenClaw에서 내가 제일 마음에 드는 기능은 디스코드 채널을 통해 내가 쓰는 에이전트에 접근할 수 있다는 점이다. 나도 설치해서 사용 해 봤지만, Claude Code가 아닌 OpenClaw 에이전트를 사용하게 된다. Claude Code의 강점인 Hook, Subagents, Agent Teams 같은 기능들을 또 포기하고 싶지도 않다.

사실 항상 디스코드를 사용해서 실험을 수행한다기 보다는, 서버에서 실험을 돌려놓고 자리를 비울 때, 경과나 결과가 나오면 바로 알고 싶다는 쪽이 더 나에게 맞다고 생각된다. 연구 워크플로우의 중심이 Claude Code로 옮겨간 지금은 Claude Code 안에서 “지금 돌아가는 실험이 끝나면 결과를 디스코드로 보내줘” 한마디면 되는 게 이상적이다.

그래서 Claude Code의 Discord webhook 기반 알림 skill을 만들었다.

주요 기능

  • 텍스트 메시지 — Markdown 지원
  • Rich Embed — 제목, 설명, 색상, 필드, 타임스탬프
  • 파일 첨부 — 최대 10개, 각 25MB
  • Raw JSON — Discord webhook API 전체 접근
  • Session Handoff — Claude Code CLI 세션을 Discord 봇에 넘기기
  • 커스텀 봇 이름/아바타, 스레드 지원

사용법

Claude Code 안에서

자연어로 요청하면 자동으로 /sc:discord skill이 호출된다:

"디스코드로 결과 보내줘"
"학습 곡선 이미지 디스코드에 공유해"
"이 세션 디스코드 봇한테 넘겨줘"

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을 만들어 입력하면 끝이다.