Claude Code 신기능: Telegram과 Discord로 원격 제어하기

Who Should Read

Claude Code를 개발 워크플로우에 적극 활용 중인 개발자, 특히 터미널을 떠나 있는 동안에도 Claude에게 작업을 시키거나 승인 요청을 처리하고 싶은 사람.

Core Mechanics

• Claude Code Channels는 MCP 서버 방식으로 동작한다. 외부 채널(Telegram, Discord)에서 이벤트를 Claude Code 세션에 밀어 넣으면, Claude가 반응하고 같은 채널로 답장을 보내는 구조다.
• v2.1.81부터 'permission relay' 기능이 추가됐다. 채널 서버가 permission capability를 선언하면, Claude가 도구 실행 승인 요청을 터미널이 아닌 스마트폰으로 전달할 수 있다. 즉, 폰에서 승인 버튼을 누르는 게 가능해졌다.
• 이 기능을 쓰려면 Claude가 백그라운드 프로세스나 항상 켜져 있는 터미널에서 실행 중이어야 한다. 세션이 살아 있어야 이벤트를 받을 수 있기 때문이다.
• 설정 시 주의할 점: MCP 서버가 동작하려면 'Bun'이 설치되어 있어야 한다. 설치 후에는 새 터미널을 열어야 적용된다. Telegram 플러그인이 안 보이면 마켓플레이스 캐시를 새로고침해볼 것.
• 대안 도구로 'Claude Code Tunnels'도 있다. 항상 켜진 세션이나 Bun 설치가 필요 없어서 채널 방식보다 간단하다는 평가도 있으니 본인 상황에 맞게 선택하면 된다.
• 플러그인 탐색은 Claude Code 내부에서 '/plugin' 명령어로 바로 할 수 있다. 공식 플러그인을 찾고 설치하는 데 이게 제일 편하다.

Evidence

• 실제 사용자들은 Git/GitHub CLI 작업(커밋, 브랜치, 풀, 푸시)을 폰에서 Claude에게 지시하는 용도로 활용하고 있다.
• Claude Code 내에서 '!' 접두사를 붙이면 셸 명령어를 바로 실행할 수 있고, 결과가 컨텍스트에 바로 반영된다. 이 기능과 채널을 조합하면 원격에서도 셸 작업 지시가 가능하다.
• 컨텍스트가 길어질수록 성능이 떨어진다는 사용자 경험이 공유됐다. 원격 제어 시에도 컨텍스트를 짧고 집중적으로 유지하는 게 좋다.
• Claude Code Tunnels 방식을 써본 사용자는 Bun 설치 불필요, 항상 켜진 세션 불필요, 별도 승인 프롬프트 없이 'claude -p'로 처리 가능하다는 점에서 채널 방식보다 낫다고 평가했다.

How to Apply

• Telegram으로 원격 제어를 해보고 싶다면: Bun을 먼저 설치하고, Claude Code 내에서 '/plugin'으로 Telegram 플러그인을 찾아 설치한다. Claude를 백그라운드 터미널에서 실행해두면 폰에서 Telegram으로 작업 지시가 가능하다.
• 항상 켜진 세션 관리가 번거롭다면: Claude Code Channels 대신 Claude Code Tunnels를 먼저 검토해볼 것. Bun 없이 더 간단하게 원격 접근을 설정할 수 있다.
• 폰에서 도구 실행 승인을 처리하고 싶다면: Claude Code v2.1.81 이상으로 업데이트하고, permission relay를 지원하는 채널 서버를 사용하면 터미널 없이 폰으로 승인 요청을 처리할 수 있다.

Code Example

# Claude Code 내에서 셸 명령어 실행 (! 접두사 활용)
! git status
! git add . && git commit -m "feat: add new feature"
! git push origin main

# Claude Code 플러그인 탐색 및 설치
/plugin

# Claude를 백그라운드에서 실행 (채널 사용 시 세션 유지 필요)
nohup claude &

Terminology

Related Resources

• 원본 Reddit 포스트
• 기능 소개 원본 트윗