Claude Code 서버 설정 가이드 — 텔레그램 & 디스코드 통합본
🤖
Claude Code의 server 기능은 터미널의 Claude Code 세션을 텔레그램/디스코드 봇 으로 연결합니다. 모바일이나 다른 기기에서 봇을 통해 Claude와 대화하고, 파일 전송, 코드 실행 등 모든 Claude Code 기능을 원격으로 사용할 수 있습니다.
—channel
옵션으로 텔레그램과 디스코드를 동시에 연결 할 수 있으며, 각 플랫폼의 특성에 따라 사용 시나리오가 달라집니다.
| 텔레그램 | 디스코드 | |
|---|---|---|
| 봇 간 메시지 | ❌ 수신 불가 | ✅ 수신 가능 |
| 제약 위치 | 서버 사이드 (우회 불가) | 클라이언트 사이드 (설정으로 해제 가능) |
| 상세 | Privacy mode 해제, 관리자 권한과 무관하게 “all messages except messages sent by other bots” 만 수신 | message.author.bot 플래그로 봇 메시지 식별 가능. Message Content Intent가 있으면 내용까지 읽을 수 있음 |
| 출처 | Telegram Bots FAQ | http://discord.py/ #6579 |
실제 예시: 루돌프(Rudolph 봇)와 엣지(Edge 봇)가 디스코드 그룹에서 @멘션으로 서로 대화 가능. 텔레그램에서는 같은 그룹에 있어도 봇끼리 소통 불가.
| 텔레그램 | 디스코드 | |
|---|---|---|
| 히스토리 조회 | ❌ 도구 없음 — 도착한 메시지만 실시간 처리 | ✅ fetch_messages 로 채널 히스토리 최대 100개 조회 |
| 텔레그램 | 디스코드 | |
|---|---|---|
| 메커니즘 | Privacy Mode (기본 ON) | Gateway Intents 시스템 |
| 동작 | 봇은 /command , @mention , reply만 수신. 관리자 봇은 모든 메시지 수신 (다른 봇 제외). 변경 후 봇 제거→재추가 필요 | Message Content Intent 없으면 메시지 본문이 빈 문자열로 수신됨. 100서버 이상 봇은 Intent 심사 필요 |
| 텔레그램 | 디스코드 | |
|---|---|---|
| 글자 수 제한 | 4,096자 | 2,000자 |
| 파일 크기 | 최대 50MB | 최대 25MB, 한 번에 10개 |
| 파일 처리 | 이미지(.jpg/.png/.gif/.webp) 자동 미리보기, 그 외 문서로 전송 | download_attachment 도구로 수신 파일 다운로드 가능 |
| 텔레그램 | 디스코드 | |
|---|---|---|
| 권한 모델 | Binary Permission (14개 비트 on/off). RBAC 없음. 샌드박스 격리 | RBAC. 역할 생성 → 권한 부여 → 봇 할당. Server → Category → Channel → User 계층적 오버라이드 |
| 이모지 | 고정 화이트리스트 (약 70개) | 유니코드 + 커스텀 모두 사용 가능 |
| 구분 | 도구 |
|---|---|
| 공통 | reply , edit_message , react |
| 디스코드 전용 | fetch_messages (최대 100개 히스토리), download_attachment (첨부파일 다운로드) |
텔레그램은 순수 이벤트 드리븐 모델 (도착 순간만 반응)
디스코드는 능동적 조회 가능
💬
1:1 대화, 긴 응답 → 텔레그램 (4,096자, 모바일 UX 우수)
🔗
봇 간 협업, 히스토리 조회 → 디스코드 (bot-to-bot 지원, fetch_messages)
📱
모바일 활용 → 텔레그램·디스코드 모두 모바일 앱이 잘 되어 있어 이동 중에도 Claude와 대화 가능. 특히 음성 입력(STT)으로 타이핑 없이 프롬프트를 보내거나, 이미지·파일 등 멀티모달 입력 도 모바일에서 바로 전송할 수 있어 활용도가 크게 올라갑니다.
⚡
둘 다 →
—channel telegram —channel discord
옵션으로 동시 연결 가능
매번
—channel telegram —channel discord
를 입력하기 번거롭다면, bash alias를 만들어두면 편리 합니다. 아래는 추천 예시입니다.
alias server=‘claude —model opus —context 1m —skip-permissions —channel telegram —channel discord’
| 추천 alias 예시 | 설명 |
|---|---|
| server | 텔레그램 + 디스코드 동시 연결. 모델·컨텍스트·권한 등 옵션을 한 번에 지정 |
| server mybot | 세션 이름을 인자로 받도록 확장 (예: sv-HHMM 형식) |
