تثبيت Claude Code بنقرة واحدة: macOS وLinux وWindows
اعتبارًا من 2026-10-07، طريقة التثبيت التي تعدّها Anthropic موصى بها لـ Claude Code هي Native Install: على macOS أو Linux أو WSL نفّذ curl -fsSL https://claude.ai/install.sh | bash، وفي Windows PowerShell نفّذ irm https://claude.ai/install.ps1 | iex؛ كما تعمل Homebrew وWinGet وnpm أيضًا. للاتصال بـ QCode، يتولى سكربت الإعداد بنقرة واحدة من QCode ذلك بأمر واحد: يختار نقطة نهاية بحسب زمن الاستجابة، ويكتب الإعدادات، ويثبّت Node.js وCLI عند الحاجة، ويتحقق من الاتصال. تسرد هذه الصفحة الأوامر الخاصة بالمساريْن، وكيفية التحقق من التثبيت، وأخطاء التثبيت الشائعة.
آخر تحديث 2026-11-13
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربعة أمور يجب معرفتها أولًا
المثبّت الرسمي، واحد لكل shell
install.sh لـ macOS وLinux وWSL، وinstall.ps1 لـ Windows PowerShell، وinstall.cmd لـ Windows CMD. تعدّ Anthropic هذه الطريقة موصى بها، وهي تحدّث نفسها في الخلفية.
تشترطه حزمة npm
تقول الوثائق الرسمية إن حزمة npm تتطلب Node.js 22 أو أحدث؛ وعلى إصدار أقدم، لا يطبع npm سوى تحذير EBADENGINE ويكتمل التثبيت مع ذلك. يثبّت npm الملف التنفيذي الأصلي نفسه الذي يثبّته المثبّت الرسمي.
سكربت الإعداد بنقرة واحدة من QCode
على macOS أو Linux نفّذ curl -fsSL https://qcode.cc/install/claude-code.sh | bash؛ وفي Windows PowerShell نفّذ irm https://qcode.cc/install/claude-code.ps1 | iex. لا حاجة إلى sudo ولا إلى حقوق مسؤول.
التحقق الأول بعد التثبيت
يطبع التثبيت العامل رقم إصدار مثل 2.1.211 (Claude Code). لإجراء تحقق أعمق نفّذ claude doctor؛ وداخل جلسة، يؤكد /status طريقة المصادقة النشطة.
أي طرق التثبيت رسمية؟
اعتبارًا من 2026-10-07، تسرد صفحة إعداد Claude Code المثبّت الرسمي (Native Install، موسوم كموصى به)، وHomebrew (brew install --cask claude-code)، وWinGet (winget install Anthropic.ClaudeCode)، وnpm (npm install -g @anthropic-ai/claude-code)؛ ويمكن لـ Debian وFedora وRHEL وAlpine أيضًا استخدام مستودعات apt وdnf وapk الموقّعة من Anthropic. الفرق الرئيسي هو التحديثات: يحدّث المثبّت الرسمي في الخلفية، بينما لا تحدّث تثبيتات Homebrew وWinGet تلقائيًا. لدى Homebrew حزمتان من نوع cask: يتتبّع claude-code القناة المستقرة، وهو عادةً متأخر بنحو أسبوع ويتخطى الإصدارات ذات الانحدارات الكبيرة، بينما يتتبّع claude-code@latest القناة الأحدث. متطلبات النظام: macOS 13.0+، أو Windows 10 1809+ أو Windows Server 2019+، أو Ubuntu 20.04+، أو Debian 10+، أو Alpine Linux 3.19+، وذاكرة RAM بسعة 4 GB أو أكثر، ومعالج x64 أو ARM64.
الإصدارات والوثائق اعتبارًا من 2026-10-07
اعتبارًا من 2026-10-07، أحدث إصدار لـ Claude Code على GitHub Releases هو v2.1.292، المنشور في 2026-10-06 (UTC)؛ وأحدث وسم لـ @anthropic-ai/claude-code على npm هو أيضًا 2.1.292، وتُدرج بيانات تعريف الحزمة الخاصة به node >=22.0.0. صفحتا الوثائق الخاصتان بـ QCode لسكربت الإعداد بنقرة واحدة ودليل التثبيت موسومتان بأنهما محدّثتان في 2026-09-25؛ يفتتح دليل التثبيت بالتوصية بالسكربت بنقرة واحدة ويقول إنه يكمل كل خطوة في تلك الصفحة بأمر واحد. يحمل سكربت claude-code.sh العام على qcode.cc سلسلة الإصدار 2026.10.07.1 في مصدره.
الجدول الزمني
تم تحديث صفحتَي وثائق QCode الخاصتين بسكربت الإعداد بنقرة واحدة ودليل التثبيت؛ واعتبارًا من 2026-10-07، يوصي دليل التثبيت بالسكربت بنقرة واحدة.
صدر Claude Code v2.1.292 على GitHub Releases (UTC)، وهو أحدث إصدار اعتبارًا من 2026-10-07؛ والوسم الأحدث على npm هو أيضًا 2.1.292.
يحمل مصدر سكربت claude-code.sh العام الإصدار 2026.10.07.1؛ وقد جرى التحقق من الأوامر ورسائل الخطأ وسلوك السكربت في هذه الصفحة مقابل الصفحات الرسمية ومصدر السكربت في هذا التاريخ.
مؤكد مقابل غير موثّق
مؤكد (حرفيًا في الوثائق)
كل ما يلي موجود حرفيًا في وثائق Claude Code، وGitHub Releases، وبيانات حزمة npm الوصفية، أو في وثائق QCode والشيفرة المصدرية العامة للنص البرمجي: أوامر التثبيت الرسمية الثلاثة وتوصية Native Install؛ والتحديثات التلقائية في الخلفية للمثبّت الرسمي وعدم وجودها لـ Homebrew وWinGet؛ وحزمة npm تتطلب Node.js 22 أو أحدث وتثبّت نفس الملف الثنائي الأصلي؛ وتقول Anthropic إنه لا يجب استخدام sudo npm install -g؛ ولا يتطلب التثبيت على Windows التشغيل بصلاحية Administrator؛ والغرض من claude --version وclaude doctor و/status؛ وأوامر النص البرمجي بنقرة واحدة من QCode، وخطواته الأربع (اختيار نقطة النهاية، وكتابة الإعدادات، وتثبيت Node.js وCLI إذا لزم الأمر، وفحص الاتصال)، والنسخ الاحتياطية والتراجع؛ وأن المتغيرات التي تكتبها الشيفرة المصدرية للنص البرمجي تتضمن ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN وCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1.
غير موثّق أو غير متحقّق منه هنا
ثلاثة أمور لا تخلص إليها هذه الصفحة: أولًا، تطلب حزمة npm الإصدار 22 من Node.js أو أحدث، لكن Anthropic تقول أيضًا إن Node.js الأقدم لا يثير سوى تحذير EBADENGINE ويكتمل التثبيت رغم ذلك؛ ويثبّت سكربت QCode إصدار LTS عند غياب Node.js، ولا تتكهن هذه الصفحة بالسلوك على أي إصدار محدد من Node.js. ثانيًا، لم يُختبر التثبيت خطوة بخطوة على كل نظام تشغيل؛ تتبع الأوامر الوثائق الرسمية ووثائق QCode التي جُلبت في 2026-10-07، ولنظامك وإصدارك الأولوية. ثالثًا، إن 2.1.211 في الوثائق الرسمية مجرد مثال على صيغة الإخراج، وليس أحدث إصدار حالي.
المثبّت الرسمي أو npm أو سكربت QCode
المثبّت الرسمي مقابل npm
تصنّف Anthropic Native Install على أنه موصى به، وهو يحدّث نفسه في الخلفية؛ وبالنسبة إلى أخطاء الأذونات الخاصة بـ npm، فإن الإصلاح الرسمي هو التحويل إليه. تتطلب طريقة npm الإصدار 22 من Node.js أو أحدث وتثبّت الملف التنفيذي الأصلي نفسه؛ ويمكن الترقية عبر npm install -g @anthropic-ai/claude-code@latest، وتحذّر الوثائق من npm update -g ومن sudo npm install -g. تناسب Homebrew وWinGet من يستخدم هذين المديرين للحزم بالفعل، لكنهما لا يحدّثان نفسيهما تلقائيًا.
Claude Code وحده مقابل سكربت QCode
المثبّت الرسمي يثبّت Claude Code فقط؛ وفي المسار الرسمي تسجّل الدخول بعد ذلك بحساب Pro أو Max أو Team أو Enterprise أو Console. كما يهيّئ سكربت QCode بنقرة واحدة الاتصال: يختار نقطة النهاية حسب زمن الاستجابة، ويكتب ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN، ويثبّت Node.js بإصدار LTS عبر nvm أو winget عند غيابه ثم CLI عبر npm، وأخيرًا يرسل طلبًا مصغّرًا باستخدام مفتاحك للتحقق. إذا كان Claude Code مثبتًا بالفعل وتريد فقط إعداد QCode، فأضف --no-install.
خطوة بخطوة، في المسارين
المسار الرسمي: (1) افتح طرفية وشغّل الأمر الخاص بنظامك: على macOS أو Linux أو WSL، curl -fsSL https://claude.ai/install.sh | bash؛ في Windows PowerShell، irm https://claude.ai/install.ps1 | iex؛ في Windows CMD، curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. (2) افتح نافذة طرفية جديدة وشغّل claude --version لتتأكد من طباعة رقم إصدار. (3) شغّل claude في مجلد مشروعك. مسار QCode: (1) احصل على مفتاح API يبدأ بـ cr_ من لوحة تحكم QCode. (2) على macOS أو Linux شغّل curl -fsSL https://qcode.cc/install/claude-code.sh | bash؛ وعلى Windows شغّل irm https://qcode.cc/install/claude-code.ps1 | iex في PowerShell، وألصق المفتاح عند المطالبة (لا يُعرض الإدخال). (3) افتح طرفية جديدة كي يسري الإعداد (على Windows، أعد أيضًا تشغيل المحررات مثل VS Code مرة واحدة)، وشغّل claude --version، ثم شغّل claude واستخدم /status لتأكيد طريقة المصادقة. للإعداد يدويًا، يضبط دليل تثبيت QCode متغيرين: ANTHROPIC_BASE_URL=https://api.qcode.cc/api وANTHROPIC_AUTH_TOKEN مضبوطًا على مفتاحك. إذا فشل أمر التثبيت بخطأ syntax error near unexpected token '<' أو بخطأ 403، فتقول الوثائق إن رابط التثبيت أعاد صفحة ويب أو حالة خطأ بدلًا من السكربت: ثبّت باستخدام Homebrew على macOS أو WinGet على Windows، أو أعد المحاولة بعد بضع دقائق.
على QCode
على QCode، يستخدم Claude Code نقطة النهاية ببروتوكول Anthropic: عيّن ANTHROPIC_BASE_URL على https://api.qcode.cc/api (توقف عند /api، بلا شرطة مائلة لاحقة) وANTHROPIC_AUTH_TOKEN على مفتاح cr_ أُنشئ في لوحة التحكم؛ يرسله Claude Code في ترويسة Authorization مع البادئة Bearer. على macOS وLinux، تتضمن المتغيرات التي يكتبها السكربت في كتلة shell المُدارة أيضًا CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1، ويصف دليل تثبيت QCode هذا المتغير بأنه يعطّل طلبات الشبكة غير الأساسية مثل القياس عن بُعد. افتراضيًا لا يكتب سكربت النقرة الواحدة ANTHROPIC_MODEL، لذا يحتفظ Claude Code بنموذجه الافتراضي المدمج ويتبع ترقياته؛ لتثبيت نموذج واحد، مرّر --model، مثل claude-sonnet-5-5 أو claude-opus-5-5. يمكن استدعاء نماذج Claude الأخرى مثل claude-sonnet-5 بالطريقة نفسها. الفوترة حسب token، وأسعار كل نموذج على /models، ولا توجد لنماذج Claude فئة منفصلة للسياق الطويل.
الأسئلة الشائعة
كيف أثبّت Claude Code على Windows؟
في 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 install Anthropic.ClaudeCode يعمل أيضًا. يدعم Anthropic الإصدار Windows 10 1809+ أو Windows Server 2019+. يعد Git for Windows اختياريًا: معه يستخدم Claude Code Git Bash؛ ومن دونه يستخدم Claude Code PowerShell كأداة shell. مع WSL، شغّل أمر تثبيت Linux داخل طرفية WSL ثم شغّل claude هناك. للاتصال بـ QCode، شغّل irm https://qcode.cc/install/claude-code.ps1 | iex في PowerShell.
هل تظهر رسالة command not found: claude أو 'claude' is not recognized بعد التثبيت؟
عادةً لا يكون دليل التثبيت على PATH لديك بعد، لذا افتح أولًا نافذة طرفية جديدة وأعد المحاولة: تشير الوثائق إلى أن الجلسة التي ثبّت منها تحتفظ بقيمة PATH القديمة. يضع المثبّت الرسمي claude في ~/.local/bin/claude على macOS وLinux، وفي %USERPROFILE%\.local\bin\claude.exe على Windows؛ يمكن لمستخدمي Zsh تشغيل echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc، ويستخدم Bash على Linux السطر نفسه في ~/.bashrc. إذا كان الأمر مفقودًا بعد سكربت QCode على Windows، فتعطي وثائق QCode الحل نفسه: افتح نافذة PowerShell جديدة.
هل تظهر رسالة irm is not recognized، أو The token '&&' is not a valid statement separator؟
الأمر لا يطابق shell لديك. تشير الوثائق إلى أن رسالة 'irm' is not recognized تعني أنك في CMD، لذا استخدم أمر CMD أو افتح PowerShell؛ ورسالة The token '&&' is not a valid statement separator تعني أنك شغّلت أمر CMD في PowerShell. تشغيل curl -fsSL ... | bash في PowerShell يفشل عند المعامل fsSL لأن curl في PowerShell اسم مستعار لـ Invoke-WebRequest. لسكربت QCode في CMD، شغّل powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://qcode.cc/install/claude-code.ps1 | iex".
هل تظهر في PowerShell رسالة running scripts is disabled on this system؟
سياسة التنفيذ تحجب سكربتات التشغيل .ps1 التي ينشئها npm. تعطي الوثائق ثلاثة حلول: شغّل Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser وأعد المحاولة؛ أو استدعِ npm.cmd وclaude.cmd بدلًا من ذلك؛ أو تخطَّ npm واستخدم مثبّت PowerShell، الذي يثبّت ملفًا ثنائيًا بدلًا من سكربت .ps1. يخفف سكربت QCode بنقرة واحدة سياسة التنفيذ لتشغيله هو فقط ويترك إعداداتك على مستوى المستخدم وعلى مستوى الجهاز كما هي؛ ولإبقاء جلسات PowerShell المستقبلية غير محجوبة، تعطي وثائق QCode الأمر Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
يفشل npm install بالخطأ EACCES. هل ينبغي أن أستخدم sudo؟
لا. تقول Anthropic إنه لا ينبغي استخدام sudo npm install -g لأنه قد يؤدي إلى مشكلات في الأذونات ومخاطر أمنية؛ إذا كنت قد ثبّت باستخدام npm سابقًا وواجهت أخطاء أذونات خاصة بـ npm، توصي الوثائق بالانتقال إلى المثبّت الرسمي، curl -fsSL https://claude.ai/install.sh | bash. لا يحتاج سكربت QCode إلى sudo أيضًا: تشغيله باستخدام sudo يكتب الإعدادات في الدليل الرئيسي للمستخدم root، حيث لا يقرأه shell الخاص بك أبدًا، لذا أعد تشغيله بدون sudo.
فشل فحص سكربت QCode بالخطأ 401 أو 404 أو بانتهاء المهلة. ماذا الآن؟
اعتمد على رمز الحالة. تقول وثائق QCode إن 401 يعني أن المفتاح غير صالح أو منتهي الصلاحية: تحقق في لوحة التحكم من نسخ البادئة cr_ كاملة، ثم أعد التشغيل؛ ويعني 404 أن عنوان URL لنقطة النهاية خاطئ: بالنسبة إلى Claude Code، ينبغي أن يكون ANTHROPIC_BASE_URL بالشكل https://api.qcode.cc/api، من دون شرطة مائلة في النهاية؛ عند انتهاء المهلة، أعد التشغيل مع الخيار --domain لاختيار نقطة نهاية أخرى. إذا قال السكربت إن الإعدادات كُتبت لكن التحقق لم ينجح، فالإعدادات موجودة بالفعل، لذا أصلح السبب وأعد التشغيل. إعادة التشغيل آمنة دائمًا: تُحدَّث الكتلة المُدارة في مكانها وتُنسخ الملفات احتياطيًا قبل استبدالها.
المصادر
طرق التثبيت والمتطلبات والتحديثات: صفحتا الإعداد المتقدم والبدء السريع من وثائق Claude Code (code.claude.com). الأخطاء وإصلاحها: صفحة استكشاف أخطاء التثبيت وتسجيل الدخول الرسمية. معاني المتغيرات: صفحتا متغيرات البيئة والمصادقة الرسميتان. الإصدارات: GitHub Releases وCHANGELOG الخاص بـ anthropics/claude-code، وبيانات npm الوصفية لـ @anthropic-ai/claude-code. من جانب QCode: صفحتا وثائق QCode الخاصتان بسكربت الإعداد بنقرة واحدة ودليل التثبيت (حُدِّثتا في 2026-09-25)، إضافةً إلى سكربت claude-code.sh العام على qcode.cc (قُرئ فقط، ولم يُنفَّذ). جُمِع كل ذلك في 2026-10-07.
ثبّته واتصل بـ QCode بأمر واحد
جهّز مفتاح cr_ الخاص بك وشغّل سكربت الإعداد بنقرة واحدة. تتم المحاسبة لكل token؛ وأسعار كل نموذج على /models.
قراءات ذات صلة
إعداد magpie لـ Claude Code: بوابة محلية لـ Claude Code وCodex (2026-11)
إعداد magpie: أوامر التثبيت وإلغاء التثبيت، وثلاث طرق لإضافة مزوّد، واختيار النماذج لـ Claude Code وCodex، وعناوين QCode الثلاثة.
دليل إعداد ANTHROPIC_BASE_URL و AUTH_TOKEN
وجّه Claude Code إلى نقطة نهاية مخصصة باستخدام متغيّري بيئة.
كيفية استخدام Claude Code في الصين
الدفع عبر Alipay / WeChat وخطوات الإعداد.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تم التحقق من الأوامر والاقتباسات في هذه الصفحة في 2026-10-07؛ ولوثائق Claude Code الرسمية ووثائق QCode الأولوية، وقد تحدث تغييرات دون إشعار. تتغير أوامر التثبيت ونصوص الأخطاء بين الإصدارات، لذا اعتمد على الإصدار الذي لديك؛ وتوافر النماذج كما هو مُدرج على /models.