📘 תיעוד 151

שימוש ב-Claude Code עם קורא מסך

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

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

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

#הפעלת מצב קורא מסך

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

• לסשן אחד: הריצו claude --ax-screen-reader.
• לסשנים שמתחילים ממעטפת אחת: הגדירו את משתנה הסביבה CLAUDE_AX_SCREEN_READER ל-1. ב-Bash או ב-Zsh, הריצו export CLAUDE_AX_SCREEN_READER=1. ב-PowerShell, הריצו $env:CLAUDE_AX_SCREEN_READER = "1". הוסיפו את השורה הזו לפרופיל המעטפת כדי לשמור אותה למעטפות הבאות.
• לכל סשן במחשב: הוסיפו "axScreenReader": true לקובץ ההגדרות של המשתמש. ההגדרה חלה בכל טרמינל, כולל הטרמינל המשולב של VS Code.

אם משלבים שיטות, Claude Code מחיל את הדגל --ax-screen-reader מעל משתנה הסביבה CLAUDE_AX_SCREEN_READER, ואת המשתנה מעל ההגדרה axScreenReader.

אם משתמשים ב-Claude Code דרך SSH, הגדירו את משתנה הסביבה או את ההגדרה במחשב המרוחק שבו Claude Code רץ.

השורה הראשונה ש-Claude Code מדפיס מאשרת את המצב: [Screen Reader Mode: on via flag], [Screen Reader Mode: on via env], או [Screen Reader Mode: on via settings].

#הגדרות הפרויקט לא יכולות להפעיל מצב קורא מסך

שורת ההפעלה Screen reader mode is off: project settings can't turn it on אומרת שהפרויקט ביקש מצב קורא מסך, ושום דבר אחר לא מפעיל אותו. Claude Code מתעלם גם ממפתח axScreenReader וגם מערך CLAUDE_AX_SCREEN_READER תחת env בקובצי .claude/settings.json ו-.claude/settings.local.json של הפרויקט, בכל ערך שלהם.

• כדי להפעיל את המצב: הפעילו את Claude Code עם --ax-screen-reader, הגדירו את CLAUDE_AX_SCREEN_READER ל-1 במעטפת, או הוסיפו "axScreenReader": true לקובץ ההגדרות של המשתמש והפעילו מחדש את Claude Code. אין צורך לשנות את קובצי הפרויקט. אחרי שמפעילים את המצב, שורת האישור מופיעה בהפעלה במקומה.
• אם לא משתמשים בקורא מסך: אין צורך לעשות דבר. כדי להפסיק את הופעת השורה, הוסיפו "axScreenReader": false לקובץ ההגדרות של המשתמש, או הסירו את מפתח axScreenReader ואת משתנה CLAUDE_AX_SCREEN_READER מקובצי ההגדרות של הפרויקט.

#כיבוי מצב קורא מסך

הפכו את השיטה שהפעילה את המצב: התחילו בלי הדגל, בטלו את משתנה הסביבה, או הגדירו את axScreenReader ל-false בקובץ ההגדרות של המשתמש. אם מגדירים את CLAUDE_AX_SCREEN_READER ל-0, Claude Code משאיר את המצב כבוי גם כאשר ההגדרה היא true.

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

הטבלה מפרטת כל אפשרות נגישות, אם מגדירים אותה כדגל, כמשתנה סביבה או כהגדרה, ומה היא משנה.

#מה קורא המסך שומע

במצב קורא מסך, Claude Code כותב טקסט שטוח:

• אין תווי ציור תיבות לעיטור הממשק
• אין רמזים של צבע בלבד
• אין ציור מחדש של תוכן שלא השתנה. ספינרי התקדמות מוצגים כטקסט סטטי
• טבלאות בתשובות של Claude נקראות כמשפטים של Header: value במקום רשת של תווי תיבה
• diff נקראים כטקסט פשוט, שורה אחר שורה, כש-+ ו-- מסמנים שורות שנוספו ושורות שהוסרו, כך שאפשר לשמוע את השינוי המוצע בפרומפט אישור של עריכת קובץ לפני שעונים עליו

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

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

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

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

כאשר מוחקים מילה או שורה עם אחד מקיצורי עריכת הטקסט, Claude Code מכריז על הטקסט שנמחק:

• מחיקת מילים עם Ctrl+W או Alt+D, או עם Option+Delete ב-macOS או עם Ctrl+Backspace ב-Windows
• מחיקה עד תחילת השורה עם Ctrl+U או Cmd+Backspace
• מחיקה עד סוף השורה עם Ctrl+K

כאשר עוברים בין מצבי הרשאה עם Shift+Tab, Claude Code מכריז על מצב ההרשאה שאליו מגיעים, כמו [plan mode on] או [accept edits on]. Claude Code מדפיס את ההכרזה פעם אחת ולא חוזר עליה בציורים מחדש מאוחרים יותר.

#קריאת פלט קודם בלי לאבד את המקום

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

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

#קפיצה בין תורות

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

• iTerm2: Cmd+Shift+Up
• טרמינל VS Code: Ctrl+Up ב-Windows, Cmd+Up ב-macOS
• Windows Terminal: אין מקש כברירת מחדל: קשרו את הפעולה scrollToMark בהגדרות שלו
• Kitty ו-Ghostty: בדקו בתיעוד של הטרמינל מהו מקש הקפיצה לפרומפט

Terminal של macOS לא פועל לפי הסמנים, ו-Claude Code לא פולט אותם ב-WezTerm. בטרמינלים האלה, חפשו ב-scrollback את התווית you: במקום זאת.

#מענה לתפריטים ולפרומפטים

במצב קורא מסך, תפריטים שבדרך כלל מנווטים בהם עם מקשי החצים, כולל פרומפטי הרשאה, הופכים לרשימות ממוספרות. Claude Code מכריז על כל אפשרות כשורה ממוספרת, ואחר כך על פרומפט Select with numbers שמציין את הטווח התקף. הקלידו את מספר האפשרות הרצויה ולחצו Enter.

• לחצו Escape כדי לבטל תפריט שהפרומפט שלו מסתיים ב-or Escape to cancel.
• אם מקלידים מספר שאינו ברשימה, Claude Code מכריז על הטווח התקף ומאפשר לנסות שוב.

בורר /effort, שהוא מחוון מחוץ למצב קורא מסך, הופך לאותו סוג של רשימה ממוספרת.

פרומפטים של כן או לא מבקשים תשובה מוקלדת במקום תפריט של שתי אפשרויות. ענו y או n ולחצו Enter. גם yes ו-no עובדים.

#שמיעה כש-Claude Code צריך אתכם

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

• Claude מסיים תשובה
• פרומפט או תיבת דו שיח צריכים את התשובה שלכם, כמו פרומפט הרשאה
• כלי שרץ יותר מ-5 שניות מסיים

הצלצול הוא ההתראה הרגילה של הטרמינל. כדי להשתיק אותו, שנו את הגדרת הצלצול ביישום הטרמינל. מחוץ למצב קורא מסך, הגדירו את preferredNotifChannel ל-"terminal_bell" כדי לקבל צלצול דומה כאשר Claude ממתין לכם.

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

יש התנהגויות שאינן מותאמות למצב קורא מסך:

• מצב קורא מסך לא נדלק אוטומטית כאשר קורא מסך פועל.
• Claude Code לא מכריז על שינוי מצב הרשאה שנעשה עם פקודה, כמו כניסה למצב plan עם /plan.
• התחברות לסשן רקע עם claude attach או מ-agent view נכנסת למסך החלופי של הטרמינל, שאין לו scrollback מובנה. זו אותה התנהגות כמו בסשנים מחוברים אחרים. כדי לחזור החוצה, לחצו על חץ שמאלה בפרומפט ריק, או על Ctrl+Z אם לתיבת דו שיח יש מיקוד.
• Claude Code מכריז על עלויות בסיכום שהוא מדפיס ביציאה, ולא בכל תור.
• מצב קורא מסך לא משנה את המצב הלא אינטראקטיבי עם הדגל -p. המצב הלא אינטראקטיבי כבר כותב טקסט פשוט, והוא נשאר חלופה לכתיבת סקריפטים.

#דיווח על בעיה

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