📘 תיעוד 114

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

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

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

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

מצב קורא מסך דורש את Claude Code בגרסה v2.1.181 ואילך. גרסאות מוקדמות יותר דוחות את הדגל --ax-screen-reader עם הודעת השגיאה error: unknown option '--ax-screen-reader'.

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

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

• עבור הפעלה בודדת: הרץ claude --ax-screen-reader.
• עבור הפעלות שמתחילות ממעטפת (shell) יחידה: הגדר את משתנה הסביבה 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].

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

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

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

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

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

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

• ללא תווי ציור תיבות (box-drawing) עבור מסגרת הממשק
• ללא רמזים המבוססים על צבע בלבד
• ללא ציור מחדש של תוכן שלא השתנה. מחווני התקדמות מוצגים כטקסט סטטי
• טבלאות בתשובות של Claude נקראות כמשפטים במבנה Header: value במקום רשת של תווי תיבות

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

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

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

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

‏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 פולט סמני שילוב מעטפת OSC 133 בגבולות של תורות שיחה, כך שמקש המעבר לשורת הפקודה הקודמת במסוף שלך עובר בין תורות שיחה מבלי לקרוא את התמליל כולו:

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

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

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

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

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

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

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

#שמיעת התרעה כאשר Claude Code זקוק לך

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

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

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

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

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

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

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

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