claudecode-discord - 디스코드에서 Claude Code를 원격 제어하는 멀티머신 에이전트 허브

Claude Code를 터미널 앞에 앉아 있지 않아도 사용할 수 있다면 어떨까요? claudecode-discord는 디스코드 봇을 통해 모바일에서도 Claude Code를 원격 제어할 수 있게 해주는 오픈소스 프로젝트입니다. 별도의 API 키 없이 기존 Claude Pro/Max 구독만으로 작동하며, 여러 머신을 하나의 디스코드 서버에서 관리할 수 있는 멀티머신 에이전트 허브 역할을 합니다.

공식 원격 제어와의 차이점

Anthropic에서 제공하는 공식 원격 제어 기능도 있지만, claudecode-discord는 몇 가지 중요한 차별점을 제공합니다.

핵심 아키텍처와 보안

claudecode-discord의 아키텍처는 디스코드 채널 = 프로젝트 디렉토리라는 직관적인 매핑 구조를 사용합니다. 각 채널에 독립적인 Claude 세션이 할당되며, 프로젝트별로 격리된 환경에서 작업할 수 있습니다.

보안 측면에서 가장 주목할 점은 아웃바운드 WebSocket만 사용한다는 것입니다. 인바운드 리스너가 없으므로 외부 공격자가 이 봇에 도달할 수 있는 네트워크 경로 자체가 존재하지 않습니다. 추가로 다음과 같은 보안 장치를 제공합니다.

• 사용자 화이트리스트 — ALLOWED_USER_IDS로 접근 가능한 디스코드 사용자를 제한
• 경로 탐색 차단 — 프로젝트 디렉토리 외부 접근 방지
• 실행 파일 필터링 — 위험한 파일 유형 업로드 차단
• 도구 승인 시스템 — 각 도구 사용 시 버튼을 통한 개별 승인/거부
• 첨부파일 크기 제한 — 25MB 상한

주요 기능과 명령어

디스코드 슬래시 명령어로 Claude Code의 모든 기능을 제어할 수 있습니다.

일반 채팅 메시지를 입력하면 Claude Code에 직접 전달되며, 파일 첨부도 지원합니다. 도구 사용이 필요한 경우 디스코드 버튼으로 승인/거부를 선택할 수 있어, 모바일에서도 안전하게 AI 코딩 작업을 관리할 수 있습니다.

기술 스택

설치 방법

플랫폼별 원클릭 설치 스크립트를 제공합니다.

macOS / Linux

git clone https://github.com/chadingTV/claudecode-discord.git
cd claudecode-discord
./install.sh

Windows

git clone https://github.com/chadingTV/claudecode-discord.git
cd claudecode-discord
./install.bat

설치 후 디스코드 봇 토큰과 ALLOWED_USER_IDS를 환경변수로 설정하면 바로 사용할 수 있습니다. 상세한 설정 가이드는 각 플랫폼별로 SETUP.md(macOS/Linux) 또는 SETUP-WINDOWS.md(Windows)에 정리되어 있습니다.

실전 활용 시나리오

주의사항과 요구사항

데몬 모드로 실행하면 터미널을 닫아도 백그라운드에서 계속 작동합니다. macOS, Windows, Linux 모두 네이티브 트레이 앱을 지원하여 시스템 트레이에서 봇 상태를 확인하고 관리할 수 있습니다.

GitHub 저장소:https://github.com/chadingTV/claudecode-discord | 라이선스: MIT (상업적 사용 가능, 출처 표기 필요)