Claude Code v2.1.80+
리서치 프리뷰
Claude Code Channels 직접 써봤습니다 — 되는 것과 막히는 것
폰에서 텔레그램 메시지 하나 보내면 집 컴퓨터의 Claude Code가 코드를 고치고 결과를 보내줍니다. 맞습니다. 그런데 권한 프롬프트 하나에 세션이 통째로 멈추고, 업데이트했는데도 기능이 안 나오는 계정이 존재합니다. 결론부터 말씀드리면, 기대했던 것과 달랐습니다.
(텔레그램·디스코드·iMessage)
심각도 점수
요구 버전
Claude Code Channels가 정확히 뭔지, 먼저 정리합니다
2026년 3월 20일, Anthropic이 Claude Code v2.1.80에 Channels를 리서치 프리뷰로 추가했습니다. 한 문장으로 정리하면 이렇습니다: 터미널에서 돌아가고 있는 Claude Code 세션으로, 텔레그램·디스코드·iMessage 같은 외부 메신저에서 보낸 메시지를 직접 밀어넣는 기능입니다. (출처: Claude Code 공식 문서, code.claude.com/docs/ko/channels)
구조를 보면 MCP(Model Context Protocol) 서버 기반입니다. 채널 플러그인이 여러분 컴퓨터에서 서브프로세스로 돌면서 텔레그램 Bot API를 실시간으로 폴링합니다. 메시지가 오면 stdio를 통해 Claude Code 세션으로 전달되고, Claude는 로컬 파일시스템·git·MCP 도구를 전부 쓴 채로 작업한 뒤 같은 채널로 답장을 보냅니다. 코드는 내 컴퓨터 밖으로 나가지 않습니다.
이전까지 비슷한 기능은 커뮤니티 프로젝트인 OpenClaw(구 Clawdbot, 현 OpenClaw)가 담당했습니다. Anthropic이 그 수요를 공식으로 흡수한 셈입니다. 다만 공식화의 의미는 보안과 심사 쪽에 있지, 기능 범위 자체가 OpenClaw를 앞선다는 뜻은 아닙니다. 이 부분은 섹션 5에서 수치로 풀어드립니다.
💡 공식 발표문과 실제 설치 흐름을 나란히 놓고 보니 이런 차이가 보였습니다.
공식 문서는 “코드가 절대 내 기기를 벗어나지 않는다”는 점을 강조합니다. 맞는 말입니다. 그런데 Claude가 작업 후 텔레그램으로 보내는 답장 텍스트는 텔레그램 서버를 경유합니다. 코드가 아닌 출력 결과물이라도, 민감한 정보가 담긴 응답을 외부 메신저로 받을 때는 이 흐름을 인지하고 써야 합니다.
폰에서 보내면 실제로 어떻게 작동하나요
전체 흐름은 이렇습니다. 폰에서 텔레그램 봇에 “테스트 돌려줘”라고 보내면, 로컬 채널 플러그인이 메시지를 받아서 stdio로 Claude Code에 밀어넣습니다. Claude는 로컬 프로젝트 폴더에서 테스트를 실행하고, 결과를 텔레그램 reply 도구로 다시 보냅니다. 단순한 명령은 3~5초 안에 첫 응답이 옵니다. (출처: shareuhack.com/en/posts/claude-code-channels-telegram 실측값)
설정 순서는 다섯 단계입니다. ① Telegram BotFather에서 봇 생성 및 토큰 발급 → ② Claude Code 세션에서 /plugin install telegram@claude-plugins-official 실행 → ③ /telegram:configure [토큰] 으로 토큰 저장 → ④ claude --channels plugin:telegram@claude-plugins-official 로 재시작 → ⑤ 봇에 DM → 6자리 페어링 코드 입력. 여기서 가장 많이 막히는 지점은 ④번입니다. 플러그인만 설치하고 --channels 플래그 없이 실행하면 아무것도 작동하지 않습니다.
요구 사항은 세 가지입니다: Claude Code v2.1.80 이상(확인: claude --version), Bun 런타임 설치(확인: bun --version), claude.ai Pro 또는 Max 구독. API 키 인증은 리서치 프리뷰 기간에 지원하지 않습니다. (출처: Claude Code 공식 문서, code.claude.com/docs/ko/channels)
‘노트북 없이 코딩’은 아직 절반짜리입니다
홍보 문구대로라면 자리를 비운 사이 Claude가 알아서 작업하고 결과를 텔레그램으로 보내줘야 합니다. 실제로는 두 가지 조건에서 그 약속이 깨집니다.
첫 번째: 권한 프롬프트에서 세션이 멈춥니다. Claude가 파일을 수정하거나 명령어를 실행할 때마다 터미널에서 직접 승인해야 합니다. 폰에서 보낸 메시지에 파일 쓰기 작업이 포함돼 있으면 Claude는 텔레그램 봇 쪽으로 아무 말도 못 하고 터미널 앞에서 대기합니다. Reddit의 실제 테스트에서도 이 문제가 가장 큰 불편으로 꼽혔습니다. (출처: r/ClaudeCode, 2026.03.20 스레드)
두 번째: 세션이 꺼지면 메시지가 사라집니다. Channels에는 메시지 큐가 없습니다. 터미널을 닫거나 Claude Code 프로세스가 종료된 사이에 텔레그램으로 보낸 메시지는 영구 소실됩니다. 공식 문서도 “이벤트는 세션이 열려 있는 동안에만 도착한다”고 명시합니다. (출처: code.claude.com/docs/ko/channels)
💡 실제 운영 흐름과 공식 문서를 교차해서 보니 이런 패턴이 나왔습니다.
커뮤니티가 찾아낸 현실적 해결책은 tmux입니다. tmux new -s claude-channels 로 세션을 만들고 while true; do claude --channels plugin:telegram@claude-plugins-official; sleep 5; done을 실행해두면 크래시 시 자동 재시작됩니다. 공식 문서가 제시하는 방법이 아니라 Reddit 커뮤니티가 직접 만든 우회법입니다. Anthropic이 공식 백그라운드 데몬을 내놓지 않은 이유는 아직 공개되지 않았습니다.
권한 프롬프트 문제의 우회 방법이 --dangerously-skip-permissions 플래그입니다. 이 플래그를 쓰면 Claude가 모든 작업을 승인 없이 실행합니다. ‘진정한 비동기 원격 제어’를 원한다면 사실상 이 플래그가 필수지만, 동시에 Channels의 3중 보안 모델을 상당 부분 무력화합니다. 보안과 편의성은 여기서 정확히 교환 관계입니다.
설정 중 막히는 곳이 따로 있습니다
설정을 완료해도 봇이 응답하지 않는 경우가 있습니다. 가장 흔한 원인 두 가지입니다.
서버사이드 피처 플래그 차단. Anthropic은 tengu_harbor라는 서버사이드 플래그로 Channels를 단계적으로 롤아웃하고 있습니다. v2.1.80 이상으로 업데이트하고 플러그인 설치까지 완료했는데도 봇이 침묵하는 경우는 이 플래그에 아직 포함되지 않은 계정입니다. 설정 문제가 아니라 서버 측 제한이라 직접 해결할 방법이 없습니다. Anthropic이 공식 답변을 내놓지 않은 부분입니다.
DISABLE_TELEMETRY 설정 덫. Claude Code 설정에서 DISABLE_TELEMETRY=0으로 설정한 경우(비활성화를 끈다는 의미로 0을 입력한 경우) Channels가 작동하지 않습니다. 직관과 반대입니다. 해결 방법은 값을 0으로 바꾸는 게 아니라 해당 키를 설정 파일에서 아예 삭제하는 것입니다. (출처: shareuhack.com/en/posts/claude-code-channels-telegram 실사용 함정 정리)
| 증상 | 원인 | 조치 |
|---|---|---|
| 봇이 페어링 코드조차 안 보냄 | tengu_harbor 서버 플래그 미포함 | 롤아웃 대기 — 내 설정 문제 아님 |
| –channels 넣어도 채널 미등록 | DISABLE_TELEMETRY=0 설정 잔존 | 해당 키를 설정 파일에서 삭제 |
| 세션 중간에 봇 침묵 | 권한 프롬프트 대기 상태 | 터미널 직접 확인 후 승인 |
| Team/Enterprise인데 기능 없음 | channelsEnabled 기본값 off | 관리자가 Admin 설정에서 수동 활성화 |
Team·Enterprise 플랜은 기본값이 채널 비활성화입니다. 조직 관리자가 channelsEnabled: true를 관리 설정에 직접 넣거나, claude.ai Admin 콘솔에서 켜야 합니다. 개인 Pro·Max 사용자는 이 검사를 건너뛰기 때문에 해당 없습니다. (출처: Claude Code 공식 문서, code.claude.com/docs/ko/channels)
OpenClaw 대체라는 말, 데이터로 확인해봤습니다
커뮤니티 반응 중 가장 많이 나온 말이 “OpenClaw 죽었다”입니다. 보안 데이터를 놓고 보면 그 방향이 맞는 이야기처럼 보입니다. OpenClaw(구 OpenClaw)는 2026년 3월까지 총 8개의 CVE를 누적했고, 그 중 CVE-2026-25253은 심각도 8.8/10의 원격 코드 실행 취약점입니다. (출처: medium.com/data-science-collective, 2026.03.18) 심각도 8.8은 공격자가 사용자 확인 없이 원격으로 임의 코드를 실행할 수 있다는 의미입니다.
그런데 기능 범위만 놓고 보면 Channels가 OpenClaw를 아직 앞서지 못하는 부분이 있습니다. 아래 표를 보면 차이가 명확합니다.
| 항목 | Claude Code Channels | OpenClaw |
|---|---|---|
| 지원 플랫폼 | 텔레그램, 디스코드, iMessage | 텔레그램, 디스코드, iMessage, WhatsApp, Slack |
| 세션 지속성 | 수동 (tmux 필요) | 24/7 지속 세션 지원 |
| 보안 모델 | 3중 보안 (발신자 허용목록·세션 옵트인·플러그인 심사) | CVE 8개 누적, RCE 취약점 포함 |
| 유지관리 주체 | Anthropic 공식 | 커뮤니티 (포크 난립) |
| 스킬/플러그인 생태계 | Anthropic 심사 목록만 | 3,200개 이상 (단, 341개 악성 보고) |
수치를 하나 더 보면, OpenClaw의 스킬 레지스트리 3,200개 중 341개가 악성으로 분류됐다는 보고가 있습니다. (출처: LinkedIn/harrison-painter, 2026.03.25) 전체의 약 10.7%입니다. 스킬을 설치할 때 10개 중 1개꼴로 악성일 수 있다는 이야기입니다.
💡 두 서비스의 공식 출시 시점과 보안 이력을 같이 놓고 보니 이런 그림이 나왔습니다.
보안 이슈를 감수하면서 OpenClaw를 쓸 이유는 WhatsApp·Slack 지원과 24/7 지속 세션입니다. Channels가 이 두 가지를 공식으로 채우는 시점이 OpenClaw의 실질적 대체 시점입니다. 현재 리서치 프리뷰 단계에서는 아직 그 지점에 이르지 않았습니다.
지금 쓸 만한지, 기다려야 하는지
리서치 프리뷰 상태를 솔직하게 정리하면 이렇습니다. 써볼 만한 조건과 기다리는 게 나은 조건이 다릅니다.
지금 써볼 만한 경우. Claude Code를 이미 터미널에서 쓰고 있고, Pro나 Max 구독자인 경우. 특히 긴 리팩터링 작업을 돌려놓고 자리를 비울 때 텔레그램으로 진행 상황을 확인하거나 간단한 지시를 추가하는 용도라면 충분히 쓸 수 있습니다. 디스코드를 쓴다면 팀원과 함께 같은 Claude Code 세션에 메시지를 보낼 수 있어서 간단한 비동기 디버깅에도 활용됩니다.
기다리는 게 나은 경우. 외출 중 Claude가 혼자 24시간 작업하는 시나리오를 원한다면 지금은 조건이 맞지 않습니다. 세션 지속성 문제와 권한 프롬프트 이슈가 해결되지 않은 상태입니다. Anthropic이 이 문제에 대해 공식 로드맵을 공개하지 않았습니다. 또한 tengu_harbor 플래그에 아직 포함되지 않은 계정이라면 설정을 아무리 해도 동작하지 않습니다.
–channels 플래그 구문은 변경될 수 있습니다. 공식 문서가 명시적으로 “리서치 프리뷰 기간 중 플래그 구문과 프로토콜 계약은 피드백에 따라 변경될 수 있다”고 밝힙니다. (출처: code.claude.com/docs/ko/channels) 현재 설정을 운영 자동화 파이프라인에 심어두는 건 이르다는 뜻입니다.
Q&A
Q. Claude Code Channels를 쓰려면 반드시 Pro나 Max 구독이어야 하나요?
네, 리서치 프리뷰 기간에는 claude.ai Pro($20/월) 또는 Max($100~200/월) 구독이 필요합니다. API 키 인증은 현재 지원하지 않습니다. 텔레그램·디스코드 플러그인 자체는 오픈소스라 무료지만, Claude Code 실행에 claude.ai 로그인이 필수입니다. (출처: code.claude.com/docs/ko/channels)
Q. 설정을 다 했는데 텔레그램 봇이 전혀 응답하지 않습니다. 왜 그런가요?
가능성이 가장 높은 두 가지입니다. 첫째, Anthropic의 tengu_harbor 서버사이드 피처 플래그에 아직 포함되지 않은 계정일 수 있습니다. 이 경우 설정을 고쳐도 해결되지 않으며 롤아웃 확대를 기다려야 합니다. 둘째, 설정 파일에 DISABLE_TELEMETRY 키가 남아 있는 경우입니다. 값을 0으로 바꾸는 게 아니라 해당 키를 아예 삭제해야 합니다.
Q. 내 코드가 텔레그램 서버로 전송되지는 않나요?
코드 파일은 내 로컬 기기를 벗어나지 않습니다. 텔레그램 서버를 경유하는 건 Claude의 텍스트 답장뿐입니다. 다만 Claude가 작업 결과 요약, 에러 메시지, 파일 내용 일부를 텍스트로 답장할 때 그 텍스트는 텔레그램 서버를 통합니다. 민감한 정보를 포함한 출력은 fakechat(localhost) 플러그인을 사용하는 게 맞습니다. (출처: code.claude.com/docs/ko/channels)
Q. Channels와 Remote Control은 무엇이 다른가요? 둘 다 폰에서 Claude Code를 쓰는 거 아닌가요?
둘 다 로컬 Claude Code 세션을 원격으로 조종하는 건 맞습니다. 차이는 인터페이스와 알림 방식입니다. Remote Control은 claude.ai 웹이나 앱 인터페이스로 연결되고 설정이 간단하지만 네이티브 푸시 알림이 없습니다. Channels는 텔레그램·디스코드를 인터페이스로 쓰기 때문에 네이티브 푸시 알림이 오고, 디스코드 서버 채널을 이용하면 팀원과 공동 접근이 됩니다. 단 설정이 더 복잡합니다. (출처: code.claude.com/docs/ko/channels)
Q. 커스텀 채널 플러그인을 직접 만들어 붙일 수 있나요?
MCP 채널 프로토콜 스펙을 구현하면 누구나 커스텀 플러그인을 만들 수 있습니다. 단, 리서치 프리뷰 기간에는 표준 –channels 플래그가 Anthropic 공식 허용 목록(claude-plugins-official) 플러그인만 받습니다. 직접 만든 채널을 테스트하려면 –dangerously-load-development-channels 플래그가 필요합니다. 이름에 경고 문구가 들어간 이유는 로컬 테스트 전용 플래그이기 때문입니다. (출처: code.claude.com/docs/ko/channels)
마치며
Claude Code Channels는 방향이 옳습니다. AI 코딩 에이전트를 터미널 앞에서만 쓰는 패턴을 깨고, 메신저를 인터페이스로 쓰는 흐름은 앞으로 더 커질 겁니다. 그리고 OpenClaw가 가졌던 보안 부채, 특히 CVE-2026-25253 같은 원격 실행 취약점 없이 공식 채널로 이 기능을 쓸 수 있다는 건 분명한 장점입니다.
다만 현재 상태로는 “폰에서 보내면 알아서 다 해줍니다”라는 인식은 정확하지 않습니다. 세션을 살려두는 방법(tmux)을 직접 구성해야 하고, 권한 프롬프트가 뜨면 여전히 터미널 앞으로 돌아가야 합니다. tengu_harbor 플래그를 아직 받지 못한 계정도 존재합니다. 리서치 프리뷰라는 말이 실질적으로 의미하는 바입니다.
써볼 준비가 됐다면 지금 시작해도 됩니다. 다만 설정하다 봇이 침묵하면 내 설정이 아니라 서버 플래그를 먼저 의심하는 게 시간을 아끼는 방법입니다.
본 포스팅 참고 자료
- Claude Code 공식 채널 문서 — code.claude.com/docs/ko/channels
- Claude Code GitHub 공식 릴리스 노트 (v2.1.80~v2.1.87) — github.com/anthropics/claude-code/releases
- 실사용 함정 정리 및 설정 가이드 (shareuhack.com) — shareuhack.com/en/posts/claude-code-channels-telegram
- Reddit r/ClaudeCode — Channels 실제 사용 경험 스레드 (2026.03.20) — reddit.com/r/ClaudeCode/comments/1ryhbg0
- OpenClaw CVE 현황 및 보안 분석 (data-science-collective) — medium.com/data-science-collective
본 포스팅은 2026년 3월 31일 작성 시점을 기준으로 합니다. Claude Code Channels는 현재 리서치 프리뷰 단계이며, 본 포스팅 작성 이후 서비스 정책·UI·기능·플래그 구문이 변경될 수 있습니다. 투자 및 의사결정에 활용하기 전 공식 문서를 반드시 최신 버전으로 확인하시기 바랍니다.
댓글 남기기