Channels — 텔레그램/디스코드에서 Claude Code 제어
Claude Code밖에서 모바일로 세션에 메시지를 보내고, Claude가 로컬 파일시스템에서 작업
Channels는 외부 메신저(텔레그램/디스코드)에서 로컬에서 실행 중인 Claude Code 세션에 메시지를 push(inject)할 수 있는 기능이다. 2025년 3월에 research preview로 출시되었다.
핵심 개념
클라우드로 세션을 이전하는 게 아니다. 내 컴퓨터에서 돌아가는 Claude Code 세션에 모바일로 창을 하나 더 여는 것이다. Claude는 여전히 내 로컬 파일시스템, Git, MCP 서버에 완전히 접근한다.
어떤 상황에서 쓰는가?
장시간 빌드/테스트를 걸어놓고 밖에서 텔레그램으로 진행 상황 확인
카페에서 모바일로 "그 파일 수정해줘" 지시
배포 후 모니터링하다가 문제 발견 시 즉시 Claude에게 디버깅 요청
잠자기 전에 "내일 아침까지 이거 해놔" 식의 장기 작업 지시
셋업 방법 (텔레그램)
먼저 Claude Code를 실행한 후:
/plugin install telegram@claude-plugins-official
/reload-plugins
그 다음 세션을 --channels 플래그와 함께 시작:
claude --channels plugin:telegram@claude-plugins-official
텔레그램 봇에 DM을 보내면 6자리 페어링 코드가 오고, 이를 입력하면 연결 완료.
지원 플랫폼
| 플랫폼 | 지원 여부 | 비고 |
|---|---|---|
| 텔레그램 | 공식 지원 | Bot API가 간단, 월 10억 사용자 |
| 디스코드 | 공식 지원 | 팀 단위 사용에 적합 |
| 슬랙 | 미지원 | 커뮤니티 요청 중, 곧 나올 가능성 |
주의사항
Permission 승인: 텔레그램에서는 permission 승인이 안 된다. 터미널에 직접 가서 해야 함.
--dangerously-skip-permissions플래그를 쓰면 해결되지만 보안 위험세션 유지 필요: Claude Code가 실행 중이어야만 메시지 수신 가능. 상시 연결하려면 persistent 터미널(tmux, screen)에서 실행
v2.1.80 이상 필요
Pro/Max 플랜 필요
Channels vs Remote Control 차이
| 기능 | Channels | Remote Control |
|---|---|---|
| 접속 방식 | 텔레그램/디스코드 앱 | claude.ai 웹/앱 |
| 인터페이스 | 메신저 채팅 | Claude Code 전체 UI |
| Permission 승인 | 불가 (터미널에서만) | 가능 |
| 적합한 용도 | 간단한 지시·확인 | 풀 세션 작업 |
| 별도 설치 | 플러그인 필요 | 불필요 (/remote-control) |
Channels vs Remote Control vs /btw 비교
| 기능 | Channels | Remote Control | /btw |
|---|---|---|---|
| 접속 방식 | 텔레그램/디스코드 앱 | claude.ai 웹/앱 | 같은 터미널 내 |
| 실행 위치 | 외부 → 로컬 세션 | 외부 → 로컬 세션 | 로컬 → 사이드 대화 |
| Permission 승인 | 불가 | 가능 | 해당 없음 |
| 별도 설치 | 플러그인 필요 | 불필요 | 불필요 |
| 적합한 용도 | 간단한 지시·모니터링 | 풀 세션 작업 | 작업 중 사이드 질문 |
| 메인 컨텍스트 영향 | 영향 있음 (같은 세션) | 영향 있음 (같은 세션) | 영향 없음 (분리) |
셋업 커맨드
1. 플러그인 설치
/plugin install telegram@claude-plugins-official
2. 플러그인 리로드
/reload-plugins
3. Channels 모드로 세션 시작
claude --channels plugin:telegram@claude-plugins-official
4. (선택) Permission 자동 승인 모드
claude --channels plugin:telegram@claude-plugins-official --dangerously-skip-permissions
⚠ 보안 위험 — 모든 파일 읽기/쓰기/명령 실행이 자동 승인됩니다
주의사항
세션이 열려있어야 수신 가능
Claude Code가 종료되면 텔레그램 메시지를 받을 수 없습니다. 상시 연결하려면 tmux나 screen에서 실행하세요.
Permission 승인은 터미널에서만
파일 쓰기나 명령 실행 시 permission 승인이 필요한 경우, 텔레그램에서 할 수 없습니다. --dangerously-skip-permissions를 쓰거나 터미널에 가서 직접 승인해야 합니다.
Research Preview + Pro/Max 플랜 필요
아직 정식 출시가 아닌 research preview 단계입니다. Claude Code v2.1.80 이상, Pro 또는 Max 플랜이 필요합니다.
사용 방법
/plugin install telegram@claude-plugins-official → /reload-plugins
claude --channels plugin:telegram@claude-plugins-official 으로 세션 시작
텔레그램 봇에 DM → 6자리 페어링 코드 입력 → 연결 완료
텔레그램에서 메시지 보내면 Claude가 로컬 파일시스템에서 작업 + 답장
Tags
Source
Anthropic (2025.3)