MCP

نقطة القيادة codex-cc-orchestrator: توزيع مهام Codex على Claude Code للتنفيذ والمراجعة

نقطة القيادة مناسبة على أفضل وجه لجعل Codex يوزّع مهام البرمجة على Claude Code للتنفيذ والمراجعة بواسطة جلسة قراءة فقط مستقلة، بشرط تمرير project_root موثوق صراحةً وتجهيز وكيلي Codex و Claude Code معًا.

Official source · 点将台 codex-cc-orchestrator

Install

git clone https://github.com/zjgxkj/codex-cc-orchestrator.git && cd codex-cc-orchestrator && git checkout v0.4.0 && uv sync

نقطة القيادة (codex-cc-orchestrator) مناسبة للسيناريوهات التي تحتاج فيها إلى أن يوزّع وكيل رئيسي (Agent) المهام على منفّذ، ثم يقوم بجلسة قراءة فقط مستقلة بمراجعتها. أهم نقطة قبل البدء: يجب أن تكون لديك أداتا Codex و Claude Code مثبتتان ومعرّفتان معًا كوكيلين محليين، ويجب تمرير project_root موثوق صراحةً لكل مهمة؛ فالخدمة لا تخمّن مساحة العمل بناءً على المجلد الحالي.

لمن هذه الأداة

  • المستخدمون الذين يستخدمون Codex بالفعل ولديهم Claude Code مثبّت، ويرغبون في توزيع المهام عبر MCP على Claude Code للتنفيذ والمراجعة، لتحقيق تنسيق تعاون متعدد الطبقات.
  • سير عمل التطوير التي تحتاج إلى توزيع المهام، والتنفيذ، ومتابعة التشغيل، والمراجعة المستقلة، وضغط النتائج، وتسجيل الاستخدام.
  • غير مناسب لـ: من لا يملك بيئتي Codex و Claude Code معًا؛ لم توضّح الأدلة إمكانية استخدام أحد الطرفين بمفرده، لذا يُرجى الرجوع إلى الوثائق الرسمية.
  • المتطلبات المسبقة: يحتاج جهازك إلى Python 3.13+ وأداة uv. خطوات التثبيت الكاملة (بالصينية) موجودة في ملف INSTALL.md الرسمي.

أول تجربة في 3 دقائق

المتطلبات: Python 3.13+، وأداة uv، و Codex و Claude Code مُعدّتان مسبقًا.

  1. الحصول على الأداة وتثبيتها (المسار الرسمي الرئيسي):
git clone https://github.com/zjgxkj/codex-cc-orchestrator.git
cd codex-cc-orchestrator
git checkout v0.4.0
uv sync
  1. تسجيل الخدمة في إعدادات STDIO MCP الخاصة بـ Codex (مثال رسمي على Windows):
[mcp_servers.codex-claude-agent]
command = 'D:\path\to\codex-claude-agent-mcp\.venv\Scripts\python.exe'
args = ['-m', 'codex_claude_agent_mcp']
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 7200
  1. إجراء تجربة أولى منخفضة المخاطر: توفّر الخدمة أداة ping، واستخدمها للتأكد من اتصال قناة MCP دون أي كتابة على الملفات. إشارة النجاح هي أن Codex يستطيع سرد أدوات الخدمة واستلام رد ping. لاحظ أن stdout مخصص لرسائل بروتوكول MCP فقط، أما السجلات والأخطاء فتظهر في stderr؛ فعند تشخيص مشاكل بدء التشغيل راقب stderr.

تنفيذ المهام الحقيقية (مثل execute_task) مسألة مختلفة: يجب تمرير project_root موثوق صراحةً، وستقرأ العملية الملفات وتكتبها داخل هذا المجلد؛ فهي ليست عملية قراءة فقط، لذا تأكد من مجلد المشروع المستهدف قبل الاستدعاء.

أمثلة الاستخدام

المثال الأول: توزيع وتنفيذ مهمة برمجية. استدعِ execute_task من جلسة Codex، مع تمرير وصف المهمة ومجلد project_root الذي تسمح به صراحةً. تستخدم جلسة المنفّذ مجموعة أدوات مقيّدة (Read/Grep/Glob/Edit/Write/Bash، مع السماح بالاتصال بالإنترنت ومنع الوكلاء المتداخلين وتحرير الـ notebook) لإتمام التعديلات. النتيجة المتوقعة: تنفيذ المهمة وحفظ حالتها في قاعدة بيانات SQLite محلية (~/.codex-claude-agent-mcp/state.db).

المثال الثاني: المراجعة المستقلة ومتابعة التشغيل. استدعاء review_task يؤدي إلى مراجعة نتيجة التنفيذ بواسطة جلسة قراءة فقط جديدة تمامًا، وتعطي حكم PASS/FAIL؛ وإذا كانت النتيجة FAIL، يمكنك استدعاء continue_task للمتابعة مع التعليقات بناءً على جلسة التنفيذ المحفوظة. النتيجة المتوقعة: المراجعة القراءة فقط لا تغيّر الملفات، ومتابعة التشغيل تعيد استخدام سياق الجلسة. يمكنك أيضًا استخدام run_job / run_jobs لتنسيق مهام متعددة، و get_job_status للاستعلام عن التقدم.

حدود الاستخدام

  • طبيعة القراءة والكتابة: ping فحص اتصال للقراءة فقط؛ بينما تكتب execute_task و run_job و run_jobs ملفات داخل project_root، أي أنها آثار جانبية حقيقية، فتأكد من صحة المجلد قبل الاستدعاء؛ وتُجرى مراجعة review_task بواسطة جلسة قراءة فقط.
  • التخويل: يمكن لكل مهمة استقبال project_root، ويجب أن يمرّر Codex جذر مساحة العمل الموثوق صراحةً؛ فالخدمة لا تخمّنه من مجلد العمل الحالي لعملية الخدمة نفسها. و ALLOWED_PROJECT_ROOTS قائمة ثقة طويلة الأمد اختيارية.
  • الحالة المحلية: تُحفظ حالة جلسات التنفيذ وغيرها في ~/.codex-claude-agent-mcp/state.db. لم توضّح الجهة الرسمية مسارًا لحذف هذه الحالة أو إبطالها.
  • قيود التزامن: CLAUDE_MAX_CONCURRENCY (الافتراضي 4) يسري على عملية خادم MCP واحدة فقط.
  • ملاحظة "قراءة فقط" للأداة تعني فقط أنها لا تنفّذ عمليات كتابة، ولا تعني أنها لن تتصل بالإنترنت أو أنها خالية من حدود الخصوصية؛ الأجزاء التي لم توضّحها الوثائق الرسمية (مثل تفاصيل إدارة بيانات الاعتماد) لا ينبغي اعتبارها خالية من المخاطر.