텔레그램으로 AI 개발 비서를 부리는 방법\! Claude Code + Telegram 연동기

작성자:

안녕하세요, 낙서장입니다!

오늘은 제가 요즘 정말 유용하게 쓰고 있는 조합을 하나 소개해 드릴게요. 바로 Claude Code + 텔레그램 연동인데요. 쉽게 말하면, 텔레그램 메신저로 AI 개발 비서에게 말을 걸면 코드 수정, 서버 관리, 파일 검색 등을 바로바로 처리해주는 환경을 만드는 거예요.

Claude Code가 뭔데?

Claude Code는 Anthropic에서 만든 AI 기반 CLI(커맨드라인) 개발 도구예요. 터미널에서 자연어로 명령하면 코드를 읽고, 수정하고, 파일을 만들고, git 작업까지 해주는 일종의 AI 페어 프로그래머죠.

일반적인 AI 챗봇과 가장 큰 차이점은, 실제로 내 로컬 환경에서 코드를 직접 수정하고 실행할 수 있다는 거예요. 파일 시스템에 접근하고, 터미널 명령어를 실행하고, git commit까지 해주니까 단순 질의응답이 아니라 진짜 “함께 일하는” 느낌이에요.

현재 최신 모델인 Claude Opus 4.6을 사용하면 100만 토큰의 컨텍스트 윈도우로 대규모 코드베이스도 한 번에 파악할 수 있어요. 수천 줄짜리 프로젝트도 전체 구조를 이해한 상태에서 정확한 수정을 해주니까, 체감상 시니어 개발자 한 명이 옆에 앉아서 같이 코딩하는 느낌이에요.

왜 텔레그램이랑 연동하나?

Claude Code는 기본적으로 터미널에서 사용하는 도구예요. 그런데 매번 맥북 열고 터미널 켜서 명령하려면 번거롭잖아요? 특히 외출 중이거나, 핸드폰만 들고 있을 때 갑자기 서버 상태가 궁금하거나, 간단한 코드 수정이 필요할 때가 있거든요.

텔레그램 연동을 하면 이런 게 가능해져요:

  • 핸드폰에서 바로 개발 지시 — “이 API 응답에 필드 하나 추가해줘” 같은 요청을 이동 중에 바로 처리
  • 서버 관리 — SSH로 원격 서버 접속해서 상태 확인, Docker 컨테이너 재시작, 로그 확인
  • 코드 리뷰 & 수정 — git 상태 확인, 파일 수정, 커밋까지 한 번에
  • 빠른 디버깅 — “서버 에러 로그 확인해줘” 한마디로 원인 파악부터 수정까지
  • 프로젝트 현황 파악 — 여러 프로젝트의 빌드 상태, 최근 변경사항 등을 한눈에

한마디로, 텔레그램이 AI 개발 비서의 리모컨이 되는 셈이에요. PC 앞에 앉아있지 않아도 개발 환경을 손 안에서 컨트롤할 수 있는 거죠.

설정 방법

생각보다 간단해요. 크게 3단계로 나뉘는데, 처음부터 끝까지 30분이면 충분해요.

1단계: 텔레그램 봇 생성

텔레그램에서 @BotFather한테 말을 걸어서 새 봇을 만들어요. /newbot 명령어를 치면 봇 이름과 유저네임을 물어보고, 완료되면 API 토큰을 발급해줘요. 이 토큰이 봇의 인증 키 역할을 하니까 잘 복사해두세요.

봇 유저네임은 반드시 bot으로 끝나야 해요. 예를 들어 my_claude_code_bot 같은 식이죠. 이름은 나중에 바꿀 수 있으니 부담 없이 정하면 돼요.

# 텔레그램에서 @BotFather에게 메시지
/newbot

# BotFather 응답:
# Alright, a new bot. How are we going to call it?
# > ClaudeCode Assistant

# Good. Now let's choose a username. It must end in 'bot'.
# > my_claude_code_bot

# Done! Your new bot is created.
# Use this token to access the HTTP API:
# 7123456789:AAF-xxxxxxxxxxxxxxxxxxxx  ← 이 토큰 복사!

2단계: Claude Code에 텔레그램 채널 설정

Claude Code 터미널에서 /telegram:configure 명령으로 봇 토큰을 등록해요. 토큰을 붙여넣으면 자동으로 검증하고, 텔레그램 메시지를 수신할 준비가 완료돼요.

설정이 끝나면 Claude Code가 “Listening for messages…” 상태로 전환되면서, 텔레그램으로 들어오는 메시지를 실시간으로 받을 수 있게 돼요. 기존 작업 중에도 텔레그램 메시지가 오면 자동으로 처리해줘요.

$ claude

# Claude Code v1.0.51
# Model: claude-opus-4-6

You: /telegram:configure

# ✓ Bot token saved
# ✓ Telegram channel ready
# ℹ Listening for messages...

3단계: 보안 페어링

아무나 내 AI 비서한테 명령할 수 없게, 페어링 코드 기반 인증을 사용해요. 텔레그램에서 봇에게 아무 메시지나 보내면 6자리 페어링 코드가 나오고, 이걸 Claude Code 터미널에서 /telegram:access pair [코드]로 승인하면 끝!

승인된 사용자만 allowlist에 등록되고, 그 외 메시지는 완전히 무시돼요. 나중에 /telegram:access 명령으로 허용된 사용자 목록을 관리하거나, DM/그룹 정책을 따로 설정할 수도 있어요. 보안도 챙기면서 편하게 쓸 수 있는 구조죠.

# 텔레그램 봇에서 받은 페어링 코드
# Bot: 🔐 Pairing code: A7X-K2M
#      Tell your Claude Code to approve this.

# Claude Code 터미널에서 승인
You: /telegram:access pair A7X-K2M

# ✓ User approved!
# ✓ Added to allowlist

실제로 이렇게 쓰고 있어요

저는 여러 프로젝트를 동시에 관리하고 있어서, 이 연동이 정말 유용해요. 실제로 자주 하는 작업들을 소개하면:

  • 서버 모니터링 — “Docker 컨테이너 상태 확인해줘” 하면 SSH 접속해서 알아서 확인하고 문제가 있으면 리포트해줌
  • 빠른 버그 수정 — 외출 중에 동료가 버그를 알려주면, 텔레그램으로 바로 “○○ 파일에서 △△ 함수 확인해봐” 하고 원인 파악 + 수정 가능
  • 코드 검색 — “프로젝트에서 API 엔드포인트 목록 정리해줘” 같은 요청도 즉시 처리
  • 워드프레스 관리 — 서버에서 돌아가는 워드프레스 사이트 상태 확인, 플러그인 업데이트 등
  • git 작업 — “지난주에 어떤 커밋들이 있었어?” 같은 히스토리 확인도 간편

예를 들어, 텔레그램에서 서버 상태를 확인하면 이런 식으로 응답이 와요:

You: 서버 Docker 상태 확인해줘

Claude: SSH 접속해서 확인 중...

📋 Docker 컨테이너 상태:
  • wordpress    Up 14 days     ✓
  • mysql-8.0    Up 14 days     ✓
  • redis        Exited (1)     ✗

⚠ redis 컨테이너가 중지 상태예요. 재시작할까요?

You: 응 재시작해줘

Claude:
  ✓ docker restart redis
  ✓ redis 정상 가동 확인 완료

특히 모바일에서 간단한 지시만으로 복잡한 작업을 처리할 수 있다는 게 가장 큰 장점이에요. 코드를 직접 치지 않아도 되니까, 이동 중에도 프로젝트를 관리할 수 있죠.

어떤 작업까지 가능할까?

Claude Code 자체가 터미널에서 할 수 있는 거의 모든 것을 지원하기 때문에, 텔레그램 연동 시 활용 범위가 꽤 넓어요:

  • 파일 읽기/쓰기/수정 — 소스 코드, 설정 파일, 문서 등
  • 터미널 명령 실행 — npm, pip, docker, git 등 CLI 도구 전부
  • SSH 원격 접속 — 등록된 서버에 접속해서 원격 작업 가능
  • 웹 검색 & 정보 수집 — 최신 라이브러리 문서 확인, 에러 메시지 검색
  • 이미지 분석 — 스크린샷을 보내면 UI 피드백이나 에러 화면 분석도 가능

단, 모든 작업은 Claude Code 세션이 실행 중인 컴퓨터에서 수행되기 때문에, 해당 머신이 켜져 있고 인터넷에 연결되어 있어야 해요.

주의할 점

물론 완벽하진 않아요. 몇 가지 알아두면 좋을 점이 있어요:

  • Claude Code 세션이 켜져 있어야 해요 — 맥북에서 Claude Code가 실행 중이어야 텔레그램 메시지를 받을 수 있어요. 맥을 끄거나 Claude Code를 종료하면 응답 불가.
  • API 사용량 — Claude Opus 모델을 사용하므로 Anthropic API 크레딧이 소모돼요. 복잡한 작업일수록 토큰을 많이 쓰니까, Max 요금제(월 $100~$200)를 사용하는 게 현실적이에요.
  • 보안 관리 — 봇 토큰이 노출되지 않도록 주의하고, allowlist를 잘 관리해야 해요. 봇 토큰이 유출되면 누군가 내 개발 환경에 명령을 내릴 수 있으니까요.
  • 권한 설정 — Claude Code의 권한 모드를 적절히 설정해두는 게 좋아요. 민감한 작업(파일 삭제, git push 등)에는 승인 단계를 두는 걸 추천해요.

마무리하며

Claude Code + 텔레그램 조합은 개발자에게 정말 강력한 도구예요. 터미널 앞에 앉아있지 않아도, 핸드폰 하나로 코드 수정, 서버 관리, 디버깅까지 할 수 있으니까요.

2026년 현재 AI 개발 도구들이 정말 빠르게 발전하고 있는데, 이런 연동 환경을 만들어두면 생산성이 확 올라가는 걸 체감할 수 있어요. 특히 여러 프로젝트나 서버를 관리하는 분들에게 강력 추천합니다.

혹시 관심 있으신 분들은 Anthropic의 Claude Code 공식 문서를 참고해보세요. 설정 자체는 30분이면 충분하답니다. 다음에는 더 재미있는 활용법으로 찾아올게요!

댓글 남기기