كيف تثبّت 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 Code | Codex CLI | |
|---|---|---|
| إصدار Windows | Windows 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 |
| CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| WinGet | winget 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». التوثيق الرسمي تجاوز ذلك، والمثبّت كذلك.
| الطريقة | الأمر |
|---|---|
| مثبّت PowerShell | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm 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 Code | irm https://claude.ai/install.ps1 | iex | curl -fsSL https://claude.ai/install.sh | bash داخل WSL |
| تثبيت Codex | مثبّت PowerShell | curl -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:
- 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. - ثبّت وشغّل داخل WSL. شغّل أمر Linux في طرفية WSL، لا في PowerShell. تشغيل Node.js الخاص بـ Windows من داخل WSL هو ما يسبّب
exec: node: not found: ثبّت Node.js في التوزيعة نفسها، بمدير الحزم الخاص بها أو بـ nvm. - احتفظ بالشيفرة في نظام ملفات 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 الوسيط الخاص بـ npm | Set-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 Code | Codex CLI | |
|---|---|---|
| التحديث الآن | claude update (أصلي)، أو winget upgrade Anthropic.ClaudeCode، أو إعادة تثبيت npm | codex 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)» في قائمة ابدأ.
تحميل AgentsRoom
شغّل كل وكلاء الذكاء الاصطناعي لديك، في كل مشاريعك، من نافذة واحدة.
التطبيق المرافق: تابع وكلاءك أينما كنت
استخدم Claude أو Codex أو Antigravity CLI أو أي مزود AI آخر.
أرسل الأخطاء والطلبات مباشرة إلى قائمة المهام العامة.
وكلاء تقرؤهم كأنها محادثة
لكل وكيل دور ووجه وسلسلة رسائل تقرؤها كما في تطبيق المراسلة.

تابع القراءة
وضع الصوت في Codex وOpenCode وAntigravity وClaude Code: أي CLI يملك واحداً؟
تحققنا من خمس أدوات CLI لوكلاء البرمجة ومن تطبيقين في 13 أكتوبر 2026. يجري Codex CLI وoh-my-pi محادثة منطوقة، ويكتفي Claude Code وAntigravity CLI بالإملاء في الموجّه، ولا يملك OpenCode شيئاً مدمجاً. كيف تشغّل كل واحدة منها، وإلى أين يذهب الصوت، وكم يكلّف الصوت من التوكنات.
اقرأ المقالClaude Code مقابل Codex CLI: أيهما تختار في 2026 (ولماذا قد تستخدم الاثنين)
مقارنة صادقة بين Claude Code و Codex CLI: السعر، السرعة، MCP، التحكم. ولماذا توقفت بعد بضعة أسابيع عن الاختيار بينهما.
اقرأ المقالكيف تزيل Co-Authored-By Claude من commits في git
يوقّع Claude Code على commits الخاصة بك بتذييل Co-Authored-By، وعلى طلبات الـ pull request بسطر Generated with Claude Code. الإعداد الذي يزيلهما، والملف الذي تضعه فيه، وكيف تنظّف الـ commits التي سبق أن دفعتها.
اقرأ المقال