---

🎯 ما هذا؟

Claw Codex هو إعادة كتابة كاملة بلغة Python لـ Claude Code، استنادًا إلى كود TypeScript الحقيقي.

⚠️ مهم: هذا ليس مجرد كود مصدر

على عكس كود TypeScript المُسرّب، Claw Codex هو أداة CLI تعمل بالكامل:

• ✅ CLI يعمل — ليس مجرد كود، بل أداة سطر أوامر تعمل بالكامل يمكنك استخدامها اليوم
• ✅ استنادًا إلى المصدر الحقيقي — تم نقله من تنفيذ Claude Code TypeScript الفعلي
• ✅ أقصى درجات الدقة — يحافظ على البنية الأصلية مع التحسين
• ✅ Python أصلي — كود Python نظيف ومعبر مع تعليقات نوع كاملة
• ✅ سهل الاستخدام — إعداد سهل، REPL تفاعلي، توثيق شامل
• ✅ تحسين مستمر — معالجة أخطاء محسّنة، اختبارات، توثيق

🚀 جرّبه الآن! افرکه، عدّله، اجعله ملكك! طلبات السحب مرحب بها!

---

⭐ Star History

✨ الميزات

دعم متعدد المزودين

providers = [
    # بروتوكولات أصلية / مخصصة
    "anthropic", "minimax", "deepseek", "zai", "openrouter", "openai", "gemini",
    # مزودون متوافقون مع OpenAI
    "nvidia-nim", "atlascloud", "wanjie-ark", "volcengine", "xiaomi-mimo",
    "novita", "fireworks", "siliconflow", "siliconflow-cn", "arcee", "moonshot",
    "huggingface", "together", "stepfun", "deepinfra",
    # خوادم محلية (لا تتطلب مفتاح API)
    "ollama", "vllm", "sglang",
]  # 25 مزوداً؛ الأسماء المستعارة مثل nim و kimi و hf تُحلّ تلقائياً

REPL تفاعلي

>>> مرحبًا!
Assistant: أهلاً! أنا Claw Codex، إعادة تنفيذ بـ Python...

>>> /help         # عرض الأوامر
>>> /             # عرض الأوامر والـ skills
>>> /save         # حفظ الجلسة
>>> /multiline    # وضع متعدد الأسطر
>>> Tab           # الإكمال التلقائي
>>> /explain-code qsort.py   # تشغيل skill

Skills (Slash Commands)

See README.md for a quick tutorial on creating skills under .clawcodex/skills/<skill-name>/SKILL.md.

CLI كامل

clawcodex --dangerously-skip-permissions              # بدء REPL
clawcodex login        # تكوين API
clawcodex --version    # التحقق من الإصدار
clawcodex config       # عرض الإعدادات

---

📊 الحالة

المكون	الحالة	العدد
الأوامر	✅ مكتمل	150+
الأدوات	✅ مكتمل	100+
تغطية الاختبارات	✅ 90%+	75+ اختبار
التوثيق	✅ مكتمل	10+ مستندات

---

🚀 البدء السريع

التثبيت

git clone https://github.com/GPT-AGI/Claw-Codex.git
cd Claw-Codex

# إنشاء venv (يُوصى بـ uv)
uv venv --python 3.11
source .venv/bin/activate

# التثبيت
uv pip install -r requirements.txt

يتم حفظ ملف التكوين في ~/.clawcodex/config.json. مثال مبسّط:

{
  "default_provider": "deepseek",
  "providers": {
    "deepseek": {
      "api_key": "xxx-xxx",
      "base_url": "https://api.deepseek.com",
      "default_model": "deepseek-v4-pro"
    }
  },
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR-TAVILY-API-KEY"
  }
}

ملاحظة: مفتاح TAVILY_API_KEY مطلوب لأداة WebSearch — احصل على مفتاح من tavily.com.

كتل session وsettings وenv اختيارية — تُطبَّق قيم افتراضية معقولة عند حذفها (الهيكل الكامل أدناه).

التكوين

الخيار 1: تفاعلي (مُوصى به)

python -m src.cli login

هذه العملية ستقوم بـ:

1. مطالبتك باختيار مزود: anthropic / openai / gemini / zai / minimax / openrouter / deepseek، أو أي مزود متوافق مع OpenAI (together, novita, fireworks, moonshot, nvidia-nim, siliconflow, deepinfra, huggingface, …) وخوادم محلية (ollama / vllm / sglang)
2. مطالبتك بمفتاح API الخاص بذلك المزود
3. حفظ عنوان URL أساسي مخصص اختياريًا
4. حفظ نموذج افتراضي اختياريًا
5. تعيين المزود المحدد كافتراضي

يتم حفظ ملف التكوين في ~/.clawcodex/config.json. مثال على الهيكل:

{
  "default_provider": "deepseek",
  "providers": {
    "anthropic": {
      "api_key": "your-api-key",
      "base_url": "https://api.anthropic.com",
      "default_model": "claude-sonnet-4-6"
    },
    "openai": {
      "api_key": "your-api-key",
      "base_url": "https://api.openai.com/v1",
      "default_model": "gpt-5.4"
    },
    "zai": {
      "api_key": "your-api-key",
      "base_url": "https://api.z.ai/api/coding/paas/v4",
      "default_model": "glm-5.2"
    },
    "minimax": {
      "api_key": "your-api-key",
      "base_url": "https://api.minimaxi.com/anthropic",
      "default_model": "MiniMax-M2.7"
    },
    "openrouter": {
      "api_key": "your-api-key",
      "base_url": "https://openrouter.ai/api/v1",
      "default_model": "deepseek/deepseek-v4-pro"
    },
    "deepseek": {
      "api_key": "your-api-key",
      "base_url": "https://api.deepseek.com",
      "default_model": "deepseek-v4-pro"
    }
  },
  "session": {
    "auto_save": true,
    "max_history": 100
  },
  "settings": {
    "advisor_enabled": false,
    "advisor_model": "claude-sonnet-4-6",
    "advisor_client_mode": false,
    "advisor_provider": "openai"
  },
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR-TAVILY-API-KEY"
  }
}

التشغيل

python -m src.cli          # بدء REPL
python -m src.cli --help   # عرض المساعدة

هذا كل شيء! ابدأ الدردشة مع AI في 3 خطوات.

---

💡 الاستخدام

أوامر REPL

الأمر	الوصف
/help	عرض جميع الأوامر
/save	حفظ الجلسة
/load <id>	تحميل جلسة
/multiline	تبديل وضع متعدد الأسطر
/clear	مسح السجل
/exit	الخروج من REPL

مثال على الجلسة

---

🎓 لماذا Claw Codex؟

استنادًا إلى الكود المصدري الحقيقي

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

Python أصلي

• تعليقات النوع — تعليقات نوع كاملة
• Python حديث — يستخدم ميزات 3.10+
• معبر — كود Python نظيف

يركز على المستخدم

• إعداد من 3 خطوات — استنساخ، تكوين، تشغيل
• تكوين تفاعلي — clawcodex login يرشدك
• REPL غني — إكمال Tab، تمييز بناء الجملة
• استمرار الجلسة — لا تفقد عملك أبدًا

---

📦 هيكل المشروع

Claw-Codex/
├── src/
│   ├── cli.py           # مدخل CLI
│   ├── config.py        # التكوين
│   ├── repl/            # REPL تفاعلي
│   ├── providers/       # مزودو LLM
│   └── agent/           # إدارة الجلسات
├── tests/               # 75+ اختبار
└── docs/                # توثيق كامل

---

🗺️ خارطة الطريق

• Python MVP
• دعم متعدد المزودين
• استمرار الجلسة
• تدقيق الأمان
• نظام استدعاء الأدوات
• حزمة PyPI
• إصدار Go

---

🤝 المساهمة

نرحب بالمساهمات!

# إعداد تطوير سريع
pip install -e .[dev]
python -m pytest tests/ -v

راجع CONTRIBUTING.md للإرشادات.

---

📖 التوثيق

• SETUP_GUIDE.md — التثبيت المفصل
• CONTRIBUTING.md — دليل التطوير
• TESTING.md — دليل الاختبار
• CHANGELOG.md — تاريخ الإصدارات

---

⚡ الأداء

• بدء التشغيل: < 1 ثانية
• الذاكرة: < 50MB
• الاستجابة: دفق (في الوقت الحقيقي)

---

🔒 الأمان

✅ تم تدقيق الأمان

• لا بيانات حساسة في Git
• مفاتيح API مشفرة في التكوين
• ملفات .env تم تجاهلها
• آمن للإنتاج

---

📄 الترخيص

ترخيص MIT — راجع LICENSE

---

🙏 الشكر

• استنادًا إلى كود Claude Code TypeScript
• مشروع تعليمي مستقل
• غير تابع لـ Anthropic

---