이제 터미널 앞에 없어도, 텔레그램 앱에서 Claude에게 직접 일을 시킬 수 있습니다.
저도 처음 이 소식 봤을 때 "이거 진짜야?" 싶었어요. Claude Code는 원래 터미널에서만 쓰는 도구거든요. 화면 앞에 앉아서 직접 타이핑해야 했는데, 이제 폰을 꺼내서 텔레그램으로 메시지 하나 보내면 Claude가 읽고 알아서 처리한 다음 답장까지 줘요.
이게 단순한 편의 기능이 아닌 이유를 설명할게요. 그리고 연결하는 방법도요.
Claude Code Channels가 뭔가요?
한 줄로 요약하면: 외부 메신저에서 보낸 메시지가 실행 중인 Claude Code 세션으로 실시간 전달되는 기능이에요.
작동 흐름은 이래요:
📱 내 텔레그램 → 내가 만든 봇에게 메시지 전송
↓
🔌 Channel 플러그인 → Claude Code 세션으로 전달
↓
🤖 Claude가 작업 수행
↓
📩 결과를 텔레그램으로 답장
단방향이 아니에요. Claude가 텔레그램으로 답장도 해줘요. "방금 푸시한 파일에 오류 없어?" 보내면 확인하고 결과를 텔레그램으로 알려줘요.
사진도 돼요. 스크린샷을 찍어서 보내면 Claude가 읽고 분석해줘요.
이게 왜 의미 있을까요?
지금까지 AI 도구를 제대로 쓰려면 항상 컴퓨터 앞에 앉아 있어야 했어요. 화면이 없으면, 세션이 끊기면, 외출 중이면 — 사실상 아무것도 못 했죠.
| 기존 | Channels 이후 |
|---|---|
| 터미널 앞에 앉아서 직접 입력 | 폰 텔레그램으로 메시지 한 줄 |
| 자리 비우면 작업 중단 | 이동 중에도 Claude가 작업 계속 |
| 결과를 터미널에서 확인 | 텔레그램으로 답장 받음 |
| 텍스트만 입력 가능 | 사진·스크린샷도 전송 가능 |
회의 중에, 이동 중에, 자리를 비운 사이에도 Claude는 계속 일하고 — 저는 결과만 받아보는 거예요. 이게 진짜 "AI 비서"의 느낌이 나는 첫 번째 기능이라고 생각해요.
텔레그램 연결 방법 — 5단계
이 기능은 Claude Code v2.1.80 이상이 필요해요. 그리고 실행 환경에 bun이 설치되어 있어야 합니다.
bun은 Node.js처럼 코드 실행 환경인데, 설치는 터미널에서
curl -fsSL https://bun.sh/install | bash 한 줄로 끝나요.
1텔레그램 봇 만들기
텔레그램에서 @BotFather를 검색해서 대화를 열어요. 그 다음 아래 메시지를 보내세요.
봇 이름과 유저네임을 입력하면 토큰을 발급해줘요. 이 토큰을 복사해 두세요. (나중에 필요해요)
📌 유저네임은 영문+숫자만 가능하고 반드시 bot으로 끝나야 해요. (예: melon_helper_bot)
2플러그인 설치
Claude Code 세션(터미널)에서 아래 명령어를 실행해요.
📌 Claude Code 내부 명령어예요. 터미널에서 claude를 실행한 상태에서 입력하면 됩니다.
3토큰 설정
1단계에서 복사한 봇 토큰을 아래처럼 입력해요.
📌 토큰은 .claude/channels/telegram/.env에 저장돼요. 깃허브 같은 곳에 올라가지 않도록 주의하세요.
4Channels 플래그로 Claude Code 재시작
Claude Code를 종료한 다음, 아래처럼 --channels 플래그를 붙여서 다시 시작해요.
📌 이 플래그 없이 그냥 claude만 실행하면 Channels 기능이 켜지지 않아요.
5페어링 & 보안 설정 (제일 중요)
텔레그램에서 내가 만든 봇에게 아무 메시지나 보내세요. 봇이 6자리 페어링 코드를 줄 거예요.
Claude Code 세션에서 아래 두 줄을 입력해요.
/telegram:access policy allowlist
⚠️ 두 번째 줄이 핵심이에요. 기본값인 pairing 정책은 코드만 알면 누구나 연결할 수 있어요. allowlist로 바꿔야 내 계정만 Claude에게 메시지를 보낼 수 있습니다.
📌 이 설정을 빠뜨리면 보안 문제가 생길 수 있어요. 꼭 설정하세요.
여기까지 하면 연결 완료예요! 이제 텔레그램에서 봇에게 메시지를 보내면 Claude가 읽고 답장해줘요.
실제로 어떻게 씁니까?
연결이 되면 그냥 텔레그램에서 메시지를 보내면 돼요. 예시를 몇 가지 들어볼게요.
💬 "지금 작업 폴더에 뭐가 있어?"
💬 "방금 수정한 파일 내용 요약해줘"
💬 "테스트 돌려보고 결과 알려줘"
💬 "이 스크린샷 보고 뭐가 문제인지 알려줘" (이미지 첨부)
💬 "오늘 작업 내용 정리해서 메시지로 보내줘"
터미널에서는 Claude가 도구를 쓰는 모습과 짧은 확인 메시지만 보이고, 실제 답변 내용은 텔레그램으로 받아요. 화면을 볼 필요가 없어요.
저는 카페에서 업무 관련 아이디어가 떠올랐을 때 바로 폰으로 Claude에게 보내고, 노트북으로 돌아왔을 때 결과를 확인하는 식으로 쓰고 있어요.
알아두면 좋은 것들
✅ 세션이 열려 있을 때만 작동해요
Channels는 실행 중인 Claude Code 세션에 연결되는 구조예요. Claude Code를 종료하면 텔레그램 메시지가 도착해도 아무 일도 안 일어나요. 항상 켜두고 싶다면 tmux나 백그라운드 터미널에 Claude를 띄워두면 돼요.
✅ 이전 대화 내용은 기억 못 해요
텔레그램으로 보낸 메시지의 히스토리는 없어요. 실시간으로 도착하는 메시지만 처리돼요. 그래서 "아까 얘기한 거 다시 해줘" 같은 건 통하지 않아요.
✅ Discord도 지원해요
텔레그램 외에 Discord 채널 연결도 가능해요. 팀 프로젝트에서 Discord를 쓴다면 거기서 Claude를 호출할 수도 있어요.
✅ 권한 요청이 필요한 작업은 터미널에서 멈춰요
Claude가 파일 삭제나 외부 실행처럼 민감한 작업을 만나면 터미널에서 확인을 요청해요.
폰에서만 보고 있으면 작업이 멈춰 있을 수 있어요. 완전 자동화를 원한다면
--dangerously-skip-permissions 플래그가 있지만 — 신뢰할 수 있는 작업에만 쓰는 게 맞아요.
자주 묻는 질문 (FAQ)
Q. Claude Code 버전은 어떻게 확인하나요?
터미널에서 claude --version을 입력하면 현재 버전이 나와요. v2.1.80 이상이어야 Channels 기능을 쓸 수 있어요. 낮은 버전이라면 npm install -g @anthropic-ai/claude-code로 업데이트하세요.
Q. 무료로 쓸 수 있나요?
Channels 기능 자체는 Claude Code에 포함된 기능이라 별도 비용은 없어요. 단, Claude Code를 사용하려면 Claude Pro 구독 또는 API 키가 필요해요.
Q. 텔레그램 봇을 직접 만들어야 하나요?
네, BotFather를 통해 봇을 직접 만들어야 해요. 어렵지 않아요 — 이름 두 개 입력하면 토큰을 발급해줘요. 5분이면 충분해요.
Q. 다른 사람이 내 봇으로 Claude에 접근할 수 있나요?
allowlist 정책으로 설정하면 내 계정만 접근 가능해요. 반드시 5단계에서 이 설정을 해주세요. 기본값인 pairing은 코드만 알면 누구나 연결 가능하기 때문에 보안에 취약해요.
Q. Windows에서도 작동하나요?
Claude Code는 현재 macOS와 Linux 환경에서 주로 사용돼요. Windows는 WSL(Windows Subsystem for Linux)을 통해 실행하면 가능합니다.
Q. Claude Code를 처음 쓰는데 어디서 시작해야 하나요?
Claude Code 입문 가이드는 이 글을 먼저 읽어보세요. (내부 링크 — 글 작성 후 연결 예정)
정리하며
Claude Code Channels는 기술적인 신기능처럼 보이지만, 그 안에 담긴 방향성이 중요해요.
Claude가 "터미널 앞에서만 쓰는 도구"에서 벗어나고 있다는 거예요. 언제 어디서든 연결되어 있는, 진짜 의미의 AI 비서로 가는 첫 발걸음 같아요.
텔레그램 연결 한 번 해두면 — 이동 중에도, 회의 중에도, 자리를 비운 사이에도 Claude는 일하고 있고 저는 결과만 받아볼 수 있어요. 한 번 써보면 돌아가기 어려울 거예요.
댓글
댓글 쓰기