# التثبيت

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

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

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

> راجع [سكربت الإعداد بنقرة واحدة](/docs/getting-started/one-click-install) للاطلاع على الخيارات واستكشاف الأخطاء وإصلاحها والتراجع.

> 📖 هل تتساءل عمّا يجب وضعه في `ANTHROPIC_BASE_URL`، أو أي نطاق وصول من النطاقات الثلاثة تختار؟ راجع [نقاط النهاية ومسارات API](./endpoints-and-api-paths).

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

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

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

<div data-os="windows" markdown="1">

## Windows

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

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

1. افتح متصفحك وزُر [https://nodejs.org/](https://nodejs.org/)

2. انقر على تنزيل إصدار «LTS» (إصدار الدعم طويل الأمد الموصى به)

3. انقر نقرًا مزدوجًا على ملف `.msi` الذي تم تنزيله

4. اتبع معالج التثبيت باستخدام الإعدادات الافتراضية

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

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

```powershell
# Using Chocolatey
choco install nodejs

# Or using Scoop
scoop install nodejs
```

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

```powershell
node --version
npm --version
```

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

افتح PowerShell أو CMD:

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

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

```powershell
claude --version
```

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

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

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

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

```powershell
[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](https://qcode.cc/dashboard).

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

```powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
```

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

```powershell
# 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؟**

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

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

- بعد ضبطها بشكل دائم، أعد تشغيل PowerShell أو CMD

- أو سجّل الخروج من Windows ثم سجّل الدخول مرة أخرى

</div>

<div data-os="macos" markdown="1">
## macOS

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

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

```bash
brew update
brew install node
```

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

1. زر [https://nodejs.org/](https://nodejs.org/)

2. نزّل إصدار LTS الخاص بـ macOS

3. افتح ملف `.pkg` الذي نزّلته

4. اتبع تعليمات التثبيت

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

```bash
node --version
npm --version
```

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

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

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

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

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

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

```bash
brew install --cask claude-code
```

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

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

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

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

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

```bash
# 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](https://qcode.cc/dashboard).

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

```bash
# 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"

</div>

<div data-os="linux" markdown="1">

## Linux / WSL2

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

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

```bash
# 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: باستخدام مدير حزم النظام

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

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm
```

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

```bash
node --version
npm --version
```

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

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

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

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

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

```bash
claude --version
```

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

#### مؤقت

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

#### دائم

```bash
# 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: بدء الاستخدام

```bash
cd /path/to/your/project
claude
```

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

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

```bash
# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"
```

</div>
## الإعداد المتقدم (متغيرات بيئة اختيارية)

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

### ANTHROPIC_MODEL

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

```bash
# 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 للتعطيل):

```bash
export MAX_THINKING_TOKENS=16000
```

### CLAUDE_CODE_EFFORT_LEVEL

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

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

### CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

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

```bash
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

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

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

1. اطّلع على [البدء السريع](/docs/getting-started/quick-start) لتتعلم الاستخدام الأساسي

2. استكشف [نصائح CLI](/docs/usage/cli-tips) لرفع الكفاءة