📘 תיעוד 56

הפעלת סשנים מקישורים

פתיחת סשן טרמינל של Claude Code מכתובת URL. הטמעת קישורי claude-cli:// ב-runbooks, בהתראות ובלוחות בקרה, כך שלחיצה פותחת את Claude Code במאגר הנכון עם הפרומפט הנכון.

קישור עמוק הוא כתובת claude-cli:// שפותחת את Claude Code בחלון טרמינל חדש. הכתובת יכולה לשאת ספריית עבודה ופרומפט למילוי מראש.

הפרומפט מאוכלס אבל לא נשלח עד שלוחצים Enter. כדי שקישורים ייפתחו במחשב, קודם שולחים פרומפט בסשן אינטראקטיבי של Claude Code שם, כדי ש-Claude Code ירשום את ה-handler של claude-cli://.

מכיוון שקישור עמוק הוא URL, אפשר לשים אותו בכל מקום שבו קישור יכול להופיע:

• שלב ב-runbook של תקלה שפותח את מאגר השירות המושפע עם פרומפט אבחוני
• התראת ניטור או לוח בקרה שמקשרים לפרומפט חקירה עבור מדד מסוים
• עמוד README או ויקי שפותח את הפרויקט עם פרומפט קליטה
• התראה על כשל ב-CI שממלאת מראש את שם המשימה שנכשלה

העמוד הזה מכסה איך לבנות קישור, להטמיע אותו ב-runbook או להפעיל אותו מהמעטפת, ולנהל או לבטל רישום handler בכל פלטפורמה.

#איך קישורים עמוקים עובדים

הקידומת claude-cli:// היא סכמת URL מותאמת אישית ש-Claude Code רושם אצל מערכת ההפעלה, בדומה לאופן שבו קישורי mailto: פותחים את תוכנת הדוא"ל. כשלוחצים על קישור עמוק:

1. הדפדפן או היישום מעבירים את ה-URL למערכת ההפעלה.
2. מערכת ההפעלה מזהה את הקידומת claude-cli:// ומפעילה את Claude Code במחשב.
3. נפתח חלון טרמינל חדש עם Claude Code שרץ בספרייה שהקישור ציין, וטקסט הפרומפט של הקישור כבר בתיבת הקלט.
4. קוראים את הפרומפט, עורכים אותו אם רוצים, ולוחצים Enter כדי לשלוח אותו.

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

הפלטפורמה שמציגה את הקישור חייבת לאפשר סכמות URL מותאמות אישית. לגבי מה ש-GitHub עושה איתן ולגבי הפתרון העקיף, ראו הקישור מוצג כטקסט רגיל במקום להיות לחיץ.

#מה סשן שהופעל מציג

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

כשהסשן נפתח, שורת אזהרה מתחת לתיבת הקלט קוראת Prompt from an external link ונשארת גלויה עד ששולחים או מנקים את הפרומפט. לפרומפטים של יותר מ-1,000 תווים, האזהרה כוללת את מספר התווים ואומרת לגלול ולסקור את הטקסט המלא לפני לחיצה על Enter, כי פרומפטים ארוכים יכולים לדחוף הוראות אל מחוץ למסך. כללי הרשאה, CLAUDE.md ופרומפטי אמון עבור הספרייה שנבחרה חלים באותו אופן כמו בכל סשן אחר.

#בניית קישור

קישור עמוק מתחיל ב-claude-cli://open, ואחריו פרמטרי שאילתה אופציונליים. הצורה המינימלית פותחת את Claude Code בספריית הבית עם פרומפט ריק:

claude-cli://open

כדי לנסות קישור בלי לשים אותו בעמוד, מדביקים אותו בשורת הכתובת של הדפדפן או פותחים אותו מהמעטפת.

מוסיפים פרמטרים כדי לשלוט איפה הסשן מתחיל ומה תיבת הפרומפט מכילה:

cwd ו-repo הם שתי דרכים לקבוע את ספריית העבודה. אם מעבירים את שניהם, cwd מקבל עדיפות ו-repo מתעלמים ממנו, גם אם נתיב cwd לא קיים.

הקישור הבא מצביע על מאגר בשם acme/payments עם פרומפט אבחוני בן שתי שורות. מחליפים את acme/payments ב-slug של owner/name של המאגר כשבונים קישור משלכם:

claude-cli://open?repo=acme/payments&q=Investigate%20the%20failed%20deploy%20of%20payments-api.%0ACheck%20recent%20commits%20to%20main%20and%20the%20last%20successful%20build.

לחיצה עליו פותחת חלון טרמינל חדש, מפעילה את Claude Code בשכפול המקומי של acme/payments, וממלאת את תיבת הפרומפט בטקסט המפוענח:

Investigate the failed deploy of payments-api.
Check recent commits to main and the last successful build.

אפשר לערוך את הפרומפט לפני לחיצה על Enter כדי לשלוח אותו. ראו בחירה בין cwd ל-repo לגבי איך הנתיב המקומי נבחר כשיש כמה שכפולים או worktrees.

#בחירה בין cwd ל-repo

משתמשים ב-cwd כשכל מי שלוחץ על הקישור מחזיק את הפרויקט באותו נתיב מוחלט, למשל תמונת devcontainer או VM אחידה.

משתמשים ב-repo כשהקישור משותף וכל אדם משכפל למיקום אחר. Claude Code פותר את ה-slug לנתיב מקומי כך:

• repo פותח את השכפול או ה-worktree של המאגר המקושר במקום שבו הרצתם claude לאחרונה. בכל פעם שמריצים claude במאגר Git, Claude Code רושם את נתיב הספרייה מול ה-slug של GitHub בצורת owner/name של המאגר. Claude Code עוקב אחרי שכפולים ו-worktrees בנפרד.
• הקישור לא משנה איזה ענף מסומן. הסשן נפתח בכל מצב שהספרייה נמצאת בו כרגע.

כותרת קבלת הפנים מציגה איזה נתיב נבחר, כדי שאפשר לאשר שנפתח השכפול הנכון.

#דוגמאות

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

#הטמעת קישור ב-runbook

קישור עמוק ב-runbook נותן למי שמטפל בתקלה דרך בלחיצה אחת להתחיל לחקור במאגר הנכון עם פרומפט מוכן. הפלטפורמה שמרנדרת את ה-runbook חייבת לאפשר סכמות URL מותאמות אישית. Markdown שמרונדר ב-GitHub לא מאפשר claude-cli://, ולכן קישור עמוק ב-README, ב-issue או בוויקי של GitHub מציג רק את התווית שלו בלי קישור לחיץ. ראו הערת פתרון הבעיות לפתרון עקיף.

הפרומפט הוא חלק מה-URL וחייב להיות מקודד ב-URL. כדי לייצר את הערך המקודד, מעבירים את טקסט הפרומפט דרך encodeURIComponent במסוף הדפדפן או בכל מקודד URL.

הדוגמה למטה מוסיפה נקודת כניסה לחקירה ל-runbook של תקלה עבור שירות בשם web-gateway:

## High 5xx rate on web-gateway

1. Acknowledge the page in PagerDuty.
2. [Open Claude Code in the gateway repo](claude-cli://open?repo=acme/web-gateway&q=5xx%20rate%20is%20elevated%20on%20web-gateway.%20Check%20recent%20deploys%2C%20error%20logs%20from%20the%20last%2030%20minutes%2C%20and%20open%20incidents%20in%20Linear.)
3. Post initial findings in #incident.

כדי להשתמש בזה ב-runbook שלכם, מחליפים את acme/web-gateway ב-slug של מאגר השירות. לפני שמהנדסים לוחצים על שלב 2, הם חייבים לשלוח פרומפט בסשן אינטראקטיבי של Claude Code במחשב שלהם ולפתוח את Claude Code בשכפול המקומי שלהם.

#פתיחת קישור מהמעטפת

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

macOS

הפקודה המובנית open מעבירה את ה-URL ל-handler הרשום של claude-cli://:

open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"

בהצלחה, נפתח חלון טרמינל חדש עם Claude Code שרץ והפרומפט ממולא מראש.

Linux

רוב סביבות שולחן העבודה מספקות את xdg-open, שמעביר את ה-URL ל-handler הרשום:

xdg-open "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"

בהצלחה, נפתח חלון טרמינל חדש עם Claude Code שרץ והפרומפט ממולא מראש. אם המעטפת מדווחת ש-xdg-open לא נמצא, ראו פתרון בעיות.

Windows

ב-PowerShell, Start-Process מעביר את ה-URL ל-handler הרשום:

Start-Process "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"

ב-cmd.exe, start מתייחס לארגומנט המצוטט הראשון שלו ככותרת חלון, ולכן מעבירים כותרת ריקה לפני ה-URL:

start "" "claude-cli://open?repo=acme/payments&q=review%20open%20PRs"

בהצלחה, נפתח חלון טרמינל חדש עם Claude Code שרץ והפרומפט ממולא מראש.

#רישום ופלטפורמות נתמכות

Claude Code רושם את ה-handler של claude-cli:// אצל מערכת ההפעלה ב-macOS, ב-Linux וב-Windows כשעושים אחד מאלה:

• שולחים משהו לסשן claude אינטראקטיבי, למשל הודעה או /help. הפעלת סשן בלי לשלוח דבר לא רושמת את ה-handler.
• מפעילים את Claude Code בתצוגת סוכן, למשל עם claude agents, בתיקייה שנתתם בה אמון

לא מריצים פקודת התקנה נפרדת. הרישום כותב רק למיקומים ברמת המשתמש:

ה-handler מפעיל את Claude Code באמולטור טרמינל שזוהה. ב-macOS, Claude Code זוכר את הטרמינל מהסשן האינטראקטיבי האחרון ומשתמש בו שוב, עם תמיכה ב-iTerm2, Ghostty, kitty, Alacritty, WezTerm ו-Terminal.app. ב-Linux הוא מכבד את משתנה הסביבה $TERMINAL, אחר כך את x-terminal-emulator, ואחר כך רשימה של אמולטורים נפוצים. ב-Windows הוא מעדיף את Windows Terminal, אחר כך את PowerShell, ואחר כך את cmd.exe.

כדי למנוע רישום לגמרי, מגדירים את disableDeepLinkRegistration ל-"disable" ב-settings.json. כדי לאכוף זאת בארגון כך שמשתמשים לא יוכלו להפעיל את זה מחדש, מגדירים אותו בהגדרות מנוהלות במקום זאת. הגדרת disableDeepLinkRegistration של Claude Code מכסה רק קישורי claude-cli://.

#פתיחת לשונית VS Code במקום טרמינל

הרחבת VS Code רושמת handler משלה ב-vscode://anthropic.claude-code/open, שפותח לשונית עורך של Claude Code ולא חלון טרמינל. ראו הפעלת לשונית VS Code מכלים אחרים לפרמטרים של ה-URL הזה.

#פתיחת סשן Claude Desktop על חיבור SSH

Claude Desktop מטפל בקישורי claude:// משלו. כדי לפתוח סשן Desktop במכונה מרוחקת דרך SSH, ראו פתיחת סשן SSH מקישור.

#פתרון בעיות

#לחיצה על הקישור לא עושה כלום

סביר שה-handler עדיין לא רשום. בסשן אינטראקטיבי, הרישום קורה כששולחים משהו, לא כשהסשן מתחיל. מפעילים סשן claude אינטראקטיבי באותו מחשב, שולחים כל פרומפט, יוצאים, ומנסים את הקישור שוב. אם אתם ב-Linux בלי סביבת שולחן עבודה, ייתכן של-xdg-open אין לאן לשלוח.

#xdg-open לא נמצא ב-Linux

הפקודה xdg-open היא חלק מחבילת xdg-utils, שתמונות שרת מינימליות, קונטיינרים והפצות WSL לעתים קרובות משמיטים. מתקינים את xdg-utils עם מנהל החבילות של ההפצה, למשל sudo apt install xdg-utils, ואז מריצים את הפקודה שוב. אם הפקודה אז רצה אבל שום דבר לא נפתח, ייתכן של-xdg-open אין סביבת שולחן עבודה לשלוח אליה. ראו לחיצה על הקישור לא עושה כלום.

#הקישור מוצג כטקסט רגיל במקום להיות לחיץ

חלק ממעבדי Markdown מתירים רק קישורי http ו-https ומסירים סכמות URL אחרות. GitHub עושה זאת ב-README, ב-issues, ב-pull requests ובוויקי: [label](claude-cli://...) מרונדר כ-label, בלי קישור וה-URL הוסר. בפלטפורמות האלה, שמים את הקישור העמוק בבלוק קוד כדי שקוראים יוכלו לראות את ה-URL ולהדביק אותו בשורת הכתובת של הדפדפן.

#הסשן נפתח בספריית הבית במקום במאגר

הפרמטר repo נפתר רק לשכפולים ש-Claude Code כבר ראה. מריצים claude בתוך השכפול פעם אחת כדי ש-Claude Code ירשום את הנתיב שלו, או מחליפים את הקישור לשימוש ב-cwd עם נתיב מוחלט.

#הקישור פותח את הטרמינל הלא נכון

ב-macOS, מפעילים claude בטרמינל המועדף פעם אחת, והקישור העמוק הבא ישתמש בו. ב-Linux, מגדירים את משתנה הסביבה $TERMINAL לשם הפקודה של האמולטור המועדף. ב-Windows, הסדר קבוע: מתקינים את Windows Terminal אם רוצים שקישורים ייפתחו שם במקום בחלון PowerShell או cmd.exe.

#למידע נוסף

העמודים האלה מכסים דרכים קשורות להפעיל או להרחיב סשנים של Claude Code:

• Skills: שמירת פרומפט runbook ארוך כ-/skill במאגר, כך שהפרמטר q של הקישור העמוק צריך רק לנקוב בשמו
• מצב לא אינטראקטיבי: הרצת Claude מסקריפט ולכידת הפלט בלי לפתוח טרמינל