클로드 코드 × 텔레그램 연동
완전 해설서

AI 비서를 24시간 대기시키는 실전 가이드

2026년 3월 23일 | kimkj.com

제1장. 이게 도대체 무엇인가 — 개념 이해

1-1. Claude Code Channels란?

Claude Code Channels는 2026년 3월 20일 Anthropic이 리서치 프리뷰로 공개한 기능입니다. 여러분의 PC(맥, 윈도우, 리눅스)에서 돌아가고 있는 클로드 코드 세션에 텔레그램이나 디스코드 같은 메신저를 연결하여, 마치 1:1 무전기처럼 어디서든 AI 에이전트에게 명령을 내릴 수 있게 해줍니다.

핵심 원리는 간단합니다. 클로드 코드와 텔레그램 봇이 하나의 채널(고유 번호)을 공유하고, 그 번호로 보낸 메시지에만 응답합니다. 봇과 클로드 코드가 24시간 연결된 상태를 유지하므로, 여러분이 밖에서 스마트폰으로 메시지를 보내면 집에 있는 PC의 클로드 코드가 즉시 받아서 처리하고 답장을 보내줍니다.

1-2. 왜 좋은가 — 핵심 장점 5가지

❶ 원격 제어 — 모바일에서 PC의 클로드 코드를 조작할 수 있습니다. 외출 중에도 집 PC에 코딩, 크롤링, 파일 정리 등을 시킬 수 있습니다.

❷ 24시간 대기 — PC가 켜져 있는 한 클로드 코드가 항상 입력을 대기합니다. 언제든 메시지를 보내면 즉시 응답합니다.

❸ 크론잡 자동화 — 매일 아침 뉴스 요약, 주간 일정 보고, 주기적 웹 크롤링 등을 자동으로 실행시킬 수 있습니다.

❹ MCP 확장 — Google Workspace(Gmail, 캘린더, 드라이브), 웹 검색 등 다양한 도구와 연결하여 업무 비서로 활용 가능합니다.

❺ 구독제 활용 — 별도 API 비용 없이 클로드 Pro/Max 구독($20/$100)만으로 Opus 4.6 모델을 사용할 수 있습니다.

1-3. 현재 지원 범위 — 반드시 알아야 할 제한사항

오직 클로드 코드 터미널(CLI)에서만 가능합니다. 새로운 기능은 항상 CLI에서 먼저 지원되므로, CLI 사용법을 반드시 익혀야 합니다.

제2장. 사전 준비 — 시작하기 전에 갖춰야 할 것

2-1. 필수 준비물 체크리스트

2-2. Claude Code CLI 설치하기

클로드 코드 CLI를 설치하는 방법은 크게 두 가지입니다. 2026년 3월 기준 Anthropic이 권장하는 네이티브 설치가 가장 간편합니다.

방법 1: 네이티브 설치 (권장)

Node.js, npm이 없어도 설치 가능합니다. 백그라운드 자동 업데이트를 지원합니다.

방법 2: npm을 통한 설치

⚠ 주의: sudo npm install -g를 사용하지 마십시오. 권한 문제가 발생할 수 있습니다.

설치 확인:

2-3. Bun 런타임 설치하기

텔레그램 공식 플러그인은 Bun 런타임을 필요로 합니다. Node.js나 Deno로는 실행되지 않으므로 반드시 Bun을 설치해야 합니다.

설치 후 터미널을 재시작하거나 source ~/.zshrc를 실행하여 PATH를 갱신합니다.

2-4. 텔레그램 데스크톱 설치

텔레그램 데스크톱 앱을 설치해야 명령어 복사·붙여넣기가 편리합니다. 공식 사이트(desktop.telegram.org)에서 macOS/Windows/Linux용 앱을 다운로드하여 설치하고, 모바일과 동일한 계정으로 로그인합니다.

제3장. 텔레그램 봇 만들기 — BotFather 완전 가이드

3-1. BotFather 찾기

텔레그램 앱의 검색창에서 @BotFather를 검색합니다. 주의할 점은 BotFather를 사칭하는 가짜 계정이 매우 많다는 것입니다. 반드시 파란색 체크마크(공식 인증)가 있는 BotFather로 들어가셔야 합니다.

3-2. 새 봇 생성하기

BotFather에게 아래 순서대로 진행합니다:

3-3. 토큰 받기 및 보관

사용자명이 사용 가능하면 BotFather가 성공 메시지와 함께 API 토큰을 표시합니다. 토큰은 다음과 같은 형식입니다:

제4장. 클로드 코드에 텔레그램 연결하기 — 6단계 설정

4-1. 작업 폴더 생성 및 클로드 실행

상주시킬 PC에 접속하여 전용 작업 폴더를 만듭니다. 저 같은 경우 맥미니에서 진행합니다.

이 폴더에서 클로드 코드를 실행하면 클사운(클로드 에이전트)이 켜집니다.

4-2. 텔레그램 플러그인 설치

클로드 코드 세션 안에서 다음 명령을 실행합니다:

설치 확인: /skills list 또는 /plugins list 명령으로 텔레그램 플러그인이 목록에 있는지 확인합니다.

또 다른 방법으로, 설치 스킬(예: claude-claw-setup-highboy)의 GitHub 주소를 클로드 코드에 알려주고 "이거 설치해 줘"라고 말하면 자동으로 설치해 줍니다.

4-3. 토큰 등록

BotFather에서 받은 토큰을 클로드 코드에 등록합니다:

이 명령은 토큰을 ~/.claude/channels/telegram/.env 파일에 저장합니다. 수동으로 이 파일을 편집할 수도 있습니다.

4-4. 채널 플래그로 클로드 재실행

현재 세션을 종료(Ctrl+C 두 번 연타)하고, 채널 플래그를 붙여서 다시 실행합니다:

이 플래그 없이는 텔레그램 연결이 되지 않습니다.

4-5. 페어링 — 봇과 클로드 코드 연결

텔레그램에서 아까 만든 봇을 찾아 대화를 시작합니다:

4-6. 접근 권한 잠금

페어링이 완료되면 허용 목록(allowlist) 모드로 전환하여, 본인만 봇을 사용할 수 있도록 잠급니다. 이렇게 하면 낯선 사람이 페어링 코드를 요청해도 봇이 응답하지 않습니다.

제5장. 24시간 대기 모드 — 본격 운용

5-1. 대기 모드로 재실행

연결만 했다고 끝이 아닙니다. 24시간 입력을 대기하는 모드로 클로드를 다시 켜야 합니다. 웹 검색이나 파일 조작 등 다양한 작업을 자동으로 처리하려면 퍼미션 모드도 함께 설정합니다:

실행 성공 시 터미널에 "listening for channel messages"가 표시됩니다.

5-2. 사용 테스트

이제 텔레그램에서 봇에게 메시지를 보내봅니다. "안녕"이라고 보내면 클로드 코드가 즉시 응답합니다. 모바일에서도 동일하게 작동하며, 한글로 보내면 한글로 답해줍니다. 현재 Opus 4.6 모델이 응답합니다.

5-3. 접속 URL 정리

제6장. 고급 활용 — MCP로 업무 자동화

6-1. Google Workspace (GWS) 연동

클로드 코드 뒤에 GWS(Google Workspace CLI)를 세팅하면, 텔레그램에서 구글 캘린더 일정 조회, Gmail 발송, 구글 드라이브 파일 관리까지 할 수 있습니다.

GWS CLI 설치 및 인증:

브라우저가 열리면 OAuth 권한을 수락합니다. 토큰이 ~/.config/gws/에 저장됩니다.

인증 확인:

이제 텔레그램에서 이런 명령이 가능합니다:

6-2. 크론잡(Cron Job) — 정기 작업 자동화

클로드 코드가 24시간 상주하고 있으므로, 크론잡을 걸어 특정 시간에 자동으로 작업을 실행시킬 수 있습니다. 크론잡이란 항상 켜져 있는 PC에서 스크립트나 작업을 매일, 매시간, 특정 시간에 실행시키는 프로그램입니다.

크론잡 활용 예시:

크론잡의 장점은 클로드 코드가 대기 시간 동안 다른 작업도 할 수 있다는 것입니다. 크론잡 없이 "3분 기다려" 하면 클로드 코드가 그동안 잡혀 있어서 다른 작업을 못 합니다. 크론잡을 걸면 시스템이 3분 뒤에 자동으로 실행시키므로, 그사이 다른 명령도 처리 가능합니다.

크론잡 종류:

• 1회성 작업 — 지정 시간에 한 번만 실행 (예: 3분 뒤, 내일 오전 10시)

• 반복 작업 — 매시간, 매일, 매주 등 주기적 실행 (예: 매일 아침 9시)

제7장. 실전 활용 시나리오

7-1. 업무 비서로 활용

• "이번 주 회의 일정 정리해서 메일로 보내줘"

• "오늘 읽지 않은 중요 메일 요약해줘"

• "내일 오후 3시에 김 과장님이랑 회의 잡아줘"

7-2. 개발 보조로 활용

• "크롤링 코드 하나 짜서 특정 사이트 조사하고 결과를 메일로 보내줘"

• "프로젝트 폴더의 ESLint 에러 전부 수정해줘"

• "깃허브에 커밋하고 PR 올려줘"

7-3. 정보 수집으로 활용

• "매일 아침 9시마다 AI 관련 해외 뉴스 10개 보내줘" (크론잡)

• "주식 관련 뉴스 검색해서 정리해줘"

• "경쟁사 홈페이지 변경사항 모니터링해줘"

7-4. PC 관리로 활용

• "바탕화면에 뭐 있는지 봐라, 정리해라"

• "다운로드 폴더에서 일주일 지난 파일 정리해줘"

• "디스크 용량 확인해서 알려줘"

제8장. 보안 주의사항 및 요금제 팁

8-1. 보안 체크리스트

① 봇 토큰 비공개 — 토큰은 비밀번호와 같습니다. 절대 공유하지 마세요.

② allowlist 설정 — 본인 텔레그램 ID만 허용하여 타인의 접근을 차단합니다.

③ 작업 디렉토리 제한 — APPROVED_DIRECTORY를 최소한의 작업 폴더로 제한합니다. /, /home, /etc 같은 민감한 경로는 절대 넣지 마세요.

④ 컨테이너 사용 권장 — --dangerously-skip-permissions를 사용할 경우 Docker 컨테이너 안에서 실행하면 안전합니다.

8-2. 카카오톡·라인 연동에 대하여

카카오톡 연동은 비공식적이며 약관 위반 소지가 있어 권장하지 않습니다. 라인(LINE) 연동은 향후 버전 업데이트로 공식 지원될 가능성이 있습니다. 현재로서는 텔레그램과 디스코드가 공식 지원됩니다.

8-3. 요금제 알뜰 활용 팁

• $20 Pro 요금제 — 기본 사용에 적합하나 24시간 대기에는 부족할 수 있습니다.

• $100 Max 요금제 — 매일 넉넉하게 사용 가능합니다.

• 5시간 한도 세션 — 클로드는 5시간마다 사용량이 리셋됩니다. 4%만 쓰고 리셋되면 아깝습니다.

• 꿀팁 — 5시간마다 가벼운 메시지를 자동으로 보내는 크론잡을 걸면, 사용량을 효율적으로 소진할 수 있습니다.

제9장. 문제 해결 FAQ

제10장. 전체 설정 요약 — 한눈에 보는 체크리스트