Claude Code Channels는 Discord 같은 채팅 플랫폼에서 로컬 Claude Code 세션에 직접 메시지를 주고받는 공식 통합 기능이다. OpenClaw 같은 별도 에이전트 프레임워크보다 간단하게 시작할 수 있으며, Claude.ai 구독만 있으면 된다. 핵심은 봇이 로컬 Claude Code 세션이 실행 중인 동안에만 동작한다는 점이다.

사전 요구 사항

• Claude Code 설치됨
• Claude.ai Pro 또는 Max 구독 (API 키 단독 인증은 지원하지 않음)
• Discord 계정 및 데스크탑 앱

1단계: Claude Code 설치 및 로그인

Windows PowerShell에서 Claude Code를 설치한다 (macOS·Linux는 npm 또는 공식 문서 참조):

irm https://claude.ai/install.ps1 | iex

작업 폴더를 만들고 Claude Code를 시작한 뒤 claude.ai 계정으로 로그인한다:

mkdir my-channels
cd my-channels
claude
/login

/login 단계는 Channels가 동작하기 위해 반드시 필요하다.

2단계: Bun 설치

공식 Channels 플러그인은 Bun 런타임을 사용한다:

# Windows
irm bun.sh/install.ps1 | iex

# macOS/Linux
curl -fsSL https://bun.sh/install | bash

설치 확인:

bun --version

3단계: Discord 플러그인 설치

Claude Code 내에서 순서대로 실행한다. 각 명령이 다음 단계를 준비하므로 순서를 지킨다:

# 1) 공식 플러그인 마켓플레이스 추가
/plugin marketplace add anthropics/claude-plugins-official

# 2) 마켓플레이스 목록 갱신
/plugin marketplace update claude-plugins-official

# 3) Discord 플러그인 설치
/plugin install discord@claude-plugins-official

# 4) 플러그인 리로드
/reload-plugins

4단계: Discord 봇 생성

Discord Developer Portal에서:

1. New Application 클릭 → 앱 이름 입력
2. Bot 섹션 → Reset Token → 토큰 복사 (안전한 곳에 보관)
3. Message Content Intent 활성화 (없으면 봇이 메시지를 읽지 못함)
4. OAuth2 URL Generator에서 봇 초대 링크 생성. 필요한 권한: – View Channels, Send Messages, Send Messages in Threads – Read Message History, Attach Files, Add Reactions
5. 생성된 링크로 봇을 Discord 서버에 초대

5단계: Claude Code에 Discord 봇 연결

/discord:configure YOUR_DISCORD_BOT_TOKEN

토큰은 Channels 설정 디렉터리에 자동 저장된다.

6단계: Channels 활성화하여 Claude Code 시작

# 기본 (권한 승인 포함)
claude --channels plugin:discord@claude-plugins-official

# 자동 승인 모드 (YOLO 모드 — 모든 도구 사용을 자동 승인)
claude --dangerously-skip-permissions --channels plugin:discord@claude-plugins-official

7단계: Discord 채널 페어링

Claude Code가 실행 중인 상태에서 봇을 초대한 Discord 채널에서:

/claude-pair

페어링이 완료되면 해당 채널에서 Claude Code에 메시지를 보낼 수 있다.

봇을 계속 실행하는 방법

봇은 Claude Code 세션이 살아있는 동안에만 동작한다. 장시간 유지하려면 PM2나 systemd를 활용한다:

# PM2 예시
npm install -g pm2
pm2 start "claude --dangerously-skip-permissions --channels plugin:discord@claude-plugins-official" --name claude-channels
pm2 save

주의 사항

• --dangerously-skip-permissions 플래그는 모든 도구 호출을 자동 승인하므로 신뢰하는 환경에서만 사용한다.
• 채널 접근은 Discord 서버의 권한 설정으로 제어한다. 봇을 초대한 채널의 멤버만 Claude Code와 대화할 수 있다.

참고 자료

• How to Set Up Claude Code Channels Locally — KDnuggets (2026-05-06)
• claude-code-channels — Claude Code Channels 기능 개요