Claude Code v2.1.80 이상
Research Preview
Claude Code Channels, 폰으로 되는 줄 알았습니다
2026년 3월 20일, Anthropic이 Claude Code에 ‘Channels’ 기능을 공식 출시했습니다. 텔레그램·디스코드로 코드를 지시하고 결과를 받을 수 있다는 얘기에 개발자 커뮤니티가 들썩였습니다. 그런데 막상 써보니 기대와 다른 부분이 꽤 됩니다. 결론부터 말씀드리면, “폰으로 Claude Code를 원격 조종한다”는 개념은 맞지만, 컴퓨터를 켜놓지 않으면 메시지가 영구적으로 사라집니다.
Channels가 정확히 어떤 기능인가
Claude Code Channels는 텔레그램이나 디스코드에서 보낸 메시지가 이미 실행 중인 로컬 Claude Code 세션 안으로 직접 들어오는 구조입니다. 클라우드 서버가 새 세션을 띄우는 방식이 아닙니다. 공식 문서에는 이렇게 나옵니다: “Events only arrive while the session is open.” — 세션이 열려 있을 때만 이벤트가 도착한다는 뜻입니다. (출처: code.claude.com/docs/en/channels)
기술적으로는 MCP(Model Context Protocol) 서버가 플러그인 형태로 동작합니다. 텔레그램 봇 API를 로컬에서 폴링하다가 메시지가 오면 그걸 <channel> 이벤트로 세션에 주입하고, Claude가 작업을 처리한 뒤 reply 도구로 텔레그램에 답장을 보냅니다. 코드는 내 로컬 컴퓨터 안에서만 돌고, 외부 서버로 파일이 나가지 않습니다.
현재 Research Preview 단계이고, 텔레그램과 디스코드 두 플랫폼만 지원합니다. 슬랙·왓츠앱·아이메시지는 커뮤니티 플러그인으로 만들 수 있도록 스펙은 공개돼 있지만, Anthropic이 공식으로 검증한 플러그인은 아직 이 두 개뿐입니다.
설정에 필요한 것들 — 생각보다 조건이 있습니다
💡 공식 문서 설치 순서를 그대로 따라가다 봇이 응답하지 않는 사례가 GitHub 이슈에 이미 20개 넘게 올라와 있습니다. 서버 측 플래그 문제일 가능성이 높습니다 — 아래에서 설명합니다.
우선 필수 조건부터 확인해야 합니다.
텔레그램 기준 설치 순서는 다음과 같습니다. BotFather에서 봇을 만들어 토큰을 복사하고, Claude Code 세션에서 /plugin install telegram@claude-plugins-official을 실행합니다. 이어서 /telegram:configure <토큰>으로 저장하고, 세션을 재시작할 때 반드시 claude --channels plugin:telegram@claude-plugins-official 플래그를 붙여야 합니다. --channels 없이 그냥 claude를 실행하면 Channels가 활성화되지 않습니다. 이 부분에서 막히는 분이 많습니다. (출처: code.claude.com/docs/en/channels)
디스코드는 Developer Portal에서 봇을 만들고, Bot 설정에서 Message Content Intent를 반드시 켜야 합니다. 이걸 빠뜨리면 봇이 메시지를 못 읽어서 아무 반응이 없는데, 오류 메시지도 안 나와서 원인을 찾기 어렵습니다.
24시간 대기가 안 되는 구조적 이유
커뮤니티에서 가장 많이 오해하는 부분입니다. “이제 맥미니 안 사도 된다”는 말이 퍼졌는데, 정확하지 않습니다.
⚠️ 메시지 큐가 없습니다
Claude Code 세션이 꺼진 상태에서 텔레그램으로 보낸 메시지는 영구적으로 사라집니다. 봇이 나중에 켜져도 그 메시지를 다시 받아올 방법이 없습니다. (출처: shareuhack.com/en/posts/claude-code-channels-telegram, 2026.03)
이건 설계 문제가 아니라 구조적 한계입니다. Channels는 클라우드에서 메시지를 큐잉하지 않고, 로컬 세션이 살아 있을 때만 텔레그램 봇 API를 폴링합니다. 세션이 닫히면 폴링 자체가 멈추니 메시지를 받을 주체가 없는 겁니다.
그래서 진짜 “자리 비워도 돌아가는” 환경을 만들려면 컴퓨터를 켜두고 tmux로 세션을 유지해야 합니다. 커뮤니티에서 쓰는 방법은 이렇습니다.
while true; do claude –channels plugin:telegram@claude-plugins-official; sleep 5; done
이 스크립트는 세션이 비정상 종료돼도 5초 뒤 자동으로 재시작합니다. tmux attach -t claude-channels로 복귀하면 됩니다. 완전한 24시간 해결책은 아니지만, “낮에 나가 있다가 저녁에 돌아오는” 패턴에는 충분히 씁니다. — 단, 컴퓨터는 계속 켜져 있어야 합니다. 이 점을 놓치면 기대가 크게 어긋납니다.
보안이 탄탄한데 실제론 건너뛰게 되는 이유
💡 공식 발표문의 보안 설계와 실제 원격 작업 흐름을 같이 놓고 보니, 구조적 모순이 보였습니다.
Anthropic은 Channels에 3중 보안 구조를 설계했습니다. 첫째, 페어링된 사용자 ID만 메시지를 보낼 수 있는 발신자 허용 목록. 둘째, 세션마다 --channels 플래그를 명시해야 하는 세션 단위 opt-in. 셋째, Anthropic이 검증한 플러그인만 허용하는 플러그인 화이트리스트. 이 구조는 OpenClaw가 보안 취약점으로 비판받던 것과 비교하면 확실히 진일보한 설계입니다. (출처: code.claude.com/docs/en/channels)
그런데 원격 작업의 핵심은 “내가 자리를 비운 사이에 Claude가 일을 끝내는 것”입니다. 문제는 여기서 생깁니다. Claude가 파일 쓰기나 명령 실행처럼 권한이 필요한 작업에 부딪히면, 터미널에서 직접 승인하기 전까지 세션이 일시 정지됩니다. 폰에서 아무리 메시지를 보내도 Claude는 답이 없고, 결국 컴퓨터 앞에 앉아야 합니다.
이 막힘을 피하려면 --dangerously-skip-permissions 플래그를 씁니다. 이름 그대로 권한 확인을 전부 건너뜁니다. 3중 보안이 “누가 메시지를 보낼 수 있는가”를 막는 구조라면, skip-permissions는 “Claude가 메시지를 받은 뒤 무엇을 할 수 있는가”를 완전히 열어두는 셈입니다. 신뢰하는 환경(예: 개인 프로젝트 전용 디렉터리)에서만 사용하고, 작업 범위를 특정 폴더로 제한하는 게 현실적인 절충점입니다.
보안과 편의 사이의 균형을 단번에 잡기 어려운 것은, Channels가 아직 Research Preview 단계이기 때문이기도 합니다. Anthropic이 공식 답변을 내놓지 않은 부분이라, 앞으로 권한 중계(permission relay) 기능이 보완될 가능성은 있습니다.
OpenClaw와 뭐가 다른지 직접 비교했습니다
커뮤니티에서는 “OpenClaw가 죽었다”는 말이 돌았지만, 실제 차이를 보면 두 도구는 겹치는 영역도, 서로 못 채우는 영역도 있습니다. 2026년 3월 기준 Research Preview 단계 데이터입니다.
텔레그램만 쓰고 보안이 중요하다면 Channels가 낫습니다. 아이메시지·왓츠앱이 필요하거나 진짜 24/7 지속 세션이 필요하다면 OpenClaw를 완전히 버릴 이유가 없습니다. 써보니 이 두 도구는 경쟁 관계라기보다 쓰임새가 다른 관계에 가깝습니다.
설정 함정 6가지 — 이것만 알면 헤매지 않습니다
GitHub 이슈와 실사용 후기를 모아서 자주 막히는 지점을 정리했습니다.
tengu_harbor 서버 플래그 — 설정 잘못이 아닙니다
v2.1.80 이상으로 업데이트했는데도 봇이 응답이 없다면 서버 측 점진적 롤아웃 때문입니다. GitHub 이슈 #36503에 “Channels are not currently available”이라는 메시지가 뜬다고 올라온 것처럼, 계정에 tengu_harbor 플래그가 활성화돼 있지 않으면 설정이 다 맞아도 동작하지 않습니다. 이 경우 기다리거나 GitHub에 요청 이슈를 올리는 것 외에 방법이 없습니다. (출처: github.com/anthropics/claude-code/issues/36503)
DISABLE_TELEMETRY=0 설정이 오히려 막습니다
설정 파일에 DISABLE_TELEMETRY=0으로 돼 있으면 Channels가 동작하지 않습니다. 0은 “텔레메트리 비활성화를 끄겠다”는 뜻으로 읽히지만, 키 자체가 존재하는 것만으로도 Channels를 막습니다. 해결책은 값을 0으로 바꾸는 게 아니라 키 자체를 삭제하는 것입니다. (출처: shareuhack.com/en/posts/claude-code-channels-telegram)
API 키로 로그인하면 아예 사용 불가
Channels는 현재 claude.ai 계정 로그인만 지원합니다. Anthropic Console에서 발급한 API 키로 Claude Code를 쓰고 있다면 Channels를 쓸 수 없습니다. 개발용 API 키 계정과 claude.ai 구독 계정을 별도로 관리하고 있다면 구독 계정으로 다시 로그인해야 합니다. (출처: shareuhack.com/en/posts/claude-code-channels-telegram)
Team·Enterprise는 관리자가 먼저 켜야 합니다
Team·Enterprise 요금제는 기본값이 Channels 비활성화입니다. 관리자가 claude.ai → Admin settings → Claude Code → Channels에서 직접 켜거나, managed settings에서 channelsEnabled: true로 설정해야 합니다. 개인 계정에서 되는 걸 봤다고 팀 계정에서도 된다고 착각하면 시간을 낭비합니다. (출처: code.claude.com/docs/en/channels)
디스코드 Message Content Intent를 빠뜨리면 아무 반응이 없습니다
Discord Developer Portal의 Bot 설정에서 Privileged Gateway Intents 아래 Message Content Intent를 활성화하지 않으면 봇이 메시지를 수신하지 못합니다. 오류 메시지도 나오지 않아서, 설정이 다 됐다고 생각하고 한참 헤매는 분이 많습니다.
텔레그램 사진은 기본 압축 — 스크린샷은 파일로 보내세요
텔레그램은 이미지를 전송할 때 기본으로 압축합니다. 디버그 스크린샷처럼 원본 화질이 필요한 경우에는 “사진”이 아닌 “파일”로 전송해야 합니다. 50MB 이하 파일까지 전송 가능합니다. 음성 메시지는 현재 지원하지 않습니다. (출처: code.claude.com/docs/en/channels)
자주 나오는 질문 5가지
Q1. Claude Code Channels를 쓰려면 유료 플랜이 꼭 필요한가요?
Pro, Max, Team, Enterprise 요금제에서 사용 가능합니다. 무료 플랜은 지원하지 않습니다. 그리고 어느 요금제든 claude.ai 계정으로 로그인해야 하고, API 키만으로는 Channels를 쓸 수 없습니다. (출처: code.claude.com/docs/en/channels, 2026.03.20)
Q2. 슬랙·왓츠앱에서도 쓸 수 있나요?
현재 Research Preview에서는 Anthropic이 공식 검증한 텔레그램과 디스코드 플러그인만 --channels 플래그로 등록할 수 있습니다. 슬랙·왓츠앱용 플러그인을 직접 만들 수는 있지만, 실행할 때 --dangerously-load-development-channels 플래그를 사용해야 합니다. 공식 검증 플러그인 목록은 github.com/anthropics/claude-plugins-official에서 확인할 수 있습니다.
Q3. 다른 사람이 내 봇에 메시지를 보내면 어떻게 되나요?
허용 목록(allowlist)에 없는 사람이 보낸 메시지는 소리 없이 무시됩니다. 오류 응답도 없습니다. 페어링 과정에서 내 텔레그램 또는 디스코드 사용자 ID가 허용 목록에 등록되고, 이후에는 등록된 ID에서 온 메시지만 처리됩니다. (출처: code.claude.com/docs/en/channels)
Q4. 작업이 오래 걸리면 폰에서 어떻게 확인하나요?
Claude가 작업을 마치면 텔레그램이나 디스코드로 답장을 보냅니다. 터미널에서는 답장 내용이 아니라 도구 호출(tool call) 로그와 “sent” 같은 확인 메시지만 표시됩니다. 실제 답장 텍스트는 해당 메신저 앱에서 확인해야 합니다. 단, 세션이 닫혀 있으면 답장 자체가 오지 않습니다. (출처: code.claude.com/docs/en/channels)
Q5. Research Preview가 끝나면 기능이 바뀔 수 있나요?
공식 문서에 “--channels flag syntax and protocol contract may change based on feedback”이라고 명시돼 있습니다. 즉, 플래그 형식이나 플러그인 프로토콜이 달라질 수 있습니다. 지금 단계에서는 개인 프로젝트나 비중요 작업에 사용하고, 핵심 프로덕션 워크플로우에 연결하는 건 Preview가 안정화된 후로 미루는 게 낫습니다. (출처: code.claude.com/docs/en/channels)
마치며 — 지금 쓸 수 있는 사람과 기다려야 할 사람
Claude Code Channels는 방향성 자체는 맞습니다. 텔레그램으로 지시를 보내면 내 로컬 파일에서 Claude가 실제로 일을 처리해주는 경험은 꽤 새롭습니다. 보안 설계도 OpenClaw에 비해 훨씬 체계적입니다.
다만 솔직히 말하면, 지금 단계에서는 기대를 조금 낮춰야 합니다. 세션이 열려 있을 때만 메시지를 받는다는 구조적 한계, API 키로는 쓸 수 없다는 제약, 서버 플래그 게이팅으로 일부 계정은 아직 접근조차 안 된다는 현실이 있습니다. “이제 맥미니 없어도 된다”는 반응은 조금 앞섰습니다.
지금 바로 써볼 만한 경우는 claude.ai 구독 계정이 있고, 컴퓨터를 하루 종일 켜둘 수 있고, 텔레그램이나 디스코드 중 하나를 주로 쓰는 개발자입니다. 반대로 API 키만 있거나, 팀 계정인데 관리자 설정을 바꾸기 어렵거나, 진짜 24시간 자율 에이전트가 필요하다면 지금은 OpenClaw나 NanoClaw가 더 현실적인 선택입니다. 이건 어떤 게 더 좋고 나쁜 문제가 아니라 현재 상태의 차이입니다.
📎 본 포스팅 참고 자료
- Anthropic 공식 Channels 문서 — code.claude.com/docs/en/channels
- Anthropic 공식 플러그인 저장소 — github.com/anthropics/claude-plugins-official
- VentureBeat 분석 기사 “Anthropic just shipped an OpenClaw killer” (2026.03.20) — venturebeat.com
- Shareuhack 실사용 리뷰 (2026.03) — shareuhack.com
- GitHub 이슈 #36503 “Channels are not currently available” — github.com/anthropics/claude-code/issues/36503
- TechZine 분석 기사 “Anthropic builds OpenClaw rival” (2026.03.20) — techzine.eu
본 포스팅은 2026년 3월 24일 기준으로 작성되었습니다. Claude Code Channels는 Research Preview 단계로, 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 특히 --channels 플래그 문법과 플러그인 프로토콜은 정식 출시 전에 달라질 수 있으니 공식 문서를 함께 확인하세요.
댓글 남기기