Claude Code v2.1.80+ 기준
Claude Code Channels, 써보니 이게 달랐습니다
폰에서 메시지 하나 보내면 집 Mac이 혼자 코드를 짠다 — 이 한 줄이 Channels의 전부입니다. 그런데 막상 써보면 “이걸 모르면 막힌다”는 조건이 생각보다 많았습니다.
(Telegram·Discord·iMessage)
(Team 사용 불가)
(없으면 미작동)
Channels가 정확히 뭔지부터
Claude Code Channels는 Anthropic이 2026년 3월 20일에 리서치 프리뷰로 공개한 기능입니다. (출처: Anthropic 공식 문서, code.claude.com/docs/en/channels) 한 줄로 정리하면 “Telegram이나 Discord 같은 메시징 앱에서 이미 실행 중인 Claude Code 세션으로 메시지를 밀어 넣는 브리지”입니다.
기존 Claude Code는 터미널 앞에 앉아서 직접 명령어를 치는 방식이었습니다. 즉, PC에 붙어 있어야만 작동하는 구조였죠. Channels는 이 구조를 바꿨습니다. MCP(Model Context Protocol) 서버가 외부 메시징 플랫폼의 이벤트를 Claude Code 세션으로 주입하고, Claude는 그 이벤트에 반응해 코드를 짜거나 파일을 처리한 뒤 결과를 채팅으로 돌려보냅니다.
💡 공식 문서의 표현을 그대로 옮기면: “채널은 당신이 터미널에 없는 동안 일어나는 일에 Claude가 반응하도록 실행 중인 세션으로 이벤트를 밀어 넣는 MCP 서버”입니다. 여기서 ‘실행 중인 세션’이라는 단어가 핵심입니다. 세션이 꺼져 있으면 어떤 메시지도 도달하지 않습니다.
지원하는 채널은 현재 Telegram, Discord, iMessage 세 가지입니다. 그 외 Slack·WhatsApp은 공식 플러그인이 아직 없어서 커뮤니티에서 직접 만들어야 합니다.
Team 플랜이면 기본 차단됩니다
많은 분들이 “Claude Code를 쓰고 있으니 Channels도 당연히 되겠지”라고 생각하십니다. 그게 아닙니다. 플랜에 따라 접근 자체가 막힙니다.
| 플랜 | Channels 사용 가능? | 비고 |
|---|---|---|
| Pro ($20/월) | ✅ 가능 | 세션당 –channels 플래그로 직접 활성화 |
| Max 5x ($100/월) | ✅ 가능 | 사용량 한도가 Pro보다 5배 넉넉함 |
| Max 20x ($200/월) | ✅ 가능 | 사용량 한도가 Pro보다 20배 넉넉함 |
| Team / Enterprise | ❌ 기본 차단 | 관리자가 channelsEnabled=true 설정 필요 |
| Free | ❌ 불가 | Claude Code 자체가 유료 플랜 전용 |
(출처: Anthropic 공식 문서, code.claude.com/docs/en/channels — Enterprise controls 섹션, 2026.03.20)
💡 공식 문서에 딱 이렇게 나옵니다. “팀·엔터프라이즈 플랜에서 채널은 기본적으로 꺼져 있습니다(Channels are off by default).” 관리자가 Admin 콘솔에서 channelsEnabled를 켜지 않으면 MCP 서버가 연결되더라도 채널 메시지가 아예 도달하지 않습니다. Team 플랜 쓰다가 “왜 안 되지?”하고 당황하는 사례가 나오는 이유입니다.
추가로, Pro·Max 사용자라도 Claude Code와 웹·앱 Claude의 사용량 한도가 공유됩니다. (출처: support.claude.com/en/articles/11145838) Claude Code에서 Channels 작업을 돌리면 그만큼 웹 채팅 한도가 줄어드는 구조입니다. Pro 플랜으로 Channels를 무거운 작업에 쓰면 금방 한도에 부딪힙니다.
세션이 꺼져 있으면 메시지가 안 옵니다
Channels를 쓰려면 Claude Code 세션이 열려 있어야 합니다. 당연한 소리 같지만, 많은 분들이 “폰에서 메시지 보내면 집 PC가 알아서 켜지겠지”라고 기대합니다. 그렇지 않습니다.
공식 문서의 표현은 명확합니다: “이벤트는 세션이 열려 있는 동안에만 도달합니다.” (출처: code.claude.com/docs/en/channels, 2026.03.20) 상시 실행을 원한다면 PC를 끄지 않고 Claude Code를 백그라운드 터미널이나 영구적인 프로세스로 유지해야 합니다.
💡 이게 OpenClaw와 가장 선명하게 갈리는 지점입니다. OpenClaw는 VPS(월 7,000원짜리 클라우드 서버)에 올려두면 365일 24시간 돌아갑니다. Channels는 내 물리적 PC가 켜져 있고 Claude Code도 실행 중이어야만 작동합니다. 노트북을 덮으면 그 순간부터 메시지가 쌓이지 않고 그냥 사라집니다.
권한 요청 팝업이 뜨는 상황도 주의해야 합니다. Claude가 외출 중 작업하다가 권한 승인이 필요한 동작에 부딪히면 세션이 일시 정지됩니다. Channels에서 ‘permission relay’ 기능을 지원하는 플러그인을 쓰면 이 팝업을 폰으로 받아 원격으로 승인할 수 있습니다. 단, 이 기능은 allowlist에 등록된 신뢰 사용자에게만 작동합니다. 아무나 허가 팝업을 받을 수 없는 구조입니다.
무인 작업을 원한다면 --dangerously-skip-permissions 플래그를 쓸 수 있지만, 공식 문서는 “신뢰할 수 있는 환경에서만 사용하라”고 명시했습니다. 샌드박스나 격리된 개발 환경이 아니라면 권장하지 않습니다.
설정 방법 — Telegram 기준 5단계
시작 전 반드시 확인해야 할 요건부터 짚습니다. Claude Code v2.1.80 이상과 Bun 런타임이 설치되어 있어야 합니다. (출처: VentureBeat, 2026.03.20) Bun은 Channels 플러그인이 Bun 스크립트로 작성되어 있기 때문에 필수입니다. bun --version을 터미널에서 쳐서 에러가 뜬다면 먼저 Bun을 설치해야 합니다.
Telegram에서 BotFather 열기 — @BotFather를 검색해 대화를 시작하고 /newbot 명령어로 봇과 액세스 토큰을 생성합니다.
플러그인 설치 — Claude Code 터미널에서 /plugin install telegram@claude-plugins-official 실행.
토큰 설정 — /telegram:configure <your-token>으로 BotFather에서 받은 토큰 입력.
Channels 모드로 재시작 — claude --channels plugin:telegram@claude-plugins-official 명령으로 Claude Code를 실행.
계정 페어링 — Telegram에서 생성한 봇에게 아무 메시지나 보내면 페어링 코드가 옵니다. 터미널에서 /telegram:access pair <code>로 본인 계정을 allowlist에 등록.
여기서 주목할 점이 있습니다. allowlist에 없는 사람이 보낸 메시지는 조용히 무시됩니다. 오류 메시지도 없이 그냥 사라집니다. 처음 써보면 “메시지가 왜 안 먹히지?”라고 당황하는데, 대부분 페어링을 빠뜨린 경우입니다.
설정 전에 fakechat을 먼저 써보는 것을 권장합니다. Fakechat은 외부 서비스 연결 없이 로컬호스트에서 Channels 흐름을 테스트할 수 있는 공식 데모 채널입니다. 플러그인 설치 후 실제 Telegram 봇을 만들기 전에 브라우저에서 Claude Code 세션과 통신이 되는지 먼저 확인할 수 있습니다.
OpenClaw랑 실제로 무엇이 다른가
커뮤니티에서 Channels가 나오자마자 “OpenClaw 킬러”라는 말이 돌았습니다. 실제로는 완전히 대체라기보다 역할이 다릅니다.
💡 공식 발표문과 OpenClaw 실사용 사례를 같이 놓고 보니 이런 차이가 보였습니다
Channels는 “개발 특화 원격 제어”고, OpenClaw는 “범용 자율 에이전트”입니다. 이 차이가 실사용에서 상당히 크게 느껴집니다.
| 항목 | Claude Code Channels | OpenClaw |
|---|---|---|
| 인프라 요건 | 내 PC 상시 켜짐 필요 | VPS에 올리면 24시간 동작 |
| 비용 구조 | Pro($20+)/월 구독 포함 | 오픈소스 + API 별도 과금 |
| 메신저 지원 | Telegram·Discord·iMessage | iMessage·Slack·WhatsApp 등 다수 |
| 개발 작업 품질 | Claude Code(Opus 4.6) 최강 | 범용 에이전트(개발 외 작업 강점) |
| 보안 | Anthropic 상용 보안 기준 | Cisco 팀이 취약점 발견 이력 있음 |
VentureBeat 보도(2026.03.20)에 따르면 X(트위터) 사용자 BentoBoi는 “Claude가 이 업데이트로 OpenClaw를 죽였다. 이제 Mac Mini를 살 필요가 없다”고 했습니다. 하지만 이 말은 개발 특화 워크플로우에만 해당합니다. 이메일 자동 발송, WhatsApp 관리, 범용 자동화가 목적이라면 OpenClaw 계열이 여전히 더 넓은 선택지를 제공합니다.
핵심은 이렇습니다. 코딩 세션 원격 제어가 목적이라면 Channels가 훨씬 안정적이고, 개발 외 광범위한 자동화가 목적이라면 OpenClaw 계열이 여전히 유연합니다.
공식 발표에 없는 주의사항 2가지
출시 직후 공식 문서와 커뮤니티 반응을 교차 확인하다 보니, 발표 자료에서 잘 강조되지 않는 포인트 두 가지가 눈에 띄었습니다.
💡 공식 문서와 실제 설정 흐름을 같이 살펴봤더니 이런 차이가 있었습니다
① allowlist 밖 플러그인은 에러 없이 조용히 차단됩니다
리서치 프리뷰 기간에는 --channels 플래그가 Anthropic이 관리하는 allowlist 또는 Team·Enterprise 관리자가 설정한 allowlist에 있는 플러그인만 허용합니다. 직접 만든 커스텀 채널을 테스트하려면 --dangerously-load-development-channels를 써야 합니다. 문제는, allowlist에 없는 플러그인을 일반 --channels로 넣으면 Claude Code는 정상 실행되지만 채널이 등록되지 않고, 터미널에 조용한 안내 메시지만 출력됩니다. 오류처럼 보이지 않아서 설정이 됐다고 착각하기 쉽습니다. (출처: code.claude.com/docs/en/channels, Research preview 섹션)
② Claude가 터미널에 보내는 답변과 채팅에 오는 답변이 다릅니다
Claude가 채널로 답변을 보낼 때, 터미널에는 툴 호출 기록과 “sent” 같은 확인 표시만 나옵니다. 실제 답변 내용은 터미널에 표시되지 않고 Telegram이나 Discord에만 나타납니다. (출처: code.claude.com/docs/en/channels) 처음 쓰는 분들이 “터미널에 답변이 없어서 작동을 안 하나”라고 오해하는 원인입니다.
리서치 프리뷰 단계이기 때문에 --channels 플래그의 문법과 프로토콜 계약은 피드백에 따라 변경될 수 있다고 Anthropic이 공식 문서에 직접 밝혔습니다. 지금 설정한 방식이 향후 버전에서 달라질 수 있으므로, 팀 내 운영 환경에 Channels를 붙이기 전에 공식 문서를 재확인하는 것이 좋습니다.
자주 나오는 질문 5가지
마치며
Claude Code Channels는 아이디어 자체는 인상적입니다. 폰에서 메시지 하나로 집 PC의 코딩 세션을 움직인다는 경험은 처음 해보면 꽤 새롭습니다. 그런데 써보면 “이 조건이 맞아야 쓸 수 있구나”라는 생각이 먼저 듭니다.
Pro 이상 구독, Bun 런타임, 세션 상시 유지, Team 플랜이면 관리자 설정 — 이 네 가지가 동시에 맞아야 작동합니다. 어느 하나라도 빠지면 조용히 안 됩니다. 오류가 뻔히 뜨는 것도 아니라서 초반에 “왜 안 되지?” 하고 시간을 쓰게 됩니다.
리서치 프리뷰 단계인 만큼 지금 당장 팀 운영 환경에 붙이기보다는, 개인 개발 환경에서 먼저 충분히 테스트해보는 것이 현실적입니다. fakechat으로 동작 원리를 파악하고, 그다음에 Telegram으로 확장하는 순서를 권장합니다.
개발 특화 원격 제어 용도로는 지금도 쓸 만합니다. OpenClaw 계열을 쓰던 분 중에서 보안이 걱정이었거나 API 비용이 부담이었다면, 구독 플랜 내에서 이 기능을 써보는 것도 합리적인 선택입니다.
본 포스팅 참고 자료
본 포스팅은 2026년 3월 27일 기준으로 작성되었습니다. Anthropic의 Claude Code Channels는 현재 리서치 프리뷰 단계이며, 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 최신 정보는 공식 문서에서 확인해 주세요.
댓글 남기기