Claude Code Channels 완벽 가이드: 텔레그램·디스코드 연동 설정법

클로드코드(Claude Code)가 2026년 3월 20일, 완전히 새로운 기능 "Channels"를 Research Preview로 출시했습니다. Channels를 사용하면 집에서 Claude Code를 실행해두고, 외출한 상태에서 텔레그램이나 디스코드로 작업을 지시하고 결과를 받아볼 수 있습니다. 터미널 앞에 앉아 있지 않아도 된다는 뜻이죠. 이 가이드에서는 Channels가 무엇인지, 어떻게 설정하는지, 그리고 실무에서 어떻게 활용할 수 있는지 단계별로 알아봅니다.

 

Claude Code Channels란 무엇인가?

한 줄로 정리하면, 실행 중인 Claude Code 세션에 외부 서비스가 직접 이벤트를 밀어 넣는(push) 시스템입니다. Anthropic 공식 문서에서는 이렇게 설명합니다. "A channel is an MCP server that pushes events into your running Claude Code session, so Claude can react to things that happen while you're not at the terminal."

 

쉽게 말하면 이렇습니다. 집 컴퓨터에서 Claude Code를 켜두고 나서 외출한 뒤, 폰에서 텔레그램을 열어 봇에게 메시지를 보냅니다. "HTML, CSS, JavaScript로 포트폴리오 사이트 만들어줘." 그러면 Claude Code가 실제로 파일을 만들기 시작하고, 완료되면 텔레그램으로 결과 메시지가 옵니다. 마치 팀원에게 문자를 보내는 것과 같은 경험입니다.

 

현재 공식으로 지원되는 플랫폼은 Telegram과 Discord 두 가지입니다. Anthropic이 인터페이스 자체를 완전히 열어두었기 때문에, 향후 Slack, WhatsApp, iMessage 등 다른 플랫폼도 커뮤니티 또는 공식 지원으로 추가될 가능성이 있습니다.

 

채널은 단방향과 양방향으로 나뉩니다. 단방향 채널은 CI/CD 빌드 결과나 서버 모니터링 알림처럼 외부 이벤트를 Claude에 전달하는 용도입니다. 양방향 채널은 Claude가 reply tool을 통해 텔레그램이나 디스코드로 응답을 보낼 수 있어서, 실제 대화처럼 주고받을 수 있습니다.

Claude Code Channel 설명

기존 MCP와 무엇이 다른가?

Claude Code는 원래 MCP(Model Context Protocol)를 통해 외부 서비스와 연결해왔습니다. 그런데 기존 방식에는 근본적인 한계가 있었습니다. Claude가 주도권을 가져야만 외부 데이터를 가져올 수 있었습니다. 예를 들어 Supabase에서 테이블 데이터를 조회하려면, Claude가 직접 MCP를 호출해야만 했습니다. 외부에서 Claude에게 먼저 말을 걸 수 없었습니다.

 

Channels는 방향을 뒤집습니다. 이제는 외부 서비스가 Claude 세션에 직접 이벤트를 밀어 넣을 수 있습니다. 개발자들이 기다렸던 기능이 드디어 온 셈입니다. 기존에는 폴링 방식으로 우회하던 작업이, 이제 실시간 푸시로 깔끔하게 처리됩니다.

 

방식	설명	한계
기존 MCP (폴링)	Claude가 필요할 때 외부 서비스에 직접 질의	Claude가 주도권, 외부 이벤트 실시간 반응 불가
Channels (푸시)	외부 서비스가 Claude 세션에 직접 이벤트 전송	세션이 열려 있어야 함
Remote Control	claude.ai 앱으로 로컬 세션 조작	Claude 주도 작업이 아님, 외부 이벤트 자동 수신 없음

이벤트가 Claude 세션에 전달될 때는 <channel source="telegram">사용자 메시지</channel> 형태의 태그로 감싸져서 전달됩니다. 이 구조 덕분에 Claude는 일반 터미널 입력과 외부 채널 입력을 명확하게 구분할 수 있습니다.

 

한 가지 알아두어야 할 점은, 터미널에서 직접 입력한 메시지는 텔레그램이나 디스코드로 전송되지 않는다는 겁니다. 세션 내 입력과 외부 채널은 격리되어 있습니다. 텔레그램에서 보낸 메시지는 세션에서 볼 수 있지만, 세션에서 직접 입력한 내용은 텔레그램으로 나가지 않습니다.

 

Channels 사용 전 확인사항

설정에 들어가기 전에 몇 가지 요건을 먼저 확인해야 합니다. 하나라도 맞지 않으면 채널이 동작하지 않으니 순서대로 체크해보세요.

 

항목	요구사항	비고
Claude Code 버전	v2.1.80 이상	claude update 로 업데이트
인증 방식	claude.ai OAuth 로그인	API 키 인증 사용 시 재로그인 필요
런타임	Bun 필수	공식 플러그인 실행에 필요
구독 플랜	Pro/Max: 기본 사용 가능	Team/Enterprise: 관리자가 별도 활성화 필요

버전 업데이트는 터미널에서 claude update 명령어 하나면 됩니다. 현재 최신 버전인지 확인해주고, 업데이트가 있으면 자동으로 진행됩니다. API 키로 로그인 중이라면 로그아웃 후 claude.ai 계정으로 다시 로그인해야 합니다. 이 부분은 꼭 사전에 확인하세요.

 

텔레그램(Telegram) 연동 설정 가이드

텔레그램 연동은 7단계로 이루어집니다. 처음 해보면 BotFather 부분에서 살짝 막히는 경우가 있는데, 봇 이름이 이미 누군가 선점했을 때입니다. 이름을 독특하게 지으면 금방 해결됩니다.

 

1단계: BotFather에서 봇 생성 및 토큰 발급

텔레그램에서 @BotFather를 검색해서 채팅을 시작합니다. /newbot 명령어를 보내면 봇 이름과 username을 순서대로 입력하라고 안내합니다. username은 bot으로 끝나야 하며 중복이 불가합니다. 생성이 완료되면 HTTP API 토큰이 제공됩니다. 이 토큰을 복사해두세요.

 

2단계: 플러그인 설치

Claude Code 세션을 열고 아래 명령어를 입력합니다.

/plugin install telegram@claude-plugins-official

설치가 완료되면 플러그인을 활성화해야 합니다. 세션을 재시작하거나 /plugins reload 명령어로 새로고침하세요. 단, 실제로 토큰 설정까지 마친 뒤에는 세션을 완전히 종료했다가 새로 시작하는 것이 더 안정적입니다.

 

3단계: 토큰 설정

1단계에서 발급받은 API 토큰을 설정합니다.

/telegram:configure <여기에_토큰_붙여넣기>

토큰은 ~/.claude/channels/telegram/.env에 저장됩니다. 권한 승인 요청이 두 번 뜨는데 모두 허용해주면 됩니다.

 

4단계: 채널 모드로 Claude Code 재시작

현재 세션을 종료하고, 아래와 같이 --channels 플래그와 함께 새 세션을 시작합니다.

claude --channels plugin:telegram@claude-plugins-official

세션이 시작되면 "Listening for channel messages from plugin telegram@claude-plugins-official"이라는 메시지가 표시됩니다. 이 플래그를 빠뜨리면 텔레그램에서 메시지를 보내도 Claude Code가 받지 못합니다. .mcp.json에 등록하는 것으로는 채널이 활성화되지 않습니다.

 

5단계: 텔레그램에서 봇에 메시지 전송 후 페어링 코드 수신

텔레그램에서 생성한 봇을 검색해 Start를 누릅니다. 아무 메시지나 보내면 봇이 페어링 코드를 담은 응답을 보내옵니다. 이 코드를 복사하세요.

 

6단계: Claude Code에서 페어링 코드 입력

Claude Code 터미널에서 아래 명령어를 실행합니다.

/telegram:access pair <페어링_코드>

승인 요청이 나타납니다. 확인해주면 페어링이 완료됩니다.

 

7단계: 보안 잠금 (allowlist 설정)

마지막으로 반드시 이 명령어를 실행하세요. 빠뜨리면 보안에 취약해집니다.

/telegram:access policy allowlist

이 설정을 적용하면 허용 목록에 등록된 사용자만 Claude Code 세션으로 메시지를 보낼 수 있습니다. 나만 접근할 수 있도록 잠근 상태가 됩니다.

Claude Code Channel 텔레그램 연동 방법

 

디스코드(Discord) 연동 설정 가이드

Discord 연동은 Telegram보다 초기 설정이 약간 더 복잡합니다. Discord Developer Portal에서 애플리케이션을 만들고 권한을 설정하는 과정이 추가됩니다. 차근차근 따라오면 어렵지는 않습니다.

 

1단계: Discord Developer Portal에서 애플리케이션 생성

Discord Developer Portal에 접속해서 "New Application"을 클릭합니다. 앱 이름을 입력하고 약관에 동의 후 생성합니다.

 

2단계: Bot 섹션 설정 및 토큰 발급

왼쪽 메뉴에서 "Bot" 섹션으로 이동합니다. 스크롤을 내리면 "Message Content Intent" 항목이 있는데, 이것을 반드시 활성화해야 합니다. 그런 다음 "Reset Token"을 클릭해서 토큰을 발급받고 복사해두세요.

 

3단계: OAuth2 권한 설정 및 서버에 봇 초대

"OAuth2" 메뉴에서 "OAuth2 URL Generator"로 이동합니다. Scopes에서 "bot"을 체크하고, 아래에 나타나는 권한 목록에서 필요한 6가지 권한을 선택합니다. 생성된 URL을 복사해서 새 탭에 붙여넣고, 봇을 초대할 서버를 선택해 승인합니다.

 

4단계: 플러그인 설치

/plugin install discord@claude-plugins-official

설치 후에는 Telegram과 마찬가지로, 세션을 종료했다가 새로 시작하는 것이 안정적입니다.

 

5단계: 토큰 설정

/discord:configure <2단계에서_발급받은_토큰>

 

6단계: 채널 모드로 Claude Code 재시작

claude --channels plugin:discord@claude-plugins-official

 

7단계: Discord에서 봇 DM 후 페어링 코드 수신

초대한 서버에서 봇을 찾아 DM을 보내면 페어링 코드가 담긴 응답이 옵니다.

 

8단계: Claude Code에서 페어링 코드 입력

/discord:access pair <페어링_코드>

 

9단계: 보안 잠금

/discord:access policy allowlist

여기까지 완료되면 Discord에서 직접 Claude Code 세션으로 메시지를 주고받을 수 있습니다. Telegram과 Discord를 동시에 연결하고 싶다면 두 플러그인을 함께 로드할 수도 있습니다.

 

실무 활용 시나리오 5가지

Channels를 실제로 어디에 쓸 수 있는지, 구체적인 시나리오를 정리해봤습니다. 특히 세 번째와 네 번째 시나리오는 기존 Claude Code의 한계를 직접 넘어서는 지점입니다.

 

1. 원격 코딩 지시

집 컴퓨터에서 Claude Code를 채널 모드로 실행해두고 외출합니다. 카페에서 폰을 꺼내 텔레그램에서 봇에게 "로그인 페이지 UI 개선해줘"라고 보내면 Claude Code가 작업을 시작합니다. 완료되면 결과 메시지가 텔레그램으로 옵니다. 컴퓨터 앞에 없어도 되는 상황입니다.

 

2. CI/CD 파이프라인 자동화

빌드가 실패하거나 배포가 완료됐을 때, CI/CD 도구가 커스텀 채널을 통해 Claude Code 세션에 자동으로 결과를 전달합니다. Claude Code는 그 내용을 보고 에러 분석을 시작하거나 다음 단계를 진행합니다. 개발자가 직접 확인하지 않아도 되는 작업 흐름을 만들 수 있습니다.

 

3. 서버 모니터링 및 온콜 대응 자동화

서버에서 이상 지표나 에러가 발생했을 때 모니터링 도구가 Claude Code 세션에 즉시 알립니다. Claude Code가 로그를 분석하고 초기 대응 코드를 작성하거나 알림을 보내는 흐름을 만들 수 있습니다. 새벽 온콜을 자동화하는 데 실질적으로 쓸 수 있는 시나리오입니다.

 

4. 자체 서비스 연동 (커스텀 채널 개발)

MCP 서버를 직접 구현하면, 자체 플랫폼에서 Claude Code 세션에 프롬프트를 보낼 수 있습니다. Anthropic이 인터페이스를 공개했기 때문에, 자신의 서비스와 Claude Code를 직접 연결하는 파이프라인을 만들 수 있습니다. 이 부분은 개발자라면 상당히 매력적인 옵션입니다.

 

5. /loop 명령어와 결합한 반복 작업 자동화

2026년 3월 업데이트에 추가된 /loop 명령어를 Channels와 함께 쓰면, 정기 보고서 생성이나 상태 모니터링을 자동화할 수 있습니다. 예를 들어 5분마다 배포 상태를 확인하고, 이상이 생기면 텔레그램으로 알림을 보내는 흐름입니다.

Claude Code Channel 활용 사례

 

한계와 주의사항

솔직하게 정리합니다. Channels는 강력하지만, 지금 단계에서 몇 가지 알고 써야 할 부분이 있습니다.

 

Research Preview 상태입니다. 아직 정식 출시 전이라 기능이 변경될 수 있고, 간헐적인 버그가 있을 수 있습니다. 실제로 설정 과정에서 세션을 재시작해야 해결되는 사소한 문제들이 발견된 바 있습니다.

 

세션이 열려 있어야 합니다. 채널 메시지는 실행 중인 세션에만 전달됩니다. 세션이 닫히면 그 사이에 온 메시지는 수신되지 않습니다. 항상 켜두려면 백그라운드 프로세스나 영구적인 터미널 환경이 필요합니다.

 

단방향 격리가 있습니다. 앞서 언급했지만, 터미널에서 직접 입력한 내용은 텔레그램이나 디스코드로 전송되지 않습니다. 채널에서 보낸 메시지만 세션에서 확인 가능하고, 세션 내 입력은 채널에 나타나지 않습니다.

 

현재는 공식 플러그인만 사용 가능합니다. Research Preview 기간 중에는 Anthropic이 승인한 플러그인(텔레그램, 디스코드)만 쓸 수 있습니다. 커스텀 채널을 테스트하려면 --dangerously-load-development-channels 플래그가 필요합니다.

 

보안 경고: Anthropic 공식 문서는 "허용 목록 없이 열려있는 채널은 프롬프트 인젝션 벡터가 된다"고 명시하고 있습니다. 채널 접근 권한이 있는 누구든 Claude Code 세션에 텍스트를 주입할 수 있습니다. 반드시 7단계(Telegram) 또는 9단계(Discord)의 allowlist 설정을 완료하세요.

 

또한 Claude Code가 작업 중 권한 승인이 필요한 상황을 만나면, 터미널 앞에 없는 경우 로컬 승인이 올 때까지 작업이 멈춥니다. 완전 자율 운영은 아직 완벽하지 않다는 점도 알아두면 좋습니다.

 

OpenClaw와의 차이: Channels 출시의 의미

왜 이 기능이 지금 나왔는지 맥락을 이해하면, Channels가 단순한 편의 기능 이상이라는 걸 알 수 있습니다.

 

2025년 초 등장한 OpenClaw는 오픈소스 AI 에이전트로, 60일 만에 GitHub 스타 30만 개를 달성했습니다. React가 10년 걸린 걸 두 달 만에 해낸 셈입니다. OpenClaw가 내세운 강점은 세 가지였습니다. 첫째, 무료(로컬 모델 사용 시). 둘째, 30개 이상 플랫폼 지원(WhatsApp, Telegram, Discord, Slack 등). 셋째, 코딩뿐 아니라 일정 관리, 이메일, 스마트홈 제어까지 지원.

 

반면 Claude Code는 터미널 도구였습니다. 폰에서 접근하기 어려웠고, 세션을 벗어나면 작업이 멈췄습니다. "Claude Code는 개발자 도구, OpenClaw는 일반인도 쓸 수 있는 도구"라는 인식이 생겼습니다.

 

그리고 2026년 3월, 클로드코드는 빠르게 그 격차를 좁혔습니다.

 

항목	Claude Code (2026년 3월)	OpenClaw
폰 접근성	Telegram, Discord (Channels)	30개 이상 플랫폼
보안	Anthropic 보안 인프라, 기업 지원	135,000대 노출 사례, 플러그인 12% 악성 보고
비용	Pro/Max 구독 필요	소프트웨어 자체는 무료 (모델 비용 별도)
코딩 특화	전문적 코드베이스 작업에 최적화	범용 생활 자동화 중심
자율성 철학	주요 작업 전 권한 요청, 사람이 루프 안에 있음	자율적 실행, 즉흥적 문제 해결

OpenClaw의 보안 문제는 실제로 심각한 수준이었습니다. 보안 연구자들이 발견한 것만으로도 135,000대가 노출 상태였고, OpenClaw 커뮤니티 플러그인 레지스트리를 감사한 결과 약 12%(2,857개 중 341개)가 악성 소프트웨어로 확인됐다는 보고가 있었습니다. 이메일과 파일에 접근하는 도구에서 8개 중 1개 꼴로 악성이라는 건 적지 않은 수치입니다.

 

Claude Code의 철학은 다릅니다. 중요한 작업을 실행하기 전에 확인을 요청하고, 작업 범위를 제한하며, 사람이 의사 결정 루프 안에 있도록 설계되어 있습니다. VentureBeat는 Channels 출시를 "동기식 요청-대기 모델에서 비동기식 자율 파트너십으로의 근본적 전환"으로 평가했습니다.

 

2026년 3월에 클로드코드에 추가된 기능들을 타임라인으로 보면 흐름이 명확합니다.

• 2025년 초: OpenClaw 등장, Claude Code와 접근성 격차 부각
• 2026년 2월 25일: Remote Control 출시, 폰/태블릿에서 로컬 세션 제어 가능
• 2026년 3월 초: 음성 모드(20개 언어), /loop 명령어, 100만 토큰 컨텍스트, Opus 4.6 기본 모델, /effort 명령어
• 2026년 3월 20일: Channels 출시 (Research Preview), Telegram 및 Discord 지원 시작

앞으로 Slack, WhatsApp, iMessage 등의 플랫폼도 커뮤니티 또는 공식 지원으로 추가될 가능성이 높습니다. 현재 클로드코드의 월간 검색 트렌드는 3월 들어 역대 최고치를 기록했고, 2026년 기준으로 주간 활성 사용자 수는 2025년 초 대비 2배 이상 늘어난 상태입니다.

 

Claude Code Channels는 아직 Research Preview지만, AI 에이전트가 터미널을 벗어나 일상 속 메신저 앱과 연결되는 첫 공식 단계입니다. Pro/Max 플랜을 사용 중이라면 지금 바로 텔레그램 연동을 시도해보세요. 향후 더 많은 플랫폼이 지원될 때 가장 빠르게 활용할 수 있는 위치에 서게 됩니다.