Claude Code Channels, 켜두면 다 된다고요?
텔레그램으로 Claude에게 메시지를 보내면 내 로컬 파일을 바꿔준다는 기능, 솔직히 들었을 때 “이거 진짜 혁명 아닌가” 싶었습니다. 막상 공식 문서를 보니 몇 가지 조건이 붙어 있어서 그걸 먼저 짚어보려 합니다.
Telegram · Discord · iMessage 지원
Team/Enterprise 기본 차단
Channels가 정확히 무엇인가요?
Claude Code Channels는 텔레그램, 디스코드, iMessage 같은 외부 메신저에서 보낸 메시지가 지금 내 컴퓨터에서 돌아가고 있는 Claude Code 세션 안으로 들어오게 해주는 기능입니다. 반대 방향도 됩니다. Claude가 작업을 마치면 답장을 텔레그램으로 돌려보내줍니다.
기술적으로는 MCP(Model Context Protocol) 서버가 이벤트를 세션으로 ‘밀어 넣는’ 구조입니다. 기존 MCP가 Claude가 필요할 때 서버에 ‘물어보는’ 방식이라면, Channels는 반대로 외부에서 먼저 ‘말 거는’ 구조입니다. (출처: Anthropic 공식 Channels 문서, 2026.03.20)
💡 공식 발표문과 실제 동작 구조를 함께 놓고 보니 MCP의 방향이 완전히 뒤집힌다는 게 보였습니다. 기존 MCP는 Claude → 서버, Channels는 서버 → Claude입니다.
2026년 3월 19일 v2.1.80에서 --channels 플래그가 처음 등장했고, 3월 20일 v2.1.81에서 권한 릴레이 기능이 추가됐습니다. 현재는 리서치 프리뷰 단계로, 지원 플랫폼은 텔레그램, 디스코드, iMessage 세 가지입니다. (출처: GitHub Claude Code CHANGELOG, 2026.03.20)
세션이 닫혀 있으면 메시지를 못 받습니다
Channels에 대해 가장 먼저 짚어야 할 부분입니다. 공식 문서에 이렇게 나옵니다.
“Events only arrive while the session is open, so for an always-on setup you run Claude in a background process or persistent terminal.”
— Anthropic 공식 Channels 문서
컴퓨터를 닫거나 터미널을 종료하면 Claude Code 세션이 꺼집니다. 세션이 꺼지면 텔레그램에서 아무리 메시지를 보내도 아무 일도 안 일어납니다. ‘항상 대기 중인 AI 비서’처럼 쓰려면 Claude Code를 백그라운드 프로세스 형태로 계속 띄워놓아야 합니다.
💡 Channels 발표 직후 “이제 전화기로 집 서버를 제어할 수 있다”는 반응이 많았는데, 집 서버가 항상 켜져 있어야 한다는 전제가 빠진 얘기입니다. 클라우드 환경처럼 서버가 상시 가동 중이어야 비로소 의미 있습니다.
그래서 Channels의 진짜 활용처는 개인 PC가 아닌, 항상 실행 중인 개발 서버나 CI 환경입니다. “외출 중에 집 PC에 메시지 보내서 코드 고친다”는 시나리오는 집 PC의 터미널이 열려 있을 때만 성립합니다.
Team 플랜이라면 먼저 확인할 것
Pro·Max 개인 사용자는 --channels 플래그를 붙이면 바로 쓸 수 있습니다. 문제는 Team·Enterprise 사용자입니다.
공식 문서에 따르면 Team과 Enterprise 플랜에서 Channels는 기본적으로 꺼진 상태입니다. 관리자가 channelsEnabled를 true로 설정하거나 claude.ai 어드민 콘솔에서 토글을 켜지 않으면, MCP 서버는 연결되지만 채널 메시지는 들어오지 않습니다. (출처: Anthropic 공식 Channels 문서 — Enterprise controls 섹션)
| 플랜 | 기본 상태 | 활성화 방법 |
|---|---|---|
| Pro / Max (개인) | ✅ 기본 활성화 | --channels 플래그만 붙이면 됨 |
| Team / Enterprise | ❌ 기본 차단 | 관리자가 어드민 콘솔 또는 managed-settings에서 활성화 |
회사 플랜을 쓰는데 Channels가 안 된다면, 팀 Claude Code 설정 페이지(claude.ai/admin-settings/claude-code)에서 관리자에게 토글을 요청해야 합니다. 설정이 꺼져 있으면 Claude Code 시작 시 경고가 뜨므로 바로 확인할 수 있습니다.
Remote Control과 헷갈리는 이유
Claude Code에는 비슷해 보이는 기능이 두 개 나란히 있습니다. Remote Control과 Channels입니다. 공식 문서에서 이 둘을 명확하게 구분하는데, 핵심은 누가 먼저 말을 거는가입니다.
💡 Remote Control은 ‘내가 다른 기기에서 세션을 조종하는 것’이고, Channels는 ‘외부 앱에서 오는 이벤트에 Claude가 반응하는 것’입니다. 방향이 정반대입니다.
| 구분 | Remote Control | Channels |
|---|---|---|
| 트리거 주체 | 내가 다른 기기에서 직접 | 외부 앱 (텔레그램, CI 등) |
| 대화 인터페이스 | claude.ai/code 또는 모바일 앱 | 텔레그램, 디스코드, iMessage |
| 이상적인 상황 | 작업 중인 세션을 이어서 원격 조종 | CI 실패 알림, 외부 훅 자동 반응 |
| 필요 플랜 | Pro / Max / Team / Enterprise | Pro / Max (Team은 관리자 활성화 필요) |
공식 문서에서는 “Channels는 비 Claude 소스가 이미 실행 중인 로컬 세션으로 이벤트를 밀어 넣는다”고 설명합니다. 즉, Channels는 내가 제어하는 게 아니라 외부 시스템이 Claude를 깨우는 것입니다. 개인이 폰으로 집 PC를 조종하는 시나리오라면 Remote Control이 더 적합합니다. (출처: Anthropic Remote Control 공식 문서)
보안 설계, 이 부분이 핵심입니다
Channels 기능에서 가장 중요하게 살펴봐야 하는 부분입니다. 외부 메신저가 로컬 Claude Code 세션으로 메시지를 밀어 넣는다는 건, 잘못 설정하면 모르는 사람이 내 파일 시스템을 건드릴 수 있다는 의미입니다.
Anthropic은 이를 막기 위해 발신자 허용 목록(Sender Allowlist) 방식을 채택했습니다. 텔레그램과 디스코드는 ‘페어링 코드’ 방식으로 처음 연결 시 허용 목록에 등록됩니다. 등록되지 않은 발신자의 메시지는 조용히 폐기됩니다. iMessage는 본인 번호로 자신에게 보내는 경우 자동 허용되고, 추가 등록은 /imessage:access allow 명령으로 합니다. (출처: Anthropic 공식 Channels 문서 — Security 섹션)
💡 v2.1.81 기준, 권한 릴레이(Permission Relay) 기능이 추가됐습니다. 세션에서 Claude가 권한 승인을 요구할 때 폰의 텔레그램으로 “허용할까요?” 메시지가 오고, 답장으로 승인 또는 거부를 할 수 있습니다. 편리하지만 허용 목록에 있는 사람이 내 Claude의 도구 사용을 원격으로 승인할 수 있다는 의미이기도 합니다.
여기서 짚어볼 지점이 있습니다. 무인 환경에서 권한 프롬프트 없이 돌리려면 --dangerously-skip-permissions 플래그를 써야 합니다. 공식 문서는 “신뢰할 수 있는 환경에서만 쓰라”고 명시하고 있습니다. 신뢰할 수 없는 환경에서 이 플래그를 켜고 Channels까지 활성화하면, 허용 목록을 우회한 공격자가 로컬 파일 시스템에 접근할 수 있는 경로가 생깁니다. Anthropic이 이 조합의 위험성을 별도로 강조한 이유가 있습니다. (출처: Anthropic 공식 Channels 문서 — Security 섹션)
실제로 설치하고 써보려면
Channels 플러그인은 Bun이 필요합니다. Claude Code가 설치된 상태에서 아래 순서로 진행합니다.
① 먼저 작동 방식 체험 — fakechat
실제 텔레그램 없이 로컬에서 Channels 흐름을 먼저 테스트할 수 있는 ‘fakechat’ 데모가 공식 제공됩니다. 브라우저에서 메시지를 보내면 터미널 세션으로 들어오고, Claude 답장이 브라우저에 뜹니다. Bun이 있다면 별도 인증 없이 바로 실행됩니다.
② 텔레그램 연결 순서
- 텔레그램에서 봇을 찾아 아무 메시지나 보냄
- 봇이 페어링 코드를 응답
- Claude Code 세션에서 프롬프트 승인
- 내 텔레그램 ID가 허용 목록에 등록됨
등록 이후부터는 claude --channels 플래그와 함께 세션을 시작하면 텔레그램 메시지가 세션으로 들어옵니다. 세션이 실행 중일 때만 동작한다는 점은 다시 한 번 기억해둘 필요가 있습니다.
현재 리서치 프리뷰 단계이므로 --channels 플래그 문법과 프로토콜 계약은 피드백에 따라 바뀔 수 있습니다. 공식 문서에 “syntax and protocol contract may change based on feedback”라고 명시돼 있습니다. (출처: Anthropic 공식 Channels 문서 — Research preview 섹션)
Q&A 5가지
Q1. Channels는 Pro 플랜에서도 쓸 수 있나요?
네, Pro와 Max 개인 플랜에서는 관리자 설정 없이 바로 사용할 수 있습니다. --channels 플래그를 붙여 세션을 시작하면 됩니다. Team·Enterprise는 관리자가 먼저 어드민 콘솔에서 활성화해야 합니다.
Q2. 스마트폰 앱을 닫아도 Channels가 유지되나요?
스마트폰 앱과는 관계없습니다. 로컬 컴퓨터의 Claude Code 세션이 실행 중인지가 기준입니다. 컴퓨터 세션이 켜져 있으면 폰 앱을 닫아도 텔레그램 메시지는 세션으로 들어옵니다. 반대로 컴퓨터 세션이 종료되면 수신이 중단됩니다.
Q3. Channels는 Slack도 지원하나요?
현재 리서치 프리뷰에서 공식 지원하는 채널은 텔레그램, 디스코드, iMessage 세 가지입니다. Slack은 별도의 Claude Code on the web + Slack 앱 연동으로 처리됩니다. Channels와는 다른 아키텍처입니다. 커스텀 채널을 직접 빌드하면 이론적으로 다른 플랫폼도 연결할 수 있습니다.
Q4. Channels 사용 시 추가 요금이 발생하나요?
Channels 기능 자체에 별도 요금이 명시돼 있지는 않습니다. 다만 채널을 통해 Claude가 작업을 수행하면 토큰이 소비됩니다. claude.ai 구독 플랜의 사용량 한도 안에서 소비되므로, 반복적으로 자동 실행되는 워크플로우를 구성할 경우 사용량 소진 속도가 빨라질 수 있습니다.
Q5. iMessage와 텔레그램 중 어느 쪽이 더 안전한가요?
설계 구조상 차이가 있습니다. iMessage는 본인 번호로 자신에게 보내는 것을 기본으로 상정해 허용 목록 관리가 단순합니다. 텔레그램과 디스코드는 페어링 코드로 등록한 ID만 허용됩니다. 어느 쪽이든 허용 목록에 신뢰하는 대상만 등록하는 것이 보안의 핵심입니다. macOS에서만 iMessage를 쓸 수 있다는 제약도 있습니다.
마치며
Claude Code Channels는 분명히 흥미로운 기능입니다. 텔레그램으로 메시지 한 줄 보내서 로컬 코드베이스에 변경이 일어난다는 건 실제로 쓸 수 있는 자동화 수준이 달라진다는 의미입니다.
다만 공식 문서를 실제로 읽어보면 마케팅 문구 이면에 중요한 전제 조건들이 있습니다. 세션이 켜져 있어야만 동작하고, Team 플랜이라면 관리자 활성화가 먼저이고, 무인 환경으로 운영하려면 보안 설정을 꼼꼼히 살펴야 합니다. 리서치 프리뷰 단계이므로 플래그 문법이 바뀔 가능성도 공식적으로 열려 있습니다.
개인적으로 가장 실용적인 시나리오는 항상 켜져 있는 개발 서버에서 CI 실패나 외부 훅을 받아 Claude가 자동으로 처리하도록 구성하는 것입니다. 집 PC를 폰으로 조종하는 시나리오라면 Remote Control이 더 직관적입니다.
현재는 리서치 프리뷰라 변경이 잦을 수 있습니다. 주요 변경이 생기면 GitHub CHANGELOG에서 확인할 수 있으며, 피드백은 Claude Code 공식 GitHub 이슈 트래커로 제출할 수 있습니다.
본 포스팅 참고 자료
- Anthropic 공식 Channels 문서 — https://docs.anthropic.com/en/docs/claude-code/channels
- GitHub Claude Code CHANGELOG — https://github.com/anthropics/claude-code/releases
- Anthropic 공식 Remote Control 문서 — https://docs.anthropic.com/en/docs/claude-code/remote-control
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. Claude Code Channels는 현재 리서치 프리뷰 단계로, 플래그 문법과 동작 방식이 달라질 수 있습니다. 최신 정보는 공식 GitHub CHANGELOG와 Anthropic 문서를 직접 확인하세요. 본 포스팅은 2026년 3월 27일 기준 공식 자료를 바탕으로 작성되었습니다.
댓글 남기기