📘 תיעוד 17

שימוש ב-Claude Code עם Chrome

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

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

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

התוסף מרכז את הכרטיסיות ש-Claude פותח לתוך קבוצת כרטיסיות של Chrome המשויכת להפעלה (session) שלך. בהפעלות מקומיות, השאלה אם Claude Code סוגר את הקבוצה הזו בסיום ההפעלה תלויה באופן שבו היא מסתיימת:

• כאשר אתה מקליד /clear, Claude Code סוגר את הקבוצה, כולל דפים פתוחים, אלא אם עבודה ששורדת את הניקוי עדיין רצה
• כאשר אתה מחליף הפעלה באמצעות פקודה כמו /resume, יוצא מ-Claude Code, או מריץ /clear בזמן שעבודה ששורדת אותו עדיין רצה, Claude Code סוגר את הקבוצה רק אם היא מכילה אך ורק כרטיסיות חדשות ריקות, כך שדפים שאתה עדיין עשוי לקרוא יישארו פתוחים

הערה: שילוב Chrome עובד עם Google Chrome ועם Microsoft Edge. Claude Code מזהה את התוסף ומגדיר את החיבור גם בדפדפנים אחרים מבוססי Chromium, כולל Brave, Arc, Vivaldi ו-Opera. שילוב Chrome אינו נתמך ב-Windows Subsystem for Linux (WSL).

#יכולות

עם Chrome מחובר, אתה יכול לשרשר פעולות דפדפן עם משימות תכנות בתהליך עבודה יחיד:

• דיבאג חי (Live debugging): קריאת שגיאות קונסולה ומצב DOM ישירות, ולאחר מכן תיקון הקוד שגרם להן
• אימות עיצוב (Design verification): בניית ממשק משתמש מתוך סקיצת Figma, ולאחר מכן פתיחתו בדפדפן כדי לוודא שהוא תואם
• בדיקת אפליקציות ווב (Web app testing): בדיקת ולידציה של טפסים, בדיקה לגילוי נסיגות חזותיות (visual regressions), או אימות תהליכי משתמש
• אפליקציות ווב עם אימות (Authenticated web apps): אינטראקציה עם Google Docs, Gmail, Notion, או כל אפליקציה שאתה מחובר אליה ללא צורך במחברי API
• חילוץ נתונים (Data extraction): משיכת מידע מובנה מדפי אינטרנט ושמירתו מקומית
• אוטומציה של משימות (Task automation): אוטומציה של משימות דפדפן שגרתיות כמו הזנת נתונים, מילוי טפסים או תהליכי עבודה בין כמה אתרים
• העלאות קבצים (File uploads): צירוף קבצים מהמחשב שלך לשדות העלאה בדפי אינטרנט
• הקלטת הפעלה (Session recording): הקלטת אינטראקציות בדפדפן כקובצי GIF כדי לתעד או לשתף את מה שקרה

#דרישות מוקדמות

לפני השימוש ב-Claude Code עם Chrome, דרושים לך:

• Google Chrome, Microsoft Edge, או דפדפן אחר מבוסס Chromium כגון Brave, Arc, Vivaldi או Opera
• תוסף Claude in Chrome בגרסה 1.0.36 ומעלה, הזמין בחנות האינטרנט של Chrome (Chrome Web Store)
• Claude Code
• תוכנית ישירה של Anthropic (Pro, Max, Team, או Enterprise)

שילוב Chrome דורש גם התחברות באמצעות /login. אם אתה מזדהה באמצעות מפתח API או טוקן ארוך טווח מ-claude setup-token, Claude Code משאיר את שילוב Chrome כבוי, גם כאשר אתה מעביר --chrome, מכיוון שתוסף הדפדפן אינו יכול לבצע אימות עם פרטי זיהוי אלה. לפני גרסה v2.1.216, הפעלות אלו יכלו להפעיל את שילוב Chrome, אך כל ניסיון להתחבר לתוסף הדפדפן נכשל עם שגיאת 403.

הערה: שילוב Chrome אינו זמין דרך ספקים צד שלישי כמו Amazon Bedrock, Agent Platform של Google Cloud, או Microsoft Foundry. אם אתה ניגש ל-Claude אך ורק דרך ספק צד שלישי, דרוש לך חשבון claude.ai נפרד כדי להשתמש בתכונה זו.

#תחילת העבודה ב-CLI

1. הפעלת Claude Code עם Chrome: הפעל את Claude Code עם הדגל --chrome:

   העתק

   claude --chrome

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

   כדי להפעיל את Chrome עבור הפעלות עתידיות ללא הדגל, ראה הפעלת Chrome כברירת מחדל.

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

   העתק

   Go to code.claude.com/docs, click on the search box,
   type "hooks", and tell me what results appear

   אם Claude Code מבקש הרשאה לפני פעולת דפדפן, אשר אותה. תיבת הדו-שיח מתחילה ב-Claude in Chrome wants to ומציעה אפשרות לאשר את כל הפעולות באותו אתר עבור ההפעלה הנוכחית. Claude פותח כרטיסייה חדשה ומתחיל במשימה.

הרץ /chrome בכל עת כדי לבדוק את סטטוס החיבור, לנהל הרשאות, לחבר מחדש את התוסף, או לבחור באיזה דפדפן מחובר להשתמש. השילוב פועל כאשר לוח הסטטוס מציג "Status: Enabled" ו-"Extension: Installed".

אם יותר מדפדפן אחד מחובר, אתה בוחר באיזה מהם Claude ישתמש. כאשר פעולת דפדפן מתחילה לפני שבחרת, Claude יבקש ממך לבחור אחד. כדי להחליף דפדפנים מאוחר יותר, הרץ /chrome ובחר Select browser…. Claude ימשיך להשתמש בבחירה שלך גם כאשר דפדפן אחר יתחבר.

עבור VS Code, ראה אוטומציית דפדפן ב-VS Code.

#התקנת התוסף כאשר Claude מבקש

כאשר Claude זקוק לדפדפן שלך בהפעלה אינטראקטיבית ו-Claude Code אינו מזהה את התוסף, Claude Code מציג הודעת התקנה שכותרתה "Claude wants to use your browser". Claude Code שואל לכל היותר פעם אחת בכל הפעלה.

ההודעה מציעה שלוש אפשרויות:

• Install extension: פותח את דף התקנת התוסף בדפדפן שלך ומתחיל הגדרה מודרכת. Claude Code ממתין להתקנה, מחבר את התוסף ומפעיל את כלי הדפדפן באותה הפעלה. כאשר החיבור מוכן, בחר "Continue with browser tools" ו-Claude ימשיך במשימה בדפדפן שלך. תוכל לצאת מתהליך ההגדרה על ידי בחירה ב-"Continue without browser tools" ולסיים מאוחר יותר באמצעות /chrome.
• Not now: ממשיך את המשימה ללא כלי דפדפן. Claude Code יכול לשאול שוב בהפעלה מאוחרת יותר.
• Don't ask again: מפסיק את הצגת ההודעה בהפעלות עתידיות. תוכל עדיין להגדיר את השילוב בכל עת באמצעות /chrome.

אם הארגון שלך חוסם את שרת ה-MCP claude-in-chrome באמצעות הגדרת הניהול deniedMcpServers, Claude Code לא יציג את הודעת ההתקנה.

#הפעלת Chrome כברירת מחדל

כדי להימנע מהעברת --chrome בכל הפעלה, הרץ /chrome ובחר "Enabled by default".

Claude Code מופעל כרגיל כאשר Chrome אינו פועל. לפני גרסה v2.1.211, תהליך ההפעלה עלול היה להיתקע כאשר שילוב Chrome היה מופעל אך Chrome לא פעל.

ב-תוסף VS Code, Chrome זמין בכל פעם שתוסף Chrome מותקן. אין צורך בדגל נוסף.

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

#ניהול הרשאות אתרים

הרשאות ברמת האתר עוברות בירושה מתוסף Chrome. נהל הרשאות בהגדרות תוסף Chrome כדי לקבוע באילו אתרים Claude יכול לגלוש, ללחוץ ולהקליד.

#כלי דפדפן במצב תוכנית

ב-מצב תוכנית (plan mode), מופיעה בקשת הרשאה לפני ש-Claude מקליט קובץ GIF, פותח כרטיסייה חדשה או מריץ קיצור דרך. אם מצב עקיפת הרשאות (bypass permissions mode) זמין בהפעלה שלך ו-אחזור דגלי תכונות (feature-flag fetching) כבוי, קריאות אלו רצות ללא בקשת הרשאה.

קריאה ל-tabs_context_mcp מבקשת אישור גם כאשר היא מגדירה את createIfEmpty, וכך גם קריאה ל-browser_batch הכוללת אחת מפעולות אלו.

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

דוגמאות אלו מציגות דרכים נפוצות לשלב פעולות דפדפן עם משימות תכנות. הרץ /mcp, בחר ב-claude-in-chrome, ולאחר מכן בחר View tools כדי לראות את הרשימה המלאה של כלי הדפדפן הזמינים.

#בדיקת אפליקציית ווב מקומית

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

I just updated the login form validation. Can you open localhost:3000,
try submitting the form with invalid data, and check if the error
messages appear correctly?

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

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

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

Open the dashboard page and check the console for any errors when
the page loads.

Claude קורא את הודעות הקונסולה ויכול לסנן לפי דפוסים או סוגי שגיאות ספציפיים.

#אוטומציה של מילוי טפסים

האץ משימות הזנת נתונים חוזרות ונשנות:

I have a spreadsheet of customer contacts in contacts.csv. For each row,
go to the CRM at crm.example.com, click "Add Contact", and fill in the
name, email, and phone fields.

Claude קורא את הקובץ המקומי שלך, מנווט בממשק הווב ומזין את הנתונים עבור כל רשומה.

#העלאת קבצים לדפי אינטרנט

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

דוגמה זו מצרפת קובץ לוג לטופס:

Open the bug tracker at bugs.example.com, create a new issue,
and attach logs/session.log to it

שלוש מגבלות חלות על העלאות:

• הרשאות: Claude יכול להעלות קובץ רק כאשר להפעלה מותר לקרוא אותו, כך ש-כללי הרשאות שמונעים גישת Read לקובץ חוסמים גם את העלאתו.
• גודל: העלאה יחידה יכולה לכלול קבצים בגודל כולל של עד 10 MB.
• קישורים קשיחים (Hard links): Claude דוחה קבצים בעלי מספר קישורים קשיחים, מצב שנפוץ בתוך מאגרי מנהלי חבילות כמו node_modules. העתק את הקובץ והעלה את העותק.

#ניסוח תוכן ב-Google Docs

השתמש ב-Claude כדי לכתוב ישירות במסמכים שלך ללא צורך בהגדרת API:

Draft a project update based on the recent commits and add it to my
Google Doc at docs.google.com/document/d/abc123

Claude פותח את המסמך, לוחץ לתוך העורך ומקליד את התוכן. זה עובד עם כל אפליקציית ווב שאתה מחובר אליה: Gmail, Notion, Sheets ועוד.

#חילוץ נתונים מדפי אינטרנט

משוך מידע מובנה מאתרים:

Go to the product listings page and extract the name, price, and
availability for each item. Save the results as a CSV file.

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

#הפעלת תהליכי עבודה מרובי אתרים

תאם משימות על פני מספר אתרי אינטרנט:

Check my calendar for meetings tomorrow, then for each meeting with
an external attendee, look up their company website and add a note
about what they do.

Claude עובד על פני כמה כרטיסיות כדי לאסוף מידע ולהשלים את תהליך העבודה.

#הקלטת GIF להדגמה

צור הקלטות שניתן לשתף של אינטראקציות בדפדפן:

Record a GIF showing how to complete the checkout flow, from adding
an item to the cart through to the confirmation page.

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

#שמירת צילומי מסך לדיסק

בקש מ-Claude לשמור צילום מסך כקובץ:

Take a screenshot of the checkout page and save it to disk

Claude שומר את התמונה לדיסק ומדווח על נתיב הקובץ. לפני גרסה v2.1.211, האפשרות save_to_disk של כלי צילום המסך לא כתבה קובץ.

#פתרון בעיות

#התוסף אינו מזוהה

אם Claude Code אינו מצליח לזהות את תוסף Chrome:

1. ודא שתוסף Chrome מותקן ומופעל ב-chrome://extensions
2. ודא ש-Claude Code מעודכן על ידי הרצת claude --version
3. בדוק ש-Chrome פועל
4. הרץ /chrome ובחר "Reconnect extension" כדי ליצור מחדש את החיבור
5. אם הבעיה נמשכת, הפעל מחדש הן את Claude Code והן את Chrome

בפעם הראשונה שאתה מפעיל את שילוב Chrome, Claude Code מתקין קובץ תצורה של מארח העברת הודעות מקומי (native messaging host configuration file). דפדפן Chrome קורא קובץ זה בעת ההפעלה, כך שאם התוסף אינו מזוהה בניסיון הראשון שלך, הפעל מחדש את Chrome כדי שיקלוט את התצורה החדשה.

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

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

עבור Chrome:

• macOS: ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Linux: ~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Windows: בדוק את HKCU\Software\Google\Chrome\NativeMessagingHosts\ ברישום של Windows (Windows Registry)

עבור Edge:

• macOS: ~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Linux: ~/.config/microsoft-edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Windows: בדוק את HKCU\Software\Microsoft\Edge\NativeMessagingHosts\ ברישום של Windows (Windows Registry)

דפדפנים אחרים מבוססי Chromium קוראים את אותו קובץ מתיקיית התצורה שלהם, הקרויה על שם הדפדפן. לדוגמה, Brave ב-macOS משתמש ב-~/Library/Application Support/BraveSoftware/Brave-Browser/NativeMessagingHosts/, וב-Windows לכל דפדפן יש מפתח רישום משלו, כגון HKCU\Software\BraveSoftware\Brave-Browser\NativeMessagingHosts\.

#הדפדפן אינו מגיב

אם פקודות הדפדפן של Claude מפסיקות לפעול:

1. בדוק אם תיבת דו-שיח מודאלית (alert, confirm, prompt) חוסמת את הדף. תיבות דו-שיח של JavaScript חוסמות אירועי דפדפן ומונעות מ-Claude לקבל פקודות. סגור את תיבת הדו-שיח ידנית, ולאחר מכן אמור ל-Claude להמשיך.
2. בקש מ-Claude ליצור כרטיסייה חדשה ונסה שוב
3. הפעל מחדש את תוסף Chrome על ידי השבתתו והפעלתו מחדש ב-chrome://extensions

#החיבור מתנתק במהלך הפעלות ארוכות

ה-service worker של תוסף Chrome יכול לעבור למצב סרק במהלך הפעלות ממושכות, מה ששובר את החיבור. אם כלי הדפדפן מפסיקים לעבוד לאחר תקופה של חוסר פעילות, הרץ /chrome ובחר "Reconnect extension".

#בעיות ספציפיות ל-Windows

ב-Windows, אתה עלול להיתקל ב:

• התנגשויות צינורות בעלי שם (Named pipe conflicts, EADDRINUSE): אם תהליך אחר משתמש באותו צינור בעל שם, הפעל מחדש את Claude Code. סגור כל הפעלה אחרת של Claude Code שעשויה להשתמש ב-Chrome.
• שגיאות מארח העברת הודעות מקומי (Native messaging host errors): אם מארח העברת ההודעות המקומי קורס בעת ההפעלה, נסה להתקין מחדש את Claude Code כדי ליצור מחדש את תצורת המארח.
• דפי הגדרה אינם נפתחים: עדכן את Claude Code. לפני גרסה v2.1.211, כרטיסיית הדפדפן שביקשה ממך לחבר את התוסף עלולה הייתה להיכשל בפתיחה ב-Windows.

#הודעות שגיאה נפוצות

אלו הן השגיאות הנפוצות ביותר וכיצד לפתור אותן:

#ראה גם

• שימוש במחשב (Computer use): שליטה באפליקציות macOS מקומיות כאשר לא ניתן לבצע משימה בדפדפן
• שימוש ב-Claude Code ב-VS Code: אוטומציית דפדפן בתוסף VS Code
• מדריך עזר ל-CLI: דגלי שורת פקודה כולל --chrome
• תהליכי עבודה נפוצים: דרכים נוספות להשתמש ב-Claude Code
• נתונים ופרטיות: כיצד Claude Code מטפל בנתונים שלך
• תחילת העבודה עם Claude ב-Chrome: תיעוד מלא עבור תוסף Chrome, כולל קיצורי דרך, תזמון והרשאות