📘 תיעוד 17

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

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

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

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

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

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

[!NOTE]

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

#יכולות

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

• ניפוי שגיאות בזמן אמת: קריאת שגיאות מסוף ומצב DOM ישירות, ואז תיקון הקוד שגרם להן
• אימות עיצוב: בניית ממשק ממוקאפ של Figma, ואז פתיחה בדפדפן כדי לוודא שהוא תואם
• בדיקת אפליקציות אינטרנט: בדיקת אימות טפסים, בדיקה לרגרסיות חזותיות, או אימות זרימות משתמש
• אפליקציות אינטרנט מאומתות: אינטראקציה עם Google Docs, Gmail, Notion, או כל אפליקציה שאתם מחוברים אליה בלי מחברי API
• חילוץ נתונים: משיכת מידע מובנה מדפי אינטרנט ושמירה מקומית
• אוטומציה של משימות: הפיכת משימות דפדפן חוזרות לאוטומטיות, כמו הזנת נתונים, מילוי טפסים, או תהליכי עבודה באתרים מרובים
• העלאת קבצים: צירוף קבצים מהמחשב לשדות העלאה בדפי אינטרנט
• הקלטת סשן: הקלטת אינטראקציות בדפדפן כקובצי GIF כדי לתעד או לשתף את מה שקרה

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

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

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

בארגוני Enterprise שבהם HIPAA מופעל, Claude in Chrome כבוי כברירת מחדל, ו-Owner יכול להפעיל אותו ב-Organization settings > Claude in Chrome. ה-Business Associate Agreement (BAA) שלכם עם Anthropic אינו מכסה נתונים שנשלחים לאתרים של צד שלישי דרך Claude in Chrome. ראו את Implementation Guide לרשימת Eligible Services.

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

[!NOTE]

שילוב 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 מנוהלות מכבות את הבקשה:

• אם הארגון חוסם את שרת ה-MCP claude-in-chrome עם ההגדרה המנוהלת deniedMcpServers, Claude Code לא מציג את בקשת ההתקנה.
• אם הארגון פורס קובץ managed-mcp.json בלי לאפשר את Claude in Chrome לצד הסט המנוהל, Claude Code לא מציג את בקשת ההתקנה.

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

כדי לחבר את Chrome בלי להעביר --chrome בכל פעם, הריצו /chrome בסשן CLI ובחרו Enabled by default. בתוסף VS Code, הקלידו /chrome בתיבת הבקשה והפעילו את המתג Enabled by default. השניים חולקים הגדרה אחת, כך שהפעלה באחד מהמקומות מפעילה גם את ה-CLI וגם את VS Code.

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

Claude Code מופעל כרגיל כש-Chrome לא רץ.

[!NOTE]

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

#מענה לדו-שיח ההפעלה

אם מופיע הדו-שיח "Claude in Chrome extension detected" כשאתם מפעילים את claude, התשובה שלכם משנה את ההגדרה Enabled by default:

• Yes, use my browser: מפעיל את ההגדרה ומחבר את הסשן הזה
• No, keep browser tools off, או Esc: מכבה את ההגדרה, ו-Claude Code מפסיק להציע להגדיר את Chrome

כדי לשנות את התשובה לסשנים מאוחרים יותר, הריצו /chrome.

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

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

#בקשות הרשאה בסשנים של VS Code

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

בסשן שהתחבר לדפדפן בהתחלה כי Enabled by default פועל, Claude Code שואל אתכם לפני פעולות דפדפן באתר שעדיין לא אישרתם, במצבים Manual, Edit automatically, Auto ו-Bypass permissions. במצבים Auto ו-Bypass permissions, זה חל עד שאתם מקלידים @browser בסשן הזה.

#כלי דפדפן במצב plan

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

קריאה ל-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 קורא את הקובץ ושולח את התוכן שלו לדפדפן, כך שהעלאות עובדות גם בסשנים מקומיים וגם בסשנים מרוחקים.

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

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

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

• Permissions: Claude יכול להעלות קובץ רק כשהסשן מורשה לקרוא אותו, כך שכללי הרשאה שאוסרים גישת Read לקובץ גם חוסמים את ההעלאה שלו.
• Size: העלאה אחת יכולה לכלול עד 10 MB של קבצים בסך הכל.
• Hard links: Claude מסרב לקבצים שיש להם כמה hard links, דבר נפוץ בתוך מאגרי מנהלי חבילות כמו node_modules. העתיקו את הקובץ והעלו את העותק.
• Credential names: Claude מסרב לקובץ שהשם שלו או התיקייה שלו הם מקום שבו נשמרים פרטי גישה, כמו .env, קובץ .pem או .key, או כל דבר תחת .ssh. דורש Claude Code v2.1.293 או חדש יותר.

#ניסוח תוכן ב-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 שומר את התמונה לדיסק ומדווח על נתיב הקובץ.

#פתרון בעיות

#התוסף לא מזוהה

אם 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. 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 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 Registry

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

#הגדרות הפרויקט לא יכולות להפעיל את Chrome

האזהרה הזו בטרמינל אומרת שהפרויקט שבו אתם עובדים ניסה להפעיל את שילוב Chrome, ו-Claude Code לא אפשר זאת:

Claude Code ignored CLAUDE_CODE_ENABLE_CFC in this project's settings: a project can't turn on Claude in Chrome. To turn it on yourself, run /chrome or start with --chrome.

הקובץ .claude/settings.json או .claude/settings.local.json של הפרויקט מגדיר את CLAUDE_CODE_ENABLE_CFC ל-1 בבלוק env שלו כדי להפעיל את שילוב Chrome. Claude Code לא החיל את ההגדרה הזו, כך ששילוב Chrome כבוי בסשן הזה ול-Claude אין כלי דפדפן.

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

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

• כדי לקבל כלי דפדפן עכשיו: צאו והתחילו מחדש עם claude --chrome ב-shell שלכם.
• כדי לקבל כלי דפדפן בסשנים מאוחרים יותר: הריצו /chrome בהנחיה של Claude Code ובחרו מופעל כברירת מחדל. זה חל על סשנים שאתם מתחילים אחר כך, לא על הסשן שרץ עכשיו.
• כדי לעצור את האזהרה בלי כלי דפדפן: הסירו את השורה CLAUDE_CODE_ENABLE_CFC מקובץ ההגדרות של הפרויקט.

#הדפדפן לא מגיב

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

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

#ניתוקי חיבור במהלך סשנים ארוכים

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

כשאתם מריצים /chrome, בדקו את שורת Status שלו. אם כתוב בה "Not connected", החיבור של הסשן הרץ עצמו ל-Chrome נכשל. בחרו "Reconnect extension" כדי להפעיל מחדש את החיבור הזה. אחרי שהחיבור מצליח, דף החיבור מחדש של התוסף נפתח ב-Chrome. לפני v2.1.290, "Reconnect extension" רק פתח את הדף הזה ולא הפעיל מחדש חיבור שנכשל, כך שאם כלי הדפדפן לא חוזרים בגרסה מוקדמת יותר, עדכנו את Claude Code.

#התוסף מחובר לארגון אחר

אם אתם שייכים ליותר מארגון claude.ai אחד, התוסף חייב להיות מחובר לאותו ארגון כמו Claude Code. אם השניים שונים, כלי הדפדפן של Claude מחזירים "Browser extension is not connected", גם כששניהם משתמשים באותו חשבון claude.ai.

כדי לראות לאיזה ארגון Claude Code מחובר, הריצו /status בהנחיה של Claude Code וקראו את שורת Organization.

[!WARNING]

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

כדי לשנות את הארגון של התוסף, התנתקו בהגדרות התוסף, ואז התחברו ובחרו את הארגון ש-/status מציג.

#בעיות ייחודיות ל-Windows

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

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

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

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

#ראו גם

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