discord

Discord Webhook Messaging

Claude Code에서 Discord webhook으로 메시지·embed·파일을 보내는 skill. CLI 의존성 없이 curl + jq 만 사용.

When to use

사용자가 다음과 같이 요청할 때:

• "디스코드로 보내", "디스코드에 공유해", "Discord에 알려"
• "이 그래프/사진/결과 디스코드로 보내"
• "실험 결과 디스코드로 정리해서 보내"
• "이 파일 디스코드 채널에 올려"

Prerequisite

~/.claude/discord-webhook.env 파일에 webhook URL 저장:

echo 'DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/ID/TOKEN' > ~/.claude/discord-webhook.env
chmod 600 ~/.claude/discord-webhook.env

설치 후 처음 실행 시 파일이 없다면 사용자에게 webhook URL 요청.

Patterns

모든 명령은 먼저 source ~/.claude/discord-webhook.env 로 URL 로드.

1. 텍스트 메시지 (단순 알림)

source ~/.claude/discord-webhook.env
curl -s -X POST "$DISCORD_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg c "메시지 내용" '{content: $c}')"

2. 단일 파일 첨부 (이미지·CSV·로그)

source ~/.claude/discord-webhook.env
curl -s -X POST "$DISCORD_WEBHOOK_URL" \
  -F 'payload_json={"content":"학습 결과 그래프"}' \
  -F "file1=@/absolute/path/to/loss_curve.png"

3. 다중 파일 첨부 (최대 10개)

source ~/.claude/discord-webhook.env
curl -s -X POST "$DISCORD_WEBHOOK_URL" \
  -F 'payload_json={"content":"실험 결과 묶음"}' \
  -F "file1=@/path/loss.png" \
  -F "file2=@/path/accuracy.csv" \
  -F "file3=@/path/confusion_matrix.png"

4. ML 실험 결과 (rich embed — 권장)

여러 metric을 inline field로 보기 좋게:

source ~/.claude/discord-webhook.env
curl -s -X POST "$DISCORD_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d "$(jq -n \
    --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
    '{
      embeds: [{
        title: "✅ Experiment Done",
        color: 5793266,
        fields: [
          {name: "🧪 Experiment", value: "Baseline vs Ours ablation", inline: false},
          {name: "📊 PSNR (train)", value: "29.8", inline: true},
          {name: "📊 PSNR (eval)", value: "28.1", inline: true},
          {name: "📊 LPIPS", value: "0.14", inline: true},
          {name: "💡 Finding", value: "Loss term X improves eval PSNR by +0.7", inline: false}
        ],
        footer: {text: "8/8 runs OK · 760s · 1× A100"},
        timestamp: $ts
      }]
    }')"

5. 단순 embed (제목 + 설명)

여러 줄 필요 없을 때만 사용. \n 줄바꿈 안 되니 multi-line 결과는 항상 #4 패턴 사용.

source ~/.claude/discord-webhook.env
curl -s -X POST "$DISCORD_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg t "제목" --arg d "한 줄 설명" \
    '{embeds: [{title: $t, description: $d, color: 5793266}]}')"

6. embed + 파일 동시 전송

source ~/.claude/discord-webhook.env
PAYLOAD=$(jq -n --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
  '{embeds: [{
    title: "✅ Result with image",
    color: 5793266,
    fields: [{name: "PSNR", value: "29.8", inline: true}],
    image: {url: "attachment://render.png"},
    timestamp: $ts
  }]}')
curl -s -X POST "$DISCORD_WEBHOOK_URL" \
  -F "payload_json=$PAYLOAD" \
  -F "file1=@/path/to/render.png"

Color codes (decimal)

상황	색상	값
성공 / 완료	초록	5793266
실패 / 에러	빨강	15548997
정보	파랑	3447003
실험 / 분석	보라	7506394
경고	주황	15105570

Limits

• 메시지 content: 2,000자
• Embed description: 4,096자
• 파일 크기: 25MB (Nitro boost 서버: 100MB)
• 파일 수: 메시지당 10개
• Embed 수: 메시지당 10개
• Rate limit: 5/sec, 30/min

Behavioral notes

1. 첨부 파일 경로는 항상 절대경로 사용 (/Users/creamnuts/...)
2. multi-line 결과는 무조건 rich embed의 fields 사용. --embed 단순 패턴은 \n 렌더링 안 됨
3. 민감 정보 (token, password) 절대 송신 금지 — webhook URL은 공개 채널 가능성 있음
4. 전송 후 사용자에게 결과 보고 ("디스코드 채널에 전송 완료" 등)
5. webhook URL이 없으면 먼저 ~/.claude/discord-webhook.env 생성 안내