מדריך קלוד קוד בעברית

תיעוד 50

שיתוף פלט של סשן כארטיפקטים

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

[!NOTE]

ארטיפקטים זמינים בתוכניות Pro, Max, Ultra, Team ו-Enterprise, ודורשים סשן שמחובר עם /login. ראו זמינות לרשימת הדרישות המלאה.

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

ארטיפקט פתוח בדפדפן בכתובת claude.ai/code/artifact. בכותרת הצופה מופיעים כותרת הארטיפקט acme-funnel-fix, כפתור Share, ואווטאר המחבר. תפריט Share פתוח עם המתג Always share latest version, בורר גרסה שקורא Sharing version 2, בורר קהל Everyone at Acme, וכפתור Copy link. מתחת לכותרת, עמוד הארטיפקט מציג שני מוקאפים לנייד זה לצד זה, תרשים משפך, ושורה של כרטיסי מדדים.

#מתי להשתמש בארטיפקט

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

  • להוביל סוקר דרך pull request עם diffs מסומנים
  • להציג לוח מחוונים מנתונים שהסשן כבר שלף
  • לפרוס כמה אפשרויות עיצוב או מימוש זו לצד זו
  • לשמור ציר זמן של חקירה שמתמלא בזמן שמשימה ארוכה רצה
  • לשלוח לחבר צוות קישור במקום להדביק פלט ב-Slack
  • לפרסם לוח סטטוס ששולף נתונים טריים דרך מחברי MCP בכל פעם שמישהו פותח אותו

ראו מה אפשר לבנות לפרומפטים שמתאימים לאלה, ושליפת נתונים חיים עם מחברי MCP לפרומפט של הלוח שמגובה במחבר.

#מה ארטיפקט אינו

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

#יצירת ארטיפקט

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

Make an artifact that walks through this PR with the diff annotated inline.
Build a dashboard artifact of last week's deploy failures by service and keep it updated as you investigate.

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

אחרי הפרסום הראשון, Claude מדפיס את ה-URL, והדפדפן נפתח לעמוד החדש.

  • פתיחה מחדש של העמוד: לחצו על Ctrl+] בכל זמן כדי לפתוח מחדש את הארטיפקט האחרון של הסשן
  • צפייה בארטיפקטים של הסשן הזה: גלולה ⧉ מתחת לפרומפט מציגה את שם הארטיפקט, או ספירה כשיש לסשן כמה. ברינדור במסך מלא, לחצו עליה כדי לפתוח את רשימת /artifacts
  • מניעת פתיחת הדפדפן: הגדירו CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 בסביבה שלכם
  • Remote Control: אם שלחתם את הפרומפט דרך Remote Control מ-claude.ai, מ-Claude Desktop, או מאפליקציית Claude לנייד, לא נפתחת לשונית במכונה שמריצה את הסשן. הדפדפן נפתח שם בפעם הבאה ש-Claude מפרסם את הארטיפקט מפרומפט שאתם מקלידים בטרמינל

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

אם Claude עונה שהוא לא יכול לפרסם, או כותב קובץ HTML מקומי בלי קישור, ארטיפקטים לא מופעלים לסשן שלכם. בדקו את דרישות הזמינות. אם הטרמינל מציג Artifacts need a claude.ai login, ראו את הרשומה של השגיאה הזו לאופן ההתחברות.

#מתי Claude Code שואל לפני פרסום

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

מתימה Claude Code עושה
הסשן נמצא במצב planשואל לפני הפרסום הראשון של כל ארטיפקט
הפרסום מצהיר על יכולות זמן ריצה לעמוד, כמו קריאות מחבר או הורדות קבציםשואל לפני הפרסום הזה
שיתפתם את הארטיפקט בפומבישואל פעם אחת בכל שיחה לפני שינוי שלו
Claude מפרסם בתור שמשימה מתוזמנת בהיקף הסשן שהופעלה בסשן שלכם התחילה, במקום פרומפט שהקלדתםשואל לפני הפרסום הראשון של כל ארטיפקט
Claude לא יכול לקרוא את הקובץ בלי האישור שלכםשואל לפני פרסום שלו. כלל allow לכלי Artifact לא מדלג על הבקשה הזו
במצב Manual או acceptEdits, Claude עושה שינוי קטן בקובץ של ארטיפקט שהוא לא יכול לערוך בלי האישור שלכם, כמו קובץ פרויקט במצב Manualשואל לפני פרסום השינוי. אתם נשאלים גם אם כלל allow מכסה את כלי Artifact, כי העריכה של הקובץ צריכה את האישור שלכם

כדי לאפשר ל-Claude לקרוא קובץ מחוץ לתיקיות העבודה שלכם בלי האישור שלכם, הוסיפו את התיקייה שלו כתיקיית עבודה עם --add-dir בהפעלה או /add-dir במהלך הסשן. Claude כבר קורא קבצים בתיקיות האלה, ובתיקייה הזמנית שאליה הוא כותב עמודים, בלי לשאול.

אם בקשת פרסום כוללת משפט כמו Also makes 1 edit to that file on disk., Claude משנה את הקובץ של הארטיפקט ומפרסם אותו בצעד אחד. כשאתם מאשרים את הבקשה, Claude Code מפרסם את העמוד, ואז כותב את השינוי לקובץ שלכם.

#עדכון ארטיפקט

בקשו מ-Claude לשנות את העמוד, או תנו למשימה ארוכה לפרסם מחדש ככל שהיא מתקדמת. Claude עורך את הקובץ שמתחת ומפרסם שוב לאותו URL.

Add a per-region breakdown below the summary chart and republish.

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

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

Update https://claude.ai/code/artifact/5fbea6f3-... with today's numbers.

#מציאת ארטיפקט שוב

הריצו /artifacts ב-Claude Code כדי לרשום את הארטיפקטים שבבעלותכם ואת אלה ששותפו איתכם. הארטיפקטים של הסשן הנוכחי מגיעים ראשונים, תחת This session.

בחרו ארטיפקט, ואז לחצו על אחד מהמקשים האלה:

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

Claude Code קורא את הרשימה מחשבון claude.ai שלכם, ולכן /artifacts עובד בסשן חדש ואחרי /clear, כשקישור של ארטיפקט כבר נגלל אל מחוץ לטרמינל.

#שיתוף ארטיפקט

ארטיפקט חדש גלוי רק לכם. כדי לשתף אותו, פתחו את הארטיפקט בדפדפן והשתמשו בפקד Share בכותרת העמוד. הכותרת גם מקשרת לגלריה שלכם ב-claude.ai/code/artifacts, שמפרטת כל ארטיפקט שיצרתם.

צופים בארגון שלכם יכולים לראות מי פרסם את העמוד: בארטיפקט ששותף בתוך הארגון, השם שלכם נמצא בתפריט הכותרת, ובארטיפקט ציבורי הוא נמצא בכותרת העמוד לצופים מחוברים בארגון שלכם. צופה שפותח קישור ציבורי בלי להתחבר, או מחוץ לארגון שלכם, רואה את התווית Content is user-generated and unverified. במקום את השם שלכם.

עם מי אפשר לשתף תלוי בתוכנית שלכם:

  • בתוך הארגון שלכם: בתוכניות Team ו-Enterprise, תנו גישה לאנשים מסוימים בארגון, או לכולם בו. צופים מתחברים ל-claude.ai כחברים בארגון שלכם כדי לראות את העמוד.
  • בפומבי: שתפו קישור שכל אחד באינטרנט יכול לפתוח, בלי צורך בהתחברות ל-claude.ai. בתוכניות Team ו-Enterprise, שיתוף ציבורי כבוי עד ש-Owner מפעיל אותו לארגון.

#קישור לתצוגה מסוימת

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

Give me a link to each tab of the deploy failures dashboard.

כל קישור הוא הקישור של הארטיפקט עם עוגן בסוף, כמו #overview.

#לאפשר למישהו לערוך יחד איתכם

אנשים שאתם משתפים איתם הם צופים כברירת מחדל: הם רואים כל גרסה שאתם מפרסמים אבל לא יכולים לשנות את העמוד. בתוכניות Team ו-Enterprise אפשר גם להפוך מישהו לעורך. בתיבת השיתוף, הוסיפו אדם והחליפו את התפקיד שלו מ-viewer ל-editor.

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

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

#קריאת ארטיפקט ששותף איתכם

כשמישהו משתף איתכם ארטיפקט, אפשר לבקש מ-Claude לקרוא אותו: תנו ל-Claude את ה-URL שלו, או צרפו אותו מ-/artifacts.

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

Claude Code מבקש את האישור שלכם לפני ש-Claude קורא את הארטיפקט במקרים האלה, בנוסף לכל בקשה שמצב ההרשאות או הכללים שלכם קוראים לה:

  • סשן ענן בלי גישת רשת: בסביבת ענן, זו רמת None. במצב auto, המסווג יכול לאשר במקום זאת. בסשן Cowork, האישור הוא שלכם בלבד.
  • ארטיפקט ציבורי של ארגון אחר: Claude Code שואל אתכם קודם, גם במצב auto. במקום שבו Claude Code לא יכול לשאול אתכם, כמו במצב bypassPermissions, Claude לא יכול לקרוא את הארטיפקט. Claude יכול לקרוא את הארטיפקטים האלה רק כששליפת feature flag פועלת.
  • בעלים או הגדרת רשת לא מאושרים: כש-Claude Code לא יכול לאשר מי יצר את הארטיפקט, או לא יכול לאשר את הגדרת הרשת של סשן ענן, הוא שואל, והאישור שלכם מכסה את הבקשה האחת הזו.
  • מצב plan: במצב plan, Claude Code שואל לפני שכלי Artifact קורא ארטיפקט שמישהו אחר בארגון שלכם יצר.

כש-Claude קורא את הארטיפקט עם WebFetch, כללי הבקשה של WebFetch עצמו עדיין חלים.

#איסוף תגובות על artifact

כשמשתפים artifact בתוך הארגון, האנשים שאיתם משתפים יכולים להשאיר תגובות בעמוד, ואפשר לבקש מקלוד לקרוא את התגובות האלה ולהשיב עליהן. צריך Claude Code v2.1.221 או גרסה מאוחרת יותר. קלוד קורא את התגובות בשני מקרים:

  • אתם מבקשים מקלוד לקרוא אותן: תנו לקלוד את כתובת ה-URL של ה-artifact ובקשו את התגובות. קלוד מפרט כל שרשור ומסמן את התגובות שמי שיכול לערוך את ה-artifact שלח אליו.
  • מישהו שיכול לערוך את ה-artifact שולח תגובה לקלוד: בשרשור בעמוד, הם שולחים תגובה עם Send to Claude, או מזכירים @claude באחת. בכל אחת מהדרכים, הם מפעילים את השרשור.

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

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

כדי לבקש את התגובות בעצמכם, תנו לקלוד את כתובת ה-URL:

Read the comments on https://claude.ai/code/artifact/5fbea6f3-... and make the changes the commenters ask for.

אם קלוד אומר שהוא לא יכול לקרוא תגובות, אשרו את הגרסה, את הסשן, ואת הגדרת ה-feature-flag:

  • אתם מריצים Claude Code v2.1.221 או גרסה מאוחרת יותר.
  • אתם לא בסשן הראשון מאז שהתקנתם את Claude Code או שדרגתם מגרסה שלפני v2.1.221. באותו סשן ראשון אחרי התקנה או שדרוג, ייתכן שקלוד עדיין לא יכול לקרוא תגובות. התחילו סשן חדש ובקשו שוב.
  • לא כיביתם את feature-flag fetching.

#תנו לקלוד להשיב לתגובות בעצמו

אחרי שהסשן שלכם מפרסם artifact, Claude Code עוקב אחרי ה-artifact הזה לתגובות. כשמישהו שיכול לערוך את ה-artifact שולח תגובה לקלוד, היא מגיעה לסשן שלכם מיד, וקלוד יכול לקרוא את השרשור ולהשיב בלי שתבקשו.

צריך Claude Code v2.1.228 או גרסה מאוחרת יותר. אם כיביתם את feature-flag fetching, Claude Code לא עוקב אחרי תגובות.

מצב ההרשאות שלכם קובע מה קלוד עושה כשמגיעה תגובה שנשלחה:

  • קלוד משיב בעצמו: אם אתם במצב הרשאות שמאפשר לקלוד לפרסם את התשובה בלי לבקש מכם, קלוד קורא את השרשור ומשיב. אתם רואים Auto-replied to comment thread on Artifact: <name>.
  • קלוד מחכה לכם: מחוץ ל-plan mode, כשפרסום התשובה דורש את האישור שלכם, אתם רואים Comments are waiting on Artifact: <name>. אחר כך קלוד מבקש מכם אישור לקרוא את השרשור, ושוב כדי לפרסם את התשובה.
  • קלוד עוצר ב-plan mode: אתם רואים Comments are waiting on Artifact: <name>, וקלוד לא משיב עד שתצאו מ-plan mode ותבקשו ממנו לקרוא ולהשיב.

קלוד גם מפסיק להשיב בעצמו ל-artifact אחרי שהוא מטפל ב-60 תגובות שנשלחו או הפעלות שרשור על אותו artifact בתוך שעה. אתם רואים Comments are waiting on Artifact: <name> פעם אחת, וקלוד חוזר לטפל כשהתגובות של אותה שעה יוצאות מחלון השעה.

הריצו /tasks כדי לראות את ה-artifacts שהסשן שלכם עוקב אחריהם. /tasks מקבץ את המעקבים ש-Claude Code התחיל בעצמו תחת השורה System tasks. לחצו Enter על השורה הזו כדי לרשום אותם. מעקב שביקשתם מקלוד להתחיל מופיע תחת Monitors.

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

  • לחצו Ctrl+C פעם אחת כשההנחיה במצב המתנה: קלוד משהה תשובות על כל artifact שהסשן שלכם עוקב אחריו. התשובות מתחדשות אחרי שתשלחו את ההודעה הבאה.
  • עצרו את המשימה ב-/tasks: קלוד מפסיק להשיב על אותו artifact עד שתבקשו ממנו לחדש תשובות שם. פרסום ה-artifact שוב לא מתחיל תשובות מחדש, והעצירה עדיין חלה כשמחדשים את הסשן מאוחר יותר.
  • לחצו Ctrl+X Ctrl+K פעמיים בתוך 3 שניות: צירוף המקשים שעוצר כל subagent רקע שרץ גם עוצר את קלוד מלהשיב על כל artifact לשאר הסשן. בקשה מקלוד לחדש תשובות לא מבטלת את העצירה הזו.

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

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

#משיכת נתונים חיים עם מחברי MCP

artifact יכול לקרוא למחברי MCP בכל פעם שמישהו צופה בו, כך שהעמוד מציג נתונים עדכניים במקום תצלום מצב מהסשן שבנה אותו. קריאות מחברים מ-artifacts זמינות בתוכניות Pro, Max, Ultra, Team ו-Enterprise ודורשות Claude Code v2.1.209 או גרסה מאוחרת יותר. בגרסאות קודמות, קלוד מפרסם את העמוד עם הנתונים שהסשן אסף בזמן הבנייה.

כדי ליצור עמוד שמגובה במחבר, ציינו בהנחיה את המחבר ואת הנתונים שאתם רוצים:

Build a dashboard artifact of our open pull requests that pulls the live list through my GitHub connector when the page loads.

קלוד מצהיר אילו מחברים העמוד רשאי לקרוא להם כחלק מהפרסום, והעמוד לא יכול לקרוא למחברים מחוץ להצהרה הזו. רק מחברים מחשבון claude.ai שלכם מתאימים: קלוד מציין אותם בהצהרה, וכשמישהו צופה בעמוד, כל קריאה עוברת דרך החיבור של חשבון הצופה עצמו לאותו מחבר. שרתי MCP מקומיים שאתם מגדירים ב-Claude Code, כמו שרתים מ-.mcp.json, יכולים לספק נתונים בזמן שקלוד בונה את העמוד, אבל העמוד שפורסם לא יכול לקרוא להם.

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

#איך קריאות מחברים עובדות לצופים

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

  • כל צופה משתמש במחברים שלו: הקריאות עוברות דרך הכלים המחוברים של חשבון הצופה, כך ששני אנשים שפותחים את אותו לוח בקרה יכולים לראות נתונים שונים לפי מה שהחשבונות שלהם יכולים לגשת אליו. העמוד אף פעם לא רואה את פרטי הגישה של אף אחד. claude.ai מבצע את הקריאות בשם העמוד.
  • הצופים מאשרים גישה קודם: claude.ai מבקש מכל צופה הרשאה לפני קריאת המחבר הראשונה של העמוד. צופה שמסרב, או שלא חיבר מחבר שהעמוד משתמש בו, עדיין רואה את העמוד בלי המקטעים החיים שלו.
  • גם פעולות משתמשות בחשבון של הצופה: עמוד יכול להציע פקדים שמפעילים כלי מחבר עם תופעות לוואי, כמו פרסום הודעה או עדכון issue. הפעולה עוברת דרך החשבון של מי שבוחר את הפקד.

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

אפשר לשתף עמוד שמגובה במחבר בתוך הארגון או באופן ציבורי, לפי מה שהתוכנית והגדרות הארגון מאפשרים. קריאות מחברים לא רצות לצופה שפותח את הקישור הציבורי בלי להתחבר ל-claude.ai, או מחוץ לארגון. הצופה הזה רואה את העמוד בלי המקטעים החיים שלו.

#העמוד לא מציג נתונים חיים לצופה

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

  • הצופה לא חיבר את המחבר: מחברים הם לפי חשבון, כך שכל צופה צריך חיבור משלו לכל מחבר שהעמוד קורא לו. הם יכולים להוסיף אחד תחת Customize > Connectors ב-claude.ai, ואז לטעון מחדש את העמוד.

  • הצופה סירב לבקשת ההרשאה: סירוב נמשך לשאר טעינת העמוד הזו. טעינה מחדש של העמוד מחזירה את בקשת ההרשאה.

  • קריאות מחברים כבויות לארגון: Owner שולט במתג Enable artifact connectors בהגדרות הניהול.

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

    כשקלוד מפרסם את העמוד והכלים של המחבר הזה זמינים בסשן שלכם, Claude Code בודק את שמות הכלים שהעמוד מצהיר עליהם מולם, מזהיר את קלוד על שמות שלא תואמים, ומסרב לפרסום כשאף אחד לא תואם. לפני v2.1.265, הוא פרסם את העמוד בלי לבדוק אותם.

#הצעת הורדת קובץ

artifact יכול להציע לצופים קובץ שהעמוד מייצר, כמו ייצוא CSV של טבלה או PNG של תרשים. הצופה שומר אותו דרך פקד הורדה בעמוד, כמו כפתור. הורדות קבצים הן יכולת בזמן ריצה ש-claude.ai מפעיל לפי חשבון, כך שקלוד בודק אם לחשבון שלכם יש אותה לפני שהוא בונה את הפקד.

צופים לא יכולים לשמור קובץ מקישור הורדה רגיל או מסקריפט בעמוד, כי צופה ה-artifacts ב-claude.ai חוסם כל הורדה שהעמוד מתחיל בעצמו, כולל קישורים לכתובות data: או blob:. אם לעמוד יש כפתורי הורדה שנבנו כך, בקשו מקלוד לבנות אותם מחדש עם יכולת ההורדות.

כדי להציע קובץ, בקשו בהנחיה את הפקד ואת פורמט הקובץ:

Add a button that downloads this table as a CSV file.

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

#מה אפשר לבנות

artifact הוא עמוד HTML יחיד, כך שכל מה שאפשר לבטא ב-HTML, ב-CSS וב-JavaScript מוטמע נמצא בתחום. הדפוסים למטה מופיעים לרוב.

#מעבר על שינוי

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

Make an artifact that walks through this PR. Render the diff with margin annotations and color-code findings by severity.

#השוואת חלופות

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

Make an artifact with four distinctly different layouts for the settings panel. Vary density and grouping, and lay them out as a grid with a one-line tradeoff under each.

#כוונון עם פקדים אינטראקטיביים

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

Build an artifact with sliders for the easing curve, duration, and delay so I can try values on this transition. Show the animation live as I move them.

#החזרת התוצאה לסשן

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

Make a triage board artifact with each open issue as a draggable card across Now, Next, Later, and Cut columns. Add a "Copy as prompt" button that gives me the final ordering to paste back here.

#מעקב אחרי עבודה בתהליך

בקשו מקלוד לשמור artifact מעודכן בזמן שמשימה ארוכה רצה, כדי שכל מי שיש לו את הקישור יוכל לעקוב בלי לקרוא את הטרמינל.

Turn this migration plan into a checklist artifact. Check items off as you complete them and add a note for anything you skip.

#שיפור העיצוב החזותי

קלוד מפעיל מיומנות עיצוב מובנית כשהוא בונה artifact, כך שעמודים מקבלים פלטת צבעים, טיפוגרפיה ופריסה מכוונות בלי הנחיה נוספת. המיומנות הזו גם מחפשת מערכת עיצוב קיימת בפרויקט לפני שהיא בוחרת משלה. אסימוני עיצוב הם ערכי הצבע, הטיפוגרפיה והריווח בעלי השם שמערכת העיצוב שלכם עושה בהם שימוש חוזר. כדי לשמור על artifacts עקביים עם המיתוג של המוצר, רשמו אותם במקום שקלוד יכול למצוא, כמו CLAUDE.md של הפרויקט או קובץ ערכת נושא במאגר:

## Design system

- Colors: primary #1a4d8f, accent #f59e0b, surface #f8fafc
- Typography: Inter for body, JetBrains Mono for code
- Spacing: 8px scale, 6px border radius

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

לטיפוגרפיה, קלוד יכול לטעון גופן מ-Google Fonts, מקור הגופנים החיצוני היחיד שעמוד artifact יכול לטעון ממנו. קלוד משבץ כל גופן אחר כ-data URI של @font-face ונותן לכל גופן מחסנית גיבוי, כך שהעמוד עדיין מוצג אם גופן לא נטען. כדי להשתמש בגופן מסוים, ציינו אותו בהנחיה או במערכת העיצוב.

#התחלה מתבנית Slides, Design או Docs

במקום לבנות עמוד מאפס, קלוד יכול להתחיל artifact מאחת התבניות בחשבון claude.ai שלכם: Claude Slides למצגת, Claude Design לעיצוב חזותי, או Claude Docs למסמך שאנשים אחרים יקראו ויערכו. כל אחת נפתחת בעורך משלה ב-claude.ai, שבו אתם וחברי הצוות משנים אותה ישירות או מבקשים מקלוד, ומייצאים אותה לפורמטים כמו PowerPoint, PDF או Word.

כדי להתחיל מתבנית, תארו מה אתם רוצים, כמו "הפכו את הערות המיגרציה למצגת לסקירה של יום חמישי" או "כתבו את התוכנית הזו כמסמך לצוות". קלוד בוחר את התבנית המתאימה, ממלא אותה מהבקשה שלכם וממה שכבר יש בסשן, ונותן לכם את הקישור. למצגת או לעיצוב אפשר גם להריץ /slides או /design עם תקציר.

[!NOTE]

התבניות בגרסת בטא. הן מופעלות כברירת מחדל בתוכניות Pro, Max, Ultra ו-Team. בתוכניות Enterprise, Owner מפעיל כל תבנית תחת Organization settings > Artifacts. אם לארגון כבויה תבנית Slides, /slides לא מופיע. אם כבויה תבנית Design, /design לא מנסח עיצובים. שתי הפקודות דורשות Claude Code v2.1.265 או גרסה מאוחרת יותר וסשן שבו artifacts זמינים.

#יצירת מצגת שקפים

הריצו /slides עם תקציר שאומר על מה המצגת ולמי היא מיועדת:

/slides a quarterly review of the platform team's reliability work, for the engineering all-hands

קלוד יוצר artifact של Claude Slides ונותן לכם את הקישור. פתחו אותו בדפדפן שולחני כדי לערוך או להציג את המצגת. אם מריצים /slides בלי תקציר, קלוד שואל על מה המצגת צריכה להיות לפני שהוא יוצר משהו.

#ניסוח קנבס עיצוב

כדי לדמות UI, זרימת מסכים, דף נחיתה או פוסטר, במקום לבנות עמוד, הריצו /design עם תקציר. קלוד מנסח את העיצוב כלוחות עיצוב על קנבס אחד ומפרסם את הקנבס כ-artifact של Claude Design. התקציר מציין מה אתם רוצים שיצויר:

/design a settings screen for a mobile banking app

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

#כתיבת מסמך עם Claude Docs

Claude Docs מגיע ל-Claude Code כמחבר של claude.ai ולא כפקודה. כשהוא מחובר, /mcp מציג אותו כ-claude.ai Claude Docs. בקשה למסמך שמיועד לאנשים אחרים עוברת אז ל-Claude Docs במקום לעמוד artifact: מפרט, הצעה, או כתיבה של התוכנית שעבדתם עליה בסשן. קלוד נותן לכם את קישור המסמך כשהוא מנוסח.

מסמך ששייך לבסיס הקוד, כמו README, נשאר קובץ. כדי לקבל קובץ למשהו שקלוד היה שם אחרת ב-Claude Docs, ציינו את הפורמט, כמו .docx או קובץ Markdown במאגר. כדי לכבות רק את המחבר claude.ai Claude Docs, ראו Disable claude.ai connectors.

#מגבלות העמוד

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

מגבלההשפעה
בקשות חיצוניותהעמוד יכול לטעון גופנים מ-Google Fonts, וסקריפטים מחמישה מארחי CDN ציבוריים: cdnjs, unpkg, ה-CDN של Tailwind ושל jQuery, ונתיבים נבחרים ב-jsDelivr כמו /npm/. ה-CSP חוסם כל תמונה חיצונית וכל שאר הסקריפטים, גיליונות הסגנון והגופנים החיצוניים, ומאפשר לקריאות fetch, XHR ו-WebSocket להגיע רק למקור של העמוד עצמו ולמארחי Google Fonts. לכן Claude טוען כל ספרייה שהעמוד צריך מאחד מאותם CDN, משבץ את כל שאר ה-CSS וה-JavaScript, ומטמיע תמונות כ-data URI. קריאות מחברים עוברות דרך claude.ai, שבעצמו מבצע את קריאת הרשת.
בלי שרת אחוריartifact הוא עמוד סטטי. הוא לא יכול לאמת צופים בעצמו.
הורדותהעמוד לא יכול להתחיל הורדה בעצמו. כדי לאפשר לצופים לשמור קובץ שהעמוד יוצר, Claude מצהיר על יכולת ההורדות. ראה הצעת הורדת קובץ.
עמוד יחידקישורים יחסיים לא נפתרים, כי שום דבר לא נפרס לצד העמוד. לתוכן מרובה מקטעים, Claude משתמש בעוגנים בתוך העמוד במקום בקבצים נפרדים.
סוגי קובץ מקורהקובץ שמתפרסם חייב להיות .html, .htm או .md, וחייב להתפענח כ-UTF-8, או כ-UTF-16 little-endian לפי סימן סדר הבתים שלו. קובצי Markdown מוצגים כעמודי מסמך מעוצבים עם קוד מודגש תחבירית. קובץ שלא מתפענח, או שמכיל את תו ההחלפה U+FFFD, נדחה עם השורה והעמודה לתיקון.
מיקום המקורקובץ בנתיב ששם מארח רשת נדחה בלי שייקרא. ראה לא פורסם: הקובץ הזה נמצא בשיתוף רשת לגבי אילו נתיבים נדחים ולגבי החריג של כונן ממופה ב-Windows.
גודל אחרי עיבודהעמוד המעובד חייב להיות 16 MiB או קטן יותר. תמונות מוטמעות גדולות הן הסיבה הרגילה כשפרסום נכשל בגלל גודל.

יצירת artifact משתמשת באסימוני פלט כמו כל תגובה אחרת, ועמוד מעוצב צורך יותר אסימונים מאותו תוכן כטקסט במסוף. CSS משובץ, JavaScript לבקרים אינטראקטיביים, ובמיוחד תמונות מוטמעות כ-data URI הם התורמים העיקריים. כדי להפחית את עלות האסימונים של artifact:

  • העדף SVG, או HTML ו-CSS, לתרשימים על פני תמונות רסטר מוטמעות
  • השמט אינטראקטיביות שאין לך צורך בה
  • תן לעמוד לסכם מערכי נתונים גדולים במקום לשבץ אותם במלואם

#זמינות

artifacts דורשים כל תנאי שלהלן. כשאחד מהם לא מתקיים, Claude כותב קובץ HTML מקומי או אומר שהוא לא יכול לפרסם.

דרישהזמין כאשר
תוכניתPro, Max, Ultra, Team או Enterprise. בתוכניות Pro, Max ו-Ultra, artifacts פרטיים לך עד שתשתף אותם, ולא חל ניהול מנהל. בתוכניות Team ו-Enterprise, artifacts פועלים כברירת מחדל, ו-Owner יכול לכבות אותם לארגון בהגדרות הניהול של claude.ai.
אימותהסשן מגובה בחשבון claude.ai: היכנס עם /login ב-CLI או באפליקציית שולחן העבודה. לסשנים של Claude Tag אין צורך בשלב כניסה. סשנים שמשתמשים במפתח API, אסימון שער או אישור של ספק ענן לא יכולים לפרסם.
ספק מודלAnthropic API. לא זמין ב-Amazon Bedrock, ב-Google Cloud's Agent Platform או ב-Microsoft Foundry.
מדיניות ארגוןמפתחות הצפנה בניהול הלקוח (CMEK), HIPAA ו-Zero Data Retention אינם מופעלים לארגון.
משטחClaude Code CLI, או אפליקציית שולחן העבודה של Claude בגרסה 1.13576.0 ואילך. סשנים של Claude Tag יכולים גם לפרסם artifacts כשגם Claude Tag וגם artifacts מופעלים לארגון. סשנים שמגיש claude remote-control יכולים לפרסם artifacts כשהתחלת את הסשן בעצמך. נדרש Claude Code v2.1.281 ואילך. כבוי כברירת מחדל ב-Agent SDK, ב-GitHub Action ובהקשרי שרת MCP, כשמריצים את Claude Code עם -p מהמסוף או מהסקריפטים שלך, וכש-CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC מוגדר.

האם artifacts מותרים לארגון שלך נובע ממדיניות הארגון שלך, ש-Claude Code טוען מ-api.anthropic.com. כש-Claude Code לא יכול לטעון את המדיניות, artifacts לא זמינים. כשאתה מבקש אחד, Claude אומר למה.

אם מעורבים פרוקסי, VPN או מסנן אינטרנט, בקש ממנהל ה-IT שלך לאפשר מעבר של api.anthropic.com. Claude Code ממשיך לנסות שוב ברקע, ו-artifacts נעשים זמינים ברגע שהמדיניות נטענת ומתירה אותם.

#כיבוי artifacts

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

איפהמה לעשות
/configכבה את שורת Artifacts, מה שכותב "enableArtifact": false להגדרות המשתמש שלך
קובץ הגדרותהגדר "enableArtifact": false. גם "disableArtifact": true שהוצא משימוש מכבה artifacts
משתנה סביבההגדר CLAUDE_CODE_DISABLE_ARTIFACT=1
כלל הרשאההוסף Artifact אל permissions.deny

אחרי שאתה מכבה artifacts בקובץ --settings או עם CLAUDE_CODE_DISABLE_ARTIFACT, או שהמנהל שלך מכבה אותם בהגדרות מנוהלות, שום קובץ הגדרות לא מדליק אותם בחזרה.

אפשר גם להגדיר "enableArtifact": false ב-.claude/settings.json או ב-.claude/settings.local.json של פרויקט כדי לכבות artifacts לסשנים באותו פרויקט. "enableArtifact": true באחד משני הקבצים לא מדליק אותם בחזרה. כיבוד המפתח בהגדרות הפרויקט ובהגדרות המקומיות דורש Claude Code v2.1.242 ואילך.

אם מוסיפים כלל deny או ask של WebFetch בלי חלק domain:, זה לא מכבה artifacts ולא חוסם קריאות artifact. כלל WebFetch(domain:claude.ai) ב-deny או ב-ask כן חל על קריאות artifact.

#ניהול artifacts לארגון שלך

בעלי תפקיד Owner בתוכניות Team ו-Enterprise שולטים ב-artifacts מהגדרות הניהול של claude.ai. תוכן artifact נשמר בתשתית ש-Anthropic מפעילה, וגלוי רק לחברים מאומתים של הארגון המפרסם ולאנשים שהם משתפים איתו, אלא אם ה-artifact משותף בפומבי.

#הפעלה או כיבוי של artifacts

כדי להפעיל או לכבות artifacts לכל הארגון, עבור אל Organization settings > Artifacts והשתמש במתג Artifacts. בתוכניות Enterprise עם בקרת גישה מבוססת תפקידים, אפשר בנוסף להגביל artifacts לתפקידים מסוימים: עבור אל Organization settings > Roles, ערוך תפקיד, והגדר את הרשאת Artifacts.

#שליטה בקריאות מחברים מ-artifacts

לקריאות מחברים מ-artifacts יש מתג משלהן, נפרד ממתג Artifacts שמפעיל או מכבה artifacts. עבור אל Organization settings > Capabilities והשתמש במתג Enable artifact connectors. אותו מתג חל על קריאות מחברים מ-artifacts שנוצרו בשיחות claude.ai.

#שליטה בשיתוף פומבי

שיתוף פומבי כבוי כברירת מחדל בתוכניות Team ו-Enterprise. כדי לאפשר לחברים לפרסם artifacts לקישורים פומביים שכל אחד יכול לצפות בהם בלי כניסה, עבור אל Organization settings > Artifacts והפעל את External sharing מתחת למתג Artifacts. כיבוי חוזר חוסם גישה דרך קישורים פומביים קיימים בלי לשנות את הקהל של כל artifact. הגישה מתחדשת אם מפעילים אותו שוב.

#הגדרת מדיניות שמירה

כדי להגדיר כמה זמן artifacts נשמרים לפני מחיקה אוטומטית, עבור אל Organization settings > Data and privacy. אפשר להגדיר תקופות שמירה נפרדות ל-artifacts שעדיין פרטיים למחבר שלהם ול-artifacts ששותפו.

#עיון ביומן הביקורת

פרסום, שיתוף ומחיקה של artifact מופיעים כל אחד ביומן הביקורת של הארגון שלך תחת סוגי האירועים claude_artifact_*, אותה משפחה שמשמשת ל-artifacts שנוצרו בשיחות claude.ai.

#רשימת היתר לדומיין הצופה

הצופה ב-claude.ai טוען כל artifact ממקור מבודד *.claudeusercontent.com. אם הארגון שלך מגביל גישת רשת יוצאת, הוסף את הדומיין הזה לרשימת ההיתר שלך לצד claude.ai. ראה דרישות גישה לרשת לרשימה המלאה.

artifact שטוען גופן מ-Google Fonts מבקש גם את fonts.googleapis.com ואת fonts.gstatic.com. שני המארחים אופציונליים. אם חוסמים אותם, artifacts מוצגים בגופני גיבוי. חסום בדחייה מהירה במקום בהשמטה שקטה כדי שבקשת הגופן תיכשל מיד במקום לעכב את העיבוד הראשון של העמוד.

artifacts יכולים גם לטעון ספריות JavaScript, כמו React או חבילת תרשימים, מ-cdnjs.cloudflare.com, cdn.jsdelivr.net, cdn.tailwindcss.com, code.jquery.com ו-unpkg.com, ומשום מארח חיצוני אחר. אם חוסמים את המארחים האלה, החלקים של artifact שתלויים בספרייה לא עובדים, ובניגוד לגופן חסום, לספרייה חסומה אין גיבוי. חסום בדחייה מהירה גם כאן, כדי שבקשת ספרייה חסומה תיכשל מיד במקום להיתקע עד פקיעת הזמן.

#הצגה ומחיקה של artifacts עם ה-Compliance API

ה-Compliance API מספק נקודות קצה להצגת ה-artifacts של ארגון, לאחזור התוכן של גרסה מסוימת ולמחיקת artifact:

שיטהנקודת קצה
GET/v1/compliance/apps/code/artifacts
GET/v1/compliance/apps/code/artifacts/{artifact_id}/versions/{version_id}
DELETE/v1/compliance/apps/code/artifacts/{artifact_id}

לסכמות הבקשה והתגובה, ראה את ההפניה של Compliance API.

#משאבים קשורים