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

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

Claude Code Channels는 무거운 에이전트 프레임워크 없이도 Claude를 디스코드와 같은 채팅 플랫폼에 연결할 수 있는 실용적인 도구이다. 이 방식은 로컬에서 실행 중인 Claude Code 세션을 기반으로 작동하며, 사용자의 Claude Pro 또는 Max 구독을 그대로 활용한다. 본 가이드는 Bun 설치부터 디스코드 봇 생성, 토큰 설정 및 계정 페어링에 이르는 전체 워크플로를 상세히 다룬다. 이를 통해 개발자는 로컬 환경의 강력한 코딩 에이전트를 익숙한 채팅 인터페이스에서 원격으로 제어할 수 있게 된다.

배경

Claude Code 설치 완료, Claude Pro 또는 Max 구독 계정, 디스코드 계정 및 데스크톱 앱, Windows 11, Linux 또는 macOS 환경

대상 독자

Claude Code를 채팅 인터페이스로 확장하려는 개발자 및 AI 에이전트 사용자

의미 / 영향

이 기술은 고가의 API 비용 대신 기존 LLM 구독 서비스를 활용하여 개인용 AI 코딩 에이전트를 구축할 수 있게 합니다. 특히 복잡한 인프라 없이도 로컬 컴퓨팅 파워와 채팅 UI를 결합할 수 있어 개인 개발자의 생산성 도구로 활용도가 높습니다.

섹션별 상세

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

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

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

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

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

실무 Takeaway

디스코드 봇 설정 시 Message Content Intent를 활성화하지 않으면 봇이 빈 메시지만 수신하게 되므로 반드시 체크해야 한다.
Claude Code를 실행할 때 '--channels' 플래그를 명시해야만 디스코드 플러그인이 활성화되며, 로컬 터미널을 종료하면 봇도 함께 오프라인이 된다.
보안을 위해 '/discord:access policy allowlist' 명령어를 사용하여 승인된 사용자만 로컬 Claude 세션에 접근할 수 있도록 제한하는 것이 중요하다.

언급된 리소스

문서Claude Code Installation

문서Bun Installation