تتيح كل وكلاء البرمجة الشهيرة استبدال النموذج المستخدم في الخلفية، لكن كل وكيل يخفي الإعدادات في ملف مختلف، واسم مفتاح مختلف، وتنسيق URL مختلف. لذا يستسلم الكثيرون ويستمرون في دفع أسعار النماذج الرائدة، على الرغم من أن مستخدمي الوكلاء بكثافة يصلون إلى حوالي 13 دولاراً لكل مطور يومياً على النماذج الافتراضية (CloudZero, 2026). هذه الصفحة تعالج هذه المشكلة؛ فهي مرجع موحد يحتوي على إعدادات API المخصصة الدقيقة لـ Claude Code، وOpenClaw، وCodex، وOpenCode، وCursor، بالإضافة إلى التمييز الوحيد الذي يفسر كل الاختلافات بينها. احفظ هذه الصفحة، لأن القيمة هنا تكمن في كتل الأكواد الجاهزة للنسخ واللصق وتنبيهات الأخطاء، بعيداً عن الحشو. بحلول نهاية هذه الصفحة، ستتمكن من توجيه أي من هؤلاء الوكلاء نحو نموذج أرخص في غضون دقائق، وستفهم سبب تغير الـ URL من أداة إلى أخرى.
نقاط أساسية
- تنقسم وكلاء البرمجة إلى عائلتين من البروتوكولات. يعمل Claude Code ببروتوكول Anthropic API؛ بينما تعمل كل من OpenClaw، وCodex، وOpenCode، وCursor ببروتوكول متوافق مع OpenAI API.
- العلامة العملية هي الـ URL: الأدوات المتوافقة مع OpenAI تتطلب لاحقة /v1، بينما Claude Code لا يتطلب ذلك.
- تحتاج كل إعدادات إلى ثلاثة عناصر: رابط أساسي (base URL)، ومفتاح API، ومعرف النموذج (model ID). فقط أسماء الحقول هي التي تتغير.
- النماذج مفتوحة الأوزان هي الحل المربح: يعمل نموذج DeepSeek V4 Flash بتكلفة تقارب 0.14 دولار لكل مليون رمز (token) مدخل، مقارنة بعدة دولارات للنماذج الرائدة (Codersera, 2026).
لماذا تستحق ورقة الغش الخاصة بـ API وكلاء البرمجة عناءها؟
السبب الذي يدفعك للاهتمام هو التكلفة، والسبب هيكلي. يقوم الوكلاء بإعادة إرسال السياق المتراكم لديهم في كل خطوة استنتاجية، لذا فهم يستهلكون رموزاً (tokens) أكثر بـ 10 إلى 100 مرة من نافذة الدردشة العادية لنفس المهمة (LeanOps, 2026). هذا المضاعف هو سبب تضخم فواتير الوكلاء، وهو أيضاً السبب في أن إعادة تسعير الرموز -بدلاً من تقليل استخدام الوكيل- هو الإجراء الذي ينجح فعلياً. يوجه الـ API المخصص وكيلك نحو نظام خلفي (backend) أرخص دون تغيير طريقة عملك. وجه مهام البرمجة الروتينية إلى نموذج مفتوح الأوزان وستنخفض تكلفة الرمز بشكل حاد، وغالباً بنسبة 70% أو أكثر، بينما تظل فجوة الجودة في المهام اليومية صغيرة. أهمية ورقة الغش لـ API المخصص تكمن في أن الوفورات حقيقية، لكن صعوبة الإعداد هي ما يوقف معظم الناس، وهذه الصعوبة تتعلق فقط بـ "أي ملف، أي حقل، وأي URL".
كيف تعمل ورقة غش الـ API المخصص لوكلاء البرمجة؟
قبل البدء في الإعدادات، إليك الفكرة الوحيدة التي تجعل كل شيء منطقياً. تنقسم وكلاء البرمجة إلى عائلتين من البروتوكولات، والعائلة التي تنتمي إليها الأداة تحدد شكل إعداداتها.
يتواصل Claude Code مع Anthropic Messages API، لذا فهو يقرأ النظام الخلفي من ANTHROPIC_BASE_URL ويستخدم رمز توثيق بأسلوب Anthropic. أما بقية الأدوات في هذه الورقة -OpenClaw، وCodex، وOpenCode، وCursor- فهي تتواصل مع OpenAI-compatible Chat Completions API، لذا فهي تتطلب baseURL ومفتاحاً بأسلوب OpenAI، وتتوقع وجود مسار /v1 في النهاية. تفصيلة /v1 هذه هي السبب الأكثر شيوعاً لفشل الإعدادات دون ظهور رسائل خطأ.
بمجرد إدراك هذا التقسيم، ستجد أن كل إدخال أدناه هو نفس القيم الثلاث في صياغة مختلفة: رابط أساسي، ومفتاح، ومعرف نموذج. تستخدم الأمثلة Atlas Cloud كمزود لأنه يخدم كلتا عائلتي البروتوكولات من حساب واحد، لذا الشيء الوحيد الذي يتغير بين الأدوات هو الصياغة، وليس المفتاح الذي تلصقه. أي مزود متوافق يعمل بنفس الطريقة؛ فقط استبدل الرابط الأساسي والمفتاح.
ورقة غش API وكلاء البرمجة، أداة بأداة
إليك جدول المراجعة السريعة أولاً، ثم كتلة الإعداد الكاملة لكل أداة. جهز مفتاح الـ API الخاص بك قبل البدء. في Atlas Cloud، يمكنك إنشاء مفتاح عن طريق اختيار Coding Plan كنوع للمفتاح، مما يربطه بحصة البرمجة القائمة على الائتمان.
| الأداة | موقع الإعدادات | الرابط الأساسي (Base URL) | البروتوكول |
|---|---|---|---|
| Claude Code | ~/.claude/settings.json | https://api.atlascloud.ai | متوافق مع Anthropic |
| OpenClaw | ~/.openclaw/openclaw.json أو openclaw onboard | https://api.atlascloud.ai/v1 | متوافق مع OpenAI |
| Codex | ~/.codex/config.toml + auth.json | https://api.atlascloud.ai/v1 | متوافق مع OpenAI |
| OpenCode | ~/.config/opencode/opencode.json | https://api.atlascloud.ai/v1 | متوافق مع OpenAI |
| Cursor | الإعدادات، النماذج، الرابط الأساسي المخصص | https://api.atlascloud.ai/v1 | متوافق مع OpenAI |
Claude Code
يعد Claude Code الاستثناء في عائلة Anthropic، لذا لاحظ أن الرابط الأساسي لا يحتوي على /v1. قم بتحرير ملف ~/.claude/settings.json على macOS أو Linux، أو %USERPROFILE%.claude\settings.json على Windows:
plaintext1{ 2 "env": { 3 "ANTHROPIC_AUTH_TOKEN": "your-atlas-api-key", 4 "ANTHROPIC_BASE_URL": "https://api.atlascloud.ai", 5 "ANTHROPIC_MODEL": "zai-org/glm-5.1", 6 "ANTHROPIC_DEFAULT_HAIKU_MODEL": "zai-org/glm-5.1", 7 "ANTHROPIC_DEFAULT_SONNET_MODEL": "zai-org/glm-5.1", 8 "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1" 9 } 10}
ضبط الافتراضيات لـ Haiku وSonnet على نفس النموذج يوجه مكالمات Claude Code الخلفية الصغيرة إلى نموذجك أيضاً، بدلاً من الفشل بسبب نموذج افتراضي غير متاح.
OpenClaw
تعد OpenClaw الأسهل لأنها توفر معالج إعداد (wizard). في الجهاز (terminal)، قم بتشغيل openclaw onboard ثم اختر Yes، ثم QuickStart، ثم Custom Provider. أدخل الرابط الأساسي https://api.atlascloud.ai/v1 والصق مفتاحك، والصق معرف النموذج، واختر بروتوكول OpenAI-compatible. عندما تظهر رسالة Verification successful، قم بتسمية نقطة النهاية (endpoint) وبذلك تكون قد انتهيت. الشيء الذي يجب معرفته إذا قمت بتحرير ~/.openclaw/openclaw.json يدوياً: إعداد OpenClaw يتكون من خطوتين. تحدد المزود تحت models.providers ثم يجب عليك إضافة النموذج إلى القائمة المسموح بها تحت agents.defaults.models باستخدام المفتاح provider-name/model-name وإلا سيرفضه الوكيل (OpenClaw docs, 2026). الفشل في إضافة النموذج للقائمة هو السبب الرئيسي لخطأ "model not allowed". معالج الإعداد يقوم بالخطوتين نيابة عنك، وهذا هو سبب كونه المسار الموصى به.
Codex
تستخدم Codex ملفين. ضع المزود في ملف ~/.codex/config.toml:
plaintext1model_provider = "atlas_coding_plan" 2model = "zai-org/glm-5.1" 3 4[model_providers.atlas_coding_plan] 5name = "atlascloud" 6base_url = "https://api.atlascloud.ai/v1" 7wire_api = "chat" 8requires_openai_auth = true
ثم ضع المفتاح في ملف ~/.codex/auth.json:
plaintext1{ "OPENAI_API_KEY": "your-atlas-api-key" }
قم بتشغيل codex في الجهاز، وتجاوز مطالبة التحديث، وستكون متصلاً.
OpenCode وCursor
يقرأ OpenCode ملف ~/.config/opencode/opencode.json (على Windows: \Users\your-name.config\opencode\opencode.json):
plaintext1{ 2 "$schema": "https://opencode.ai/config.json", 3 "provider": { 4 "atlascloud": { 5 "npm": "@ai-sdk/openai-compatible", 6 "name": "atlascloud", 7 "options": { 8 "baseURL": "https://api.atlascloud.ai/v1", 9 "apiKey": "your-atlas-api-key" 10 }, 11 "models": { 12 "zai-org/glm-5.1": { "name": "glm-5.1" } 13 } 14 } 15 } 16}
لا يحتوي Cursor على ملف إعداد لهذا. افتح الإعدادات (Settings)، انتقل إلى النماذج (Models)، أضف معرف النموذج الخاص بك بالاسم، ثم اضبط الرابط الأساسي المخصص لـ OpenAI على https://api.atlascloud.ai/v1 والصق مفتاحك. نظراً لأن Cursor يتبع نمط توافق OpenAI، فإن الرابط الأساسي والمفتاح المستخدمان في الأدوات الأخرى سيعملان هنا دون تغيير.
اختيار نموذج: النصف الآخر من ورقة غش API المخصص لوكلاء البرمجة
ربط نقطة النهاية هو نصف المهمة فقط. النموذج الذي تختاره هو ما يحدد الوفورات. النمط الناجح هو الاعتماد على نموذج مفتوح قوي ورخيص للبرمجة اليومية، والاحتفاظ بنموذج رائد للمهام الاستنتاجية الأكثر صعوبة. فجوة القدرات أصغر من فجوة الأسعار: في اختبار SWE-Bench Pro، تسجل النماذج المفتوحة الرائدة في السبعينات العالية مقابل حوالي 91 لأفضل النماذج الرائدة (Codersera, 2026)، وهو فارق يكاد لا يظهر في العمل الروتيني وإعادة بناء الأكواد (refactors).
بالنسبة للمزود القائم على الائتمان، لكل نموذج مضاعف يربط استهلاك الرموز بالاعتمادات، لذا من السهل قراءة التكلفة النسبية:
| معرف النموذج | السياق (Context) | مضاعف الإدخال | مضاعف الإخراج | الوفورات التقريبية مقابل السعر الرسمي |
|---|---|---|---|---|
| deepseek-ai/deepseek-v4-flash | 1M | 0.23 | 0.46 | ~50% |
| deepseek-ai/deepseek-v3.2 | 160K | 0.42 | 0.62 | ~55% |
| minimaxai/minimax-m2.5 | 200K | 0.65 | 2.18 | ~45% |
| moonshotai/kimi-k2.6 | 262K | 1.72 | 7.26 | ~45% |
| zai-org/glm-5.1 | 200K | 2.54 | 7.99 | ~45% |
| المصدر: قواعد ائتمان Atlas Cloud Coding Plan. تكلفة الائتمان = الرموز المدخلة × مضاعف الإدخال + الرموز المخرجة × مضاعف الإخراج. | ||||
| الاختيار الافتراضي العملي: GLM-5.1 أو Kimi K2.6 للبرمجة التفاعلية، وDeepSeek V4 Flash للمهام ذات الحجم الكبير أو المهام الخلفية، واستخدام نموذج رائد فقط للمهمة النادرة التي لا تستطيع النماذج المفتوحة حلها. التبديل يتم بتغيير سطر واحد لمعرف النموذج في أي من الإعدادات أعلاه. |
مفتاح API واحد عبر كل وكيل برمجة
لاحظ ما يظهره جدول ورقة الغش بهدوء: نفس المفتاح ونفس معرفات النماذج تظهر في كل إعداد. هذه هي الحجة الحقيقية لمزود موحد. إذا قمت بربط كل أداة بمزود مختلف، سينتهي بك الأمر بمفاتيح منفصلة، ولوحات تحكم منفصلة، وفواتير منفصلة، وستفقد الرؤية الموحدة للإنفاق. توجيههم جميعاً إلى مزود واحد يدمج ذلك في رصيد ائتماني واحد ومكان واحد لتبديل النماذج. هذا يسهل عملية وضع الميزانية، وهو أمر يصعب تحقيقه مع الفواتير القائمة على الرموز. الخطة التي تجدد رصيد ائتماني يومي ثابت عند منتصف الليل تضع سقفاً للأضرار الناتجة عن حلقة وكيل خارجة عن السيطرة، بينما تستوعب باقات الدفع حسب الاستخدام أي زيادة عرضية. تبدأ خطط Atlas Cloud من 10 دولارات شهرياً، وتوفر باقات الدفع حسب الاستخدام خصماً بنسبة 41%، ويتم احتساب الترقيات في منتصف الدورة بشكل تناسبي، لذا فإن الانتقال إلى مستوى أعلى يكلف فقط الفرق وليس تكلفة خطة جديدة بالكامل.
ورقة غش API المخصص لوكلاء البرمجة: أخطاء شائعة
تعتمد معظم الإعدادات الفاشلة تقريباً على أحد هذه الأخطاء، وكلها سهلة الإصلاح. الخلط في /v1. الخطأ الأكثر تكراراً في هذه الورقة. الأدوات المتوافقة مع OpenAI تريد لاحقة /v1؛ أما Claude Code فلا. عادة ما يعني خطأ الاتصال أن المسار خاطئ بالنسبة لعائلة الأداة. استخدام نوع مفتاح خاطئ. مفتاح المزود الخاص بك ليس هو مفتاح Anthropic، والعكس صحيح. لصق المفتاح الخاطئ سيؤدي إلى خطأ في التوثيق يبدو أكثر تعقيداً مما هو عليه في الواقع. تخطي القائمة المسموح بها في OpenClaw. تحديد المزود هو نصف إعداد OpenClaw فقط. إذا رأيت "model not allowed"، فهذا يعني أن النموذج مفقود من القائمة أو أن مفتاح provider-name/model-name يحتوي على خطأ إملائي. ترك النماذج الخلفية دون ضبط في Claude Code. إذا قمت بضبط النموذج الرئيسي فقط وتركت إعدادات Haiku وSonnet الافتراضية تشير إلى نماذج غير متاحة، ستفشل المكالمات الخلفية الصغيرة. اضبط الثلاثة جميعاً.
الأسئلة الشائعة: ورقة غش API المخصص لوكلاء البرمجة
هل تتطلب ورقة غش API المخصص تغيير الأدوات؟
لا. الهدف بالكامل هو أن تستمر في استخدام الوكيل الذي تستخدمه بالفعل، سواء كان Claude Code، أو OpenClaw، أو Codex، أو OpenCode، أو Cursor. الـ API المخصص هو تغيير في الإعدادات وليس ترحيلاً، لذا تظل سير عملك متطابقة بينما يتغير النظام الخلفي والفاتورة.
لماذا يتغير الرابط الأساسي في ورقة غش API المخصص لكل أداة؟
بسبب عائلة البروتوكول. يستخدم Claude Code بروتوكول Anthropic API ويأخذ النطاق (domain) المجرد، بينما تتوقع الأدوات المتوافقة مع OpenAI مسار /v1. نفس المزود، نفس المفتاح، مسار مختلف. هذا الاختلاف الوحيد يفسر معظم الإعدادات الفاشلة.
كم يمكن أن توفر لي ورقة غش API المخصص لوكلاء البرمجة؟
الكثير، اعتماداً على النموذج. يعمل DeepSeek V4 Flash بتكلفة تقارب 0.14 دولار لكل مليون رمز مدخل مقابل عدة دولارات للنماذج الرائدة (Codersera, 2026)، لذا فإن إرسال العمل الروتيني إلى نموذج مفتوح غالباً ما يقلل فاتورة الرموز بنسبة 70% أو أكثر دون تغيير طريقة برمجتك.
بأي نموذج يجب أن أبدأ من ورقة غش API المخصص؟
للبرمجة التفاعلية، يعتبر GLM-5.1 أو Kimi K2.6 خيارات افتراضية قوية وبأسعار معقولة. للمهام ذات الحجم الكبير أو المهام الخلفية، يعتبر DeepSeek V4 Flash أرخص. احتفظ بنموذج رائد للاستخدام عند الضرورة فقط للمهام التي لا يستطيع النموذج المفتوح التعامل معها.
هل إعداد ورقة غش API المخصص قابل للتراجع؟
نعم. كل إعداد قابل للتراجع. استعد الرابط الأساسي الأصلي أو قم بإزالة كتلة المزود، وسيعود الوكيل للإشارة إلى وضعه الافتراضي. يحتفظ العديد من المطورين بكلا الإعدادين ويقومون بالتبديل بناءً على المهمة.
الخلاصة
السبب في أن ورقة غش API المخصص لوكلاء البرمجة تستحق الاحتفاظ بها هو أن الجزء الصعب لم يكن المفهوم قط، بل تذكر أي ملف وأي URL تريده كل أداة. بمجرد رؤية عائلتي البروتوكولات، ستجد أن كل إعداد هو مجرد رابط أساسي ومفتاح ومعرف نموذج بنفس الصياغة المختلفة. اختر نموذجاً مفتوح الأوزان، والصق الكتلة الصحيحة، وانتبه لقاعدة /v1؛ وستحتفظ بالوكيل الذي تحبه بينما تدفع جزءاً بسيطاً من أسعار النماذج الرائدة. إذا كنت تريد مفتاحاً واحداً وميزانية واحدة عبرهم جميعاً، يمكنك إعداد ذلك من خلال وحدة تحكم Atlas Cloud Coding Plan وتبديل النماذج كلما تغيرت المهمة.
