كيف تثبّت Claude Code وCodex CLI على Windows

أوامر PowerShell وCMD وWinGet وnpm الدقيقة لتثبيت Claude Code وCodex CLI على Windows 10 و11، ومتى تختار WSL، وكيف تصلح خطأ «claude is not recognized» وبقية الأخطاء التي ستواجهها.

صار تثبيت كل من أداتي CLI على Windows يتم بسطر واحد. أغلب المشاكل تأتي بعد هذا السطر: طرفية لا تجد الأمر، وسياسة تنفيذ تمنع npm، وتوزيعة WSL 1 قديمة، وأمر ملصوق في الـ shell الخطأ. يعطيك هذا الدليل الأوامر الدقيقة لكل طريقة تثبيت، ثم الأخطاء وطرق إصلاحها.

المعلومات عن الأداتين مأخوذة من توثيق Anthropic وOpenAI ومن سكربتات التثبيت نفسها، بعد قراءتها في 16 نوفمبر 2026، مع Claude Code 2.1.318 وCodex CLI 0.169.0. الأداتان تتطوران بسرعة: إن فشل أحد الأوامر أدناه، فراجع الصفحة الرسمية المرتبطة في كل قسم.

الجواب المختصر. افتح PowerShell، لا CMD، وشغّل:

irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

ثم افتح طرفية جديدة وشغّل claude --version وcodex --version. إن ردّ Windows بأن claude غير معروف، فإصلاح PATH موجود في جدول الأخطاء أدناه.

ما تحتاجه كل أداة CLI على Windows

Claude CodeCodex CLI
إصدار WindowsWindows 10 1809 أو أحدث، Windows Server 2019 أو أحدثيُنصح بـ Windows 11، وWindows 10 الحديث «بأفضل جهد»
المعالجx64 أو ARM64، وليس 32 بت أبدًاx64 أو ARM64
الحساباشتراك Claude مدفوع أو حساب Consoleاشتراك ChatGPT أو مفتاح API من OpenAI
Node.jsلطريقة npm فقط، الإصدار 22 أو أحدثلطريقة npm فقط
Git for Windowsاختياريغير مطلوب
بيئة معزولة على Windows الأصليلا، داخل WSL 2 فقطنعم، بيئته المعزولة الخاصة بـ Windows
صلاحيات المسؤول للتثبيتلالا

سطران في هذا الجدول يفاجئان الناس. لم يعد Claude Code يشترط Git for Windows: من دونه يستخدم PowerShell كأداة shell. وCodex يعزل الأوامر في بيئة معزولة (sandbox) على Windows الأصلي، بينما لا يفعل Claude Code ذلك إلا داخل WSL 2.

تثبيت Claude Code على Windows

تعرض صفحة التثبيت لدى Anthropic أربع طرق. المثبّت الأصلي هو الطريقة الموصى بها: لا يحتاج إلى Node.js ويحدّث نفسه في الخلفية.

الطريقةالأمر
PowerShell (موصى بها)irm https://claude.ai/install.ps1 | iex
CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WinGetwinget install Anthropic.ClaudeCode
npm (Node.js 22+)npm install -g @anthropic-ai/claude-code@latest

ما تتركه كل طريقة على جهازك:

  • المثبّت الأصلي: الملف claude.exe في %USERPROFILE%\.local\bin، والإصدارات في %USERPROFILE%\.local\share\claude. ينبّهك المثبّت حين لا يكون .local\bin ضمن PATH، لكنه لا يضيفه نيابة عنك.
  • WinGet: لا تحديثات تلقائية. تحدّث بالأمر winget upgrade Anthropic.ClaudeCode، وتنبّه Anthropic إلى أن التحديث قد يفشل أثناء تشغيل Claude Code، لأن Windows يقفل الملف التنفيذي.
  • npm: مع Node.js أقدم من 22، ينتهي التثبيت بتحذير EBADENGINE.

لتبقى متأخرًا بإصدار واحد عن الأحدث، على القناة المستقرة:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

ثم تحقّق من التثبيت. يطبع claude --version رقم الإصدار، ويجري claude doctor فحصًا للقراءة فقط للتثبيت وإعداداته.

إن كان Git for Windows مثبّتًا لديك، يبحث Claude Code عن Git Bash في C:\Program Files\Git، ثم C:\Program Files (x86)\Git، ثم git الموجود في PATH. لفرض نسخة أخرى، اضبط CLAUDE_CODE_GIT_BASH_PATH في كتلة env داخل ملف settings.json. يجب أن يشير إلى ملف اسمه bash.exe أو sh.exe، لا git-bash.exe.

تثبيت Codex CLI على Windows

صفحة Windows لدى OpenAI واضحة: استخدم Codex أصليًا مع بيئته المعزولة الخاصة بـ Windows افتراضيًا، واختر WSL حين تكون أدواتك على Linux أصلًا. مصدر واحد متأخر: صفحة التثبيت في مستودع GitHub ما زالت تقول «Windows 11 via WSL2». التوثيق الرسمي تجاوز ذلك، والمثبّت كذلك.

الطريقةالأمر
مثبّت PowerShellpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm install -g @openai/codex

مثبّت PowerShell هو الأسهل. قراءة السكربت تكشف ما يفعله: يثبّت Codex في %LOCALAPPDATA%\Programs\OpenAI\Codex\bin، ويضيف هذا المجلد إلى PATH الخاص بمستخدمك وإلى الجلسة الحالية، ويطلب منك فتح نافذة PowerShell جديدة. تشغيل الأمر نفسه مرة أخرى يحدّث Codex. ومع npm، تحدّث بإعادة تشغيل أمر التثبيت.

ثم سجّل الدخول. شغّل codex واختر Sign in with ChatGPT، أو شغّل codex login. على جهاز من دون متصفح، يعطيك codex login --device-auth رمزًا تكتبه على جهاز آخر. ويخبرك codex login status بالحساب الذي سجّلت الدخول به.

البيئة المعزولة في Windows

لدى Codex ثلاثة تطبيقات للبيئة المعزولة على Windows:

  • mxc: الموصى به، ولا يحتاج إلى أي إعداد من المسؤول. يتطلب Windows 11 24H2 (البنية 26100.9278) أو 25H2 (البنية 26200.9278).
  • elevated: البديل المفضّل. يتطلب إعدادًا لمرة واحدة يوافق عليه المسؤول.
  • unelevated: عزل أضعف للشبكة، ولا مسارات للقراءة فقط.

يتم الاختيار في config.toml:

[features]
prefer_mxc = true

[windows]
sandbox = "elevated" # or "unelevated"

إن فشلت البيئة المعزولة بالخطأ 1385، فقد رفض Windows نوع تسجيل الدخول لحساب البيئة المعزولة. تطلب OpenAI في هذه الحالة الملف CODEX_HOME/.sandbox/sandbox.log. لا تشارك أبدًا محتوى .sandbox-secrets/.

Windows الأصلي أم WSL؟

أصلي (PowerShell، CMD)WSL 2
تثبيت Claude Codeirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.sh | bash داخل WSL
تثبيت Codexمثبّت PowerShellcurl -fsSL https://chatgpt.com/codex/install.sh | sh داخل WSL
البيئة المعزولة في Claude Codeغير متاحةمتاحة، مع bubblewrap وsocat
البيئة المعزولة في Codexبيئة Windows المعزولةبيئة Linux المعزولة
أين تحتفظ بالمستودعفي أي مكانتحت ~/، لا تحت /mnt/c/

اختر WSL 2 حين يُبنى مشروعك ويعمل على Linux في كل الأحوال، أو حين تريد أن يعزل Claude Code الأوامر التي يشغّلها. وابقَ على Windows الأصلي حين يكون مشروعك مشروع Windows: .NET، وسكربتات PowerShell، ومسارات Windows في كل مكان.

ثلاث قواعد إن اخترت طريق WSL:

  1. WSL 2، وليس WSL 1 أبدًا. أوقف Codex دعم WSL 1 منذ الإصدار 0.115. والبيئة المعزولة في Claude Code ترفض WSL 1 برسالة Sandboxing requires WSL2، وقد يفشل التثبيت على WSL 1 بالخطأ Exec format error. حوّل التوزيعة بالأمر wsl --set-version <DistroName> 2.
  2. ثبّت وشغّل داخل WSL. شغّل أمر Linux في طرفية WSL، لا في PowerShell. تشغيل Node.js الخاص بـ Windows من داخل WSL هو ما يسبّب exec: node: not found: ثبّت Node.js في التوزيعة نفسها، بمدير الحزم الخاص بها أو بـ nvm.
  3. احتفظ بالشيفرة في نظام ملفات Linux. الشركتان كلتاهما تنصحان بإبقاء المستودع خارج /mnt/c/، وتنبّه Anthropic إلى أن عمليات البحث في Claude Code تكون أقل اكتمالًا هناك. انسخه تحت مجلدك الشخصي في Linux.

«claude is not recognized» وبقية الأخطاء

ما تراهالسببالحل
'claude' is not recognized as an internal or external command (CMD)، The term 'claude' is not recognized (PowerShell)%USERPROFILE%\.local\bin ليس ضمن PATHأضفه إلى PATH الخاص بالمستخدم (الأوامر أدناه)، ثم افتح طرفية جديدة
ما زال غير معروف بعد إضافتهالطرفية، أو المحرر الذي يحتويها، بدأت قبل التغييرأغلق الطرفية وأعد فتحها، والمحرر أيضًا إن كانت الطرفية داخله
غير معروف مباشرة بعد تحديثتحديث انقطع في منتصف الاستبدال ولم يترك أي claude.exeأعد تسمية أحدث claude.exe.old.* إلى claude.exe (الأمر أدناه)
'irm' is not recognizedلصقت سطر PowerShell في CMDافتح PowerShell، أو استخدم سطر CMD
The token '&&' is not a valid statement separatorلصقت سطر CMD في Windows PowerShellاستخدم سطر PowerShell
npm.ps1 cannot be loaded because running scripts is disabled on this systemسياسة التنفيذ تمنع ملف PowerShell الوسيط الخاص بـ npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser، أو استدعِ npm.cmd
خطأ عن Windows بنسخة 32 بت على حاسوب 64 بتفتحت «Windows PowerShell (x86)» من قائمة ابدأافتح PowerShell العادي بنسخة 64 بت
claude يفتح تطبيق سطح المكتب بدلًا من CLIتطبيق Claude قديم لسطح المكتب وضع Claude.exe في WindowsApps، قبل CLI في PATHحدّث تطبيق Claude لسطح المكتب
requires either Git for Windows (for bash) or PowerShellلم يجد Claude Code أيًّا من الـ shell الاثنينثبّت Git for Windows، أو تحقّق من وجود PowerShell ضمن PATH
EBADENGINE أثناء npm installإصدار Node.js أقدم من 22حدّث Node.js، أو استخدم المثبّت الأصلي

إصلاح PATH، في PowerShell، للمستخدم الحالي، من دون صلاحيات المسؤول:

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

لترى أين يبحث Windows قبل أن تغيّر أي شيء:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude

إعادة التسمية بعد تحديث معطوب:

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

عن سياسة التنفيذ: Windows PowerShell 5.1، النسخة المرفقة مع Windows، مضبوطة افتراضيًا على Restricted في أجهزة المستخدمين، ولهذا يمنع حاسوب محمول جديد الملف npm.ps1. النطاق CurrentUser لا يحتاج إلى صلاحيات المسؤول. مثبّت Claude الأصلي ومثبّت Codex لا يتأثران بذلك: irm | iex و-ExecutionPolicy ByPass لا يحمّلان أبدًا ملف سكربت من القرص.

التحديث وإلغاء التثبيت

Claude CodeCodex CLI
التحديث الآنclaude update (أصلي)، أو winget upgrade Anthropic.ClaudeCode، أو إعادة تثبيت npmcodex update في الإصدارات التي تدعمه، أو إعادة تشغيل مثبّت PowerShell، أو npm install -g @openai/codex
التحديثات التلقائيةفي التثبيت الأصلي فقط، وتُعطَّل بـ DISABLE_AUTOUPDATER=1غير موثّقة
إلغاء التثبيتاحذف %USERPROFILE%\.local\bin\claude.exe و%USERPROFILE%\.local\share\claude، أو winget uninstall Anthropic.ClaudeCode، أو npm uninstall -g @anthropic-ai/claude-codeاحذف مجلد التثبيت، أو npm uninstall -g @openai/codex
الإعدادات المتبقية%USERPROFILE%\.claude و%USERPROFILE%\.claude.json%USERPROFILE%\.codex

ما تعلّمناه من تشغيل أدوات CLI للوكلاء على Windows

يشغّل AgentsRoom كلًّا من Claude Code وCodex وبقية أدوات CLI للوكلاء جنبًا إلى جنب، وعلّمتنا نسخته لـ Windows أين تنكسر هذه التثبيتات حين تخرج من الطرفية. أربعة أمور تستحق المعرفة حتى لو لم تستخدم تطبيقنا أبدًا.

البرنامج الذي يُشغَّل من قائمة ابدأ يحتفظ بـ PATH الذي بدأ به. تثبّت Claude Code، وتضيف .local\bin إلى PATH، ومع ذلك يبقى تطبيق سطح مكتب كان مفتوحًا عاجزًا عن إيجاد claude. إعادة تشغيل الطرفية لا تكفي للتطبيقات التي تشغّل أدوات CLI نيابة عنك. يعيد AgentsRoom قراءة PATH الخاص بالمستخدم والجهاز من السجل (Registry) حين يبحث عن أداة CLI، كي لا يُبلَّغ عن تثبيت نجح للتو كأنه مفقود.

لا يثبّت npm ملف .exe. يكتب npm install -g @openai/codex ثلاثة ملفات في %APPDATA%\npm: codex وcodex.cmd وcodex.ps1. البرنامج الذي يشغّل codex مباشرة يحصل على spawn codex ENOENT، لأن Windows لا يضيف إلا .exe إلى الاسم المجرّد. الطرفية تخفي عنك ذلك، لأن PowerShell وCMD يقرآن PATHEXT. وهذا سبب إضافي لتفضيل المثبّتات الأصلية، فهي تضع ملفًا تنفيذيًا فعلًا.

ملفات npm الوسيطة تحتاج إلى Node.js وقت التشغيل. إن ثبّتّ Node.js ثم أداة CLI في الجلسة نفسها، يُعثر على الملف الوسيط .cmd لكنه يفشل برسالة «node is not recognized» في أي برنامج بدأ قبل أن يصبح Node.js ضمن PATH. والعَرَض نفسه يظهر مع مدير إصدارات Node تشير ملفاته الوسيطة إلى إصدار غير مفعّل.

تشغيل عملية جديدة أغلى بكثير على Windows. قسنا من 20 إلى 80 ms لإنشاء عملية على Windows، مقابل 1 إلى 3 ms على macOS، وكل فحص لملف يكلّف أكثر لأن مضاد الفيروسات يفحصه. كانت أول طريقة لدينا لاكتشاف أدوات CLI تجرّب كل مجلد وكل اسم وكل امتداد، فتجمّد التطبيق لمدة تصل إلى ثانية على Windows. قراءة كل مجلد مرة واحدة فقط حلّت المشكلة.

في التطبيق، يثبّت مساعد الإعداد أداة CLI الناقصة بالمثبّت الرسمي من الجهة المطوّرة لنظام تشغيلك (irm https://claude.ai/install.ps1 | iex لـ Claude Code، وسكربت OpenAI لـ Codex)، ويعود إلى npm إن فشل السكربت، ويشغّله في طرفية يمكنك مراقبتها. وحين لا تبدأ أداة CLI، يقرأ CLI Doctor الخطأ والأمر الدقيق، ثم يخبرك بما تعطّل. وبمجرد أن تجيب الأداتان على --version، يأخذك دليل البدء من هناك، وتشرح ملاحظات إصدار Windows ما يفعله التطبيق على Windows.

الأسئلة الشائعة

كيف أثبّت Claude Code على Windows؟

افتح PowerShell وشغّل irm https://claude.ai/install.ps1 | iex. في CMD استخدم بدلًا منه سطر install.cmd من صفحة التثبيت لدى Anthropic، ومع WinGet شغّل winget install Anthropic.ClaudeCode. يوضع الملف التنفيذي في %USERPROFILE%\.local\bin، ولا يضيف المثبّت هذا المجلد إلى PATH: أضفه بنفسك إن لم يتعرّف النظام على claude، ثم افتح طرفية جديدة وشغّل claude --version.

هل أحتاج إلى WSL لتشغيل Claude Code أو Codex على Windows؟

لا. كلاهما يعمل أصليًا في PowerShell أو CMD على Windows 10 و11. يستحق WSL 2 العناء حين يكون مشروعك على Linux أصلًا، أو حين تريد البيئة المعزولة (sandbox) في Claude Code، وهي لا تعمل على Windows الأصلي. استخدم WSL 2 لا WSL 1: أوقف Codex دعم WSL 1 منذ الإصدار 0.115.

لماذا يقول Windows إن 'claude' غير معروف مباشرة بعد تثبيته؟

يضع المثبّت الأصلي claude.exe في %USERPROFILE%\.local\bin ويعرض تحذيرًا إن لم يكن هذا المجلد ضمن PATH، لكنه لا يعدّل PATH بنفسه. أضف المجلد إلى PATH الخاص بمستخدمك، ثم أغلق الطرفية وأعد فتحها، وأعد فتح المحرر أيضًا إن كانت الطرفية تعمل داخله. الطرفية المفتوحة من قبل تحتفظ بـ PATH القديم.

هل يحتاج Claude Code إلى Git for Windows؟

لم يعد يحتاج إليه. تذكر صفحة التثبيت لدى Anthropic أن Git for Windows اختياري: من دونه يعتمد Claude Code على PowerShell كأداة shell. ومعه يعثر Claude Code على Git Bash في C:\Program Files\Git، ويمكنك الإشارة إلى ملف bash.exe آخر عبر الإعداد CLAUDE_CODE_GIT_BASH_PATH.

هل يمكنني تثبيت Codex CLI على Windows من دون Node.js؟

نعم. يحمّل مثبّت PowerShell من OpenAI نسخة مستقلة من Codex، ويضعها في %LOCALAPPDATA%\Programs\OpenAI\Codex\bin ويضيف هذا المجلد إلى PATH الخاص بمستخدمك. وحدها طريقة npm، أي npm install -g @openai/codex، تحتاج إلى Node.js.

هل أستخدم PowerShell أم CMD لتثبيتهما؟

PowerShell. الأمران الرسميان كلاهما أوامر PowerShell، وأكثر الأخطاء شيوعًا سببها لصق سطر PowerShell في CMD أو العكس: رسالة 'irm' is not recognized تعني أنك في CMD، ورسالة '&&' is not a valid statement separator تعني أنك في PowerShell. استخدم PowerShell بنسخة 64 بت، لا مدخل «Windows PowerShell (x86)» في قائمة ابدأ.

مهندس DevOpsكاتب المحتوىمطور الواجهة الأماميةمندوب المبيعاتمطور الخلفيةالمدرب والمرشدمهندس البرمجياتالمستشار القانونيمهندس QAالمالية والإدارةمطور Full-Stackالمصمم الإبداعيمطور الهاتف المحمولالباحثمهندس الأمانالموارد البشرية والتوظيف
مدير المشروعالمترجمخبير Gitمحلل البياناتأخصائي SEOالمحاسبأخصائي التوطينالاتصال والعلاقات العامةمفكرالعمليات والخدمات اللوجستيةأخصائي التسويقدعم العملاءمساعد المشروعمسؤول المشترياتمدير المجتمعالمساعد الشخصي

تحميل AgentsRoom

شغّل كل وكلاء الذكاء الاصطناعي لديك، في كل مشاريعك، من نافذة واحدة.

تحميل AgentsRoomمجاني

التطبيق المرافق: تابع وكلاءك أينما كنت

استخدم Claude أو Codex أو Antigravity CLI أو أي مزود AI آخر.

تثبيت الملحق
Chrome Web Store

أرسل الأخطاء والطلبات مباشرة إلى قائمة المهام العامة.

وكلاء تقرؤهم كأنها محادثة

لكل وكيل دور ووجه وسلسلة رسائل تقرؤها كما في تطبيق المراسلة.

عرض المحادثة

عرض المحادثة في AgentsRoom: عمل وكيل برمجة بالذكاء الاصطناعي على شكل محادثة
مشاريع متعددة
متعدد المزوّدين
وكلاء متعددون
حالة مباشرة
فرق الملفات والـ commit
تطبيق الهاتف
معاينة مباشرة
فرق الوكلاء
أتمتة المتصفح
تطوير موجّه بالـ backlog
مكتبة البرومبت
مكتبة المهارات
عرض جميع الميزات

تابع القراءة