Claude Code v2.1.80+
리서치 프리뷰
Claude Code 채널, 이 조건이면 텔레그램 연결이 안 됩니다
텔레그램에서 메시지 하나로 Claude Code에 일을 시킬 수 있다는 소식, 이미 들으셨을 겁니다. 2026년 3월 20일 Anthropic이 공식 출시한 Claude Code Channels가 그 주인공인데요. 그런데 설치를 끝냈는데도 봇이 아무 반응이 없는 경우가 있습니다. 설정 오류가 아닙니다. 공식 문서에서 직접 확인한 3가지 조건이 맞지 않으면, 아무리 해도 안 됩니다.
Claude Code 채널이 뭔지 결론부터
솔직히 말하면, 처음 소식 접했을 때 “이제 노트북 안 켜도 되겠다”는 생각이 먼저 들었습니다. 텔레그램이나 디스코드에서 메시지 하나 보내면 집에 있는 PC가 알아서 코드 짜고 결과까지 보내준다니까요. Claude Code 채널(Channels)은 2026년 3월 20일 Claude Code v2.1.80에서 리서치 프리뷰로 첫 공개된 Anthropic 공식 기능입니다. (출처: Claude Code GitHub Releases — v2.1.80 changelog)
핵심 개념은 단순합니다. 일반 MCP 서버가 “Claude가 호출할 때만 반응”하는 수동적 구조라면, 채널은 반대입니다. 텔레그램 메시지가 오면, CI 빌드가 실패하면, Datadog 알림이 울리면 — 외부 이벤트가 Claude Code 세션 안으로 먼저 뛰어들어 옵니다. Anthropic Head of Claude Code Boris Cherny는 출시 직후 이렇게 설명했습니다: “A channel is an MCP server that pushes events into a Claude Code session so Claude can react to things happening outside the terminal.” (출처: Claude Code Channels 공식 레퍼런스 문서)
💡 공식 발표에서 자주 빠지는 내용이 있습니다. 채널은 로컬에서만 돌아갑니다. 내 PC가 꺼져 있으면, 세션이 종료되어 있으면 — 텔레그램 메시지는 그냥 사라집니다. “어디서든 제어” 가능하지만, “항상” 가능하지는 않습니다.
지원 채널은 현재 텔레그램·디스코드·iMessage 세 가지입니다. 카카오톡은 두 도구 모두 공식 미지원입니다. (출처: Claude Code Channels 개요 문서)
안 되는 3가지 조건 — 공식 문서에 딱 나와 있습니다
v2.1.80으로 업데이트했고, 플러그인도 설치했는데 봇이 아무 말도 안 합니다. 이 상황을 겪었다면 아래 세 가지 중 하나입니다.
① API 키로 로그인한 상태
Claude Code 채널은 claude.ai 계정 로그인 필수입니다. API 키 인증으로는 작동하지 않습니다. 공식 문서에 “claude.ai account login required (API key authentication is not supported)”라고 명시되어 있습니다. (출처: Claude Code Channels 개요 문서) API 키로 Claude Code를 쓰던 개발자라면 처음부터 막히는 조건입니다. 로그인 방식 자체를 바꿔야 합니다.
② Pro/Max 미구독 상태
Free 플랜은 채널을 쓸 수 없습니다. Pro($20/월) 이상이 필요합니다. 팀·엔터프라이즈 환경에서는 추가 조건이 있습니다 — 관리자가 claude.ai Admin 설정에서 channelsEnabled: true를 명시적으로 활성화해야 채널이 켜집니다. 기본값은 비활성이라, 개인 Pro 계정과는 동작 조건이 다릅니다. (출처: Claude Code Channels — Enterprise 설정 섹션)
③ 내 계정이 순차 배포 대상이 아닌 경우
💡 커뮤니티에서 가장 많이 혼동하는 부분입니다. Anthropic은 서버 사이드 피처 플래그(tengu_harbor)를 사용해 Channels를 단계적으로 배포합니다. v2.1.80으로 업데이트하고 플러그인을 설치해도, 내 계정이 배포 범위에 없으면 플러그인은 설치되지만 이벤트 핸들러 자체가 등록되지 않습니다. 봇이 설치는 됐는데 반응이 없다면, 설정 문제가 아닐 가능성이 높습니다.
확인 방법은 간단합니다: 텔레그램 봇에 메시지를 보냈을 때 페어링 코드가 오지 않으면, 서버 사이드 게이팅 상태입니다. 추가 디버깅보다 배포 확대를 기다리는 게 현실적입니다.
④ 숨은 4번째 함정: DISABLE_TELEMETRY 설정
DISABLE_TELEMETRY 키가 Claude Code 설정에 존재하면, 값을 0으로 설정해도 채널이 차단됩니다. “끄지 않는다”는 의미로 0을 넣은 건데, 키 자체가 있으면 채널이 비활성화됩니다. 해결은 키를 아예 삭제하는 것입니다. 값 변경이 아닙니다.
보안이 탄탄하다는 말, 반만 맞습니다
Claude Code 채널의 보안 구조는 공식 문서 기준으로 3계층입니다. 페어링 코드 인증, 세션 단위 opt-in(매 실행마다 --channels 플래그 필수), Anthropic이 승인한 플러그인만 허용. 여기까지는 맞습니다.
💡 공식 발표문과 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다. 보안 3계층은 “누가 메시지를 보낼 수 있는가”를 막습니다. 그런데 진짜 원격 제어의 핵심 — “PC 앞에 없을 때 Claude가 알아서 실행”하려면, 결국 --dangerously-skip-permissions 플래그가 필요합니다. 이 플래그를 쓰는 순간, 허용된 발신자의 메시지는 무엇이든 내 로컬 머신에서 실행됩니다.
공식 채널 레퍼런스 문서는 이렇게 설명합니다: “To truly achieve unattended remote control, you’ll almost certainly need --dangerously-skip-permissions.” 이 플래그의 이름 자체가 경고입니다. (출처: Claude Code Channels 레퍼런스 — 권한 섹션)
결과적으로 사용 방식은 두 가지로 나뉩니다.
파일 쓰기·명령 실행 시 터미널에서 직접 승인.
보안은 최대.
--dangerously-skip-permissions 필요.작업 범위를 특정 디렉토리로 제한 권장.
보안 위험 직접 감수.
이 부분이 아쉬웠습니다. Permission Relay(원격에서 텔레그램으로 도구 실행 승인·거부)가 있지만, 정말 아무도 없는 환경에서는 한계가 있습니다. 보안과 편의의 균형을 직접 조정해야 합니다.
텔레그램 연결 15분 설치 흐름 정리
위 3가지 조건을 통과했다면 설치 자체는 어렵지 않습니다. 흐름만 잡아두겠습니다.
/newbot → 이름·username(bot으로 끝나야 함) 설정 → 토큰 복사/plugin install telegram@claude-plugins-official
/telegram:configure <토큰>
/reload-pluginsclaude --channels plugin:telegram@claude-plugins-official--channels 플래그 없이 시작하면 채널이 이벤트를 수신하지 않습니다./telegram:access pair <코드>
/telegram:access policy allowlist⚠️ 오프라인 메시지는 영구 유실됩니다. 채널에는 메시지 큐가 없습니다. 세션이 종료된 상태에서 텔레그램 메시지를 보내면, 그 메시지는 돌아오지 않습니다. 장시간 자리를 비울 때는 tmux로 세션을 유지하는 방법이 현실적 대안입니다.
# tmux 세션 유지 패턴 (커뮤니티 검증)
tmux new -s claude-channels
while true; do claude –channels plugin:telegram@claude-plugins-official; sleep 5; done
공식 발표와 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다
“어디서든 Claude Code를 제어할 수 있다”는 문장은 맞습니다. 그런데 실제 데이터를 같이 놓고 보면 이야기가 좀 달라집니다.
비용이 예상보다 빠르게 닳습니다
2026년 3월 26일 Forbes가 보도한 내용을 보면, $100 플랜(Max 5x) 사용자가 단순한 CRUD 데이터베이스 작업 프롬프트 하나로 5시간 세션 한도의 37%를 소진했습니다. 이후 모델을 바꾸어도 한 세션 안에서 약 70%까지 올라갔습니다. (출처: Forbes, 2026.03.26 — Anthropic: Huge Pricing Issues With Glitching Claude Code Limits) Anthropic 엔지니어는 X(트위터)를 통해 “오전 피크 시간대(한국 기준 평일 오후 9시~오전 3시)에 5시간 세션 한도가 더 빠르게 차도록 조정했다”고 공식 언급했습니다. 주간 총량은 동일하지만, 하루 안에 쓸 수 있는 양이 줄어드는 구조입니다.
💡 이 수치가 채널 사용에서 의미하는 것: 텔레그램으로 작업을 원격 지시하면 터미널에서 직접 할 때보다 컨텍스트 처리량이 늘어납니다. 메시지 파싱과 응답 전송 과정에서 토큰이 추가로 쓰입니다. 피크 시간대에 긴 작업을 원격으로 걸어두면, 예상보다 훨씬 빨리 세션 한도에 부딪힐 수 있습니다.
텔레그램과 디스코드의 도구 기능이 다릅니다
같은 채널처럼 보이지만 실제 Claude에게 주어지는 도구 스펙이 다릅니다. (출처: claude-plugins-official GitHub)
| 도구 | 텔레그램 | 디스코드 |
|---|---|---|
| reply (메시지 전송) | ✅ | ✅ |
| react (이모지 리액션) | ✅ | ✅ |
| fetch_messages (메시지 히스토리 조회) | ❌ | ✅ (최대 100건) |
| download_attachment (첨부 파일) | ✅ (50MB) | ✅ (25MB) |
텔레그램은 Bot API 특성상 메시지 히스토리 조회가 안 됩니다. 과거 대화 맥락을 Claude에게 넘겨야 하는 작업에서는 디스코드가 유리합니다. 반면 파일 첨부 용량은 텔레그램(50MB)이 디스코드(25MB)의 두 배입니다. 스크린샷이나 로그 파일을 자주 보내야 한다면 텔레그램이 낫습니다.
OpenClaw와 뭐가 다를까 — 수치로 비교
커뮤니티에서 “OpenClaw 종말론”이 나왔지만, 막상 비교해보면 대체가 아니라 용도가 다릅니다. 결정적 차이 두 가지만 짚겠습니다.
아키텍처가 근본적으로 다릅니다
Claude Code 채널은 내 PC에서만 돌아갑니다. 인바운드 포트 없음, 외부 서버 없음. 텔레그램 메시지는 로컬 플러그인이 Bot API를 long-polling으로 받아서 세션에 밀어 넣는 구조입니다. OpenClaw는 EC2/VPS 등 클라우드 서버에서 상시 실행됩니다. 내 PC가 꺼져 있어도 서버는 돌아갑니다. (출처: Claude Code Channels 개요 문서 — 아키텍처 다이어그램)
| 항목 | Claude Code 채널 | OpenClaw |
|---|---|---|
| 실행 위치 | 내 PC (로컬) | 클라우드 서버 (EC2/VPS) |
| PC 꺼지면? | 세션 종료, 메시지 유실 | 서버는 계속 실행 |
| 지원 LLM | Claude 전용 | Claude, GPT 등 복수 |
| 지원 플랫폼 수 | 3개 (텔레그램·디스코드·iMessage) | 12개+ (WhatsApp, Slack 등 포함) |
| 보안 이슈 | 공식 관리, 인바운드 포트 없음 | CVE-2026-25253 (CVSS 8.8) 등 다수 사례 |
| 구독 조건 | Pro $20/월 이상 | 무료 (서버 비용 별도) |
OpenClaw의 보안 사고 기록은 실측 데이터가 있습니다. 독립 보안 연구원 Maor Dayan이 4만 2천 개, SecurityScorecard STRIKE 팀이 13만 5천 개 이상의 공개 노출 인스턴스를 발견했고, CVE-2026-25253(CVSS 8.8, 1-click RCE)이 공개됐습니다. (출처: CrowdStrike 종합 리포트) 이 수치가 의미하는 건 명확합니다 — 보안보다 편의가 우선인 사용자가 그만큼 많다는 뜻이고, Channels는 그 반대편을 노린 설계입니다.
Q&A
마치며
Claude Code 채널은 분명 흥미로운 기능입니다. 공식 지원, 3계층 보안, 설치 15분 — 이것만 봐도 충분히 써볼 이유가 됩니다.
그런데 막상 해보면 다릅니다. API 키 사용자는 시작부터 막히고, Free 플랜이면 아예 대상이 아니며, Pro/Max라도 내 계정이 순차 배포 범위 밖이면 설치 후에도 봇이 묵묵부답입니다. DISABLE_TELEMETRY 키 하나가 조용히 채널을 막는 경우도 있습니다.
솔직히 말하면 지금은 “설치 가능한지 확인”이 먼저인 기능입니다. 페어링 코드가 텔레그램으로 오면 운 좋게 배포 대상이 된 겁니다. 그때부터 실제로 써볼 수 있습니다. 피크 타임 토큰 소진 속도와 오프라인 메시지 유실 문제는 감안하면서, 자리를 비우는 낮 시간 동안 간단한 작업을 걸어두는 용도로 시작하는 게 현실적입니다.
리서치 프리뷰가 정식 출시로 넘어가면 달라질 부분이 많습니다. 그 전에 지금 조건을 확인해두는 게 낭비 없이 시작하는 방법입니다.
본 포스팅 참고 자료
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. Claude Code Channels는 현재 리서치 프리뷰 상태로, 기능·가격·지원 플랫폼·배포 범위가 정식 출시 시 달라질 수 있습니다. 최신 정보는 Anthropic 공식 문서를 직접 확인하시기 바랍니다.
댓글 남기기