تثبيت Claude Code على ويندوز: الخطوات ومفتاح API وحل الأخطاء

لتثبيت Claude Code على ويندوز، افتح PowerShell وشغّل أداة التثبيت من Anthropic: irm https://claude.ai/install.ps1 | iex. ثم افتح طرفية جديدة وتحقق من التثبيت بالأمر claude --version. تحتاج إلى ويندوز 10 أو 11 بنظام 64 بت، ولا تحتاج إلى صلاحيات المسؤول. بعدها سجّل الدخول باشتراك Claude، أو ضع مفتاح API وعنوان الأساس في ملف إعدادات Claude Code.

ما الذي تحتاجه قبل التثبيت؟#

• إصدار ويندوز: ويندوز 10 الإصدار 1809 أو أحدث، أو ويندوز 11، أو Windows Server 2019 أو أحدث.
• المعالج: بنظام 64 بت، من نوع x64 أو ARM64. لا يعمل Claude Code على ويندوز 32 بت.
• الذاكرة: ذاكرة عشوائية بسعة 4 جيجابايت أو أكثر، مع اتصال بالإنترنت.
• الطرفية: PowerShell أو موجّه الأوامر (Command Prompt). تثبيت Git for Windows اختياري، لكن Anthropic توصي به.
• طريقة للدفع مقابل النموذج: اشتراك Claude من Anthropic يشمل Claude Code، مثل Pro وMax وUltra وTeam وEnterprise، أو حساب في Anthropic Console، أو مفتاح API من خدمة متوافقة مثل 5abeer. ولا تشمل باقة Claude المجانية أداة Claude Code.

كيف أثبّت Claude Code على ويندوز؟#

توصي Anthropic بأداة التثبيت الأصلية. تضع الأداة Claude Code في مجلد المستخدم، وتحدّثه تلقائيًا في الخلفية.

1. 1

   افتح PowerShell#

   افتح قائمة ابدأ، واكتب PowerShell، ثم اختر Windows PowerShell، وتجنّب الخيار الذي يحمل علامة (x86). لا تحتاج إلى «تشغيل كمسؤول». يبدأ سطر PowerShell بالنص PS C:\، أما سطر موجّه الأوامر فيبدأ بالنص C:\ وحده.

2. 2

   شغّل أداة التثبيت#

   الصق الأمر الخاص بالنافذة التي فتحتها، ثم اضغط Enter:

   PowerShellCommand Prompt

   انسخ

   irm https://claude.ai/install.ps1 | iex

   لا تعرض أداة التثبيت شريط تقدم أثناء التنزيل، فامنحها دقيقة أو دقيقتين.

3. 3

   افتح نافذة جديدة وتحقق#

   أغلق الطرفية، وافتح طرفية جديدة، ثم شغّل:

   PowerShellانسخ

   claude --version

   إذا ظهر رقم إصدار، فقد نجح التثبيت. وللفحص الأشمل، يعرض الأمر claude doctor حالة التثبيت والإعدادات دون أن يغيّر شيئًا. وإذا ظهرت رسالة بأن الأمر claude غير معروف، فانظر حل مشكلة PATH في قسم الأخطاء أدناه.

طرق أخرى للتثبيت#

أغلق Claude Code قبل winget upgrade، لأن ويندوز يمنع استبدال ملف البرنامج ما دام يعمل. ومع npm، تجنّب npm update -g، فقد لا ينقلك إلى أحدث إصدار.

ويندوز مباشرة أم WSL؟#

يعمل Claude Code مباشرة على ويندوز، ويعمل أيضًا داخل WSL، أي نظام ويندوز الفرعي للينكس. والفرق الأساسي بينهما هو العزل (Sandboxing)، الذي يحدّ مما تصل إليه الأوامر التي ينفذها Claude:

وهذا أمر تثبيت لينكس داخل طرفية WSL:

curl -fsSL https://claude.ai/install.sh | bash

ثم شغّل claude من طرفية WSL نفسها، لا من PowerShell.

أما على ويندوز مباشرة، فيستخدم Claude Code برنامج Git Bash إذا كان Git for Windows مثبتًا، ويستخدم PowerShell إذا لم يكن مثبتًا. وإذا لم يعثر على Git Bash، فحدد مساره في ملف الإعدادات:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

هل أسجّل الدخول باشتراك Claude أم أستخدم مفتاح API؟#

باشتراك Claude: شغّل claude، فيفتح المتصفح لتسجيل الدخول بحساب Claude أو بحساب Anthropic Console. وإذا لم يُفتح المتصفح، فاضغط c لنسخ رابط تسجيل الدخول.

بمفتاح API: إذا وجد Claude Code في ملف الإعدادات مفتاحًا وعنوان أساس، فإنه يتخطى تسجيل الدخول، ويرسل كل طلب إلى هذا العنوان، ويُحاسب صاحب المفتاح على كل توكن. ولا تخضع هذه الطلبات لحدود الاشتراك. أنشئ مفتاحًا من لوحة التحكم (طريقة إنشاء المفتاح)، ثم أضف هذه الإعدادات:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.5abeer.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_5ABEER_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5.5"
  }
}

على ويندوز، يقابل المسار ~/.claude/settings.json المسار %USERPROFILE%\.claude\settings.json. ينشئ هذان الأمران المجلد عند الحاجة، ويفتحان الملف في المفكرة:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
notepad "$env:USERPROFILE\.claude\settings.json"

إذا كان في الملف قسم env من قبل، فأضف السطور الثلاثة إليه. واحفظ المفتاح في هذا الملف الشخصي وحده، ولا تضعه أبدًا في ملف .claude\settings.json داخل مشروع، لأن هذا الملف يُرفع عادةً إلى Git.

ولتجربة مفتاح في جلسة واحدة، اضبط المتغيرات في PowerShell بدلًا من الملف. تختفي هذه المتغيرات عند إغلاق النافذة، وتتقدم عليها قيم ملف الإعدادات. ضع قيمة ANTHROPIC_BASE_URL من الإعدادات المعروضة أعلاه مكان BASE_URL:

$env:ANTHROPIC_BASE_URL = "BASE_URL"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_5ABEER_API_KEY"
claude

كيف أتحقق من أول تشغيل؟#

افتح الطرفية في مجلد مشروعك، وشغّل claude، ثم اكتب /status. إذا كان المفتاح فعّالًا، يعرض تبويب Status سطر Anthropic base URL بعنوان 5abeer، وسطر Auth token الذي يذكر ANTHROPIC_AUTH_TOKEN. أما ظهور سطر Login method الذي يذكر claude.ai فمعناه أن Claude Code ما زال يستخدم تسجيل دخول محفوظًا.

وهذه عناوين الأساس لكل صيغة API:

ولاختبار المفتاح خارج Claude Code، شغّل هذا الطلب في PowerShell. إذا جاء الرد ولم يعمل Claude Code، فالمشكلة في ملف الإعدادات، لا في المفتاح.

$headers = @{
    "x-api-key" = $env:KHABEER_API_KEY
    "anthropic-version" = "2023-06-01"
}
$body = @'
{
  "model": "claude-sonnet-5.5",
  "max_tokens": 512,
  "messages": [
    {
      "role": "user",
      "content": "اكتب فكرة منتج في سطر واحد"
    }
  ]
}
'@

$response = Invoke-RestMethod -Method Post -Uri "https://api.5abeer.ai/v1/messages" `
  -Headers $headers `
  -ContentType "application/json; charset=utf-8" `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($body))

$response | ConvertTo-Json -Depth 20

{
  "id": "msg_01Xh7",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5.5",
  "content": [
    {
      "type": "text",
      "text": "مرحبًا! كيف أساعدك اليوم؟"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 21,
    "output_tokens": 12
  }
}

كيف أحل أخطاء ويندوز الشائعة؟#

تأتي أغلب أخطاء التثبيت من تشغيل الأمر في نافذة غير مناسبة:

• 'irm' is not recognized: أنت في موجّه الأوامر. استخدم أمر CMD، أو افتح PowerShell.
• The token '&&' is not a valid statement separator: أنت في PowerShell. استخدم أمر PowerShell.
• A parameter cannot be found that matches parameter name 'fsSL' أو 'bash' is not recognized: شغّلت أمر macOS أو لينكس. استخدم أمر ويندوز، أو شغّله داخل WSL.
• running scripts is disabled on this system: منع PowerShell تشغيل السكربت الذي ثبّته npm. نفّذ Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser، أو استخدم أداة التثبيت الأصلية.
• The process cannot access the file ... because it is being used by another process: أغلق برامج التثبيت الأخرى أو انتظر حتى ينتهي برنامج مكافحة الفيروسات، ثم احذف المجلد %USERPROFILE%\.claude\downloads وشغّل أداة التثبيت مرة أخرى.
• Claude Code does not support 32-bit Windows: نفّذ [Environment]::Is64BitOperatingSystem. إذا كانت النتيجة True فقد فتحت نسخة PowerShell التي تحمل علامة (x86)، فافتح النسخة العادية. وإذا كانت False فويندوز نفسه بنظام 32 بت.
• Claude Code on Windows requires either Git for Windows (for bash) or PowerShell: ثبّت Git for Windows مع اختيار «Add to PATH»، أو ثبّت PowerShell 7.

الأمر claude غير معروف#

تضع أداة التثبيت الملف claude.exe في المجلد %USERPROFILE%\.local\bin، لكنها لا تضيف هذا المجلد إلى متغير PATH. وعندها تعرض ملاحظات الإعداد الرسالة Native installation exists but C:\Users\you\.local\bin is not in your PATH. أضف المجلد لمستخدمك، ثم افتح طرفية جديدة:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

وإذا توقف claude عن العمل بعد تحديث مباشرةً، فاستعد النسخة الاحتياطية التي يحتفظ بها المحدِّث:

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

وقد تستحوذ نسخة قديمة من تطبيق Claude لسطح المكتب على الأمر claude. يعرض الأمر where.exe claude كل النتائج، فإذا جاء تطبيق سطح المكتب أولًا، فحدّثه.

ما زال Claude Code يطلب تسجيل الدخول#

لم يعثر Claude Code على مفتاح. تأكد أن ANTHROPIC_AUTH_TOKEN داخل قسم env، وأن صيغة JSON في الملف صحيحة. ولمسح تسجيل دخول قديم إلى claude.ai، شغّل /logout ثم أعد تشغيل Claude Code. أما المفتاح في ANTHROPIC_API_KEY فيحتاج إلى موافقة لمرة واحدة، وإذا رفضتها فأعد تفعيلها من /config.

وإذا رُفض طلب برمز خطأ، فالرمز INVALID_API_KEY يعني أن المفتاح خطأ أو محذوف، والرمز INSUFFICIENT_BALANCE يعني أن رصيدك لا يكفي للطلب. وكل الرموز في رموز الأخطاء وحلولها.

كيف أشغّل Claude Code على ويندوز عبر 5abeer؟#

5abeer خدمة مستقلة متوافقة مع واجهة Anthropic Messages، لذلك يعمل Claude Code كما تصدره Anthropic، ولا يتغير إلا عنوان الأساس والمفتاح. ولك طريقان:

• مفتاح API تدفع فيه حسب الاستخدام. تدفع ثمن التوكنات من رصيدك، وتضع لكل مفتاح حد إنفاق وتاريخ انتهاء وقائمة عناوين IP مسموح بها (التحكم في المفاتيح). وأسعار Claude في صفحة Claude API.
• باقة 5abeer. يجهّز تطبيق 5abeer AI لويندوز أداة Claude Code على باقتك بضغطة واحدة، دون مفتاح ودون تعديل ملفات (ما الذي تشغّله كل باقة). الباقات مخصصة للتطبيقات المدعومة، ولاستخدام النماذج من الكود الخاص بك تحتاج إلى مفتاح API. راجع صفحة الأسعار وصفحة Claude Code.

وكل الإعدادات مشروحة في صفحة Claude Code في التوثيق.

أسئلة شائعة#

هل أحتاج إلى صلاحيات المسؤول؟#

لا. تضع أداة التثبيت الأصلية Claude Code في مجلد المستخدم، فتكفيك نافذة PowerShell أو موجّه أوامر عادية.

هل أحتاج إلى Git for Windows؟#

لا، لكن Anthropic توصي به. عند تثبيته يستخدم Claude Code برنامج Git Bash لأداة Bash، ودونه ينفذ أوامر الطرفية عبر PowerShell. ولا تحتاج إليه داخل WSL.

هل يعمل Claude Code على ويندوز 32 بت؟#

لا. يحتاج إلى ويندوز 64 بت على معالج x64 أو ARM64.

هل أحتاج إلى حساب Anthropic؟#

فقط إذا أردت تسجيل الدخول باشتراك Claude أو بحساب Console. أما مع مفتاح API وعنوان أساس في ملف الإعدادات، فلا يطلب منك Claude Code تسجيل الدخول.

كيف أحدّثه أو أزيله؟#

يحدّث التثبيت الأصلي نفسه تلقائيًا، والأمر claude update يحدّثه في الحال. أما تثبيت WinGet فيُحدَّث بالأمر winget upgrade Anthropic.ClaudeCode ويُزال بالأمر winget uninstall Anthropic.ClaudeCode. ولإزالة التثبيت الأصلي، نفّذ في PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

تبقى إعداداتك في %USERPROFILE%\.claude وفي %USERPROFILE%\.claude.json حتى تحذفها بنفسك.

هل أستطيع استخدام Claude Code في VS Code على ويندوز؟#

نعم. تحمل إضافة VS Code نسختها الخاصة من Claude Code، فتعمل دون التثبيت من الطرفية، لكنها لا تضيف الأمر claude إلى PATH. ولتعطي الإضافة مفتاحًا، أضف claudeCode.environmentVariables إلى إعدادات المستخدم في VS Code، كما يشرح دليل Claude Code في VS Code.

أي نموذج أستخدم؟#

ابدأ بالنموذج الافتراضي claude-sonnet-5.5، فهو يكفي أغلب مهام البرمجة. وانتقل إلى claude-opus-5.5 أو claude-fable-5.1 في أصعب المشكلات. بدّل النموذج بالإعداد ANTHROPIC_MODEL، أو من داخل Claude Code بالأمر /model. والقائمة كاملة بأسعارها في صفحة النماذج.

المصادر#

راجعناها في 2026-11-01:

• توثيق Claude Code: Advanced setup
• توثيق Claude Code: Troubleshoot installation and login
• توثيق Claude Code: Other LLM gateways
• توثيق Claude Code: Connect Claude Code to an LLM gateway

ابدأ#

قارن بين الاشتراك ومفتاح API في أرخص طريقة لاستخدام Claude Code، وتعرّف إلى الأساسيات في ما هو مفتاح API وكيف تحصل على واحد، أو جهّز Codex CLI بمفتاح API.