리서치 프리뷰
Claude Code Channels, 폰으로 된다고요?
이 조건 먼저 보세요
2026년 3월 20일, Anthropic이 Claude Code에 Channels 기능을 리서치 프리뷰로 추가했습니다. 텔레그램·디스코드로 실행 중인 Claude Code 세션에 메시지를 넣고, Claude가 직접 코드 작업 후 답장을 보내주는 구조입니다. 그런데 “폰으로 아무 때나 쓸 수 있다”는 말이 꼭 맞지는 않습니다. 세션이 살아 있어야 하고, Pro 이상 구독이 필수이며, 허가 프롬프트가 뜨면 세션이 멈춥니다. 이 글에서는 실제로 어떻게 작동하는지, 무엇이 안 되는지를 공식 문서와 실사용 사례를 교차해서 짚어봤습니다.
Claude Code Channels가 뭔지 결론부터
Claude Code Channels는 이미 실행 중인 Claude Code 세션을 텔레그램·디스코드·iMessage로 원격 조작하는 기능입니다. 2026년 3월 20일 리서치 프리뷰로 공개됐고, Claude Code v2.1.80 이상이 필요합니다. (출처: Anthropic 공식 문서 — Channels, 2026.03.20)
작동 방식을 한 줄로 설명하면 이렇습니다. 폰 텔레그램 앱에서 봇에게 메시지를 보내면 → 봇이 이를 로컬 PC에서 돌아가는 Claude Code 세션에 이벤트로 주입 → Claude가 실제 파일·git·MCP 툴을 그대로 써서 작업하고 → 결과를 텔레그램으로 돌려보냅니다. 코드는 내 PC 밖으로 나가지 않습니다.
커뮤니티 반응은 빨랐습니다. AI 유튜버 Matthew Berman은 “They’ve BUILT OpenClaw”라는 말로 반응을 대신했습니다. 2025년 11월 오픈소스 프로젝트 OpenClaw가 텔레그램·디스코드 원격 제어로 개발자들 사이에서 빠르게 퍼졌는데, Anthropic이 그 기능을 자사 제품에 직접 내장한 셈이니까요. 실제로 Anthropic은 OpenClaw 제작자에게 상표 관련 중지·시정 요청(C&D)을 보낸 바 있는데, 그 제작자는 이후 OpenAI에 합류했습니다. (출처: VentureBeat, 2026.03.20)
💡 공식 발표문과 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다 — Channels가 “내 코드를 외부 서버로 보내지 않는다”고 강조하는 이유가 있습니다. OpenClaw는 커뮤니티 스킬 레지스트리에서 악성 스킬이 12%로 집계될 만큼 보안 문제가 있었습니다. Channels는 Anthropic이 관리하는 허용 목록(allowlist) 내 플러그인만 `–channels` 플래그로 로드할 수 있도록 강제해 이 문제를 구조적으로 차단했습니다. (출처: LevelUp GitConnected, 2026.03.26 분석)
코드가 내 PC를 떠나지 않는 구조
Channels의 핵심은 채널이 MCP(Model Context Protocol) 서버라는 점입니다. MCP는 Anthropic이 2024년에 공개한 오픈소스 표준으로, AI가 외부 데이터와 툴에 연결하는 공통 인터페이스입니다. Channels는 이 MCP 서버를 Claude Code가 이미 열어 둔 세션 안에서 두 방향 다리처럼 씁니다. (출처: Anthropic 공식 문서 — Channels)
이벤트 흐름을 순서대로 보면: 텔레그램·디스코드에서 메시지 전송 → 채널 플러그인이 메시지를 `<channel>` 이벤트로 감싸서 stdio로 Claude Code 세션에 주입 → Claude가 로컬 파일시스템·git·MCP 툴로 작업 → `reply` 툴을 통해 플랫폼으로 답장. 이 흐름에서 코드베이스는 로컬에 그대로 있고, 오직 텍스트 답장만 텔레그램·디스코드 서버를 경유합니다.
Bun 런타임이 필수라는 점도 중요합니다. 채널 플러그인이 Bun 스크립트로 짜여 있어서, Bun 없이는 `–channels` 플래그 자체가 작동하지 않습니다. 설치 전에 `bun –version`으로 확인이 먼저입니다.
| 방식 | 인터페이스 | 세션 위치 | 푸시 알림 |
|---|---|---|---|
| Channels | 텔레그램·디스코드 | 로컬 PC | ✅ 네이티브 |
| Remote Control | claude.ai / 모바일 앱 | 로컬 PC | ❌ 앱 직접 열어야 확인 |
| Web Sessions | claude.ai 브라우저 | Anthropic 클라우드 | ❌ 앱 직접 열어야 확인 |
출처: Anthropic 공식 문서 (code.claude.com/docs/en/channels), 2026.03.20
텔레그램 5분 세팅 전체 흐름
텔레그램 세팅이 디스코드보다 빠릅니다. 아래 순서대로 하면 됩니다. v2.1.80 이상 업데이트가 먼저입니다. `npm install -g @anthropic-ai/claude-code`로 최신화한 뒤 진행하세요.
BotFather에서 봇 생성
텔레그램에서 @BotFather에 접속 → `/newbot` 입력 → 이름과 유저네임(`bot`으로 끝나야 함) 설정 → 토큰 복사
플러그인 설치
Claude Code 세션 내에서: /plugin install telegram@claude-plugins-official
토큰 등록
/telegram:configure <토큰>
Channels 활성화 후 재시작
claude --channels plugin:telegram@claude-plugins-official
페어링 + 보안 잠금
봇에게 아무 메시지 → 페어링 코드 수신 → /telegram:access pair <코드> → /telegram:access policy allowlist
마지막 단계의 `allowlist` 정책이 중요합니다. 이걸 빠뜨리면 페어링되지 않은 사람도 봇으로 메시지를 보낼 수 있습니다. 내 세션에 외부인이 명령을 주입하는 상황이 실제로 가능해지므로, 세팅 직후 반드시 실행하는 게 맞습니다.
⚠️ 텔레그램 봇 API는 실시간 폴링 방식입니다. 세션이 꺼진 상태로 보낸 메시지는 서버에 남지 않고 소멸합니다. 장시간 자리를 비울 때는 tmux나 screen으로 세션을 유지해야 메시지 유실을 막을 수 있습니다. (출처: Anthropic 공식 문서 Channels)
Remote Control과 뭐가 다른가
솔직히 말하면, Channels와 Remote Control은 “폰으로 Claude Code 조작”이라는 목표는 같지만 출발점이 다릅니다. Remote Control은 claude.ai 웹 또는 모바일 앱을 인터페이스로 씁니다. Channels는 텔레그램·디스코드 자체가 인터페이스입니다.
실사용에서 차이가 드러나는 순간은 “폰을 꺼내드는 타이밍”입니다. Remote Control은 claude.ai 앱을 열어서 세션을 확인해야 합니다. 따로 알림이 오지 않습니다. 반면 Channels는 Claude가 작업을 마치거나 도움이 필요할 때 텔레그램 푸시 알림을 보냅니다. 8분마다 앱을 열어 확인하지 않아도 됩니다. 실사용자들이 이를 “알림 공백이 사라졌다”고 표현한 이유입니다.
단, 두 기능 모두 해결하지 못하는 부분이 있습니다. 폰에서 세션을 새로 시작할 수 없다는 점입니다. Remote Control이든 Channels든, 반드시 데스크탑에서 먼저 세션을 열고 나가야 폰에서 접근 가능합니다. 집에서 세션을 안 켜고 나왔다면, 폰에서는 아무것도 할 수 없습니다. (출처: LevelUp GitConnected 실사용 분석, 2026.03)
💡 두 기능을 동시에 켜는 방법도 있습니다 — claude remote-control --channels plugin:telegram@claude-plugins-official 플래그를 함께 쓰면 됩니다. claude.ai 앱에서 세션을 직접 조작하면서, 텔레그램으로 알림도 받는 구성이 가능합니다. 공식 문서에 딱 이렇게 나와 있습니다.
세션이 죽으면 메시지도 사라집니다
Channels를 실제로 쓰다 보면 가장 먼저 부딪히는 문제입니다. 공식 문서에 분명히 적혀 있습니다. “이벤트는 세션이 열려 있는 동안만 도달합니다.” (출처: Anthropic 공식 문서 Channels) 세션이 닫히면 채널도 오프라인 상태가 됩니다.
텔레그램과 디스코드는 여기서도 차이가 납니다. 텔레그램 봇 API는 실시간 폴링 방식이라, 세션이 꺼진 상태에서 보낸 메시지는 서버에 남지 않고 그냥 사라집니다. 디스코드는 `fetch_messages` 툴로 최대 100개까지 이전 메시지를 불러올 수 있어서, 세션이 재시작되면 밀린 명령을 따라잡을 수 있습니다. 장기 자리 비움에는 디스코드가 낫습니다.
권한 허가 프롬프트 문제도 짚고 가야 합니다. Claude가 작업 도중 파일 쓰기나 실행 명령 등 허가가 필요한 작업을 만나면, 로컬 터미널에서 직접 승인할 때까지 세션이 멈춥니다. 텔레그램으로 “ㅇㅇ” 한 글자 보내봤자 세션은 움직이지 않습니다. 이 부분은 공식 문서가 별도로 이유를 밝히지 않았습니다만, Remote Control 앱에서는 원격으로 승인이 가능합니다. Channels 단독으로는 아직 허가 프롬프트를 원격 처리할 수 없습니다.
⚠️ “–dangerously-skip-permissions” 주의
권한 프롬프트 없이 모든 작업을 자동 승인하는 플래그입니다. 자신이 완전히 신뢰하고 격리된 환경에서만 쓰는 게 맞습니다. 실제 코드베이스나 민감한 파일이 있는 환경에서는 쓰지 않는 게 좋습니다. 이 판단은 사용자 본인에게 있습니다.
팀플랜은 어드민이 먼저 켜야 합니다
Pro·Max 개인 구독자는 별도 설정 없이 `–channels` 플래그만 쓰면 됩니다. 그런데 Team·Enterprise 플랜은 다릅니다. Channels가 기본값으로 꺼져 있습니다. 어드민이 claude.ai 관리 콘솔에서 직접 활성화하지 않으면, 플러그인을 설치해도 메시지가 도달하지 않습니다. 세션에는 어드민 활성화를 요청하라는 시작 알림이 뜹니다. (출처: Anthropic 공식 문서 — Enterprise controls)
어드민은 `channelsEnabled: true` 설정으로 전체 활성화 후, `allowedChannelPlugins` 항목으로 어떤 플러그인만 허용할지 추가로 제한할 수 있습니다. 예를 들어 공식 텔레그램 플러그인만 허용하고 디스코드는 막는 식입니다. `allowedChannelPlugins`가 설정되면 Anthropic 기본 허용 목록은 완전히 대체됩니다. 명시된 플러그인 외에는 아무것도 등록되지 않습니다.
무료 플랜은 Channels 자체를 쓸 수 없습니다. 공식 문서에 “claude.ai Pro 또는 Max 구독 필요”라고 명시돼 있습니다. API 키 인증도 리서치 프리뷰 기간에는 지원되지 않습니다. claude.ai 로그인 방식만 가능합니다.
💡 Team·Enterprise가 Channels를 기본으로 끈 이유를 Anthropic이 공식 답변으로 내놓지 않은 부분입니다. 다만 보안 구조를 보면 맥락이 읽힙니다 — 허가된 발신자 외 모든 메시지를 조용히 차단하는 allowlist 구조, 플러그인 레지스트리를 어드민이 완전 교체 가능한 구조, 그리고 “허가 릴레이 권한을 가진 발신자는 툴 사용 승인·거부도 가능”하다는 문서 문구가 조합되면, 어드민이 먼저 조직 내 신뢰 범위를 결정해야 한다는 설계 의도가 보입니다.
Q&A 5가지
마치며 — 총평
Claude Code Channels는 솔직히 꽤 쓸 만합니다. “폰으로 아무 때나 Claude Code에 명령 보낸다”는 게 이전에는 OpenClaw 같은 서드파티 세팅이 필요했는데, 이제는 텔레그램 봇 하나 만들고 10분이면 됩니다. 특히 장시간 리팩터링이나 빌드 작업을 걸어놓고 자리를 비울 때, 텔레그램으로 알림을 받는 경험이 Remote Control의 “앱 열어서 확인” 방식과 실용성 차이가 납니다.
그러나 아쉬운 부분도 분명합니다. 세션이 살아 있어야 한다는 구조적 한계 때문에, 폰에서 세션을 새로 시작할 수 없습니다. 자리를 비우기 전에 tmux 같은 세션 유지 환경을 미리 잡아놔야 합니다. 허가 프롬프트가 뜨면 원격에서 해결이 안 되는 부분도 여전히 남아 있습니다. 리서치 프리뷰라는 라벨이 붙어 있는 만큼, `–channels` 플래그 문법이나 플러그인 구조가 GA 전에 바뀔 가능성도 열려 있습니다.
개인적으로는 Pro 구독자이고 Claude Code를 일상적으로 쓰는 사람이라면 텔레그램 세팅 하나 해두는 게 분명히 값어치가 있다고 봅니다. Team·Enterprise라면 어드민에게 `channelsEnabled` 활성화를 먼저 요청해야 시작이 됩니다. 기능 자체의 방향성은 맞습니다. 지금은 리서치 프리뷰니까 주요 흐름을 파악해두고, GA가 되면 본격적으로 써볼 만한 기능입니다.
📚 본 포스팅 참고 자료
- Anthropic 공식 문서 — Claude Code Channels (code.claude.com)
- VentureBeat — Anthropic just shipped an OpenClaw killer called Claude Code Channels (2026.03.20)
- LevelUp GitConnected — Claude Code Just Got Channels. Is It Enough? (2026.03)
- Towards AI — Claude Code Channels: Message Your AI Coding Agent from Telegram and Discord (2026.03)
- Builder.io — Every Claude Code Update From March 2026, Explained (2026.03)
본 포스팅은 2026년 3월 30일 기준 작성되었습니다. Claude Code Channels는 현재 리서치 프리뷰 상태이며, 본 포스팅 작성 이후 서비스 정책·UI·플래그 문법·기능이 변경될 수 있습니다. 최신 정보는 Anthropic 공식 문서를 직접 확인하세요.
댓글 남기기