איך לחבר קלוד קוד (Claude Code) לבוט טלגרם, לשלוט מהנייד

אפשר לשלוט בקלוד קוד (Claude Code) ישירות מטלגרם: שולחים לו משימה מהנייד, הוא מבצע אותה על הפרויקט האמיתי, ומחזיר תשובה לצ'אט. כל מה שצריך זה בוט טלגרם וסקריפט קטן שמגשר בין ההודעות שלכם לסשן הרץ. במדריך הזה נבנה את הגשר הזה מאפס, עם הקוד המלא, בשיטת long-polling פשוטה, בלי שרת ובלי webhook.

גילוי נאות: את המדריך הזה ביקשתי מקלוד קוד דרך בוט טלגרם, מהנייד, והוא כתב אותו, פרסם, ושלח לי את הקישור בחזרה.

מה בונים כאן?

"גשר" (bridge) בין שני צדדים:

1. טלגרם → קלוד: סקריפט שמאזין להודעות שלכם ומעיר את הסשן של קלוד קוד (Claude Code) עם מה שכתבתם.
2. קלוד → טלגרם: סקריפט שמחזיר את התשובה של קלוד לצ'אט שלכם.

בתווך: קלוד קוד עצמו, שמריץ את המשימה עם כל הכלים שיש לו (עריכת קבצים, הרצת פקודות, פריסה, קריאה ל-APIים).

שלב 1: יוצרים בוט טלגרם ומקבלים טוקן

1. פותחים בטלגרם צ'אט עם BotFather (הבוט הרשמי ליצירת בוטים).
2. שולחים /newbot, בוחרים שם ושם משתמש (חייב להסתיים ב-bot).
3. מקבלים טוקן שנראה כך: 8927:AA.... זה המפתח לכל ה-API. שמרו אותו, ואל תשתפו אותו, הוא כמו סיסמה.

שלב 2: שומרים את הפרטים בבטחה

הטוקן והצ'אט לא נכנסים לקוד ולא ל-git. שומרים אותם בקובץ מקומי:

# ~/.telegram-creds
TG_TOKEN=הטוקן-שקיבלתם-מ-BotFather
TG_CHAT=            # יתמלא אוטומטית בהודעה הראשונה

chmod 600 ~/.telegram-creds   # רק אתם יכולים לקרוא

שלב 3: הסקריפט שמאזין (Telegram ← אתם)

השיטה: long-polling. שואלים את טלגרם "יש הודעה חדשה?" עם timeout גבוה, וטלגרם מחזיק את החיבור פתוח עד שמגיעה הודעה או שהזמן עובר. פשוט, בלי כתובת ציבורית.

#!/usr/bin/env bash
set -euo pipefail
set -a; . "${HOME}/.telegram-creds"; set +a
BASE="https://api.telegram.org/bot${TG_TOKEN}"
OFFSET_FILE="${HOME}/.telegram-offset"
offset="$(cat "$OFFSET_FILE" 2>/dev/null || echo 0)"

# timeout=45 -> טלגרם מחזיק את החיבור עד 45 שניות (long-polling)
resp="$(curl -s --max-time 60 \
  "${BASE}/getUpdates?timeout=45&offset=${offset}&allowed_updates=%5B%22message%22%5D")"

# מחלצים את ההודעה + chat id, ומקדמים את ה-offset כדי לא לקרוא אותה פעמיים
echo "$resp" | python3 -c '
import sys, json
d = json.load(sys.stdin)
for u in d.get("result", []):
    m = u.get("message") or {}
    txt = m.get("text")
    if txt:
        chat = m["chat"]["id"]
        print(f"CHAT\t{chat}")
        print(f"MSG\t{txt}")
        print(f"OFFSET\t{u[\"update_id\"] + 1}")
'

שני עקרונות חשובים כאן:

• offset: טלגרם מחזיר הודעות לפי מספר עולה. שומרים את המספר האחרון שטופל, כדי לא לעבד את אותה הודעה שוב.
• סינון לפי chat id: שומרים את ה-chat מההודעה הראשונה, ומאותו רגע מתעלמים מכל צ'אט אחר. כך רק אתם מפעילים את הבוט.

שלב 4: הסקריפט ששולח (Telegram ← קלוד)

#!/usr/bin/env bash
set -euo pipefail
set -a; . "${HOME}/.telegram-creds"; set +a
curl -s -X POST "https://api.telegram.org/bot${TG_TOKEN}/sendMessage" \
  --data-urlencode "chat_id=${TG_CHAT}" \
  --data-urlencode "text=${1}" \
  -d "disable_web_page_preview=true" >/dev/null && echo SENT

טיפ: שולחים כטקסט רגיל (בלי parse_mode), כדי להימנע מכל כאב הראש של escaping ב-MarkdownV2. טלגרם מציג עברית ו-RTL מצוין ככה.

שלב 5: לולאת הגשר

עכשיו מחברים הכל בקלוד קוד (Claude Code): מבקשים ממנו להריץ את סקריפט ההאזנה, וכשמגיעה הודעה, הוא מבצע את מה שביקשתם ומחזיר תשובה עם סקריפט השליחה. ואז מאזין שוב. זהו, לולאה:

מאזינים  →  מגיעה הודעה  →  קלוד מבצע  →  שולחים תשובה  →  מאזינים שוב

בפועל אומרים לקלוד משהו כמו: "תיכנס למצב גשר טלגרם: הרץ את listen, ולכל הודעה שמגיעה, בצע אותה ותחזיר לי תשובה עם send, ואז תאזין שוב." מרגע זה אתם שולחים לו משימות מהנייד: "תפרסם את הטיוטה", "תבדוק כמה לידים נכנסו היום", "תריץ את הבדיקות", והוא מבצע בפועל ומדווח בטלגרם.

אבטחה: שלושה כללים

1. רק הצ'אט שלכם. נעילה ל-chat id אחד. הודעות מאחרים מתעלמות.
2. הטוקן = סיסמה. בקובץ מקומי עם chmod 600, לא ב-git, לא בצילומי מסך. אם דלף, /revoke ב-BotFather.
3. הרשאות. קלוד קוד רץ עם ההרשאות של המשתמש שלכם. תנו פקודות ברורות, ובדקו מה שהוא עומד לבצע כשזה נוגע לדברים בלתי-הפיכים.

למה זה כל כך שימושי

זה הופך את קלוד קוד (Claude Code) מכלי ששמור לשולחן העבודה, לעוזר שתמיד בכיס. אותה מערכת אפשר לחבר גם לוואטסאפ עם Green API, וזה אותו עיקרון בדיוק שראינו במערכת תיאום הפגישות שבנינו, התראות ופקודות דרך צ'אט.

רוצים ללמוד לעבוד ככה עם קלוד קוד? יש מדריך Claude Code מלא בעברית, סדנת קלוד קוד לארגונים, ושיעור פרטי 1-על-1 שבו נבנה את זה יחד על הפרויקט שלכם.

שורה תחתונה

חיבור קלוד קוד (Claude Code) לבוט טלגרם הוא שני קבצי bash קטנים + טוקן מ-BotFather. אין צורך בשרת, ב-webhook או ב-HTTPS, long-polling פשוט מספיק. התוצאה: אתם שולטים בפרויקט שלכם מהנייד, מכל מקום, ומקבלים תשובות בזמן אמת.