공개 노트

Claude Code Channels로 텔레그램·디스코드에서 "작업 지시" 받는 법

2026-03-20Views 300약 4분생성형 AI 활용

Summary

Claude Code Channels는 실행 중인 Claude Code 세션에 텔레그램/디스코드 같은 외부 메시지를 "푸시"해, 터미널 밖에서 생긴 일을 Claude가 바로 처리하게 만드는 기능입니다. 한마디로 노트북 앞이 아니어도, 폰 메신저로 "빌드 돌려줘" "버그 고쳐줘"라고 시키고 결과를 다시 메신저로 받는 흐름이죠. 이 글에서는 Channels가 정확히 무엇인지, Fakechat으로 안전하게 감 잡는 방법, 텔레그램·디스코드 연결 순서, 그리고 꼭 알아야 할 보안 포인트까지 2000자 내외로 정리합니다.¹

Claude Code Channels란? 비동기 '상주 세션'의 시작

기존의 AI 코딩은 대개 "질문 → 기다림 → 응답"이었습니다. 그런데 Channels는 발상을 바꿉니다. Claude Code 세션을 백그라운드에서 계속 켜 두고, 텔레그램/디스코드 메시지가 들어오는 순간 세션에 이벤트가 꽂히게 만들어요. 즉, Claude가 "항상 대기 중인 동료"처럼 바뀝니다.

기술적으로는 MCP(Model Context Protocol) 기반의 채널 플러그인이 폴링 방식으로 새 메시지를 가져와 현재 세션에 전달합니다. 이때 중요한 전제 조건이 몇 가지 있습니다. Claude Code는 v2.1.80+가 필요하고, 플러그인이 Bun 스크립트로 돌아가므로 Bun도 설치돼 있어야 합니다. 인증은 claude.ai 로그인 기반만 지원하며, 콘솔/API 키 인증은 지원되지 않습니다.¹

Fakechat으로 5분 만에 흐름 체험하기(외부 서비스 없이)

처음부터 텔레그램 봇, 디스코드 권한 설정을 하다 보면 삽질 포인트가 많습니다. 그래서 공식 데모 채널인 Fakechat부터 권합니다. 브라우저에 메시지를 치면 Claude Code 세션으로 들어가고, Claude 답이 다시 브라우저로 오는 "왕복"을 로컬에서 바로 확인할 수 있거든요.

설치와 실행은 간단합니다. Claude Code 세션에서 플러그인을 설치한 뒤, --channels로 재시작해 Fakechat 채널을 켭니다.¹

/plugin install fakechat@claude-plugins-official

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

이후 http://localhost:8787로 접속해 메시지를 보내면 끝입니다. 다만 자리를 비운 사이 권한 승인 프롬프트가 뜨면 세션이 멈출 수 있어요. 무인 운영을 노린다면 --dangerously-skip-permissions 유혹이 오지만, 이건 말 그대로 "위험하게 건너뛰기"라서 신뢰 경계를 먼저 정리한 뒤에만 고려하는 게 안전합니다.¹²

텔레그램·디스코드 연결: 설치보다 중요한 건 '페어링+allowlist'

텔레그램은 흐름이 명확합니다. BotFather로 봇을 만들고 토큰을 받은 뒤, 플러그인 설치→토큰 설정→--channels 재시작→페어링 승인→allowlist 잠금 순서로 갑니다.¹

/plugin install telegram@claude-plugins-official

/telegram:configure <token>

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

봇에게 DM을 보내면 페어링 코드가 오고, 그 코드를 Claude Code에서 승인하면 내 계정이 허용 목록에 들어갑니다.

/telegram:access pair <code>

마지막으로 정책을 allowlist로 바꿔 "등록된 사람만" 들어오게 잠그는 게 핵심입니다.

/telegram:access policy allowlist

디스코드는 봇 생성 자체보다 권한 설정이 관문입니다. 특히 메시지 내용을 읽으려면 개발자 포털에서 Message Content Intent를 켜야 하고, 서버 초대 시 메시지 읽기/전송 관련 권한을 제대로 줘야 합니다.¹ 나머지 흐름(설치→토큰 설정→--channels 재시작→DM 페어링→allowlist)은 텔레그램과 동일합니다.

운영·보안 체크리스트: "상주 세션"은 보안 모델부터 다르다

Channels의 보안은 크게 세 겹입니다. 첫째, 페어링으로 "누가 보냈는지"를 확정합니다. 둘째, allowlist로 발신자를 제한합니다(목록 밖은 조용히 무시). 셋째, 그 세션에서 --channels로 명시적으로 켠 채널만 메시지가 들어옵니다.¹

여기에 조직/엔터프라이즈 변수도 있습니다. Team/Enterprise는 기본적으로 Channels가 꺼져 있어 관리자 설정에서 channelsEnabled를 켜야 합니다.¹

그리고 "완전 무인 자동화"는 특히 조심해야 합니다. 권한을 전부 자동 승인하는 모드는 편하지만, 실제로 위험한 삭제나 데이터 유출 사고로 이어질 수 있다는 경험담과 사례들이 계속 공유되고 있습니다.² 가능하면 컨테이너/샌드박스에서 돌리고, 필요한 채널만 켜고, 페어링 직후 allowlist 잠금까지를 기본 습관으로 두세요.

시사점

Claude Code Channels는 단순한 메신저 연동이 아니라, 개발자가 AI와 일하는 방식을 "동기형"에서 "비동기형"으로 바꾸는 기능입니다. 가장 좋은 시작은 Fakechat으로 흐름을 먼저 몸에 익히고, 그다음 텔레그램(가장 단순) → 디스코드(권한이 관문) 순서로 확장하는 겁니다.

운영 팁을 한 줄로 요약하면 이렇습니다. "세션은 상주, 연결은 최소, 접근은 즉시 잠금." 이 세 가지를 지키면, 폰 하나로도 Claude Code를 꽤 믿을 만한 원격 작업 파트너로 만들 수 있습니다.

참고

¹이벤트를 채널과 함께 실행 중인 세션으로 푸시하기 - Claude Code Docs

²Claude Code dangerously-skip-permissions: Why It's Tempting, Why It's Dangerous