<aside> 📡 **Claude Code v2.1.80+**에서 텔레그램으로 Claude와 대화할 수 있는 공식 기능입니다. 스마트폰에서 메시지를 보내면 PC의 Claude Code가 작업하고 결과를 돌려줍니다.

</aside>

Channels란?

Channel은 Claude Code 세션에 외부 메시지를 밀어넣는 MCP 서버입니다.

텔레그램에서 메시지 보내기 → Claude Code가 읽고 작업 → 결과를 텔레그램으로 답변

터미널 앞에 없어도 Claude에게 지시할 수 있고, CI 결과나 모니터링 알림도 전달할 수 있습니다.

사전 준비 — 시작하기 전에 확인하세요

<aside> 🛠️ 아래 3가지가 모두 준비되어야 합니다. 하나라도 없으면 진행할 수 없습니다.

</aside>

1. Claude Code CLI — 터미널에서 claude --version을 입력했을 때 v2.1.80 이상이 나와야 합니다.
2. Bun 런타임 — 터미널에서 bun --version을 입력했을 때 버전이 나와야 합니다. 설치 안 되어 있다면: curl -fsSL <https://bun.sh/install> | bash
3. 텔레그램 계정 — 스마트폰에 텔레그램 앱이 설치되어 있고 로그인된 상태여야 합니다.

확인 방법:

# 터미널에서 아래 두 명령어를 실행하세요
claude --version    # → 2.1.80 이상이면 OK
bun --version       # → 숫자가 나오면 OK

설정 가이드 — 처음부터 끝까지

아래 6단계를 순서대로 따라하면 됩니다. 각 단계마다 스크린샷 대신 정확한 동작을 설명합니다.

Step 1 · 텔레그램 봇 만들기 (토큰 받기)