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 قراءة الإعداد عند كل تشغيل.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): أنشئ ملف إعداد عام وحدد النموذج الافتراضي وسياسة الموافقة.
  2. متوسط (⭐⭐): أنشئ إعدادًا على مستوى المشروع و AGENTS.md لمشروعك، مع تعريف أسلوب الكود والعمليات المحظورة.
  3. متقدم (⭐⭐⭐): صمم مخطط إعداد متعدد البيئات — DeepSeek للتطوير، OpenAI للمهام المتعلقة بالإنتاج — مع تبديل تلقائي.
Web-Tutorial.com

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

100%