Claude Code v2.1.80 · Research Preview
Claude Code Channels, 5분 설정으로 다 될까요? 4가지 조건을 직접 확인했습니다
텔레그램으로 Claude Code를 원격 제어할 수 있다는 말, 사실입니다. 그런데 공식 문서에는 같이 봐야 할 내용이 따로 있습니다.
Claude Code Channels가 뭔지 딱 한 문장으로
Anthropic이 2026년 3월 20일 리서치 프리뷰로 출시한 기능입니다. 한 줄 요약: 텔레그램이나 디스코드 메시지를 로컬에서 실행 중인 Claude Code 세션으로 바로 밀어 넣을 수 있는 구조입니다. (출처: Anthropic 공식 문서, 2026.03.20)
기존 Claude Code는 터미널 앞에 앉아야 작동하는 도구였습니다. 작업 중간에 자리를 비울 수 없었고, 폰으로 뭔가 지시하려면 Remote Control을 열고 claude.ai 인터페이스를 통해야 했죠. Channels는 이 구조를 바꿉니다. 텔레그램 봇에게 메시지를 보내면, Claude가 그 내용을 읽고 로컬 파일시스템에서 직접 작업한 뒤 결과를 같은 채팅으로 돌려보냅니다.
기술적으로는 MCP(Model Context Protocol) 서버 구조입니다. Bun 런타임으로 동작하는 채널 플러그인이 외부 메시징 플랫폼의 이벤트를 Claude Code 세션으로 전달하는 방식이죠. 코드와 도구는 내 기기에 그대로 남고, 메시징 앱은 그 세션을 들여다보는 창 역할을 합니다.
💡 공식 문서와 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다. Channels는 클라우드 코딩 환경이 아닙니다. 세션은 내 기기에서 돌아가고, 메시징 앱은 그 세션에 연결되는 인터페이스일 뿐입니다. “폰으로 코딩하는 것”이 아니라 “폰으로 내 기기에 있는 Claude Code를 지시하는 것”입니다.
폰에서 시작이 안 된다 — 가장 많이 오해하는 부분
Channels를 쓰면 폰으로 Claude Code를 완전히 다룰 수 있을 것 같습니다. 막상 써보면 다릅니다. 세션을 시작하는 건 여전히 내 기기 터미널에서 해야 합니다. 외출 전에 터미널을 켜두지 않았다면, 폰에서는 아무것도 할 수 없습니다.
공식 문서에서 직접 확인한 내용입니다. “Session must stay running: Close the terminal or stop the claude process and the channel goes offline.” (출처: Channels 공식 문서 제한사항 항목) 세션을 닫으면 채널도 끊깁니다.
여기서 끝이 아닙니다. Claude가 권한 프롬프트를 만나면 세션이 멈춥니다. 파일 수정이나 bash 명령어 실행 때 승인이 필요한데, 텔레그램으로는 그 승인을 할 방법이 없습니다. 승인하려면 터미널 앞으로 가야 합니다. 이걸 우회하려면 --dangerously-skip-permissions 플래그를 사용하는 방법이 있지만, 공식 문서에서 “격리된 환경 외에는 사용하면 안 된다”고 명시한 옵션입니다. 일반 개발 환경에서는 권장하지 않습니다.
💡 “텔레그램에서 Claude에게 지시할 수 있다”는 말과 “폰으로 모든 걸 다 할 수 있다”는 말은 다릅니다. Channels는 이미 켜져 있는 세션에 명령을 밀어 넣는 구조입니다. 세션을 켜는 것, 권한 승인하는 것은 여전히 기기 앞에서만 됩니다.
주의: Remote Control과 다르게 Channels는 10분 네트워크 단절 후 자동 타임아웃이 있습니다. 노트북이 절전 모드로 들어가면 세션이 종료됩니다. 장시간 운영이 필요하다면 VPS에 올리거나 기기 절전 설정을 꺼두는 방법을 함께 고려해야 합니다.
텔레그램 vs 디스코드, 취향 차이가 아닙니다
많은 가이드에서 “텔레그램이나 디스코드 중 평소 쓰는 걸 선택하면 된다”고 합니다. 공식 문서를 직접 보면 이야기가 달라집니다. 두 플랫폼 사이에는 구조적 차이가 하나 있고, 그게 실제 사용 방식에 영향을 줍니다.
| 항목 | 텔레그램 | 디스코드 |
|---|---|---|
| 메시지 히스토리 | 없음 (Bot API 미지원) | 있음 (최대 100개) |
| 세션 재시작 시 | 오프라인 중 메시지 소실 | fetch_messages로 복구 가능 |
| 팀 공유 | 그룹 챗 가능 | 서버 채널로 팀 공유 가능 |
| 설정 난이도 | 약 5분 (BotFather만) | 약 10분 (Developer Portal 필요) |
| 파일 전송 | 최대 50MB, 이미지 자동 수신 | 첨부파일 수동 다운로드 |
| 작업 중 상태 확인 | “타이핑 중…” 표시 | 상태 표시 없음 |
(출처: claudefa.st Channels 공식 가이드, 2026.03 / Anthropic 공식 문서)
핵심은 메시지 히스토리입니다. 텔레그램 Bot API는 메시지 히스토리를 제공하지 않습니다. 세션이 꺼진 사이에 보낸 메시지는 복구할 방법이 없습니다. 반면 디스코드는 fetch_messages 도구로 최대 100개 메시지를 가져올 수 있어서, 세션이 재시작되어도 그 사이에 쌓인 요청을 Claude가 처리할 수 있습니다.
빠르게 시작하고 싶다면 텔레그램. 세션이 끊겼다 켜지는 일이 잦거나, 팀이 함께 쓴다면 디스코드가 더 안정적입니다.
설정 가이드 — 텔레그램 5단계·디스코드 6단계
설정 전에 두 가지를 먼저 확인합니다.
- Claude Code 버전 v2.1.80 이상:
claude --version으로 확인. 낮으면npm install -g @anthropic-ai/claude-code로 업데이트 - Bun 런타임 설치: 채널 플러그인이 Bun으로 동작합니다.
bun --version으로 확인. 없다면curl -fsSL https://bun.sh/install | bash - Pro 또는 Max 플랜: API 키 인증은 지원하지 않습니다. claude.ai 계정 로그인이 필요합니다.
텔레그램 연결 (5단계, 약 5분)
- 텔레그램에서 @BotFather에게
/newbot전송 → 이름과 username 입력 → 토큰 복사 - Claude Code에서:
/plugin install telegram@claude-plugins-official /telegram:configure <발급받은-토큰>- 종료 후 재시작:
claude --channels plugin:telegram@claude-plugins-official - 텔레그램에서 내 봇에게 아무 메시지 전송 → 6자리 코드 수신 → Claude Code에서
/telegram:access pair <코드>입력 후/telegram:access policy allowlist실행 (내 계정만 허용)
디스코드 연결 (6단계, 약 10분)
- Discord Developer Portal에서 New Application 생성
- Bot 탭 → 토큰 Reset → 복사
- Bot 설정에서 “Message Content Intent” 반드시 활성화 (이게 빠지면 메시지 내용이 빈 값으로 수신됩니다)
- OAuth2 → URL Generator → bot 스코프 + 메시지 관련 권한 선택 → 생성된 URL로 서버 초대
- Claude Code에서:
/plugin install discord@claude-plugins-official→/discord:configure <토큰> claude --channels plugin:discord@claude-plugins-official로 재시작 → 봇에게 DM 전송 → 페어링 코드 입력
팁. Remote Control과 Channels를 동시에 쓰려면 플래그를 합치면 됩니다: claude remote-control --channels plugin:telegram@claude-plugins-official. claude.ai 앱으로도 제어하면서 텔레그램 알림까지 받을 수 있습니다.
Team·Enterprise 사용자가 먼저 확인해야 할 것
개인 Pro/Max 플랜은 설정하면 바로 됩니다. 그런데 Team이나 Enterprise 요금제를 쓴다면 한 단계가 더 있습니다. Channels는 조직 관리자 설정에서 기본값이 비활성화입니다. 관리자가 먼저 켜줘야 팀원이 사용할 수 있습니다.
공식 문서에 직접 나와 있습니다. “On Team and Enterprise plans, organization admins control channel availability through a channelsEnabled managed setting. It’s disabled by default and must be explicitly enabled.” (출처: claudefa.st 공식 가이드) 설정을 다 했는데 채널이 작동하지 않는다면, 먼저 관리자에게 활성화 요청을 해야 합니다.
한 가지 더. 현재 Research Preview 상태라 --channels 플래그에서 허용되는 플러그인은 Anthropic이 관리하는 공식 목록 안의 플러그인만 됩니다. 커스텀 채널 플러그인을 직접 만들어 사용하려면 --dangerously-load-development-channels 플래그를 써야 하는데, 이름처럼 운영 환경에서 쓰기에는 적합하지 않습니다. 슬랙이나 WhatsApp 지원은 아직 공식 릴리스 일정이 발표되지 않았습니다.
💡 보안 측면에서 Channels 데이터 흐름을 이해해두면 좋습니다. Claude의 응답은 텔레그램·디스코드 서버를 경유합니다. 민감한 코드나 API 키가 응답에 포함될 경우 외부 서버를 통한다는 의미입니다. Remote Control은 Anthropic API를 통하고, Channels는 메시징 플랫폼 서버를 추가로 통합니다. 사내 규정이 있다면 이 점을 먼저 확인해야 합니다.
OpenClaw와의 차이, 공식 자료로 직접 비교했습니다
Channels가 출시되자마자 “OpenClaw 킬러”라는 말이 나왔습니다. VentureBeat도 같은 제목을 붙였습니다. AI YouTuber Matthew Berman은 “They’ve BUILT OpenClaw”라고 했죠. (출처: VentureBeat, 2026.03.20) 그런데 두 도구를 같이 놓고 보면 남아 있는 차이가 보입니다.
| 항목 | Claude Code Channels | OpenClaw |
|---|---|---|
| 폰에서 세션 시작 | ❌ 불가 | ✅ 가능 |
| 지원 메신저 | 텔레그램, 디스코드 (공식) | Signal, Telegram, Discord, WhatsApp 등 |
| 권한 프롬프트 폰 승인 | ❌ 터미널 직접 승인 | ✅ 메신저에서 승인 |
| 보안 감사 | Anthropic 상업 제품 기준 | CVE-2026-25253 (CVSS 8.8) 확인 |
| 24/7 상시 운영 비용 | Pro/Max 구독 내 포함 | 약 월 7,000원 VPS 별도 필요 |
| 오픈소스 여부 | 플러그인은 GitHub 공개 | 오픈소스 (커뮤니티 스킬 12% 악성 코드 포함 확인) |
(출처: Yanli Liu, Medium, 2026.03 / VentureBeat, 2026.03.20)
결정적인 차이는 세션을 시작하는 주체입니다. OpenClaw는 서버가 항상 켜진 상태로 폰에서 첫 명령을 넣을 수 있습니다. Channels는 기기에서 먼저 세션을 열어야 그 다음부터 폰으로 제어가 가능합니다. “항상 켜진 AI 비서”를 원한다면 아직 VPS에 직접 운영하는 방식이 더 맞습니다.
보안 면에서는 반대입니다. OpenClaw 커뮤니티 스킬 저장소에서 전체의 약 12%가 악성 코드로 확인됐습니다. (출처: Yanli Liu 분석, 2026.03) Channels는 Anthropic이 관리하는 공식 플러그인 목록만 허용하는 구조라 이 문제를 피할 수 있습니다.
Q&A 5가지
마치며
Claude Code Channels는 “폰으로 Claude Code를 쓸 수 있다”는 말이 처음으로 현실적인 의미를 갖게 된 기능입니다. 텔레그램 봇 하나로 이미 켜진 세션에 작업을 밀어 넣고, 결과를 알림으로 받는 경험은 실제로 작업 방식이 달라지는 수준입니다.
그런데 공식 문서와 실사용 사례를 같이 보면, 이 기능이 해결하는 것과 아직 해결 못하는 것이 명확합니다. 세션을 시작하는 건 여전히 기기 앞에서 해야 하고, 권한 프롬프트가 터미널을 잡고 있으면 텔레그램에서 할 수 있는 게 없습니다. 완전한 “자리 비워도 돌아가는 AI”를 원한다면 아직 VPS에 별도 에이전트를 올리는 방식이 현실적입니다.
솔직히 말하면, 지금 상태로도 충분히 유용합니다. 긴 빌드를 시작해두고 자리를 비웠다가 텔레그램 알림을 받는 용도, 이동 중에 빠른 수정 지시를 보내는 용도 — 이 두 가지만으로도 Pro/Max 구독에 값어치를 충분히 합니다. Research Preview라는 딱지가 떼어질 때, 아마 세션 시작과 권한 승인을 폰에서도 할 수 있게 될 것입니다. 그때가 진짜 데스크 탈출의 시점이 될 것 같습니다.
한 줄 정리
세션을 켜두고 나간다면 폰이 터미널이 됩니다. 그 전에는 아닙니다.
본 포스팅 참고 자료
- Anthropic 공식 Claude Code Channels 문서 — https://code.claude.com/docs/en/channels
- VentureBeat — “Anthropic just shipped an OpenClaw killer called Claude Code Channels” (2026.03.20) — 링크
- claudefa.st Claude Code Channels 상세 설정 가이드 (2026.03) — 링크
- Yanli Liu, “Claude Code Just Got Channels. Is It Enough?” Medium (2026.03) — 링크
- Anthropic Claude March 2026 Usage Promotion 공식 문서 — 링크
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 모든 정보는 2026년 3월 27일 기준 공식 문서를 바탕으로 작성되었습니다.

댓글 남기기