ورقة غش واجهة برمجة التطبيقات (API) المخصصة لوكلاء البرمجة: انسخ والصق الإعدادات لتقليل فاتورة التوكن الخاصة بك

تتيح كل وكلاء البرمجة (Coding Agents) الشائعة إمكانية استبدال النموذج المستخدم فيها، لكن كل أداة تخفي هذا الإعداد في ملف مختلف، وباسم مفتاح مختلف، وتنسيق رابط (URL) مختلف. لذا يستسلم الكثيرون ويستمرون في دفع أسعار النماذج الرائدة، على الرغم من أن مستخدمي الوكلاء المكثفين يصلون إلى حوالي 13 دولاراً لكل يوم عمل مطور نشط على النماذج الافتراضية (CloudZero, 2026). هذه الصفحة تعالج هذه المشكلة؛ فهي مرجع موحد يحتوي على إعدادات API المخصصة الدقيقة لكل من Claude Code، وOpenClaw، وCodex، وOpenCode، وCursor، بالإضافة إلى التمييز الوحيد الذي يفسر كل الاختلافات بينها. احتفظ بهذه الصفحة في مفضلتك، لأن القيمة هنا تكمن في كتل النصوص القابلة للنسخ واللصق والتنبيهات، وليس في الحشو. بحلول نهاية قراءتك، ستكون قادراً على توجيه أي من هذه الوكلاء إلى نموذج أرخص في غضون دقائق، وستفهم سبب تغير الرابط من أداة إلى أخرى.

النقاط الرئيسية

• تنقسم وكلاء البرمجة إلى عائلتين من البروتوكولات. يتحدث Claude Code بروتوكول Anthropic API؛ بينما تتحدث OpenClaw وCodex وOpenCode وCursor بروتوكول OpenAI المتوافق.
• العلامة العملية هي الرابط: الأدوات المتوافقة مع OpenAI تتطلب لاحقة /v1 في الرابط، بينما Claude Code لا يتطلب ذلك.
• كل إعداد يحتاج إلى ثلاثة أشياء: رابط أساسي (Base URL)، ومفتاح API، ومعرف النموذج (Model ID). فقط أسماء الحقول هي التي تتغير.
• النماذج مفتوحة الأوزان (Open-weight) هي المكسب الحقيقي: يعمل DeepSeek V4 Flash بتكلفة تقارب 0.14 دولار لكل مليون رمز (Token) مقارنة بعدة دولارات للنماذج الرائدة (Codersera, 2026).

لماذا تستحق صفحة "غش" إعدادات API المخصصة لوكلاء البرمجة ثمنها؟

السبب في تكبد عناء هذا الأمر هو التكلفة، والسبب بنيوي. يعيد الوكلاء إرسال سياقهم المتراكم في كل خطوة استنتاجية، لذا فهم يستهلكون رموزاً (Tokens) أكثر بـ 10 إلى 100 مرة من نافذة الدردشة لنفس المهمة (LeanOps, 2026). هذا المضاعف هو سبب تضخم فواتير الوكلاء، وهو أيضاً السبب في أن إعادة تسعير الرموز، بدلاً من تقليل استخدام الوكيل، هو الإجراء الفعال حقاً. يوجه الـ API المخصص وكيلك إلى نظام خلفي أرخص دون تغيير طريقة عملك. وجه أعمال البرمجة الروتينية إلى نموذج مفتوح الأوزان وستنخفض تكلفة الرمز الواحد بشكل حاد، وغالباً بنسبة 70% أو أكثر، بينما تظل فجوة الجودة في المهام اليومية صغيرة. أهمية صفحة غش إعدادات API المخصصة تكمن في أن التوفير حقيقي، ولكن صعوبة الإعداد هي ما يوقف معظم الناس، وهذه الصعوبة تتعلق بالكامل بـ "أي ملف، وأي حقل، وأي رابط".

كيف تعمل إدخالات صفحة غش إعدادات 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 كنوع للمفتاح، مما يربطه بحصة البرمجة القائمة على الرصيد.

Claude Code

Claude Code هو الاستثناء في عائلة Anthropic، لذا لاحظ أن الرابط الأساسي لا يحتوي على /v1. قم بتحرير ~/.claude/settings.json على macOS أو Linux، أو %USERPROFILE%.claude\settings.json على Windows:

JSONCopy
1{
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، امنح اسماً لنقطة النهاية وستكون قد انتهيت. الشيء الذي يجب معرفته إذا قمت بتحرير ~/.openclaw/openclaw.json يدوياً: إعداد OpenClaw يتم على خطوتين. أنت تحدد المزود تحت models.providers ثم يجب عليك إضافة النموذج إلى القائمة المسموح بها (Allowlist) تحت agents.defaults.models باستخدام المفتاح provider-name/model-name وإلا سيرفضه الوكيل (OpenClaw docs, 2026). الفشل في إضافته للقائمة المسموح بها هو السبب الأول لخطأ "model not allowed". يقوم المعالج بتنفيذ كلتا الخطوتين نيابة عنك، ولهذا السبب نوصي باستخدامه.

Codex

تستخدم Codex ملفين. ضع المزود في ~/.codex/config.toml:

TOMLCopy
1model_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:

JSONCopy
1{ "OPENAI_API_KEY": "your-atlas-api-key" }

قم بتشغيل codex في طرفيتك، وتجاوز مطالبة التحديث، وستكون متصلاً.

OpenCode وCursor

يقرأ OpenCode ملف ~/.config/opencode/opencode.json (على ويندوز، \Users\your-name.config\opencode\opencode.json):

JSONCopy
1{
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 على ملف إعدادات لهذا الغرض. افتح الإعدادات، انتقل إلى "النماذج" (Models)، أضف معرف النموذج الخاص بك بالاسم، ثم اضبط الرابط الأساسي المخصص لـ OpenAI على https:​//api.atlascloud.ai/v1 والصق مفتاحك. نظراً لأن Cursor تتبع نمط OpenAI، فإن نفس الرابط الأساسي والمفتاح المستخدمين في الأدوات الأخرى يعملان دون تغيير.

---

اختيار نموذج: النصف الآخر من صفحة غش إعدادات API المخصصة

توصيل نقطة النهاية هو نصف المهمة فقط. النموذج الذي تختاره هو الذي يحدد التوفير. النمط الفعال هو الاعتماد افتراضياً على نموذج مفتوح قوي ورخيص للبرمجة اليومية، والاحتفاظ بنموذج رائد للطوارئ للمهام الاستنتاجية الأكثر صعوبة. فجوة القدرات أصغر من فجوة السعر: في اختبار SWE-Bench Pro، تسجل النماذج المفتوحة الرائدة في السبعينات العالية مقابل 91 تقريباً للنماذج الرائدة (Codersera, 2026)، وهو فرق يكاد لا يُذكر في مهام الميزات الروتينية وإعادة الهيكلة. بالنسبة لمزود يعتمد على الرصيد، لكل نموذج مضاعف يربط استخدام الرموز بالرصيد، لذا فإن التكلفة النسبية سهلة القراءة:

المصدر: قواعد رصيد خطة برمجة Atlas Cloud. تكلفة الرصيد = رموز الإدخال × مضاعف الإدخال + رموز الإخراج × مضاعف الإخراج. الخيار الافتراضي العملي: 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 المخصص هو تغيير في الإعدادات، وليس ترحيلاً، لذا تظل سير عملك متطابقاً بينما يتغير النظام الخلفي والفاتورة.

لماذا يتغير الرابط الأساسي في صفحة الغش لكل أداة؟

بسبب عائلة البروتوكول. يستخدم Claude Code واجهة Anthropic API ويأخذ النطاق المجرد، بينما تتوقع الأدوات المتوافقة مع OpenAI مسار /v1. نفس المزود، نفس المفتاح، مسار مختلف. هذا الاختلاف الوحيد يفسر معظم حالات فشل الإعداد.

كم يمكن أن توفر صفحة غش إعدادات API المخصصة لك؟

الكثير، اعتماداً على النموذج. يعمل DeepSeek V4 Flash بما يقارب 0.14 دولار لكل مليون رمز إدخال مقابل عدة دولارات للنماذج الرائدة (Codersera, 2026)، لذا فإن إرسال العمل الروتينى إلى نموذج مفتوح يقلل عادةً من فاتورة الرموز بنسبة 70% أو أكثر دون تغيير طريقة برمجتك.

بأي نموذج يجب أن أبدأ من صفحة غش إعدادات API المخصصة؟

للبرمجة التفاعلية، يعتبر GLM-5.1 أو Kimi K2.6 خيارات افتراضية قوية وبأسعار معقولة. للمهام ذات الحجم الكبير أو الخلفية، يعتبر DeepSeek V4 Flash أرخص. احتفظ بنموذج رائد للطوارئ فقط للمهام التي لا يمكن للنموذج المفتوح التعامل معها بصدق.

هل إعداد صفحة غش إعدادات API المخصصة قابل للتراجع؟

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

الخلاصة

السبب الذي يجعل صفحة غش إعدادات API المخصصة تستحق الاحتفاظ بها هو أن الجزء الصعب لم يكن المفهوم أبداً، بل كان تذكر أي ملف وأي رابط تريده كل أداة. بمجرد رؤية عائلتي البروتوكولات، ستجد أن كل إعداد هو نفس الرابط الأساسي، والمفتاح، ومعرف النموذج بصياغة مختلفة. اختر نموذجاً مفتوح الأوزان، الصق الكتلة الصحيحة، وانتبه لقاعدة /v1، وستحتفظ بالوكيل الذي تحبه بينما تدفع جزءاً بسيطاً من أسعار النماذج الرائدة. إذا كنت تريد مفتاحاً واحداً وميزانية واحدة عبرهم جميعاً، يمكنك إعداد ذلك من خلال وحدة تحكم خطة برمجة Atlas Cloud وتبديل النماذج وقتما تتغير المهمة.