דלגו לתוכן
גיליון 001·חי·20:20 IL
→ יומן/2026-11-02·8 דק׳

Claude Code וה-Agent SDK מוסיפים גבולות קריאה וכתיבה: ערות הגרסה v2.1.312 עד v2.1.316 מול התיעוד

בין 27 ל-31 באוקטובר, Claude Code וה-Claude Agent SDK ל-TypeScript הוסיפו הגדרות שגורמות לכלי קבצים לסרב לכתיבות מחוץ לספריות העבודה, לפטור נתיבי קריאה ספציפיים, ולדווח על sandbox שלא יכול לרוץ. השוויתי את ערות הגרסה עם עמודי התיעוד הנוכחיים.

מאת Harel Asaf·בונה בינה מלאכותית·תל אביב

Claude Code v2.1.314 (30 באוקטובר 2026) הוסיף את permissions.blockWritesOutsideWorkingDirectories, הגדרה שגורמת לכלי Write, Edit ו-NotebookEdit לסרב לנתיבים מחוץ לספריות העבודה "in every permission mode". Claude Agent SDK ל-TypeScript קיבל את אותה הגדרה באותו יום, ויום אחר כך הוסיף דרך לפטור נתיבי קריאה ספציפיים. אם אתם מריצים את Claude Code או ה-SDK בתוך המוצר שלכם, אלה הגדרות גבול ששווה להכיר. עמודי התיעוד שהצלחתי לקרוא עוד לא מתארים את כולן, וזו הסיבה לקרוא את ערות הגרסה ישירות.

קראתי את ערות הגרסה ב-GitHub של Claude Code v2.1.309 עד v2.1.316 ושל Agent SDK ל-TypeScript v0.3.309 עד v0.3.316, ועוד עמודי הייחוס של הרשאות והגדרות של Claude Code. לא התקנתי ולא הרצתי אף אחד. כל מה שלמטה הוא מה שהמסמכים האלה אומרים.

מה יצא, לפי גרסה

Claude Code v2.1.314 (30 באוקטובר)

  • permissions.blockWritesOutsideWorkingDirectories: Write, Edit ו-NotebookEdit מסרבים לנתיבים מחוץ לספריות העבודה בכל מצב הרשאות.
  • תיקון לקובץ הגדרות שהודר עם --setting-sources ועדיין סיפק כמה הגדרות, כמו כללי auto mode והסכמות הרשאה שמורות.
  • תיקון להגנות sandbox שלא הוחלו על worktree שנכנסו אליו עם claude -p --resume או --continue.

Claude Code v2.1.316 (31 באוקטובר)

  • תיקון לסשנים עם --restricted שהעלו קבצים מחוץ לספריות העבודה כשכלל allow של Read כיסה אותם.
  • תיקונים ל-auto mode: רשימת autoMode.allow מנוהלת בלי "$defaults" שקיבלה חזרה חריגות מובנות מ---settings של אפליקציית host, וסשני ענן שלא סומנו כנכשלים כש-auto mode עצר סיבוב כי השרת לא החזיר verdict בטיחות.
  • Fast mode ל-Opus 4.8 הוצא משימוש החל מ-30 באוקטובר 2026 ויוסר ב-30 בנובמבר 2026, ואז הבקשות האלה מחזירות שגיאה במקום ליפול ל-fallback.

Agent SDK ל-TypeScript

  • v0.3.312 (27 באוקטובר): נוספו autoMode, skipAutoPermissionPrompt, useAutoModeDuringPlan ו-permissions.disableAutoMode לטיפוס Settings, ותוקן resolveSettings() שהחזיר הגדרות auto-mode מנוהלות עם טיפוס שגוי.
  • v0.3.314 (30 באוקטובר): נוסף permissions.blockWritesOutsideWorkingDirectories ל-Settings, נוסף sandbox_required_unavailable ל-startup_failure_reason (התוצאה ש-Claude Code כותב כש-sandbox נדרש לא יכול לרוץ), נוסף prewarm() אלפא לנקודת הכניסה של הליבה, ותוקן קובץ הגדרות שנשאר מחוץ ל-settingSources ועדיין סיפק כמה הגדרות.
  • v0.3.316 (31 באוקטובר): נוסף permissions.blockReadsExemptPaths ל-Settings, מתואר כנתיבים, הנקראים רק מ---settings והגדרות שה-host שולח, ש-blockReadsOutsideWorkingDirectories מעביר בלי להפוך אותם לספריות עבודה. עודכן לשוויון עם Claude Code v2.1.316.

איך זה משתלב במודל ההרשאות בתיעוד

עמוד ההרשאות מתאר איך קריאות וכתיבות מטופלות. כמה שורות חשובות כאן:

  • כלים לקריאה-בלבד כמו קריאות קבצים ו-Grep לא צריכים אישור בתוך ספריית העבודה וספריות נוספות.
  • סט מובנה של פקודות Bash נחשב קריאה-בלבד ורץ בלי prompt בכל מצב, "except as permissions.blockReadsOutsideWorkingDirectories changes for paths outside your working directories".
  • redirects של קלט ויעדי tee מחוץ לספריות העבודה צריכים אישור אלא אם כלל allow מכסה אותם.
  • עם permissions.blockReadsOutsideWorkingDirectories דולק, או בסשן --restricted, קבצים מצורפים שצוינו ב-@ מנתיבים נדחים גם מושמטים.

עמוד ייחוס ההגדרות שמשכתי מפרט את permissions.blockReadsOutsideWorkingDirectories ("make the file tools refuse reads outside the working directories in every permission mode") ו-sandbox.failIfUnavailable ("refuse to start when the sandbox can't, instead of running unsandboxed"). לא מצאתי את blockWritesOutsideWorkingDirectories או blockReadsExemptPaths בעמודים שמשכתי. זה יכול להיות caching של העמוד או פיגור תיעוד. אני מתייחס לערות הגרסה כמקור לשניים האלה.

למה גבול הכתיבה הוא הגדרה נפרדת

הגדרת הכתיבה החדשה מנים שלושה כלים: Write, Edit ו-NotebookEdit. עמוד ההרשאות, בחלק ה-symlink שלו, אומר שכתיבה עדיין יכולה לעבור דרך symlink כשספרייה בדרך לקובץ היא symlink, או כשפקודת Bash או PowerShell עושה את הכתיבה, ומסביר איך המקרים האלה מטופלים בהתאם למקום שהקובץ המפוענח יושב. אז אני קורא את ההגדרה החדשה כמכסה רק את כלי הקבצים. אם היא משפיעה על כתיבות shell לא מצוין בערת הגרסה, ולא הייתי מניח שכן. לא קראתי את עמוד ה-sandboxing, אז אני לא יכול להגיד איזו בקרה מכסה כתיבות shell.

אות כשל ה-sandbox

ל-hosts של SDK, sandbox_required_unavailable שימושי כי הוא מפריד "ה-sandbox לא הצליח להתחיל" מכשלי הפעלה אחרים. יחד עם sandbox.failIfUnavailable מייחוס ההגדרות, הדפוס הוא: לדרוש את ה-sandbox, ולזהות את הכשל לפי קוד הסיבה שלו. לא קראתי את תיעוד ה-SDK ל-startup_failure_reason מעבר לערת הגרסה.

מה הייתי בודק

אלה הצעות שלא בדקתי.

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

2. לנסות redirect של shell לאותו נתיב חיצוני ולראות מה מצב ההרשאות שלכם עושה, מכיוון שערת הגרסה מנים רק את כלי הקבצים.

3. אם אתם מטמיעים את ה-SDK, לשלוח blockReadsExemptPaths דרך הגדרות host ולאשר שזה לא עובד מקובץ הגדרות פרויקט.

4. לכפות כשל sandbox על מכונת בדיקה ולאשר שה-host שלכם מטפל ב-sandbox_required_unavailable.

5. לקבוע את גרסאות ה-CLI וה-SDK, מכיוון שה-SDK אומר שכל גרסה בשוויון עם גרסת CLI.

6. אם אתם משתמשים ב-fast mode על Opus 4.8, לתכנן את ההסרה ב-30 בנובמבר.

מה לא הייתי מסיק

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

שאלות נפוצות

מה permissions.blockWritesOutsideWorkingDirectories עושה?

לפי ערות v2.1.314, Write, Edit ו-NotebookEdit מסרבים לנתיבים מחוץ לספריות העבודה בכל מצב הרשאות.

יש הגדרת קריאה תואמת?

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

מה זה blockReadsExemptPaths?

שדה Settings של SDK שנוסף ב-v0.3.316. הערות אומרות שהוא מפרט נתיבים, הנקראים רק מ---settings והגדרות שנשלחות מה-host, שחסימת הקריאה מעבירה בלי להפוך אותם לספריות עבודה.

מה sandbox_required_unavailable אומר?

זו סיבת כשל הפעלה לתוצאה ש-Claude Code כותב כש-sandbox נדרש לא יכול לרוץ, לפי ערות SDK v0.3.314.

מה השתנה ב-auto mode?

ה-SDK הוסיף שדות auto-mode ל-Settings, ו-Claude Code תיקן כמה התנהגויות של auto mode, כולל רשימות allow מנוהלות וסשני ענן בלי verdict בטיחות.

מה הוצא משימוש?

Fast mode ל-Opus 4.8, הוצא משימוש החל מ-30 באוקטובר 2026 ויוסר ב-30 בנובמבר 2026, לפי ערות v2.1.316.

בדקת משהו מזה?

לא. קראתי את ערות הגרסה ועמודי התיעוד.

מקורות

כולם נקראו ב-2 בנובמבר 2026.

לא נקרא: עמוד ה-sandboxing, עמוד מצבי ההרשאות, תיעוד ה-SDK עצמו, וקוד המקור.

קריאה נוספת

יומן הבנייה

לעקוב אחרי העבודה.

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

עקבו ב-RSS