Claude Code 채널을 로컬에 설정하는 방법

섹션별 상세

Claude Code Channels는 로컬 세션이 활성화된 상태에서만 작동하는 경량화된 채팅 연동 방식이다. 별도의 복잡한 에이전트 프레임워크 설치 없이도 Claude 구독 계정을 통해 디스코드에서 모델과 직접 소통할 수 있는 환경을 제공한다.

근거

Claude Code Channels는 로컬 Claude Code 세션이 실행 중일 때만 작동한다. — Introduction 섹션 및 Final Notes

설치를 위해 PowerShell에서 Claude Code를 먼저 구성한 후, 플러그인 실행에 필요한 Bun 런타임을 추가로 설치해야 한다. 이후 Claude Code 내부 명령어를 통해 공식 플러그인 마켓플레이스를 추가하고 디스코드 전용 플러그인을 설치 및 로드하는 과정을 거친다.

디스코드 개발자 포털에서 봇 애플리케이션을 생성하고 Message Content Intent를 반드시 활성화해야 한다. 이 설정이 누락되면 봇이 메시지 내용을 읽지 못해 응답하지 않으므로, 적절한 OAuth2 권한 부여와 함께 봇을 서버에 초대하는 과정이 필수적이다.

근거

디스코드 봇이 메시지를 읽으려면 Message Content Intent 활성화가 필수적이다. — Creating and Configuring Your Discord Bot 섹션

설정된 봇 토큰을 Claude Code에 등록한 후 '--channels' 플래그를 사용하여 세션을 다시 시작해야 연동이 시작된다. 매번 도구 사용 승인을 묻는 번거로움을 피하려면 '--dangerously-skip-permissions' 옵션을 사용할 수 있으나, 이는 보안상 신뢰할 수 있는 환경에서만 권장된다.

최종적으로 디스코드 DM을 통해 받은 페어링 코드를 Claude Code에 입력하여 계정을 연결하고 접근 정책을 설정한다. allowlist 정책을 적용하면 승인된 사용자만 봇을 사용할 수 있도록 제한하여 로컬 세션의 보안을 유지할 수 있다.

기술

Claude Code
Bun
Discord API
PowerShell

활용 사례

디스코드를 통한 원격 코딩 보조
개인용 AI 비서 구축
로컬 LLM 세션의 채팅 인터페이스 확장

언급된 리소스

문서Claude Code Installation

문서Bun Installation