Codex: إعداد Codex وتخصيصه
آخر تحديث: 2026-08-31
يقدم Codex خيارات إعداد غنية — من إعدادات API الأساسية إلى سياسات الموافقة المتقدمة وإعدادات sandbox، كل شيء قابل للتخصيص حسب احتياجاتك.
📋 المتطلبات المسبقة: Codex مثبت والاستخدام الأساسي مكتمل
1. ما ستتعلمه
- مواقع وهيكل ملفات الإعداد
- عناصر الإعداد الأساسية
- خيارات الإعداد المتقدمة
- الإعداد على مستوى المشروع مقابل الإعداد العام
2. مواقع ملفات الإعداد
| نوع الإعداد | المسار | النطاق |
|---|---|---|
| الإعداد العام | ~/.codex/config.toml |
جميع المشاريع |
| إعداد المصادقة | ~/.codex/auth.json |
مفاتيح API، إلخ |
| إعداد المشروع | .codex/config.toml |
المشروع الحالي |
| AGENTS.md | AGENTS.md |
قواعد وسياق المشروع |
3. الإعداد العام config.toml
(1) الإعداد الأساسي
TOML
# ~/.codex/config.toml
# Model settings
model = "gpt-5-codex"
# Approval policy: ask / approve / deny
approval_policy = "ask"
# Sandbox mode: readonly / workspace-write / full-access
sandbox_mode = "workspace-write"
# Context window size (tokens)
context_window = 128000
(2) إعداد المصادقة auth.json
JSON
{
"OPENAI_API_KEY": "sk-your-api-key",
"OPENAI_BASE_URL": "https://api.openai.com/v1"
}
▶ مثال 1: إعداد أليس
TOML
# Alice's global config
model = "gpt-5-codex"
approval_policy = "ask"
sandbox_mode = "workspace-write"
# Custom prompt prefix
system_prompt_prefix = """
You are a senior full-stack engineer, proficient in TypeScript and Python.
Code style guidelines:
- Use type annotations
- Functions no longer than 50 lines
- Every function has a docstring
"""
4. الإعداد المتقدم
(1) تفاصيل سياسة الموافقة
| السياسة | السلوك | حالة الاستخدام |
|---|---|---|
ask |
تأكيد كل عملية حساسة | التطوير اليومي (افتراضي) |
approve |
موافقة تلقائية على جميع العمليات | سيناريوهات أتمتة موثوقة |
deny |
رفض جميع العمليات الحساسة | مراجعة للقراءة فقط |
TOML
# Per-operation-type approval settings
[approval]
shell_commands = "ask" # shell commands need confirmation
file_writes = "approve" # file writes auto-approved
network_access = "deny" # deny network access
sensitive_paths = "ask" # sensitive paths need confirmation
(2) إعداد Sandbox
TOML
# Sandbox mode
[sandbox]
mode = "workspace-write" # Only allow writes within workspace
allowed_paths = ["src/", "test/"] # Restrict writable paths
blocked_paths = [".env", "secrets/"] # Blocked access paths
network = false # Deny network access
(3) إدارة السياق
TOML
[context]
auto_compact = true # Auto-compress context
compact_threshold = 0.8 # Trigger compression at 80% usage
max_file_size = "100KB" # Max single file read size
include_patterns = ["*.py", "*.ts", "*.js"] # Include file patterns
exclude_patterns = ["node_modules/", ".git/"] # Exclude patterns
5. الإعداد على مستوى المشروع
أنشئ .codex/config.toml في جذر المشروع لتجاوز الإعدادات العامة:
TOML
# .codex/config.toml (project-level)
# Project-specific model
model = "deepseek-coder"
# Project-specific approval policy
approval_policy = "approve"
# Project-specific sandbox
[sandbox]
allowed_paths = ["src/", "tests/"]
blocked_paths = ["production/", "secrets/"]
▶ مثال 2: إعداد مشروع بوب
TOML
# Bob's frontend project config
# .codex/config.toml
model = "gpt-5-codex"
approval_policy = "ask"
[context]
include_patterns = ["*.tsx", "*.ts", "*.css"]
exclude_patterns = ["node_modules/", "dist/", ".next/"]
[sandbox]
allowed_paths = ["src/", "public/", "styles/"]
blocked_paths = [".env.local", ".env.production"]
6. قواعد المشروع AGENTS.md
AGENTS.md هو ملف قواعد على مستوى المشروع يوضع في جذر المشروع. يقرأه Codex تلقائيًا:
MARKDOWN
# AGENTS.md
## Project Rules
- Use TypeScript strict mode
- All API endpoints must have input validation
- Test coverage no less than 80%
- Run npm run lint before committing
## Code Style
- Use functional components
- Naming: camelCase
- Files: kebab-case
## Prohibited Operations
- Do not modify .env files
- Do not delete test files
- Do not install new dependencies (requires manual confirmation)
7. إعداد متغيرات البيئة
| المتغير | الوصف | المثال |
|---|---|---|
OPENAI_API_KEY |
مفتاح API | sk-xxx |
OPENAI_BASE_URL |
نقطة نهاية API | https://api.deepseek.com |
CODEX_MODEL |
النموذج الافتراضي | gpt-5-codex |
CODEX_SANDBOX |
وضع Sandbox | workspace-write |
BASH
# Temporary override
CODEX_MODEL=deepseek-coder codex
8. أولوية الإعداد
TEXT
📖 للعرض فقط
CLI arguments > Environment variables > Project config > Global config > Defaults
▶ مثال 3: الأولوية في الممارسة
BASH
# Global config: model = "gpt-5-codex"
# Project config: model = "deepseek-coder"
# Environment variable: CODEX_MODEL="gpt-4o"
# Final: gpt-4o (env var > project config > global config)
CODEX_MODEL="gpt-4o" codex
# CLI argument has highest priority
codex --model o3
# Final: o3
❓ أسئلة شائعة
س ماذا لو تعارض إعداد المشروع مع الإعداد العام؟
ج إعداد المشروع له الأولوية. يقرأ Codex الإعداد العام أولًا، ثم يتجاوزه بإعداد المشروع.
س ما الفرق بين AGENTS.md و config.toml؟
ج config.toml هو إعداد تقني (نموذج، sandbox، سياسة الموافقة)؛ AGENTS.md هو قواعد بلغة طبيعية (أسلوب كود، عمليات محظورة، اتفاقيات مشروع). كل منهما يكمل الآخر.
س هل يمكنني وضع مفاتيح API في إعداد المشروع؟
ج غير موصى به. يجب أن تذهب مفاتيح API إلى
~/.codex/auth.json أو متغيرات البيئة لتجنب تسريبها إلى مستودعات git.س كيف أعرض الإعداد الفعال الحالي؟
ج شغّل
codex --show-config لرؤية الإعداد المدمج الكامل.س ماذا لو أخطأت في الإعداد؟
ج عدّل ملف الإعداد مباشرة، أو احذفه لاستعادة الافتراضيات. يعيد Codex قراءة الإعداد عند كل تشغيل.
📖 ملخص
- الإعداد العام:
~/.codex/config.toml، إعداد المشروع:.codex/config.toml - سياسات الموافقة: ask / approve / deny
- أوضاع Sandbox: readonly / workspace-write / full-access
- AGENTS.md يعرّف قواعد المشروع بلغة طبيعية
- أولوية الإعداد: وسيطات CLI > متغيرات بيئة > مشروع > عام > افتراضي
📝 تمارين
- أساسي (⭐): أنشئ ملف إعداد عام وحدد النموذج الافتراضي وسياسة الموافقة.
- متوسط (⭐⭐): أنشئ إعدادًا على مستوى المشروع و AGENTS.md لمشروعك، مع تعريف أسلوب الكود والعمليات المحظورة.
- متقدم (⭐⭐⭐): صمم مخطط إعداد متعدد البيئات — DeepSeek للتطوير، OpenAI للمهام المتعلقة بالإنتاج — مع تبديل تلقائي.