التثبيت

ثبّت Claude Code واضبط إعداداته على Windows وmacOS وLinux

آخر تحديث 2026-11-13

تحتاج مفتاح API؟ أنشئ حسابًا ←نقاط النهاية وعناوين Base URL ←

في هذه الصفحة

المتطلبات الأساسية
Windows
macOS
Linux / WSL2
الإعداد المتقدم (متغيرات بيئة اختيارية)
الخطوات التالية

⚡ موصى به: الإعداد بنقرة واحدة — أمر واحد ينفّذ كل شيء في هذه الصفحة (اختبار سرعة نقطة النهاية، والإعداد، وتثبيت Node.js / Claude Code، وفحص الاتصال؛ دون sudo). تابع القراءة للتثبيت اليدوي.

# macOS / Linux
curl -fsSL https://qcode.cc/install/claude-code.sh | bash

# Windows PowerShell
irm https://qcode.cc/install/claude-code.ps1 | iex

راجع سكربت الإعداد بنقرة واحدة للاطلاع على الخيارات واستكشاف الأخطاء وإصلاحها والتراجع.

📖 هل تتساءل عمّا يجب وضعه في ANTHROPIC_BASE_URL، أو أي نطاق وصول من النطاقات الثلاثة تختار؟ راجع نقاط النهاية ومسارات API.

اتبع هذا الدليل لتثبيت Claude Code واستخدامه بسهولة على حاسوبك. تستغرق العملية بأكملها 5 دقائق فقط.

المتطلبات الأساسية¶

يحتاج Claude Code إلى Node.js ليعمل. يُرجى التأكد من تثبيت Node.js 18.0 أو أحدث على حاسوبك (يُوصى بـ 22 LTS).

Windows¶

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

الخيار أ: التنزيل الرسمي (موصى به)¶

افتح متصفحك وزُر https://nodejs.org/
انقر على تنزيل إصدار «LTS» (إصدار الدعم طويل الأمد الموصى به)
انقر نقرًا مزدوجًا على ملف .msi الذي تم تنزيله
اتبع معالج التثبيت باستخدام الإعدادات الافتراضية

الخيار ب: استخدام مدير الحزم¶

إذا كان Chocolatey أو Scoop مثبتًا لديك:

# Using Chocolatey
choco install nodejs

# Or using Scoop
scoop install nodejs

التحقق من التثبيت¶

node --version
npm --version

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

افتح PowerShell أو CMD:

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

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

claude --version

الخطوة 3: ضبط متغيرات البيئة¶

مؤقت (الجلسة الحالية)¶

$env:ANTHROPIC_BASE_URL = "https://api.qcode.cc/api"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"

دائم (موصى به)¶

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.qcode.cc/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key", [System.EnvironmentVariableTarget]::User)

استبدل your-api-key بمفتاحك الفعلي من لوحة تحكم QCode.cc.

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

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

الخطوة 4: بدء الاستخدام¶

# Go to your project directory
cd C:\path\to\your\project

# Start Claude Code
claude

الأسئلة الشائعة حول Windows¶

خطأ في الأذونات؟

شغّل PowerShell كمسؤول
أو وجّه npm إلى دليل المستخدم لديك: npm config set prefix %APPDATA%\npm

خطأ في سياسة تنفيذ PowerShell؟

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

متغيرات البيئة لا تسري؟

بعد ضبطها بشكل دائم، أعد تشغيل PowerShell أو CMD
أو سجّل الخروج من Windows ثم سجّل الدخول مرة أخرى

macOS¶

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

الخيار A: باستخدام Homebrew (موصى به)¶

brew update
brew install node

الخيار B: التنزيل الرسمي¶

زر https://nodejs.org/
نزّل إصدار LTS الخاص بـ macOS
افتح ملف .pkg الذي نزّلته
اتبع تعليمات التثبيت

التحقق من التثبيت¶

node --version
npm --version

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

الخيار A: باستخدام npm¶

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

إذا واجهت مشكلات في الأذونات:

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

الخيار B: باستخدام Homebrew¶

brew install --cask claude-code

الخطوة 3: تعيين متغيرات البيئة¶

مؤقت (الجلسة الحالية)¶

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"

دائم (موصى به)¶

حرّر ملف إعدادات shell الخاص بك:

# For zsh (macOS default)
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc

# For bash
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bash_profile
source ~/.bash_profile

استبدل your-api-key بالمفتاح الفعلي الخاص بك من لوحة التحكم QCode.cc.

الخطوة 4: بدء الاستخدام¶

# Go to your project directory
cd /path/to/your/project

# Start Claude Code
claude

الأسئلة الشائعة حول macOS¶

خطأ في الأذونات؟

ثبّت باستخدام sudo: sudo npm install -g @anthropic-ai/claude-code
أو وجّه npm إلى دليل المستخدم الخاص بك: npm config set prefix ~/.npm-global

هل يحظر macOS الملف التنفيذي؟

افتح "System Settings" → "Privacy & Security"
انقر على "Open Anyway" أو "Allow"

Linux / WSL2¶

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

الخيار A: باستخدام NodeSource (موصى به)¶

# Add the NodeSource repository
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# Install Node.js
sudo apt-get install -y nodejs

الخيار B: باستخدام مدير حزم النظام¶

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

التحقق من التثبيت¶

node --version
npm --version

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

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

إذا واجهت مشكلة في الأذونات:

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

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

claude --version

الخطوة 3: تعيين متغيرات البيئة¶

مؤقت¶

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"

دائم¶

# For bash (default)
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bashrc
source ~/.bashrc

# For zsh
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc

الخطوة 4: بدء الاستخدام¶

cd /path/to/your/project
claude

الأسئلة الشائعة حول Linux¶

هل توجد تبعيات بناء مفقودة؟

# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"

الإعداد المتقدم (متغيرات بيئة اختيارية)¶

بالإضافة إلى المتغيرين المطلوبين، يمكنك تخصيص الإعداد بشكل أكبر باستخدام هذه المتغيرات الاختيارية:

ANTHROPIC_MODEL¶

حدّد النموذج الافتراضي. نوصي بتعيين Sonnet 5 صراحةً. إذا لم يُعيَّن، يستخدم Claude Code الإعداد الافتراضي المدمج الخاص به لذلك الإصدار من CLI — لا تعتمد على اسم افتراضي تاريخي من هذه الصفحة. تظل معرّفات 4.x مثل claude-sonnet-4-6 وclaude-opus-4-8 معروضة للبيع.

# Daily recommendation (Sonnet 5)
export ANTHROPIC_MODEL=claude-sonnet-5

# Heavy work (Opus 5, higher cost)
export ANTHROPIC_MODEL=claude-opus-5

MAX_THINKING_TOKENS¶

تحكّم في الحد الأقصى لعدد tokens في عملية تفكير النموذج (اضبطه على 0 للتعطيل):

export MAX_THINKING_TOKENS=16000

CLAUDE_CODE_EFFORT_LEVEL¶

اضبط مستوى الجهد لدى Claude:

# Options: low / medium / high
export CLAUDE_CODE_EFFORT_LEVEL=high

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC¶

عطّل طلبات الشبكة غير الضرورية (مثل القياس عن بُعد):

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

الخطوات التالية¶

تهانينا! لقد ثبّت Claude Code بنجاح. الخطوات التالية:

اطّلع على البدء السريع لتتعلم الاستخدام الأساسي
استكشف نصائح CLI لرفع الكفاءة

نقاط النهاية ومسارات API

← التالي

متغيرات البيئة

ابدأ مع QCode

مفتاح API واحد لـ Claude Code وCodex وغيرها — تُحسب حسب التوكن، وأسعار كل نموذج على qcode.cc/models

أنشئ حسابًا عرض خطط الأسعار ←

المؤسسات ←

التثبيت

المتطلبات الأساسية¶

Windows¶

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

الخيار أ: التنزيل الرسمي (موصى به)¶

الخيار ب: استخدام مدير الحزم¶

التحقق من التثبيت¶

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

الخطوة 3: ضبط متغيرات البيئة¶

مؤقت (الجلسة الحالية)¶

دائم (موصى به)¶

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

الخطوة 4: بدء الاستخدام¶

الأسئلة الشائعة حول Windows¶

macOS¶

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

الخيار A: باستخدام Homebrew (موصى به)¶

الخيار B: التنزيل الرسمي¶

التحقق من التثبيت¶

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

الخيار A: باستخدام npm¶

الخيار B: باستخدام Homebrew¶

الخطوة 3: تعيين متغيرات البيئة¶

مؤقت (الجلسة الحالية)¶

دائم (موصى به)¶

الخطوة 4: بدء الاستخدام¶

الأسئلة الشائعة حول macOS¶

Linux / WSL2¶

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

الخيار A: باستخدام NodeSource (موصى به)¶

الخيار B: باستخدام مدير حزم النظام¶

التحقق من التثبيت¶

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

الخطوة 3: تعيين متغيرات البيئة¶

مؤقت¶

دائم¶

الخطوة 4: بدء الاستخدام¶

الأسئلة الشائعة حول Linux¶

الإعداد المتقدم (متغيرات بيئة اختيارية)¶

ANTHROPIC_MODEL¶

MAX_THINKING_TOKENS¶

CLAUDE_CODE_EFFORT_LEVEL¶

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC¶

الخطوات التالية¶

وثائق ذات صلة