Claude Code Channels — AI가 텔레그램으로 일하는 시대

Claude Code가 텔레그램 메시지를 받고, 알아서 코드를 짜고, 답장까지 보낸다면 어떨까?

 

AI 코딩 에이전트를 터미널에서 실행하고 있으면, 결국 한 가지 아쉬움이 생깁니다. "내가 자리를 비운 사이에도 알아서 일하면 좋겠는데." 이 바람은 단순히 자동화를 넘어서, 외부 세계의 이벤트에 AI가 능동적으로 반응하는 것을 의미합니다. CI가 실패했을 때, 동료가 메시지를 보냈을 때, 모니터링 알림이 울렸을 때 — 이런 순간마다 AI가 직접 상황을 파악하고 대응할 수 있다면 개발 워크플로우는 완전히 달라집니다.

Anthropic이 2026년 3월 Claude Code v2.1.80에서 공개한 Channels 기능이 바로 이 비전을 현실로 만듭니다. 이 글에서는 Channels가 무엇인지, 어떤 플랫폼을 지원하는지, 그리고 실제로 텔레그램과 디스코드를 연동하는 방법까지 상세히 다뤄보겠습니다.

 

Claude Code Channels란 무엇인가

Channels는 MCP(Model Context Protocol) 서버를 기반으로 외부 이벤트를 실행 중인 Claude Code 세션에 푸시하는 기능입니다. 기존에는 사용자가 터미널에서 직접 명령을 입력해야만 AI가 동작했지만, Channels를 통하면 텔레그램 메시지, 디스코드 채팅, CI 결과, 웹훅 같은 외부 신호가 자동으로 세션에 전달됩니다. Claude는 이 이벤트를 읽고, 필요한 작업을 수행한 뒤, 같은 채널을 통해 답장까지 보낼 수 있습니다.

핵심적인 특징은 양방향 통신입니다. 단순히 알림을 받는 것이 아니라, Claude가 분석 결과나 코드 수정 내역을 다시 원래 플랫폼으로 보내줍니다. 예를 들어 텔레그램에서 "프로젝트 빌드 상태 확인해줘"라고 보내면, Claude가 터미널에서 빌드를 실행하고 결과를 텔레그램으로 돌려보내는 식입니다. 이 과정에서 터미널에는 인바운드 메시지와 도구 호출 로그가 표시되지만, 실제 답장 텍스트는 해당 플랫폼에서만 보입니다.

 

지원 채널과 설정 방법

현재 리서치 프리뷰 단계에서 공식 지원하는 채널은 텔레그램과 디스코드 두 가지입니다. 둘 다 Bun 런타임이 필요하며, Claude Code 플러그인 형태로 설치합니다. 텔레그램의 경우 BotFather에서 봇을 생성하고 토큰을 발급받은 뒤, /plugin install telegram@claude-plugins-official 명령으로 플러그인을 설치합니다. 그다음 /telegram:configure <token>으로 토큰을 저장하고, claude --channels plugin:telegram@claude-plugins-official로 재시작하면 됩니다.

디스코드도 과정은 유사합니다. Discord Developer Portal에서 봇을 만들고, Message Content Intent를 활성화한 뒤, 적절한 권한(채널 보기, 메시지 보내기, 파일 첨부 등)을 설정합니다. 두 플랫폼 모두 페어링 코드 방식으로 보안을 관리합니다. 봇에 메시지를 보내면 코드가 발급되고, Claude Code에서 /telegram:access pair <code>로 승인하면 해당 계정만 메시지를 보낼 수 있게 됩니다. 이를 통해 승인되지 않은 사용자의 메시지는 자동으로 무시됩니다.

 

보안 모델과 엔터프라이즈 제어

Channels의 보안 설계는 꽤 신중합니다. 모든 채널 플러그인은 발신자 허용 목록(allowlist)을 유지하며, 등록되지 않은 ID의 메시지는 자동으로 드롭됩니다. .mcp.json에 서버가 등록되어 있더라도 --channels 플래그로 명시적으로 활성화하지 않으면 메시지가 도달하지 않습니다. 즉 이중 잠금 구조입니다.

기업 환경에서는 더 엄격한 제어가 가능합니다. Team이나 Enterprise 플랜에서는 기본적으로 Channels가 비활성화되어 있으며, 관리자가 channelsEnabled 설정을 명시적으로 켜야 합니다. 반면 Pro/Max 개인 사용자는 기본적으로 사용 가능하되, 매 세션마다 --channels로 직접 활성화해야 합니다. 이런 세분화된 권한 체계 덕분에 조직 보안 정책과 개인 편의성 사이의 균형이 잘 잡혀 있습니다. Anthropic 공식 문서에 따르면, 현재는 claude.ai 로그인만 지원하며 Console이나 API 키 인증은 아직 미지원 상태입니다.

 

실전 활용 시나리오

가장 즉각적인 활용은 원격 개발 관리입니다. 외출 중에 텔레그램으로 "최근 커밋 3개 보여줘"라고 보내면, Claude가 git log를 실행하고 결과를 텔레그램으로 보내줍니다. CI 파이프라인이 실패했을 때 웹훅으로 알림을 받고, Claude가 자동으로 에러 로그를 분석해서 수정 방안을 제시하는 것도 가능합니다.

더 흥미로운 건 팀 협업 시나리오입니다. 디스코드 채널에 Claude 봇을 배치하면, 팀원이 자연어로 코드베이스에 대해 질문하고 즉시 답변을 받을 수 있습니다. "이 함수가 어디서 호출되는지 찾아줘"나 "테스트 실행해줘" 같은 요청을 디스코드에서 바로 처리할 수 있습니다. 다만 권한 프롬프트가 뜨면 세션이 일시 중지되므로, 무인 운영 시에는 --dangerously-skip-permissions 플래그를 신뢰할 수 있는 환경에서만 사용해야 합니다.

 

핵심 정리

• Channels는 MCP 기반으로 텔레그램/디스코드 등 외부 이벤트를 Claude Code 세션에 양방향 푸시하는 기능
• 페어링 코드 + 발신자 허용 목록으로 보안 관리, 엔터프라이즈 플랜은 관리자 승인 필요
• 현재 리서치 프리뷰 단계이며, 커스텀 채널 개발도 가능

 

아직 리서치 프리뷰이지만, Channels는 AI 코딩 에이전트의 패러다임을 "내가 시킬 때만 동작"에서 "세상이 말 걸면 반응"으로 바꾸는 첫 걸음입니다. 텔레그램 봇 하나 만들어서 Claude Code에 연결해보세요. 자리를 비운 사이에도 당신의 AI가 일하고 있다는 감각은 생각보다 강렬합니다.