💬 텔레그램 연동 — 클로드 코드 무료 학습

사전 준비 — 이미 다 있습니다

밖에서도 AI를 쓰고 싶지 않나요? 출근길 지하철에서, 카페에서, 자기 전에—스마트폰 하나로 집 PC의 Claude Code를 원격 조종할 수 있습니다. 해결책은 텔레그램 봇 연동이에요.

✅ 이미 설치 완료

✅ Windows PC
✅ Claude Code (CLI)
✅ Claude Pro 구독 & 로그인

📋 오늘 할 것

1️⃣ 텔레그램 봇 토큰 발급
2️⃣ 코깍딜 다운로드
3️⃣ 봇 서버 실행 → 끝!

왜 텔레그램?

카카오톡이나 LINE과 달리, 텔레그램은 무료 봇 API를 공식 제공합니다. 봇을 만들고 연동하는 데 별도 비용이나 사업자 등록이 필요 없어요.

STEP 1: 텔레그램 봇 토큰 발급

📁 작업 폴더 만들기

먼저 코깍딜 파일과 AI 대화 기록이 저장될 폴더를 하나 만드세요.

1파일 탐색기에서 원하는 위치에 폴더 만들기 (예: my-ai-bot)

2폴더 안에서 주소창 클릭 → powershell 입력 → Enter

3열린 PowerShell에서 claude 입력 → Claude Code 시작!

📱 텔레그램 설치

스마트폰 앱스토어에서 "Telegram" 설치
PC: telegram.org → 데스크탑 앱 설치
전화번호로 가입

🤖 봇 토큰 발급

@BotFather 검색 → START BOT
/newbot 입력
봇 이름 설정 (예: 내 AI 비서)
유저네임 설정 (예: myai_helper_bot) — 반드시 _bot으로 끝나야 함
발급된 토큰을 복사해두기!

BotFather에서 /newbot 명령 실행 — @BotFather에게 /newbot을 입력하면 봇 이름을 물어봐요

토큰은 비밀번호입니다

봇 토큰은 7123456789:AAH... 형식의 긴 문자열입니다. 이 토큰을 가진 사람은 봇을 제어할 수 있으니, 절대 공개하지 마세요.

STEP 2: 코깍딜 다운로드

Claude Code에게 시키면 끝입니다. STEP 1에서 열어둔 Claude Code에 아래 내용을 입력하세요.

Claude Code에 입력

cokacdir를 다운로드 해줘.
https://github.com/kstost/cokacdir 여기가 공식 저장소야.
현재 폴더에 저장하고,
현재 이 경로에서 새 PowerShell 창도 열어줘.

Claude Code가 승인을 요청하면 Y만 눌러주세요. 다운로드 + 새 PowerShell 창 열기까지 자동으로 완료됩니다.

STEP 3: 봇 서버 실행

이것만 직접 실행합니다. Claude Code가 열어준 새 PowerShell 창에서 아래 명령을 입력하세요.

PowerShell

.\cokacdir.exe --ccserver <봇토큰붙여넣기>

# 예시:
.\cokacdir.exe --ccserver 7123456789:AAH_abcdefg...

처음 실행 시 “터미널(앱)에서 열기”를 선택하세요. 지난 시간에 로그인한 Claude Pro 계정이 자동으로 연결됩니다.

왜 이것만 직접 실행하나요?

코깍딜은 터미널 화면(TUI)을 사용하는 앱이라 Claude Code 안에서는 실행이 안 됩니다. 별도 PowerShell 창에서 직접 실행해야 합니다.

테스트해보기

봇 서버가 실행되면, 텔레그램에서 아까 만든 봇에게 메시지를 보내보세요.

텔레그램에서 보내볼 메시지

안녕! 넌 누구야?
오늘 날씨 알려줘
현재 폴더에 있는 파일 목록 보여줘

내 PC의 Claude Code가 메시지를 받으면 웹 검색, 파일 읽기/쓰기, 코드 실행, 보고서 생성까지 수행하고 결과를 텔레그램으로 돌려보냅니다.

이해하기: 코깍딜이란?

봇이 동작하는 걸 확인했으니, 이게 어떤 원리인지 알아볼게요.

코깍딜(cokacdir)은 Claude CLI를 호출하는 텔레그램 연동 도구입니다. 내 PC에서 내 Claude 계정으로 직접 로그인해서 사용하기 때문에 정책을 100% 준수합니다.

핵심 원리

코깍딜은 내 PC에서 내 Pro 구독으로 직접 로그인합니다. 로그인 정보가 내 PC에만 존재하고, 제3자에게 넘기지 않습니다.

동작 흐름

내 Windows PC에서 바로 동작합니다. WSL 없이도 됩니다.

📱텔레그램에서 메시지 전송

🖥️코깍딜 서버가 메시지 수신 (내 PC의 PowerShell에서 실행 중)

🔐Claude CLI로 AI 호출 (내 Pro 구독 로그인)

⚙️AI가 파일 읽기 · 코드 실행 · 웹 검색 수행

💬결과를 텔레그램으로 전송

Windows 네이티브!

코깍딜은 Windows exe 파일 하나로 실행됩니다. WSL이나 Tailscale 같은 추가 설치가 필요 없어요.

OpenClaw vs 코깍딜

텔레그램과 Claude Code를 연결하는 방법은 크게 두 가지입니다.

	🐾 OpenClaw	🤖 코깍딜
설명	오픈소스 메신저 AI 에이전트	Claude Agent SDK 기반 텔레그램 연동
인증 방식	내 로그인 정보를 제3자에 전달	내 PC에서 직접 로그인
실행 위치	제3자 서버에서 내 계정 사용	내 PC에서 Claude CLI 직접 호출
Anthropic 정책	⚠️ 위반 (공식 금지)	✅ 준수 (공식 CLI 사용)
보안	정보 유출 · 폭주 위험	로그인 정보가 내 PC에만 존재
계정 안전	차단 가능성 있음	안전

OpenClaw의 치명적 문제

OpenClaw의 핵심 문제는 내 Claude Pro 구독 인증을 제3자 프로그램에 넘기는 것입니다. 마치 내 신용카드를 모르는 사람에게 빌려주는 것과 같아요.

🚫계정 차단

Anthropic이 공식적으로 Free, Pro, Max 계정의 OAuth 토큰을 제3자 도구에서 사용하는 것을 금지했습니다.

🔓보안 위험

타인이 내 계정으로 API를 호출할 수 있으며, 공개 Discord 서버에서 파일 시스템 탐색 사례가 보고되었습니다.

💸비용 폭탄

에이전트가 폭주하여 메시지 500건 이상을 무차별 발송한 실제 사고가 발생했습니다.

결론

OpenClaw은 편리하지만 정책 위반으로 계정이 차단될 수 있습니다. 이 가이드에서는 안전한 코깍딜을 사용합니다.

핵심 차이: 인증 방식

비유로 이해하면 쉽습니다.

🐾 OpenClaw

💳 신용카드를 모르는 사람에게 빌려주고 "대신 쇼핑해 주세요"

얼마를 쓸지 모름
어디서 쓸지 모름
내 통제 범위 밖

🤖 코깍딜

🏠 집 안의 내 금고에서 내가 직접 꺼내 쓰고 "열쇠는 내가 갖고 있다"

토큰이 내 PC에만 존재
내가 완전히 통제
추가 비용 없음

에러: Invalid API key

claude auth login으로 OAuth 로그인은 성공했는데, 코깍딜을 실행하면 이런 에러가 나오는 경우가 있습니다.

에러 메시지

Error: Invalid API key · Fix external API key

원인: API 키가 OAuth보다 먼저 적용됨

Claude CLI는 인증을 이 순서로 확인합니다:

환경변수 ANTHROPIC_API_KEY — 있으면 무조건 이걸 사용
OAuth 토큰 (.credentials.json) — 환경변수가 없을 때만

즉, 예전에 설정한 잘못된/만료된 API 키가 남아있으면 정상적인 OAuth 로그인을 덮어씌웁니다.

해결 방법

1단계: 환경변수 확인

PowerShell

echo $env:ANTHROPIC_API_KEY

값이 출력되면 → 이게 범인입니다. 아무것도 안 나오면 2단계로.

2단계: 환경변수 제거

PowerShell — 현재 세션에서 제거

$env:ANTHROPIC_API_KEY = ""

PowerShell — 영구 제거 (시스템 전체)

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $null, "User")

또는 시스템 속성 → 환경변수에서 직접 ANTHROPIC_API_KEY를 찾아 삭제하세요.

3단계: 확인 테스트

PowerShell

claude -p "안녕"

정상 응답이 오면 OAuth 인증이 잘 되는 것입니다. 코깍딜을 다시 실행하세요.

추가 확인 포인트

환경변수 외에도 API 키가 숨어있을 수 있는 곳:

코깍딜 실행 BAT 파일 안에 set ANTHROPIC_API_KEY=... 라인
작업 폴더의 .env 파일
%USERPROFILE%\.claude\settings.json에 apiKey 관련 설정

모두 확인하고 API 키 관련 항목이 있으면 삭제하세요.

에러: OS error 193

코깍딜을 실행하면 이런 에러가 나오는 경우입니다.

에러 메시지

OS error 193: %1은(는) 올바른 Win32 응용 프로그램이 아닙니다

원인: claude.cmd ≠ claude.exe

코깍딜(Rust 바이너리)은 내부적으로 claude -p "메시지"를 실행합니다. 그런데 Windows에서 npm install -g @anthropic-ai/claude-code로 설치하면, 실제로 만들어지는 건 claude.exe가 아니라 claude.cmd(배치 파일)입니다.

Rust 프로그램은 .cmd 파일을 직접 실행할 수 없습니다. 마치 “이 파일은 프로그램이 아닙니다”라고 거부당하는 것이에요.

구조 이해

📦

npm이 설치하는 것claude.cmd (배치 파일 — 텍스트 스크립트)

⚙️

코깍딜이 찾는 것claude.exe (네이티브 실행 파일)

❌

결과.cmd는 .exe가 아니므로 → OS error 193

해결 방법: EXE shim 만들기

claude.cmd를 대신 실행해주는 진짜 .exe 파일을 만들어야 합니다. Claude Code에게 시키면 됩니다.

Claude Code에 입력

코깍딜이 claude를 실행할 때 "OS error 193" 에러가 나.
npm이 설치한 claude.cmd를 Rust 바이너리가 .exe로 인식 못 하는 문제야.
claude.cmd를 정상 실행할 수 있도록 해결해줘

Claude Code가 아래와 같은 작업을 자동으로 수행합니다:

1claude.cmd 위치 확인 (where claude)

2Node.js로 claude.cmd를 호출하는 래퍼 스크립트 작성

3래퍼를 .exe로 컴파일하거나, PATH 우선순위 조정

4claude 명령이 정상 동작하는지 테스트

직접 수동 해결하고 싶다면

claude.cmd가 있는 폴더를 확인하고 (보통 %APPDATA%\npm\), 같은 경로에 claude.cmd를 cmd.exe /c로 실행하는 래퍼 EXE를 넣으면 됩니다.

PowerShell — claude.cmd 위치 확인

where.exe claude

하지만 이건 수동 작업이 많으니, Claude Code에게 맡기는 걸 추천합니다. AI한테 시키면 30초면 끝나요.

자동 실행 BAT 파일 만들기

매번 PowerShell을 열고 명령어를 치는 대신,더블클릭 한 번으로 코깍딜을 시작하는 BAT 파일을 만들어 봅시다.

start-bot.bat — 메모장에서 작성 후 저장

@echo off
cd /d "C:\Users\내유저\my-ai-bot"
set CLAUDE_CODE_BUBBLEWRAP=1
start "MyBot" cokacdir.exe --ccserver 여기에봇토큰붙여넣기

📁

cd /d 경로

CLAUDE.md가 있는 작업 폴더. 봇의 역할/규칙이 이 파일에서 결정됩니다.

🔒

CLAUDE_CODE_BUBBLEWRAP=1

샌드박스 모드. 봇이 시스템을 변경하지 못하게 보호합니다.

🚫

ANTHROPIC_API_KEY 없음

OAuth 인증을 사용하므로 API 키를 넣지 않습니다. 넣으면 Invalid API key 에러 발생!

Windows 시작 시 자동 실행하려면

Win + R → shell:startup 입력 → 열린 폴더에 BAT 파일의 바로가기를 넣으세요. PC를 켤 때마다 봇이 자동으로 시작됩니다.

그래도 안 되면 이것을 확인하세요

아래 5가지 결과를 확인하면 대부분의 문제를 진단할 수 있습니다:

claude --version — CLI 버전 확인
echo $env:ANTHROPIC_API_KEY — API 키 환경변수 확인
where.exe claude — claude 실행 파일 경로 확인
실행 BAT 파일 전체 내용
코깍딜 실행 시 전체 에러 로그

활용 ①: 파일 주고받기

텔레그램에서

[엑셀 파일 첨부]

이 매출 데이터 분석해서
월별 트렌드 차트 만들고
보고서로 보내줘

AI가 하는 일:

첨부 파일을 내 PC에 저장
Python으로 데이터 분석
차트 이미지 생성
보고서 파일로 정리
결과 파일을 텔레그램으로 전송

지하철에서 보고서 완성

지하철에서 엑셀 보내면 → 집 PC가 분석해서 → 보고서가 텔레그램으로 도착합니다.

활용 ②: 24시간 자동 비서

대화 예시

👤 "매일 아침 8시에 오늘 날씨랑 뉴스 요약 보내줘"

🤖 스케줄 등록 완료! 매일 08:00에 실행됩니다.

─────── 다음 날 아침 8:00 ───────

🤖 좋은 아침입니다!
🌤️ 서울 맑음 12°C
📰 뉴스 3건 요약 전송

PC만 켜 놓으면 내가 자고 있어도 봇이 알아서 일하고 결과를 보내줍니다.

활용 ③: 한 줄 지시 → 완성된 보고서

텔레그램에서

"2026년 AI 시장 동향 조사해서 보고서 만들어줘"

🤖 웹 검색 → 분석 → 차트 생성...

🤖 완료! 📎 AI_시장_동향_2026.html (차트 포함)

🔍

웹 검색

최신 데이터를 실시간으로 수집

📝

분석 & 정리

AI가 핵심만 추출해서 정리

📊

보고서 생성

차트 포함 완성된 파일로 전송

실전 프롬프트: 보고서 허브

"보고서 아카이빙 웹페이지를 만들어줘. 현재 폴더의 .html 파일들을 스캔해서 제목, 날짜, 카테고리를 자동 추출하고, 카테고리별 필터가 있는 카드 리스트로 만들어. 포트 5321로 dev 서버 띄워서 같은 와이파이의 폰에서도 볼 수 있게 해줘." — 이렇게 길고 구체적인 지시도 한 번에 처리합니다.

활용 ④: 영수증 → 자동 가계부

평소에 틈날 때마다

👤 [영수증 사진 📸]
🤖 저장! 스타벅스 6,500원 (카페)

👤 [영수증 사진 📸]
🤖 저장! GS25 12,300원 (편의점/식비)

👤 [카드 문자 캡처 📱]
🤖 저장! 쿠팡 45,900원 (온라인쇼핑)

월말에

👤 "이번 달 지출 리포트 만들어줘"

🤖 3월 지출 리포트 완성!
📎 3월_지출_리포트.html
· 총 1,842,500원
· 카테고리별 차트 포함

가계부 앱 필요 없습니다. 영수증 찍어서 텔레그램에 보내기만 하면 AI가 누적 관리하고, 월말에 한 마디면 차트 포함 리포트가 완성됩니다.

활용 ⑤: 프로젝트별 멀티봇

BotFather에서 봇을 추가로 만들고, 코깍딜을 하나 더 실행하면 끝입니다. 텔레그램 채팅방을 전환하듯이 목적별 AI 비서를 사용할 수 있어요.

💼

업무 봇

· 보고서 작성
· 이메일 초안
· 데이터 분석

📚

학습 봇

· 영어 회화 연습
· 자격증 문제 풀기
· 논문 요약

🏠

생활 봇

· 레시피 추천
· 가계부 관리
· 일정 알림

봇마다 독립된 대화 & 기억

각 봇은 별도의 대화 맥락을 가집니다. 업무 봇에게 말한 내용을 학습 봇이 알지 못해요.

활용 ⑥: 나를 기억하는 AI

대화 예시

── 3월 3일 ──

👤 "나 매운 거 못 먹어. 기억해줘"
🤖 기억했습니다! 매운 음식 제외하겠습니다.

── 일주일 후 ──

👤 "오늘 점심 뭐 먹지?"
🤖 매운 음식 빼고 추천드릴게요!
🍝 크림 파스타 — 강남역 '파스타집' (도보 5분)
🍱 연어 포케 — 역삼역 '포케샐러드' (도보 8분)

대화 내용이 내 PC에 저장됩니다. 오래 쓸수록 나를 더 잘 아는 AI가 돼요. ChatGPT와 달리 데이터가 클라우드가 아닌 내 컴퓨터에만 존재해서 프라이버시도 보호됩니다.

핵심 정리

1코깍딜은 내 Windows PC에서 내 Pro 구독으로 직접 실행 → 정책 준수

2설치는 3단계 — 봇 만들기 → 코깍딜 설치 → 실행 → 끝!

3OpenClaw은 편리하지만 정책 위반 → 계정 차단 위험

4핵심 차이는 인증 방식 — 로그인 정보를 제3자에게 vs 내 PC에서 직접

5텔레그램 봇 하나면 어디서든 AI 원격 조종 가능

내 AI를, 안전하게, 어디서든

터미널 앞에서만 쓰던 AI를 이제 주머니에서 꺼내 쓰세요. 텔레그램 하나로 파일 분석, 자동 스케줄, 웹 리서치, 보고서 생성, 코드 실행, 번역까지 — 모든 것이 가능합니다.