쓸모 쓸모연구소 · 실전 노트
제 825 호이번 주 새 글 49 편2026 · 11 · 14
AI 에이전트⁠·비서
Claude · 텔레그램 · OpenClaw

이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.

클로드 코드 텔레그램 연결 방법, 오픈클로 대신 메가 프롬프트로

내 컴퓨터의 클로드 코드(Claude Code)를 텔레그램에 연결해, 오픈클로(OpenClaw) 없이 휴대폰에서 부리는 개인 비서로 만드는 방법을 정리했습니다. 클로드 코드 텔레그램 연결용 메가 프롬프트를 21단계로 따라가고, 텔레그램 봇 만들기와 권한 점검, 되돌리는 법까지 담았습니다.

클로드 코드 텔레그램 연결 방법, 오픈클로 대신 메가 프롬프트로 삽화
삽화 · 쓸모연구소

클로드 코드 텔레그램 연결, 먼저 알아 둘 보안

구조는 단순합니다. 데스크톱의 클로드 코드를 텔레그램에 연결해 두면, 휴대폰 메시지 하나로 내 컴퓨터의 클로드 코드가 움직입니다. 이 구조를 한 번에 만들어 주는 설치용 프롬프트 파일을 "메가 프롬프트"라고 부릅니다.

보안 쪽에서 이 방식이 챙기는 부분은 이 정도입니다.

  • 예전 오픈클로 파생판 방식에서는 보안과 권한을 하나하나 직접 점검해야 했다.
  • 메시지가 텔레그램 API를 거칠 때 본인 확인을 한다.
  • 처음 설계할 때부터 "Telegram에서 Claude Code를 쓰되 이용약관(terms of service)을 어기지 않는다"를 조건으로 삼았다.

그래도 원격 실행 구조 자체에는 위험이 남습니다. 메시지를 보낼 수 있는 사람이 곧 내 컴퓨터에 명령을 내릴 수 있는 사람이 되기 때문입니다. 봇에 말을 걸 수 있는 사람과 클로드 코드가 손댈 수 있는 범위는 직접 확인해 두는 편이 안전합니다. 확인 방법은 아래 "텔레그램 봇 만들기와 접근 제한" 구획에 정리했습니다.

오픈클로 대신 클로드 코드를 쓰는 이유

오픈클로(예전 이름 ClawdBot)는 "4분 벽을 깬 것"에 비유됩니다. 육상에서 1마일 4분 벽이 한 번 깨지자 다들 따라 깬 것처럼, 휴대폰으로 AI 비서를 부리는 길을 처음 보여 줬다는 뜻입니다. 다만 속을 보면 이미 잘 만들어진 클로드 코드 구조(harness, AI 모델이 도구를 쓰게 감싸 주는 틀)를 다시 이리저리 이어 붙인 것에 가깝습니다.

OpenClaw, Nano Claw, Pico Claw 저장소를 복제해 직접 만들어 보면 더 빠르긴 합니다. 문제는 "이중 입력"입니다.

  • 데스크톱 클로드 코드에서 잘 되는 스킬을 새 도구용으로 또 옮겨야 한다.
  • 예약 작업은 클라우드 어딘가에서 따로 돌려야 한다.
  • 보안과 권한을 하나하나 직접 점검해야 한다.

클로드 코드를 직접 연결하면 6~7개월 동안 데스크톱에 쌓은 스킬, MCP(클로드가 외부 서비스를 직접 쓰게 해 주는 연결 규격), CLAUDE.md(클로드 코드가 매번 읽는 작업 규칙 파일), 파일을 그대로 씁니다. 기존 클로드 코드 요금제를 쓰니 원하지 않으면 API 비용을 낼 필요도 없습니다.

연결 다리는 제3자 도구가 아니라 Anthropic의 Agent SDK(클로드 코드와 같은 에이전트를 내 프로그램 안에서 돌리게 해 주는 개발 도구)입니다. Anthropic API만 쓰면 "모델의 지능"만 얻고 도구 실행 체계는 직접 만들어야 합니다. Agent SDK를 쓰면 클로드 코드의 작은 하위 프로세스가 늘 돌아가는 형태가 됩니다.

텔레그램 메시지 하나가 처리되는 흐름

메시지 하나는 8단계를 거쳐 5초 안에 처리되도록 설계돼 있습니다. 큰 흐름은 이렇습니다.

  • 텔레그램에서 텔레그램 API로 넘어가며 본인 확인
  • 미디어 처리기가 영상, 사진, 음성 메모를 처리
  • 메모리 주입(5단계): 로컬 SQLite(내 컴퓨터에 파일 하나로 저장되는 작은 데이터베이스)에 저장된 최근 기억을 넣는다. Supabase나 Convex 같은 유료 클라우드 DB 없이 무료입니다.
  • Agent SDK가 클로드 하위 프로세스를 띄워 명령을 실행
  • 응답을 글이나 음성으로 바꿔 텔레그램으로 돌려보냄

휴대폰으로 찍은 영상을 보내면 30~40초 뒤 영상 내용을 해석한 답이 옵니다. nano banana로 이미지를 만들게 할 수도 있습니다.

메모리 3층 구조

  • 1층: 첫 메시지 때 세션 ID가 생기고, 같은 세션 ID로 맥락을 이어 간다. 클로드 코드의 컨텍스트 창(AI가 한 번에 기억하는 대화 분량) 한계는 그대로라서, Sonnet 모델의 100만 컨텍스트 창과 함께 쓰는 게 "가장 큰 치트키"입니다.
  • 2층: SQLite에 의미 기반(semantic, 뜻이 비슷한 기억을 찾는 벡터 DB 방식) 기억과 일화(episodic, 언제 무슨 일이 있었는지) 기억을 둔다. 최근 대화일수록 가중치를 높인다.
  • 3층: 매 메시지 전에 최근 기억과 상위 기억을 검색하고, 잡음을 중복 제거해 주입한다(context injection).

이 구성은 하나의 "최적점"일 뿐입니다. 각자 바꾸거나 통째로 버려도 됩니다.

메가 프롬프트에 들어 있는 것

메가 프롬프트 파일에는 이 도구가 무엇인지, 할 수 있는 일, 설치 단계, 인프라별 비용, 지식베이스⁠·세션 재개⁠·메모리가 가득 찼을 때의 동작, 텔레그램을 왓츠앱에 연결하는 방법, cron(정해진 시각에 자동 실행하는 예약 기능) 예약 작업이 들어 있습니다.

음성은 속도를 생각하면 Groq가 낫고, 복제 목소리가 필요하면 ElevenLabs가 낫습니다.

따라 하기 전에 알아 둘 것

아래 21단계는 메가 프롬프트를 실행해 마법사 질문에 답하고, 설치 후 온보딩까지 가는 순서입니다. 세 가지를 먼저 알아 둡니다.

  • 이미 설치된 컴퓨터에서 다시 돌리면 기존 것을 덮어씁니다. 덮어쓰기 직전에 Esc를 누르면 멈출 수 있습니다.
  • 설치 후 온보딩 질문 순서는 버전마다 다를 수 있습니다. 아래 3부는 기능을 다 갖춘 "풀 버전" 기준이라, 1~2부에서 만드는 Lite 버전은 질문 몇 개가 다르게 나올 수 있습니다.
  • 텔레그램 봇 토큰은 따로 만들어야 합니다. 봇 만들기, 나만 쓰게 제한하기, 되돌리는 법은 글 뒤쪽에 정리했습니다.

처음부터 직접 만들면 1~2시간 걸리고, 메가 프롬프트로는 빌드에 10~30분 걸립니다.

준비물

  • 이미 설치해서 쓰고 있는 클로드 코드. 없다면 맥 터미널에서 curl -fsSL https://claude.ai/install.sh | bash로 설치하고 claude로 로그인합니다.
  • 메가 프롬프트 파일: 클로드 코드를 실행할 작업 폴더 안에 두면 @로 태그하기 쉽습니다.
  • 텔레그램 계정
  • Anthropic API 키, 또는 Claude Code Max 요금제(OAuth 로그인용, 이미 가입한 계정으로 로그인해 권한을 빌려주는 방식)
  • 계속 켜 둘 컴퓨터나 맥미니: 예약 작업을 계속 돌리려면 켜져 있어야 합니다.
  • 비용: 원하지 않으면 API 비용 없이 기존 요금제로 됩니다. 음성 기능(Groq, OpenAI, ElevenLabs)은 따로 요금이 붙을 수 있으니 각 서비스의 공식 요금 안내를 확인해야 합니다.

1부. 메가 프롬프트 실행하기

  1. 클로드 코드를 연다. 터미널에서 메가 프롬프트 파일이 있는 폴더로 이동한 뒤 claude를 입력합니다.
    • 확인: 클로드 코드 입력창이 준비된다.
  2. 입력창에 메가 프롬프트 파일을 @rebuild로 태그해 넣는다.
프롬프트
@rebuild
  • 팁: 복사해서 붙여 넣을 필요 없이 태그만 하면 됩니다.
  • 주의: @rebuild는 예시 파일 이름입니다. 받은 파일 이름이 다르면 @를 치고 파일 이름 앞 글자를 입력해 목록에서 고릅니다.
  • 확인: 메가 프롬프트 파일이 태그된다.
  1. 뒤에 실행 지시를 입력한다.
프롬프트
execute this
  • 팁: "read this", "do whatever's in this"처럼 비슷한 말이면 됩니다.
  • 확인: 입력창에 @rebuild execute this 형태의 메시지가 들어 있다.
  1. Enter를 눌러 메시지를 보낸다.
    • 확인: 작은 ASCII 아트(글자로 그린 그림) 애니메이션과 "Claude Claw Lite"가 뜬다. 누구나 쓸 수 있게 만든 일반 버전이라 Lite가 붙어 있습니다.
  2. 화면에 나온 설명(필요한 단계 안내)을 읽는다.
    • 팁: 궁금한 건 이 시점에 물어봐도 됩니다.
    • 확인: 무엇이 필요한지 안내문을 확인했다.
  3. 설치 시작을 요청하는 문장을 입력한다.
프롬프트
help me set this up now
  • 확인: 입력창에 문장이 들어 있다.
  1. Enter를 눌러 보낸다.
    • 확인: 마법사가 실행되고 객관식 선택 창이 뜬다. 기술에 익숙하지 않은 사람도 겁먹지 않게 객관식으로 묻도록 만들어져 있습니다.

2부. 마법사 질문에 답하기

아래 선택값은 예시입니다. 자기 필요에 맞게 고르면 됩니다. 선택지는 방향키로 옮기고 Enter로 고릅니다.

  1. 음성 옵션 하나를 고른다.
    • 위치: 음성 질문의 선택지 Grok(Groq), OpenAI, Eleven Labs, No Voice, type something(직접 입력)
    • 팁: 속도를 원하면 Groq를 고릅니다. 음성이 필요 없으면 No Voice를 고르면 외부 서비스 키가 하나 줄어듭니다.
    • 확인: 고른 항목이 선택된다.
  2. Enter(Next)로 다음 질문으로 넘어간다.
    • 확인: "What kind of memory system do you want?"(어떤 메모리 방식을 원하나요) 질문이 뜬다.
  3. 메모리 방식에서 "full memory"를 클릭한다.
    • 팁: 기본값(episodic + semantic)으로 먼저 만들어 보고 나중에 고쳐도 됩니다.
    • 확인: 기능 선택 질문으로 넘어간다.
  4. 켤 기능을 체크한다.
    • 위치: 기능 목록 scheduler(예약 작업), video analysis(영상 분석), WhatsApp bridge(왓츠앱 연결), background service(백그라운드 상시 실행)
    • 팁: scheduler 정도만 켜고 필요 없는 나머지는 빼도 됩니다. 처음엔 기능을 적게 켤수록 점검할 곳도 줄어듭니다.
    • 확인: 원하는 기능만 체크돼 있다.
  5. "submit"을 누른다.
    • 확인: 제출 버튼이 한 번 더 보일 수 있다.
  6. 다시 "submit"을 클릭한다.
    • 주의: 버튼이 다시 보이지 않으면 이 단계는 건너뜁니다.
    • 주의: 같은 도구를 이미 설치한 컴퓨터라면 기존 것을 덮어씁니다. 멈추려면 여기서 Esc를 누릅니다.
    • 확인: 전체 빌드 과정이 시작된다.
  7. 이어지는 맞춤 질문에 하나씩 답한다.
    • 팁: 모르는 질문이 나오면 "이 질문이 무슨 뜻인지, 추천 값은 뭔지 설명해 줘"라고 되물으면 됩니다. 텔레그램 봇 토큰을 물으면 아래 "텔레그램 봇 만들기"대로 만든 토큰을 붙여 넣습니다.
    • 확인: 빌드가 진행된다. 10~30분 걸립니다.

3부. 설치 후 실행과 온보딩

여기부터는 기능을 다 갖춘 풀 버전 기준 화면입니다. Lite 버전은 질문 몇 개가 빠지거나 순서가 다를 수 있습니다.

  1. 터미널에서 실행 명령을 입력한다.
명령어
claude claw
  • 주의: 명령 이름은 빌드 설정에 따라 다를 수 있습니다. 안 되면 빌드가 끝난 클로드 코드에게 "방금 만든 도구를 실행하는 명령이 뭐야?"라고 물어 확인합니다.
  • 확인: 풀 버전 ASCII 아트가 뜨고 온보딩이 시작된다.
  1. "yes"를 골라 계속 진행한다.
    • 확인: "Do you want voice input?"(음성 입력을 쓸까요) 질문이 뜬다.
  2. 음성 입력에 "yes"를 고른다.
    • 확인: 다음 질문("Do you want this?")으로 넘어간다.
  3. 그 질문에 "yes"를 고른다.
    • 확인: video analysis 질문이 뜬다.
  4. video analysis에 "no"를 고른다.
    • 확인: WhatsApp 질문이 뜬다.
  5. WhatsApp에 "no"를 고른다.
    • 확인: "Do you want to clone any of the repos?"(저장소를 복제할까요) 질문이 뜬다.
  6. 저장소 복제 질문에 "no"를 고른다.
    • 팁: 여러 저장소에서 마음에 드는 기능을 골라 오고 싶으면 yes를 고릅니다.
    • 확인: 다음 질문이 뜬다. 그다음 항목에도 "no"를 고르면 API 키를 넣을지, Claude Code Max 요금제로 OAuth 로그인할지 묻는 단계가 나온다.
    • 팁: 이미 Max 요금제를 쓰고 있다면 OAuth 로그인을 골라야 추가 API 비용이 붙지 않습니다. 화면 안내에 따라 브라우저에서 Claude 계정으로 로그인하고 승인합니다.

클로드 코드 텔레그램 연결이 끝났는지 점검

  • @rebuild execute this 실행 후 ASCII 아트(Claude Claw Lite)가 떴는가
  • 음성, 메모리, 기능 선택을 마치고 빌드가 시작됐는가
  • 빌드가 끝난 뒤 실행 명령으로 온보딩 화면이 뜨는가
  • API 키나 Max 요금제 OAuth 중 하나로 인증했는가
  • 텔레그램으로 메시지를 보냈을 때 답이 오는가
  • 다른 계정으로 봇에 말을 걸었을 때 답하지 않는가

텔레그램 답장은 글 메시지라면 몇 초 안에 와야 합니다. 영상 파일을 보내 해석을 맡기면 30~40초 걸립니다. 마지막 항목은 다른 사람이 내 컴퓨터를 부리지 못하게 막혀 있는지 보는 점검입니다.

막힐 때

  • 마법사가 기존 설정을 덮어쓰려 한다: 이미 설치된 컴퓨터에서 다시 돌린 경우입니다. Esc로 멈춥니다.
  • 대화가 길어지면 맥락이 끊긴다: 클로드 코드의 컨텍스트 창 한계는 그대로입니다. Sonnet 모델의 100만 컨텍스트 창과 함께 쓰면 덜 끊깁니다.
  • 예약 작업이 안 돈다: 컴퓨터가 꺼져 있거나 잠든 경우입니다. 맥이라면 시스템 설정 → 에너지(또는 배터리)에서 "디스플레이가 꺼져 있을 때 자동으로 잠자기 방지"를 켜 둡니다. 임시로는 터미널에서 caffeinate -dimsu를 실행해 둔 동안 잠들지 않게 할 수 있습니다.
  • 음성 답장이 느리다: 음성 서비스를 ElevenLabs 대신 Groq로 바꾸면 빨라집니다.

텔레그램 봇 만들기와 접근 제한

텔레그램 봇 만들기

메가 프롬프트가 봇 토큰을 물으면 아래 순서로 만듭니다.

  1. 텔레그램에서 @BotFather를 검색해 파란 인증 표시가 있는 공식 계정을 엽니다.
  2. /newbot을 보냅니다.
  3. 봇 이름을 입력합니다. 아무 이름이나 됩니다.
  4. 사용자명(username)을 입력합니다. 끝이 bot으로 끝나야 합니다.
  5. BotFather가 보내 준 토큰(긴 문자열)을 복사해 마법사가 묻는 자리에 붙여 넣습니다. 토큰은 비밀번호와 같으니 다른 곳에 올리지 않습니다.

나만 쓰게 제한하기

텔레그램 봇은 사용자명만 알면 누구나 말을 걸 수 있습니다. 빌드가 끝나면 클로드 코드에게 이렇게 확인시킵니다.

프롬프트
방금 만든 텔레그램 봇이 내 텔레그램 사용자 ID에서 온 메시지에만 답하도록 되어 있는지 코드에서 확인해 줘. 안 되어 있으면 허용 목록(allowlist)을 추가하고, 다른 사용자가 보낸 메시지는 무시하고 기록만 남기게 바꿔 줘.

내 텔레그램 사용자 ID는 @userinfobot 같은 봇에게 아무 메시지나 보내면 숫자로 알려 줍니다.

클로드 코드가 손댈 수 있는 범위 확인

휴대폰에서 보낸 명령은 컴퓨터 앞에서 "허용할까요?" 창을 눌러 줄 사람이 없습니다. 그래서 이런 구조는 권한 확인을 미리 넓게 열어 두는 경우가 많습니다. 빌드가 끝나면 아래처럼 물어 설정을 직접 읽어 봅니다.

프롬프트
텔레그램에서 들어온 명령을 실행할 때 클로드 코드가 어떤 권한 모드로 돌고 있는지, 접근할 수 있는 폴더가 어디까지인지 설정 파일 위치와 함께 알려 줘. 파일 삭제, git push, 메일 발송처럼 되돌리기 어려운 동작은 실행 전에 텔레그램으로 나에게 확인을 받도록 바꿀 수 있는지도 알려 줘.

되돌리는 법

  1. 실행 중인 봇 프로세스를 멈춥니다. 터미널에서 돌고 있다면 Ctrl+C, 백그라운드 서비스로 설치했다면 클로드 코드에게 "백그라운드 서비스를 중지하고 자동 시작을 해제해 줘"라고 시킵니다.
  2. BotFather에서 /revoke로 토큰을 폐기하거나 /deletebot으로 봇을 지웁니다.
  3. 빌드로 생긴 폴더를 지우기 전에, 어떤 파일이 새로 생겼는지 클로드 코드에게 목록을 받아 확인합니다.

공식 기능도 함께 확인

Anthropic은 클로드 코드를 휴대폰이나 원격에서 쓰는 기능을 계속 내놓고 있습니다. 메가 프롬프트로 직접 만들기 전에 클로드 코드 공식 문서에서 원격 사용이나 메신저 연결 기능이 있는지 먼저 확인해 보면, 유지보수 부담을 줄일 수 있습니다.

클로드 코드 텔레그램 방식의 장점과 한계

가장 큰 장점은 데스크톱용과 이동용 "두 개의 뇌"를 따로 관리할 필요가 없다는 점입니다. 클로드 코드 시스템 하나를 개선하고 스킬을 전역으로 만들어 두면, 휴대폰 경험도 같이 좋아집니다.

Codex나 Gemini처럼 CLI(터미널에서 쓰는 명령형 프로그램)가 있는 다른 모델로도 같은 방식을 만들 수 있습니다.

클로드 코드를 이미 오래 써서 스킬과 설정이 쌓여 있는 사람이라면 솔깃한 구조입니다. 새 도구로 옮겨 심지 않아도 되니까요. 한계도 있습니다. 컴퓨터가 켜져 있어야 하고, 휴대폰에서 내 컴퓨터를 움직이는 구조인 만큼 허용 목록과 권한 범위를 직접 챙겨야 합니다.

자주 묻는 질문

클로드 코드를 텔레그램에 연결하면 API 비용이 드나요?

기존 클로드 코드 요금제(예: Max)로 OAuth 로그인하면 추가 API 비용 없이 쓸 수 있습니다. API 키 방식을 고르면 사용량만큼 요금이 붙고, 음성 기능(Groq, ElevenLabs 등)은 별도 요금일 수 있으니 공식 안내를 확인해야 합니다.

오픈클로 대신 클로드 코드를 쓰면 무엇이 좋은가요?

이미 쌓아 둔 스킬, MCP, CLAUDE.md를 그대로 쓸 수 있어 "이중 입력"이 사라진다는 점입니다. 데스크톱과 휴대폰이 같은 시스템을 쓰니 한쪽을 고치면 양쪽이 같이 좋아집니다.

컴퓨터를 꺼 두면 텔레그램 봇이 작동하나요?

작동하지 않습니다. 봇은 내 컴퓨터의 클로드 코드를 불러 쓰는 구조라, 예약 작업까지 돌리려면 컴퓨터나 맥미니를 켜 두고 잠자기도 막아야 합니다.

다른 사람이 내 봇에 명령을 보내면 어떻게 되나요?

제한을 걸지 않았다면 그 명령이 내 컴퓨터에서 실행될 수 있습니다. 빌드 후 내 텔레그램 사용자 ID만 허용하는 목록이 있는지 확인하고, 없으면 추가하도록 클로드 코드에게 시키는 것이 안전합니다.

이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.

원본 영상 보러가기 ↗