המדריך המלא: חיבור Claude Code לטלגרם - מהתקנה עד הפעלה אוטומטית לצמיתות
המדריך המלא: חיבור Claude Code לטלגרם
מאת רועי טל | 22 במרץ 2026 | 12 דקות קריאה
תארו לעצמכם: אתם בחוץ, רחוק מהמחשב, ופתאום צריכים ש-Claude Code יבצע משימה - לעדכן קובץ, לשלוח הודעה אוטומטית, לכתוב קוד. עם החיבור שתלמדו במדריך הזה - שולחים הודעה פשוטה בטלגרם מהטלפון, ו-Claude Code על המחשב שלכם מבצע את הפקודה. מרחוק. בזמן אמת. בלי לגעת במחשב.
🎯מה תשיגו בסוף המדריך הזה
- ✅בוט טלגרם אישי שמחובר ישירות ל-Claude Code שלכם
- ✅הבוט עולה אוטומטית עם הדלקת המחשב - ללא שום פעולה ידנית
- ✅חוזר לחיות לבד אחרי שינה, הפעלה מחדש, או קריסה
- ✅אין כפילויות, אין בעיות, אין תחזוקה ידנית
- ✅שליטה מלאה על מי מורשה לפנות לבוט - רק אתם
לפני שמתחילים - מה נדרש
Claude Code
מותקן ומוגדר עם API Key של Anthropic. אם עוד לא - התקינו עם:
npm install -g @anthropic-ai/claude-code
חשבון טלגרם
אפליקציית Telegram מותקנת על הטלפון. תצטרכו גישה לשיחות עם בוטים.
Windows 10/11
המדריך מותאם ל-Windows. ראו בהמשך את הסעיף המיוחד למשתמשי Mac.
🍎 משתמשי Mac / Linux - לחצו לראות את ההוראות שלכם
ב-Mac ו-Linux, במקום Task Scheduler ו-.bat, משתמשים בכלים מקבילים. כל שאר השלבים (BotFather, טוקן, הרשאות) זהים לחלוטין.
שלב 3 (Mac): קובץ הפעלה
במקום .bat - צרו קובץ start-telegram-bot.sh:
#!/bin/bash
pkill -f "bun.*telegram" 2>/dev/null
sleep 2
claude --channels plugin:telegram@claude-plugins-official --dangerously-skip-permissionsהפכו את הקובץ להרצה: chmod +x start-telegram-bot.sh
שלב 4 (Mac): הפעלה אוטומטית עם Startup - LaunchAgent
במקום Task Scheduler - צרו קובץ plist ב-~/Library/LaunchAgents/:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.rtai.telegram-bot</string>
<key>ProgramArguments</key>
<array>
<string>/bin/bash</string>
<string>/Users/YOUR_USER/start-telegram-bot.sh</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
<key>StandardOutPath</key>
<string>/tmp/telegram-bot.log</string>
<key>StandardErrorPath</key>
<string>/tmp/telegram-bot-error.log</string>
</dict>
</plist>החליפו YOUR_USER בשם המשתמש שלכם. לאחר מכן הפעילו:
launchctl load ~/Library/LaunchAgents/com.rtai.telegram-bot.plist
💡 יתרון Mac: ה-KeepAlive: true בפועל עושה גם את עבודת ה-Watchdog - macOS יפעיל מחדש את הבוט אוטומטית אם יקרוס. אין צורך בסקריפט Watchdog נפרד!
💡 חשוב לדעת: כל החיבור הזה הוא מקומי - הבוט רץ על המחשב שלכם בלבד, לא על שרת חיצוני. זה אומר שהחיבור פועל רק כשהמחשב פועל ומחובר לאינטרנט. היתרון: הכל פרטי ומאובטח - אף מידע לא עובר דרך שרתי צד שלישי.
מסלול אוטומטי
אתם אומרים ל-Claude מה לעשות, הוא עושה. אין כתיבת קבצים ידנית. ~10 דקות.
מומלץ לרוב המשתמשים ↓מסלול טכני
כל קובץ, כל פקודה, כל שלב - בידיים שלכם. שליטה מלאה.
למשתמשים טכניים ↓מסלול אוטומטי - Claude עושה הכל
אתם נותנים הוראות בשפה רגילה ומאשרים פעולות. אין כתיבת קבצים ידנית.
צרו בוט בטלגרם דרך BotFather 
השלב היחיד שצריך לעשות ידנית - יצירת הבוט נעשית מתוך טלגרם.
- 1. פיתחו טלגרם וחפשו @BotFather (הרשמי עם ✓ כחול)
- 2. שלחו
/newbot - 3. תנו שם לבוט ושם משתמש (חייב להסתיים ב-
bot) - 4. העתיקו את ה-API Token - תצטרכו אותו בשלב הבא
הגדרת הטוקן ב-Claude Code
יש שתי דרכים - בחרו את המתאימה לכם:
✅ אופציה א - דרך הסקיל (מומלץ, הטוקן לא עובר בשיחה)
- 1. פיתחו CMD והריצו:
claude --dangerously-skip-permissions⚠️ על הפלאג: כשהבוט רץ ברקע אין מי שיאשר פעולות - הפלאג מאפשר לClaude לעבוד אוטומטית. הסיכון נמוך כי רק אתם שולחים לבוט פקודות.
- 2. כשנפתח, הריצו את הסקיל:
/telegram:configure - 3. Claude ישאל אתכם ישירות על הטוקן - הדביקו אותו. הוא לא עובר בשיחה.
🛠 אופציה ב - ידנית (בלי Claude)
- 1. נווטו לתיקייה:
C:Users[שמכם].claudechannels elegram - 2. צרו קובץ בשם
.env(אם לא קיים) - 3. כתבו בתוכו:
TELEGRAM_BOT_TOKEN=הדביקו_כאן_את_הטוקן - 4. שמרו את הקובץ
חיבור הטלגרם שלכם (Pairing)
Claude Code עדיין פתוח ורץ מהשלב הקודם.
- 1. פיתחו טלגרם בטלפון, חפשו את הבוט לפי שם המשתמש שנתתם, ושלחו לו: /start
-
2. חזרו ל-CMD - תראו הודעה שמישהו מבקש להתחבר (זה אתם). הגידו ל-Claude:
💬 תגידו ל-Claude:
approve the pairing - 3. ✅ הבוט כבר יענה להודעות שלכם - שלחו "היי" לבדיקה
Claude יוצר את כל הקבצים ומגדיר Startup
זה השלב שמשנה הכל. משפט אחד ל-Claude - הוא יוצר את כל 4 הקבצים (BAT, VBS, Watchdog, Watchdog-VBS) ומוסיף אותם להפעלה אוטומטית עם Windows.
💬 תגידו ל-Claude (החליפו [שמכם] בשם המשתמש Windows שלכם):
צור לי את כל הקבצים שנדרשים כדי שהבוט יעבוד ברקע אוטומטית עם Windows: קובץ BAT להפעלה, VBS שמסתיר את החלון, סקריפט Watchdog ב-PowerShell שבודק כל 5 דקות אם הבוט חי ומפעיל אותו מחדש אם לא, ו-VBS שמפעיל את ה-Watchdog. שמור הכל בנתיב C:Users[שמכם].claudechannels elegram ואחר כך הוסף את שני קבצי ה-VBS לתיקיית Startup כדי שיעלו עם Windows
אשרו כל פעולה שClaude מבקש - יצירת קבצים, הוספה ל-Startup. הוא יטפל בכל שאר הפרטים.
🍎 Mac/Linux? הוסיפו "אני על Mac" להודעה למעלה - Claude יוצר .sh ו-LaunchAgent במקום .bat/.vbs, כולל KeepAlive שמחליף את ה-Watchdog.
בדיקה - וודאו שהכל עובד
- 1. כבו את המחשב לגמרי והדליקו מחדש
- 2. חכו כדקה שהכל יעלה
- 3. שלחו "בדיקה" לבוט שלכם בטלגרם - Claude אמור להגיב ✅
- 4. אם הבוט לא הגיב - חכו עוד 30 שניות ונסו שוב. אם עדיין לא עובד - פתחו שיחה חדשה עם Claude Code וכתבו לו "הבוט לא מגיב, בדוק מה לא עובד ותקן" - הוא יאתר בעצמו שגיאות כמו תהליכים כפולים שרצים, הרשאות חסרות, ושגיאות בהרצה
⚠️שגיאה נפוצה: הבוט מפסיק להגיב לאחר שימוש
אם פתחתם Claude Code ידנית עם --channels בזמן שה-background service כבר פועל - יש עכשיו שני instances שמתחרים על אותן הודעות. כל אחד תופס הודעה ו"זורק" אותה - ולא מגיבים.
איך נמנעים: לא לפתוח Claude Code עם --channels ידנית - ה-background service עושה את זה לבד.
איך מתקנים: פתחו שיחה עם Claude Code וכתבו "הבוט לא מגיב, נקה תהליכים כפולים ואתחל" - הוא יטפל בהכל.
מסלול טכני - שליטה מלאה
כל קובץ, כל פקודה, כל שלב - בידיים שלכם. מתאים למי שרוצה להבין לעומק או להתאים אישית.
שלב 1: יצירת הבוט בטלגרם דרך BotFather
כל בוט בטלגרם נוצר דרך בוט מיוחד שנקרא BotFather - הכלי הרשמי של טלגרם ליצירת בוטים. התהליך לוקח פחות מ-2 דקות.
פיתחו טלגרם וחפשו @BotFather
חפשו בשורת החיפוש "BotFather" - בחרו את הבוט הרשמי עם סימן הוי כחול ✓. לחצו Start אם צריך.
שלחו /newbot
BotFather יבקש שם לבוט (לדוגמה: "Claude Assistant") ואחר כך שם משתמש - חייב להסתיים ב-bot (לדוגמה: my_claude_bot).
העתיקו את ה-API Token
BotFather ישלח הודעה עם הטוקן - נראה כך: 1234567890:AAHxxx...xxx. שמרו אותו - תצטרכו אותו בשלב הבא.
✅ עד כאן: יצרתם בוט בטלגרם וקיבלתם API Token. זה הגשר בין טלגרם ל-Claude Code. שמרו אותו.
שלב 2: הגדרת הטוקן ב-Claude Code
עכשיו נחבר את הטוקן ל-Claude Code. הדרך הפשוטה ביותר - פשוט לומר ל-Claude את הטוקן, והוא יטפל בשאר.
כך עושים:
- 1. פיתחו CMD ב-Windows (Windows + R ← הקלידו cmd ← Enter)
- 2. הפעילו Claude Code:
claude - 3. כשהמסך עולה, הקלידו:
הגדר את חיבור הטלגרם עם הטוקן: [הדביקו כאן] - 4. Claude יפעיל אוטומטית את הסקיל המתאים ויגדיר הכל
מה קורה ברקע: Claude שומר את הטוקן בקובץ .env בנתיב C:\Users\[שמכם]\.claude\channels\telegram\.env. לא תצטרכו לגעת בקובץ הזה ידנית.
שלב 3: חיבור הטלגרם שלכם (Pairing)
הבוט יודע מי מורשה לפנות אליו דרך "רשימת מורשים". בשלב זה נוסיף את הטלגרם שלכם לרשימה.
⚠️ למה יש --dangerously-skip-permissions בכל הפקודות?
כש-Claude Code רץ בחלון CMD רגיל - אתם שם. הוא יכול לשאול "האם לבצע פעולה X?" ואתם לוחצים Y. אבל כשהבוט רץ ברקע, אוטומטית, ללא חלון - אין מי שיאשר. Claude Code ישלח שאלת אישור לחלל, לא יקבל תשובה, ויתקע. הפקודה שליחתם מהטלפון לעולם לא תבוצע.
הפלאג --dangerously-skip-permissions אומר ל-Claude Code: "בצע הכל ישירות, בלי לשאול". זה מה שמאפשר לו לעבוד לגמרי אוטומטי.
הסיכון הקטן: Claude יכול לבצע פעולות (מחיקת קבצים, הרצת קוד) בלי לבקש אישור שלכם. זה נשמע מפחיד, אבל בפועל הסיכון נמוך מאוד - כי הגדרתם שרק אתם יכולים לשלוח פקודות לבוט. כלומר אם שלחתם "מחק את הקובץ" - הוא יבצע. בדיוק כמו שרציתם. שמרו על הגישה לבוט רק לעצמכם - ואין לאף אחד אחר אפשרות לנצל את זה.
הפעילו את הבוט לראשונה
ב-CMD, הריצו:
claude --channels plugin:telegram@claude-plugins-official --dangerously-skip-permissions
חכו שיופיע: "Listening for channel messages from: plugin:telegram..."
שלחו הודעה לבוט שלכם מטלגרם
חפשו את הבוט בטלגרם לפי שם המשתמש שנתתם לו (לדוגמה @my_claude_bot) ושלחו כל הודעה - "שלום", "בדיקה", או כל דבר אחר.
אשרו את החיבור ב-Claude Code
במסך Claude Code תופיע בקשת חיבור. הקלידו: approve the pairing או אשר את הpairing
✅ מעכשיו Claude Code יענה להודעות שלכם בטלגרם! אבל הוא עדיין לא מופעל אוטומטית ולא רץ ברקע. זה מה שנפתור בשלבים הבאים.
שלב 4: הרצה ברקע - ללא חלון CMD פתוח
כרגע הבוט רץ רק כשחלון CMD פתוח. ניצור שני קבצים פשוטים שיאפשרו לו לרוץ בשקט ברקע.
קובץ 1: start-telegram-bot.bat
שמרו בנתיב: C:\Users\[שמכם]\.claude\channels\telegram\start-telegram-bot.bat
@echo off
REM Kill any existing bun processes to prevent duplicates
taskkill /F /IM bun.exe /T 2>nul
REM Wait 2 seconds for cleanup
timeout /t 2 /nobreak >nul
cd /d "C:\Users\[שמכם]\[תיקיית הפרויקט שלכם]"
"C:\Users\[שמכם]\AppData\Roaming\npm\claude.cmd" --channels plugin:telegram@claude-plugins-official --dangerously-skip-permissions
שימו לב: החליפו [שמכם] בשם המשתמש Windows שלכם (מה שמופיע ב-C:\Users\...) ו-[תיקיית הפרויקט] בנתיב לתיקיה שבה אתם עובדים עם Claude Code בד"כ.
קובץ 2: start-hidden.vbs
שמרו באותה תיקייה: start-hidden.vbs
CreateObject("WScript.Shell").Run "C:\Users\[שמכם]\.claude\channels\telegram\start-telegram-bot.bat", 0, Falseהקובץ הזה מפעיל את ה-BAT עם חלון מוסתר לחלוטין (0 = Hidden). כפל לחיצה עליו - ושום דבר לא יופיע על המסך. הבוט יעבוד ברקע.
שלב 5: הפעלה אוטומטית עם Windows
נוסיף את הבוט להפעלה אוטומטית בכניסה ל-Windows, כך שלא תצטרכו להפעיל אותו ידנית אף פעם.
הדרך הפשוטה - תיקיית Startup
- 1. לחצו Windows + R על המקלדת
- 2. הקלידו
shell:startupולחצו Enter - נפתחת תיקיית ה-Startup - 3. גררו לשם את קובץ
start-hidden.vbs(או צרו קיצור דרך אליו) - 4. זהו! מהפעם הבאה שתפעילו את Windows - הבוט יעלה אוטומטית
שלב 6 - הכי חשוב: Watchdog שמחזיר את הבוט לחיים
זהו השלב שרוב המדריכים מדלגים עליו - ולכן הבוט נעצר אחרי שינה. ה-Watchdog הוא תהליך שרץ ברקע, בודק כל 5 דקות אם הבוט חי, ואם לא - מפעיל אותו מחדש. אוטומטית. בלי שתצטרכו לעשות כלום.
אחרי שינה
כשהמחשב מתעורר, הבוט מת. ה-Watchdog מגלה תוך עד 5 דקות ומפעיל מחדש.
אחרי קריסה
אם הבוט קורס מסיבה כלשהי - Watchdog מחזיר אותו לחיים.
קובץ 1: watchdog.ps1
שמרו בנתיב C:\Users\[שמכם]\.claude\channels\telegram\watchdog.ps1:
while ($true) {
$bun = Get-Process -Name bun -ErrorAction SilentlyContinue
if (-not $bun) {
Start-Process -FilePath 'wscript.exe' -ArgumentList 'C:\Users\[שמכם]\.claude\channels\telegram\start-hidden.vbs'
}
Start-Sleep -Seconds 300
}קובץ 2: start-watchdog.vbs
שמרו באותה תיקייה:
CreateObject("WScript.Shell").Run "powershell.exe -WindowStyle Hidden -ExecutionPolicy Bypass -File ""C:\Users\[שמכם]\.claude\channels\telegram\watchdog.ps1""", 0, Falseהוספת ה-Watchdog ל-Startup
בדיוק כמו בשלב 5 - הוסיפו גם את start-watchdog.vbs לתיקיית ה-Startup. כך גם הבוט וגם ה-Watchdog יעלו עם Windows.
בדיקה סופית - וודאו שהכל עובד
✅ רשימת בדיקה
- □ בוט נוצר ב-BotFather + טוקן שמור
- □ הטוקן הוגדר ב-Claude Code (קובץ .env)
- □ ה-Pairing אושר
- □ start-telegram-bot.bat נוצר ונערך
- □ start-hidden.vbs נוצר
- □ watchdog.ps1 נוצר ונערך
- □ start-watchdog.vbs נוצר
- □ שני ה-VBS קיימים בתיקיית Startup
🧪 איך לבדוק
- 1. כבו את המחשב לגמרי והדליקו מחדש
- 2. חכו כדקה שהכל יעלה
- 3. שלחו "בדיקה" לבוט שלכם בטלגרם - Claude אמור להגיב
- 4. אם לא הגיב - פתחו שיחה חדשה עם Claude Code וכתבו "הבוט לא מגיב, בדוק מה לא עובד ותקן" - הוא יאתר ויתקן לבד
- 6. שלחו שוב "בדיקה" - ללא שום פעולה ידנית
פתרון בעיות נפוצות
🐛 הבוט לא מגיב - instances כפולים
הסיבה: פתחתם Claude Code ידנית עם --channels בזמן שה-background service פועל - שניים מתחרים על אותן הודעות, אף אחד לא מגיב.
זיהוי: Task Manager ← חפשו bun.exe - אם יש יותר מ-2 תהליכים, זו הבעיה.
תיקון מהיר - CMD כ-Administrator:
taskkill /F /IM bun.exe /T
ואז הריצו שוב את start-telegram-bot.bat - זה ינקה ויעלה instance אחד נקי.
מניעה: לא לפתוח Claude Code עם --channels ידנית כשה-background service פעיל.
🐛 הבוט עובד כשCMD פתוח אבל לא ברקע
בדקו שה-VBS מצביע לנתיב הנכון של ה-BAT, ושה-BAT מצביע לנתיב הנכון של claude.cmd (בדרך כלל: C:\Users\[שמכם]\AppData\Roaming\npm\claude.cmd).
🐛 אחרי שינה הבוט לא חוזר
ודאו שה-Watchdog רץ: פיתחו Task Manager ← חפשו "powershell.exe" ← אמור להיות שם. אם אין - הריצו שוב את start-watchdog.vbs.
🐛 שגיאת "TELEGRAM_BOT_TOKEN required"
הטוקן לא נשמר. חזרו לשלב 2 - הפעילו Claude Code ואמרו לו "הגדר טלגרם עם הטוקן" שוב.
🖥️ רץ על VPS / Windows Server? לחצו לפתרון מיוחד
הגישה של BAT + VBS + Startup folder מתאימה למחשב רגיל עם משתמש מחובר. בשרת VPS (Windows Server 2019/2022), כשמנתקים RDP - ה-session עלול לסגור תהליכים. הפתרון: NSSM - שהופך את הבוט ל-Windows Service אמיתי.
✅ יתרונות NSSM על VPS
- • רץ ללא session פתוח - לא תלוי ב-RDP
- • עולה אוטומטית עם הserver
- • מתאים ב-crash אוטומטית - ללא Watchdog נפרד
- • עובד על Windows Server 2019/2022
שלב 1: הורידו NSSM
הורידו את nssm.exe מהאתר הרשמי ושמרו אותו למשל ב-C:\tools\nssm.exe.
שלב 2: צרו את ה-Service
פתחו CMD כ-Administrator והריצו:
nssm install ClaudeTelegramBot "C:\Users\[username]\AppData\Roaming\npm\claude.cmd" "--channels plugin:telegram@claude-plugins-official --dangerously-skip-permissions"החליפו [username] בשם המשתמש שלכם בשרת.
שלב 3: הפעילו את ה-Service
nssm start ClaudeTelegramBotפקודות ניהול שימושיות
nssm status ClaudeTelegramBot
nssm restart ClaudeTelegramBot
nssm stop ClaudeTelegramBot
שאר השלבים במדריך (BotFather, טוקן, הרשאות) זהים לחלוטין - רק שלבים 3-6 מוחלפים ב-NSSM.
הירשמו לעדכונים במייל
רוצים להישאר צעד אחד קדימה?
עדכונים על כלי AI, מדריכים וטיפים - ישר למייל. בלי ספאם.
