מדריך OpenAI

5. הגדרות (config.toml) והתאמה אישית

חלק ב׳: שליטה והתאמה אישיתפרק 5 מתוך 16זמן קריאה: כ-4 דקות

כל ברירת המחדל של Codex — איזה מודל להשתמש בו, כמה חופש לתת לו, אילו שרתי MCP מחוברים, איך נראה הטרמינל — יושבת בקובץ הגדרות אחד: config.toml. בפרק הזה נראה איפה הוא נמצא, איך לערוך אותו נכון, ואיך להתאים אישית את חוויית הטרמינל (עורך, ערכת נושא, השלמות, קיצורי מקלדת).

איפה נמצא קובץ ההגדרות

Codex קורא הגדרות מ-~/.codex/config.toml כברירת מחדל. התיקייה הזו נקראת Codex home, ואפשר להחליף אותה עם משתנה הסביבה CODEX_HOME — שימושי כשרוצים פרופיל נפרד, למשל למשתמש אוטומציה ייעודי לפרויקט:

CODEX_HOME=$(pwd)/.codex codex exec "List active instruction sources"

בפרויקטים מהימנים (trusted) אפשר גם להגדיר שרתי MCP ברמת הפרויקט עצמו, בקובץ .codex/config.toml שיושב לצד הקוד.

הקובץ כתוב בפורמט TOML — טבלאות מוגדרות עם [שם.טבלה], וערכים כ-מפתח = ערך. אפשר לפתוח אותו בכל עורך טקסט.

סדר עדיפויות

כשאותה הגדרה מופיעה במקומות שונים, הגדרה ברמה יותר ספציפית גוברת. דגלי -c key=value שמעבירים ישירות בשורת הפקודה גוברים על הכול, ותקפים רק להרצה הנוכחית:

codex -c sandbox_mode="read-only" -c approval_policy="on-request"

להרצה שמתעלמת לגמרי מהגדרות המשתמש (שימושי לבדיקות מבודדות או אוטומציה נקייה), יש שני דגלים:

--ignore-user-config — לא טוען את $CODEX_HOME/config.toml בכלל.
--ignore-rules — מדלג על קובצי .rules של המשתמש והפרויקט (ראו פרק 6: AGENTS.md: הזיכרון הקבוע של הפרויקט).

ההגדרות החשובות ביותר

הנה כמה מהמפתחות הנפוצים ביותר בקובץ ההגדרות. חלקם מפורטים בפרקים ייעודיים בהמשך המדריך:

מפתח	מה הוא קובע
`sandbox_mode`	גבולות ה-sandbox — `read-only`, `workspace-write` או `danger-full-access` (ראו פרק 4: מצבי אישור ובטיחות)
`approval_policy`	מתי Codex עוצר ושואל לפני פעולה (ראו פרק 4: מצבי אישור ובטיחות)
`[sandbox_workspace_write]` → `network_access`	האם למצב Auto יש גישה לרשת
`[mcp_servers.<name>]`	הגדרת שרתי MCP מחוברים (ראו פרק 7: חיבור לכלים חיצוניים (MCP))
`project_doc_fallback_filenames`, `project_doc_max_bytes`	שמות קבצי הוראות חלופיים ל-`AGENTS.md`, והגבלת הגודל המצטבר (ראו פרק 6: AGENTS.md: הזיכרון הקבוע של הפרויקט)
`model`, `model_reasoning_effort`	המודל וברירת המחדל של עומק החשיבה (ראו פרק 10: מודלים ומהירות)
`tui.theme`	ערכת הצבעים של הטרמינל

דוגמה לקובץ הגדרות בסיסי:

# ~/.codex/config.toml
model = "gpt-5.6"
approval_policy = "on-request"
sandbox_mode    = "workspace-write"

[sandbox_workspace_write]
network_access = true

פרופילים: כמה תצורות מוכנות מראש

כשעוברים בין הקשרי עבודה שונים (למשל עבודה שוטפת מול בדיקה זהירה של קוד לא מוכר), אפשר לשמור כמה תצורות מוכנות כפרופילים, ולבחור ביניהן עם --profile:

# ~/.codex/full_auto.config.toml
approval_policy = "on-request"
sandbox_mode    = "workspace-write"

# ~/.codex/readonly_quiet.config.toml
approval_policy = "never"
sandbox_mode    = "read-only"

codex --profile profile-name

התאמת הממשק בטרמינל

ל-CLI יש כמה אפשרויות התאמה אישית ייעודיות, שמשתנות בין הרצה מהירה דרך פקודת / לבין ערך קבוע שנשמר ב-config.toml.

ערכת נושא והדגשת תחביר

הטרמינל (TUI) מדגיש תחביר בבלוקים של קוד ובהצגת diff. הריצו /theme כדי לפתוח את בורר הערכות, לתצוגה מקדימה ולשמירת הבחירה ב-tui.theme:

/theme

כדי להוסיף ערכת נושא מותאמת אישית, שימו קובץ .tmTheme בתיקיית $CODEX_HOME/themes, והוא יופיע בבורר.

השלמות Shell

אפשר לייצר סקריפט השלמה ל-Bash, Zsh, Fish או PowerShell:

codex completion zsh

ואז לטעון אותו מקובץ ההגדרות של ה-shell. ל-Zsh למשל:

eval "$(codex completion zsh)"

אם Zsh מדווח command not found: compdef, יש לאתחל את מערכת ההשלמות שלו קודם:

autoload -Uz compinit && compinit
eval "$(codex completion zsh)"

עורך טקסט לפרומפטים ארוכים

לפרומפט ארוך, Ctrl+G בתיבת ההקלדה פותח אותו בעורך המוגדר במשתנה הסביבה VISUAL (או EDITOR אם VISUAL לא מוגדר). שמירה וסגירה של העורך מחזירה את הטקסט לתיבת ההקלדה.

קיצורי מקלדת, שורת סטטוס וכותרת החלון

עוד כמה פקודות / שמתאימות אישית את הממשק ונשמרות אוטומטית לקובץ ההגדרות:

פקודה	מה היא עושה	נשמר ב-
`/keymap`	מיפוי מחדש של קיצורי מקלדת בטרמינל	`tui.keymap`
`/statusline`	בחירה וסידור מחדש של פריטי שורת הסטטוס (מודל, שימוש בטוקנים, ענף Git…)	`tui.status_line`
`/title`	בחירת הפריטים שמופיעים בכותרת חלון/כרטיסיית הטרמינל	`tui.terminal_title`
`/vim`	הפעלת מצב Vim בתיבת ההקלדה עבור ההפעלה הנוכחית	`tui.vim_mode_default = true` לברירת מחדל קבועה
`/raw` (או `Alt`+`R`)	מצב גלילה גולמי, לבחירה והעתקה נוחה יותר מהטרמינל	`tui.raw_output_mode = true`
`/pets`	חיית מחמד קטנה שרצה בטרמינל, לשעשוע	נשמר אוטומטית; `/pets off` מסתיר

לא בטוחים מאיפה מגיעה הגדרה?

הפקודה /debug-config בטרמינל מציגה את סדר שכבות ההגדרות (מהעדיפות הנמוכה לגבוהה), את מצבן (פעיל/כבוי), ומקור המדיניות לכל אחת — שימושי כשערך בפועל שונה ממה שכתוב ב-config.toml. הפקודה /status מציגה תמונת מצב מהירה יותר: מודל פעיל, מדיניות אישורים, תיקיות כתיבה וניצול טוקנים.

בקצרה

קובץ ההגדרות המרכזי הוא ~/.codex/config.toml (בפורמט TOML), ואפשר להחליף מיקום עם CODEX_HOME.
פרויקטים מהימנים יכולים להוסיף .codex/config.toml משלהם, למשל להגדרת שרתי MCP ברמת הפרויקט.
דגלי -c key=value גוברים על הקובץ להרצה בודדת; --ignore-user-config מדלג עליו לגמרי.
אפשר לשמור כמה תצורות כפרופילים ולבחור ביניהן עם --profile.
פקודות / כמו /theme, /keymap, /statusline, /title, /vim ו-/raw מתאימות את הטרמינל אישית ונשמרות אוטומטית תחת tui.*.

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