Claude Code

يتحدث Claude Code أصلًا صيغة Anthropic : يكفي توجيهه نحو https://api.cloudzir.com/anthropic وتحديد أي نموذج Mina يستجيب لأي مستوى. بلا أي إضافة (plugin)، بلا أي تعديل في شيفرة الوكيل.

المتطلبات المسبقة#

• Node.js 18 أو أحدث.
• Claude Code : npm install -g @anthropic-ai/claude-code
• مفتاح zir_ai_… ومحفظة مشحونة.

الإعداد#

export ANTHROPIC_BASE_URL="https://api.cloudzir.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="zir_ai_..."
export ANTHROPIC_MODEL="mina-full"
export ANTHROPIC_DEFAULT_OPUS_MODEL="mina-full"
export ANTHROPIC_DEFAULT_SONNET_MODEL="mina-full"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="mina-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="mina-flash"

cd mon-projet
claude

$env:ANTHROPIC_BASE_URL = "https://api.cloudzir.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "zir_ai_..."
$env:ANTHROPIC_MODEL = "mina-full"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "mina-full"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "mina-full"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "mina-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL = "mina-flash"

cd mon-projet
claude

set ANTHROPIC_BASE_URL=https://api.cloudzir.com/anthropic
set ANTHROPIC_AUTH_TOKEN=zir_ai_...
set ANTHROPIC_MODEL=mina-full
set ANTHROPIC_DEFAULT_OPUS_MODEL=mina-full
set ANTHROPIC_DEFAULT_SONNET_MODEL=mina-full
set ANTHROPIC_DEFAULT_HAIKU_MODEL=mina-flash
set CLAUDE_CODE_SUBAGENT_MODEL=mina-flash

cd mon-projet
claude

إعداد دائم#

لتفادي تكرار هذه المتغيرات في كل جلسة، ضعوها في ملف إعدادات Claude Code (~/.claude/settings.json، أو .claude/settings.json لمشروع واحد فقط) :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.cloudzir.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "zir_ai_...",
    "ANTHROPIC_MODEL": "mina-full",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "mina-full",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "mina-full",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "mina-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "mina-flash"
  }
}

اختيار نماذج Mina#

تقبل متغيرات النموذج أعلاه معرّفات Mina mina-flash وmina-low وmina-full. تُعيد GET /anthropic/v1/models قائمة النماذج المفعّلة لمفتاحكم. أما أسماء المتغيرات فهي جزء من إعداد العميل.

التحقق من عمل الإعداد#

في Claude Code، اطلبوا مثلًا «اعرض ملفات المشروع ولخّص البنية». ثم تحققوا في Usage من ظهور طلبات /anthropic/v1/messages مع تكلفتها.

نصائح الاستخدام والتكلفة#

• الوكلاء الفرعيون بـmina-flash : مهام البحث/القراءة تمثل معظم الحجم، ولا تحتاج إلى النموذج الأغلى.
• راقبوا السياق : يعيد وكيل برمجي كل التاريخ في كل جولة. ابدؤوا جلسة نظيفة بين مهمتين غير مرتبطتين.
• حدّدوا تنبيه رصيد : جلسة وكيل طويلة قد تستهلك مئات آلاف الرموز.

القيود المعروفة#

• cache_control مقبول ودون أثر: التخزين المؤقت تلقائي، لا شيء يُوسَم يدويًا.
• الحقل thinking مُعتمَد (وضع التفكير): إيقاف الاستدلال يسرّع بشكل ملحوظ مهام الوكيل البسيطة.