Claude Code v2.1.80+
리서치 프리뷰
Claude Code Channels 직접 써봤습니다
— 되는 것과 막히는 것
2026년 3월 20일, Anthropic이 Claude Code에 Channels 기능을 공개했습니다.
텔레그램·디스코드로 내 PC에서 돌아가는 코딩 에이전트를 원격 조종하는 기능입니다.
설정을 마치고 나서야 보이는 함정이 두 가지 있었습니다.
Claude Code Channels가 뭔지, 한 줄로 정리하면
Claude Code Channels는 이미 열려 있는 내 로컬 Claude Code 세션에 텔레그램·디스코드 메시지를 밀어 넣는 기능입니다.
클라우드 서버를 새로 띄우는 게 아니라, 지금 터미널에서 돌고 있는 세션 그대로 씁니다.
코드는 내 PC에 있고, Claude는 내 파일을 직접 건드립니다.
기술 구조는 MCP(Model Context Protocol)입니다. 텔레그램 플러그인이 로컬에서 Bot API를 폴링하다가 메시지가 오면 Claude Code 세션에 푸시하고, Claude가 처리한 뒤 같은 경로로 답장을 보냅니다.
외부 서버를 경유하지 않습니다. URL을 노출할 필요도 없습니다.
“세션이 열려 있는 동안만 메시지가 도착한다”는 문구가 공식 문서에 명시돼 있습니다.
(출처: code.claude.com/docs/en/channels, 2026.03.20 기준)
즉, Claude Code가 꺼져 있을 때 텔레그램으로 보낸 메시지는 영구 소실됩니다. 큐가 없습니다.
많은 소개 글이 “자리를 비워도 된다”고 표현하는데, 정확히는 “내 PC가 켜져 있고 세션이 살아 있는 동안만”입니다.
이 차이가 실사용에서 꽤 크게 느껴집니다.
Team·Enterprise 플랜은 기본값이 다릅니다
Claude Code Channels를 켜는 데 플랜별로 기본값이 다릅니다. Pro·Max는 `–channels` 플래그만 붙이면 바로 됩니다.
그런데 Team·Enterprise는 조직 관리자가 먼저 활성화해야 합니다.
| 플랜 | Channels 기본값 | 활성화 방법 |
|---|---|---|
| Pro / Max (개인) | ✅ 사용 가능 | 세션 시작 시 --channels 플래그 |
| Team / Enterprise | ❌ 기본 비활성화 | 관리자 → Admin settings → Claude Code → Channels 활성화 |
공식 문서에 딱 이렇게 나옵니다: “Team / Enterprise: Channels disabled until an admin explicitly enables them.”
(출처: code.claude.com/docs/en/channels, 2026.03.20 기준)
팀 플랜을 쓰는데 봇이 아무 반응이 없다면, 설정 문제가 아니라 관리자 승인이 안 된 거일 가능성이 높습니다.
MCP 서버는 .mcp.json에 등록돼 있어도 --channels에 명시되지 않으면 메시지를 받을 수 없습니다.
플러그인 설치와 Channels 활성화는 별개 단계입니다. 설치만 하고 플래그를 빼먹으면 봇은 침묵합니다.
텔레그램 연결 7단계 — 막히는 지점만 짚어드립니다
시작 전에 꼭 확인할 게 있습니다. 피처 플래그 게이팅 문제입니다.
Anthropic이 서버사이드 피처 플래그(tengu_harbor)로 점진적 롤아웃을 하고 있어서,
v2.1.80으로 업데이트해도 아직 대상에 포함되지 않은 계정은 봇이 응답하지 않습니다.
(출처: shareuhack.com Claude Code Channels Hands-On 리뷰, 2026.03.21 / GitHub Issue #34528)
설정 오류가 아닙니다. 서버사이드 게이팅입니다.
@BotFather에게 /newbot 입력 → 이름 설정 → 토큰 복사. 토큰은 직접 코드에 넣지 말고 ~/.claude/channels/telegram/.env에 저장됩니다.
Claude Code 세션에서 /plugin install telegram@claude-plugins-official 실행. 플러그인 마켓플레이스가 없으면 먼저 /plugin marketplace add anthropics/claude-plugins-official.
공식 채널 플러그인은 Bun 스크립트로 작성돼 있습니다. bun --version으로 확인 후 없으면 curl -fsSL https://bun.sh/install | bash. Node나 Deno도 호환되지만 공식 플러그인은 Bun 기준으로 빌드돼 있습니다.
/telegram:configure 입력 후 BotFather 토큰 붙여넣기. 자동으로 ~/.claude/channels/telegram/.env에 저장됩니다.
가장 많이 막히는 지점입니다. 플러그인을 설치했더라도 claude --channels plugin:telegram@claude-plugins-official로 실행해야 채널이 활성화됩니다. 플래그 없이 실행하면 플러그인은 연결되지만 메시지를 받지 못합니다.
텔레그램에서 만든 봇에게 아무 메시지 전송 → 봇이 6자리 페어링 코드 응답 → Claude Code 터미널에서 /telegram:access pair 입력 후 코드 승인.
/telegram:access policy allowlist로 허용 목록 외 메시지 차단. 이 단계를 빠뜨리면 발신자 ID를 아는 누구나 메시지를 주입할 수 있습니다.
3중 보안 구조, 그런데 실제로는 이렇게 씁니다
Claude Code Channels의 보안 구조는 3층으로 설계돼 있습니다.
발신자 허용 목록, 세션당 명시적 opt-in, 플러그인 화이트리스트입니다.
공식 문서에 각각의 작동 방식이 상세히 나와 있습니다. (출처: code.claude.com/docs/en/channels, 2026.03.20 기준)
--channels 플래그를 달아야만 메시지 수신. 실행할 때마다 명시해야 합니다.
Claude가 파일 쓰기나 명령어 실행 같은 작업에 도달하면 터미널에서 수동 승인이 필요합니다.
자리를 비운 상태에서 이 프롬프트가 뜨면 세션이 멈춥니다.
완전 비감독 원격 제어를 하려면 사실상 --dangerously-skip-permissions가 필요한데,
이 플래그는 Claude Code의 모든 권한 검사를 우회합니다.
(출처: code.claude.com/docs/en/channels, permission-modes 항목, 2026.03.20 기준)
3중 보안이 “누가 보낼 수 있냐”를 막는다면, 이 플래그는 “받은 메시지로 무엇을 할 수 있냐”의 제약을 없앱니다.
실용적인 선택지는 두 가지입니다. 주시 가능한 상황에서는 기본 모드, 완전 비감독이 필요한 경우엔 격리된 디렉터리 내에서 skip-permissions를 쓰는 식으로 쓰임새를 구분하는 게 현실적입니다.
OpenClaw와 다른 점 — 표로 직접 비교했습니다
Channels가 공개된 직후 커뮤니티에서 “OpenClaw는 이제 끝났다”는 반응이 쏟아졌습니다.
막상 기능 목록을 놓고 보면 이야기가 다릅니다.
| 항목 | Claude Code Channels | OpenClaw | NanoClaw |
|---|---|---|---|
| 지원 플랫폼 | 텔레그램·디스코드·iMessage | 텔레그램·디스코드·iMessage·WhatsApp·Slack | 텔레그램·디스코드·WhatsApp·Slack |
| 세션 지속성 | 세션 열려야 수신 | 24시간 지속 가능 | Docker 컨테이너 유지 |
| 보안 구조 | 3중 레이어 (공식) | 보안 우회 이슈 제기됨 | Docker 샌드박스 |
| 유지 주체 | Anthropic (공식) | 커뮤니티 (Peter Steinberger) | 커뮤니티 |
| 엔터프라이즈 제어 | 관리자 설정 지원 | 없음 | 제한적 |
| 메시지 큐 | 없음 | 있음 | 있음 |
Channels는 보안과 공식 지원에서 앞서고, OpenClaw는 플랫폼 폭과 세션 지속성에서 앞섭니다.
텔레그램 기준으로 개인 프로젝트에 가끔 쓰는 용도라면 Channels로 충분합니다.
WhatsApp이나 Slack이 반드시 필요하거나 세션 24시간 유지가 필수라면 OpenClaw가 아직 유효합니다.
알고 가야 할 함정 4가지
공식 문서와 실사용 리뷰를 교차해서 보니, 사전에 알지 못하면 시간을 꽤 잃을 수 있는 지점이 4개 있었습니다.
Q&A
마치며 — 지금 써야 하나, 아직 기다려야 하나
Claude Code Channels는 방향이 맞습니다. MCP 위에 채널 아키텍처를 올린 설계는 확장성이 있고,
3중 보안 구조와 엔터프라이즈 제어도 공식 도구로서 합당한 수준입니다.
그런데 지금 당장 쓰기엔 두 가지 현실적인 장벽이 있습니다.
피처 플래그 게이팅으로 아직 접근 불가한 계정이 있고,
메시지 큐 부재로 세션을 항상 열어둬야 한다는 운영 부담이 있습니다.
지금 추천하는 접근은 이렇습니다. 먼저 설정을 한 번 해보세요. 봇이 정상 응답하면 개인 프로젝트에서 써보고 감각을 잡아두는 게 좋습니다. 응답이 없으면 설정 오류가 아닌 서버사이드 게이팅이니 OpenClaw를 계속 쓰면서 Anthropic의 롤아웃을 기다리는 쪽이 현실적입니다.
리서치 프리뷰가 정식 출시로 넘어가면 메시지 큐와 플랫폼 폭 문제도 함께 개선될 가능성이 높습니다.
본 포스팅 참고 자료
-
Anthropic 공식 Channels 문서 —
code.claude.com/docs/en/channels
(2026.03.20 기준) -
Anthropic 공식 Channels 레퍼런스 문서 —
code.claude.com/docs/en/channels-reference
(2026.03.20 기준) -
Claude Code Channels Hands-On 리뷰 (ShareuHack) —
shareuhack.com/claude-code-channels-telegram
(2026.03.21) -
Anthropic builds OpenClaw rival (TechZine) —
techzine.eu
(2026.03.21) -
GitHub Issue #34528 — tengu_ccr_bridge 피처 플래그 버그 리포트 —
github.com/anthropics/claude-code/issues/34528
본 포스팅은 2026년 3월 25일 기준으로 작성되었습니다. Claude Code Channels는 리서치 프리뷰 단계이며,
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다.
--channels 플래그 문법과 프로토콜 계약은 공식 출시 전까지 변경될 수 있으니 최신 공식 문서를 참고하세요.
댓글 남기기