Claude Code CLI

Claude Code هو وكيل البرمجة الذكي الرسمي من Anthropic — يعمل في الطرفية ويتيح لك كتابة الكود وتصحيحه وإعادة هيكلته بلغة طبيعية.

الخطوة 1 — تثبيت Node.js

تخطّ هذه الخطوة إن كان مثبّتًا لديك؛ تحقّق بـ node -v.

تحتاج إلى Node.js 18+ — للتنزيل: https://nodejs.org/en/download

# Verify after installing
node -v
# A version number (e.g. v24.4.1) means it installed correctly

# During install, check "Automatically install the necessary tools"
# Reopen PowerShell after installing and verify
node -v

الخطوة 2 — تثبيت Claude Code

npm install -g @anthropic-ai/claude-code

npm install -g @anthropic-ai/claude-code

تحقّق من التثبيت:

claude --version

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

الخطوة 3 — ضبط واجهة LMU AI API

يضبط Claude Code نقطة نهاية API مخصّصة عبر settings.json.

موقع ملف الإعداد

~/.claude/settings.json

C:\Users\YourUsername\.claude\settings.json

إنشاء ملف الإعداد

mkdir -p ~/.claude && touch ~/.claude/settings.json

mkdir "$env:USERPROFILE\.claude" -Force
New-Item "$env:USERPROFILE\.claude\settings.json" -Force

كتابة الإعداد

افتح settings.json في محرّر نصوص وأضف ما يلي (استبدل المفتاح بمفتاحك):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lmuai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-lmu-ai-api-key",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

تفعيل سياق المليون رمز في Claude Code (اختياري)

يدعم Claude Opus 4.8 / Sonnet 5 نافذة سياق طويلة بمليون رمز (200K افتراضيًا)، وهي مفيدة للمستودعات الضخمة والسجلات الطويلة وعمليات إعادة الهيكلة عبر الملفات. أضِف لاحقة [1M] إلى معرّف النموذج لتفعيلها.

الخيار أ — التبديل اليدوي بـ /model (يُنصح به للاستخدام العرضي)

احتفظ بـ settings.json بالحد الأدنى (فقط ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN)، وشغّل Claude Code، ثم اكتب في الموجّه:

/model claude-opus-5[1M]

أو:

/model claude-sonnet-5[1M]

يؤدّي هذا إلى التبديل إلى نسخة المليون رمز دون تغييرات في الإعداد. ينطبق على الجلسة الحالية ويعود إلى الوضع الافتراضي عند الخروج.

الخيار ب — إعداد افتراضي دائم في settings.json (يُنصح به للاستخدام اليومي للسياق الطويل)

أضِف سطرين إلى قسم env من settings.json بحيث يستخدم /model opus / /model sonnet نسخة المليون رمز افتراضيًا:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lmuai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-lmu-ai-api-key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5[1M]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5[1M]",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

احفظ وأعِد تشغيل Claude Code؛ يستخدم اختيار opus / sonnet في الأمر /model الآن نسخة المليون رمز تلقائيًا.

مرجع الحقول

استخدام النماذج الصينية (اختياري)

يدعم LMU AI نماذج LLM الصينية (مثل سلسلة Qwen). بضبط model في settings.json، تتخطّى التبديل اليدوي بـ /model عند كل تشغيل وتستخدم النموذج المحدّد مباشرة.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lmuai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-lmu-ai-api-key",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  },
  "model": "qwen3.8-max-preview",
  "effortLevel": "medium"
}

مرجع الحقول:

الخطوة 4 — تشغيل Claude Code

افتح طرفية في مجلد مشروعك وشغّل:

claude

وضع بلا موافقة (يُنصح به)

claude --dangerously-skip-permissions

في هذا الوضع يشغّل Claude Code الأوامر تلقائيًا دون تأكيد كل خطوة — مفيد داخل مجلد مشروع.

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

بعد التشغيل، اكتب في واجهة Claude Code:

/status

يعرض ما يلي حاليًا:

• اسم النموذج
• عنوان API Base URL (يجب أن يظهر https://api.lmuai.com)
• حالة مفتاح API

إن كان Base URL صحيحًا، فالإعداد يعمل.

المشاكل الشائعة

401 Unauthorized

السبب: مفتاح API خاطئ، أو أن الطلب ما زال يذهب إلى نقطة نهاية Anthropic الرسمية.

الحل:

1. تأكّد أن ANTHROPIC_AUTH_TOKEN في settings.json هو مفتاح LMU AI الخاص بك
2. تحقّق مما إذا كان متغيّر بيئة في الصدفة يتجاوز الإعداد

echo $ANTHROPIC_BASE_URL

echo $env:ANTHROPIC_BASE_URL

3. أعِد فتح الطرفية، ثم شغّل Claude Code مرة أخرى

stream disconnected

السبب: شبكة محلية غير مستقرة، أو تفعيل VPN / وكيل / وكيل النظام — تدوير الوكيل لعنوان IP يقطع الاتصال.

الحل: أوقف VPN / الوكيل / وكيل النظام وأعِد المحاولة. يتصل LMU AI مباشرةً داخل الصين ولا يحتاج إلى VPN؛ الاتصال المباشر هو الأسرع والأكثر استقرارًا.

503 No available accounts

السبب: عادةً يضبط ~/.zshrc أو ~/.bashrc متغيّرات بيئة عامة مثل ANTHROPIC_AUTH_TOKEN / ANTHROPIC_BASE_URL، والتي تتجاوز settings.json.

الحل: احذف تلك الأسطر من إعداد الصدفة، أو انقلها إلى ملف منفصل تستدعيه بـ source فقط عند تشغيل Claude Code. راجع الأسئلة الشائعة · المشكلة 6.

انتهاء مهلة الاستجابة

السبب: المهلة الافتراضية قصيرة.

الحل: تأكّد من ضبط API_TIMEOUT_MS على 3000000 (50 دقيقة) حتى لا تُقطع المهام الطويلة.

نصائح

• شغّل Claude Code من جذر المشروع كي يلتقط بنية المشروع تلقائيًا
• مرّر تعليمة مباشرة، مثل claude "refactor this function for me"
• Ctrl+C يقاطع المهمة الحالية، و/exit يخرج
• اكتب ? أو /help لرؤية كل الأوامر

استخدام /goal لجعل Claude Code يعمل حتى تحقيق الهدف (اختياري)

/goal أمر شرطة مائلة مدمج في Claude Code (متاح منذ v2.1.139، مايو 2026) يضبط شرط إنجاز للجلسة الحالية. بمجرد ضبطه، يواصل Claude العمل عبر الأدوار من تلقاء نفسه حتى يُحكَم بأن الشرط قد تحقق، بدلًا من التوقف عندما "يبدو الأمر منجزًا". وهو مفيد بشكل خاص على LMU AI للمهام الطويلة التي تعمل حتى الاكتمال (إعادة هيكلة المستودعات الكبيرة، أو التنفيذ وفق مواصفة قبول، أو تصفية تراكم المشكلات).

الإصدارات الأقدم لا تحتوي على هذا الأمر. إن أبلغ عن أمر غير معروف، فرقِّ Claude Code إلى أحدث إصدار أولًا.

الاستخدام الأساسي

للجلسة هدف واحد فقط في المرة الواحدة؛ تعيين هدف جديد يستبدل القديم ويبدأ دورًا جديدًا فورًا.

كيف يحكم على "تحقّق"

في نهاية كل دور، يُسلّم Claude Code شرط الإنجاز الخاص بك + محادثة هذا الدور إلى نموذج صغير وسريع (Haiku افتراضيًا) ليحكم. ينظر الحاكم فقط إلى الأدلة الموجودة أصلًا في المحادثة — مخرجات الاختبارات، وسجلات البناء، وفروق الملفات — ولن يعيد تشغيل CI بالكامل من وراء ظهرك. لذا اكتب الشرط بصيغة يستطيع Claude فيها "إنتاج أدلة" داخل المحادثة.

يُمسح الهدف تلقائيًا في أيٍّ من الحالات التالية:

• الحكم بأن الشرط قد تحقق؛
• حُكم النموذج بأن الشرط مستحيل التحقّق؛
• اصطدام دور بخطأ يتطلّب تدخّلك.

كتابة شرط هدف جيّد

• استخدم حالة نهائية قابلة للتحقق: مثل "خروج npm test بالرمز 0"، أو "tsc --noEmit لا يُبلغ عن أخطاء" — لا أوصافًا ذاتية مثل "اجعل الكود أجمل"؛
• دع الأدلة تظهر في المحادثة: اطبع نتائج الاختبار / البناء في كل دور كي يراها النموذج الحاكم؛
• حدّد نطاقه + قيّد الأدوار: مثل "غيّر فقط الملفات ضمن src/auth/، وتوقّف بعد 20 دورًا كحد أقصى" لتجنّب الدوران في المكان؛
• يتطلّب مساحة عمل موثوقة (مع تفعيل الخطافات) ليصبح فعّالًا.

آخر تحديث: 2026-09-10