# تثبيت Claude Code على ويندوز: الخطوات ومفتاح API وحل الأخطاء

> ثبّت Claude Code على ويندوز 10 أو 11 عبر PowerShell أو CMD أو WinGet أو WSL، ثم سجّل الدخول أو أضف مفتاح API، وحلّ أخطاء التثبيت الشائعة.

آخر تحديث: 2026-11-01

لتثبيت Claude Code على ويندوز، افتح PowerShell وشغّل أداة التثبيت من Anthropic: `irm https://claude.ai/install.ps1 | iex`. ثم افتح طرفية جديدة وتحقق من التثبيت بالأمر `claude --version`. تحتاج إلى ويندوز 10 أو 11 بنظام 64 بت، ولا تحتاج إلى صلاحيات المسؤول. بعدها سجّل الدخول باشتراك Claude، أو ضع مفتاح API وعنوان الأساس في ملف إعدادات Claude Code.

## ما الذي تحتاجه قبل التثبيت؟

- **إصدار ويندوز:** ويندوز 10 الإصدار 1809 أو أحدث، أو ويندوز 11، أو Windows Server 2019 أو أحدث.
- **المعالج:** بنظام 64 بت، من نوع x64 أو ARM64. لا يعمل Claude Code على ويندوز 32 بت.
- **الذاكرة:** ذاكرة عشوائية بسعة 4 جيجابايت أو أكثر، مع اتصال بالإنترنت.
- **الطرفية:** PowerShell أو موجّه الأوامر (Command Prompt). تثبيت Git for Windows اختياري، لكن Anthropic توصي به.
- **طريقة للدفع مقابل النموذج:** اشتراك Claude من Anthropic يشمل Claude Code، مثل Pro وMax وUltra وTeam وEnterprise، أو حساب في Anthropic Console، أو مفتاح API من خدمة متوافقة مثل 5abeer. ولا تشمل باقة Claude المجانية أداة Claude Code.

## كيف أثبّت Claude Code على ويندوز؟

توصي Anthropic بأداة التثبيت الأصلية. تضع الأداة Claude Code في مجلد المستخدم، وتحدّثه تلقائيًا في الخلفية.

### 1. افتح PowerShell

افتح قائمة ابدأ، واكتب PowerShell، ثم اختر **Windows PowerShell**، وتجنّب الخيار الذي يحمل علامة (x86). لا تحتاج إلى «تشغيل كمسؤول». يبدأ سطر PowerShell بالنص `PS C:\`، أما سطر موجّه الأوامر فيبدأ بالنص `C:\` وحده.

### 2. شغّل أداة التثبيت

الصق الأمر الخاص بالنافذة التي فتحتها، ثم اضغط Enter:

PowerShell:

```powershell
irm https://claude.ai/install.ps1 | iex
```

Command Prompt:

```text
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

لا تعرض أداة التثبيت شريط تقدم أثناء التنزيل، فامنحها دقيقة أو دقيقتين.

### 3. افتح نافذة جديدة وتحقق

أغلق الطرفية، وافتح طرفية جديدة، ثم شغّل:

```powershell
claude --version
```

إذا ظهر رقم إصدار، فقد نجح التثبيت. وللفحص الأشمل، يعرض الأمر `claude doctor` حالة التثبيت والإعدادات دون أن يغيّر شيئًا. وإذا ظهرت رسالة بأن الأمر `claude` غير معروف، فانظر حل مشكلة PATH في قسم الأخطاء أدناه.

### طرق أخرى للتثبيت

| الطريقة | أمر التثبيت | التحديث |
| --- | --- | --- |
| أداة التثبيت الأصلية | أمر PowerShell أو CMD أعلاه | تلقائي، أو بالأمر `claude update` |
| WinGet | `winget install Anthropic.ClaudeCode` | يدوي بالأمر `winget upgrade Anthropic.ClaudeCode` |
| npm مع Node.js 22 أو أحدث | `npm install -g @anthropic-ai/claude-code` | تلقائي، أو نفّذ الأمر نفسه مرة أخرى مع `@latest` في آخره |

أغلق Claude Code قبل `winget upgrade`، لأن ويندوز يمنع استبدال ملف البرنامج ما دام يعمل. ومع npm، تجنّب `npm update -g`، فقد لا ينقلك إلى أحدث إصدار.

## ويندوز مباشرة أم WSL؟

يعمل Claude Code مباشرة على ويندوز، ويعمل أيضًا داخل WSL، أي نظام ويندوز الفرعي للينكس. والفرق الأساسي بينهما هو العزل (Sandboxing)، الذي يحدّ مما تصل إليه الأوامر التي ينفذها Claude:

| البيئة | العزل | طريقة التثبيت |
| --- | --- | --- |
| ويندوز مباشرة | غير مدعوم | أداة التثبيت عبر PowerShell أو CMD |
| WSL 2 | مدعوم | أداة تثبيت لينكس، داخل طرفية WSL |
| WSL 1 | غير مدعوم | أداة تثبيت لينكس، داخل طرفية WSL |

وهذا أمر تثبيت لينكس داخل طرفية WSL:

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

ثم شغّل `claude` من طرفية WSL نفسها، لا من PowerShell.

أما على ويندوز مباشرة، فيستخدم Claude Code برنامج Git Bash إذا كان Git for Windows مثبتًا، ويستخدم PowerShell إذا لم يكن مثبتًا. وإذا لم يعثر على Git Bash، فحدد مساره في ملف الإعدادات:

```json
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
```

## هل أسجّل الدخول باشتراك Claude أم أستخدم مفتاح API؟

**باشتراك Claude:** شغّل `claude`، فيفتح المتصفح لتسجيل الدخول بحساب Claude أو بحساب Anthropic Console. وإذا لم يُفتح المتصفح، فاضغط `c` لنسخ رابط تسجيل الدخول.

**بمفتاح API:** إذا وجد Claude Code في ملف الإعدادات مفتاحًا وعنوان أساس، فإنه يتخطى تسجيل الدخول، ويرسل كل طلب إلى هذا العنوان، ويُحاسب صاحب المفتاح على كل توكن. ولا تخضع هذه الطلبات لحدود الاشتراك. أنشئ مفتاحًا من لوحة التحكم ([طريقة إنشاء المفتاح](https://5abeer.ai/ar/docs/start/keys.md#create))، ثم أضف هذه الإعدادات:

`~/.claude/settings.json`

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.5abeer.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_5ABEER_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5.5"
  }
}
```

على ويندوز، يقابل المسار `~/.claude/settings.json` المسار `%USERPROFILE%\.claude\settings.json`. ينشئ هذان الأمران المجلد عند الحاجة، ويفتحان الملف في المفكرة:

```powershell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
notepad "$env:USERPROFILE\.claude\settings.json"
```

إذا كان في الملف قسم `env` من قبل، فأضف السطور الثلاثة إليه. واحفظ المفتاح في هذا الملف الشخصي وحده، ولا تضعه أبدًا في ملف `.claude\settings.json` داخل مشروع، لأن هذا الملف يُرفع عادةً إلى Git.

ولتجربة مفتاح في جلسة واحدة، اضبط المتغيرات في PowerShell بدلًا من الملف. تختفي هذه المتغيرات عند إغلاق النافذة، وتتقدم عليها قيم ملف الإعدادات. ضع قيمة `ANTHROPIC_BASE_URL` من الإعدادات المعروضة أعلاه مكان `BASE_URL`:

```powershell
$env:ANTHROPIC_BASE_URL = "BASE_URL"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_5ABEER_API_KEY"
claude
```

## كيف أتحقق من أول تشغيل؟

افتح الطرفية في مجلد مشروعك، وشغّل `claude`، ثم اكتب `/status`. إذا كان المفتاح فعّالًا، يعرض تبويب Status سطر **Anthropic base URL** بعنوان 5abeer، وسطر **Auth token** الذي يذكر `ANTHROPIC_AUTH_TOKEN`. أما ظهور سطر **Login method** الذي يذكر claude.ai فمعناه أن Claude Code ما زال يستخدم تسجيل دخول محفوظًا.

وهذه عناوين الأساس لكل صيغة API:

| الصيغة | العنوان الأساسي | ترويسة المفتاح |
| --- | --- | --- |
| OpenAI | `https://api.5abeer.ai/v1` | `Authorization: Bearer <KEY>` |
| Anthropic | `https://api.5abeer.ai` | `x-api-key: <KEY>` |
| Gemini | `https://api.5abeer.ai/v1beta` | `x-goog-api-key: <KEY>` |

ولاختبار المفتاح خارج Claude Code، شغّل هذا الطلب في PowerShell. إذا جاء الرد ولم يعمل Claude Code، فالمشكلة في ملف الإعدادات، لا في المفتاح.

```bash
curl --request POST "https://api.5abeer.ai/v1/messages" \
  --header "x-api-key: $KHABEER_API_KEY" \
  --header "Content-Type: application/json" \
  --header "anthropic-version: 2023-06-01" \
  --data '{"model":"claude-sonnet-5.5","max_tokens":512,"messages":[{"role":"user","content":"اكتب فكرة منتج في سطر واحد"}]}'
```

```python
import os
import requests

response = requests.post(
    "https://api.5abeer.ai/v1/messages",
    headers={
        "x-api-key": os.environ['KHABEER_API_KEY'],
        "Content-Type": "application/json",
        "anthropic-version": "2023-06-01",
    },
    json={
    "model": "claude-sonnet-5.5",
    "max_tokens": 512,
    "messages": [
        {
            "role": "user",
            "content": "اكتب فكرة منتج في سطر واحد"
        }
    ]
},
    stream=False,
    timeout=60,
)

response.raise_for_status()
print(response.json())
```

## كيف أحل أخطاء ويندوز الشائعة؟

تأتي أغلب أخطاء التثبيت من تشغيل الأمر في نافذة غير مناسبة:

- `'irm' is not recognized`: أنت في موجّه الأوامر. استخدم أمر CMD، أو افتح PowerShell.
- `The token '&&' is not a valid statement separator`: أنت في PowerShell. استخدم أمر PowerShell.
- `A parameter cannot be found that matches parameter name 'fsSL'` أو `'bash' is not recognized`: شغّلت أمر macOS أو لينكس. استخدم أمر ويندوز، أو شغّله داخل WSL.
- `running scripts is disabled on this system`: منع PowerShell تشغيل السكربت الذي ثبّته npm. نفّذ `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`، أو استخدم أداة التثبيت الأصلية.
- `The process cannot access the file ... because it is being used by another process`: أغلق برامج التثبيت الأخرى أو انتظر حتى ينتهي برنامج مكافحة الفيروسات، ثم احذف المجلد `%USERPROFILE%\.claude\downloads` وشغّل أداة التثبيت مرة أخرى.
- `Claude Code does not support 32-bit Windows`: نفّذ `[Environment]::Is64BitOperatingSystem`. إذا كانت النتيجة `True` فقد فتحت نسخة PowerShell التي تحمل علامة (x86)، فافتح النسخة العادية. وإذا كانت `False` فويندوز نفسه بنظام 32 بت.
- `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell`: ثبّت Git for Windows مع اختيار «Add to PATH»، أو ثبّت PowerShell 7.

### الأمر claude غير معروف

تضع أداة التثبيت الملف `claude.exe` في المجلد `%USERPROFILE%\.local\bin`، لكنها لا تضيف هذا المجلد إلى متغير PATH. وعندها تعرض ملاحظات الإعداد الرسالة `Native installation exists but C:\Users\you\.local\bin is not in your PATH.` أضف المجلد لمستخدمك، ثم افتح طرفية جديدة:

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

وإذا توقف `claude` عن العمل بعد تحديث مباشرةً، فاستعد النسخة الاحتياطية التي يحتفظ بها المحدِّث:

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

وقد تستحوذ نسخة قديمة من تطبيق Claude لسطح المكتب على الأمر `claude`. يعرض الأمر `where.exe claude` كل النتائج، فإذا جاء تطبيق سطح المكتب أولًا، فحدّثه.

### ما زال Claude Code يطلب تسجيل الدخول

لم يعثر Claude Code على مفتاح. تأكد أن `ANTHROPIC_AUTH_TOKEN` داخل قسم `env`، وأن صيغة JSON في الملف صحيحة. ولمسح تسجيل دخول قديم إلى claude.ai، شغّل `/logout` ثم أعد تشغيل Claude Code. أما المفتاح في `ANTHROPIC_API_KEY` فيحتاج إلى موافقة لمرة واحدة، وإذا رفضتها فأعد تفعيلها من `/config`.

وإذا رُفض طلب برمز خطأ، فالرمز [`INVALID_API_KEY`](https://5abeer.ai/ar/docs/help/errors.md#INVALID_API_KEY) يعني أن المفتاح خطأ أو محذوف، والرمز [`INSUFFICIENT_BALANCE`](https://5abeer.ai/ar/docs/help/errors.md#INSUFFICIENT_BALANCE) يعني أن رصيدك لا يكفي للطلب. وكل الرموز في [رموز الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md).

## كيف أشغّل Claude Code على ويندوز عبر 5abeer؟

5abeer خدمة مستقلة متوافقة مع واجهة Anthropic Messages، لذلك يعمل Claude Code كما تصدره Anthropic، ولا يتغير إلا عنوان الأساس والمفتاح. ولك طريقان:

- **مفتاح API تدفع فيه حسب الاستخدام.** تدفع ثمن التوكنات من رصيدك، وتضع لكل مفتاح حد إنفاق وتاريخ انتهاء وقائمة عناوين IP مسموح بها ([التحكم في المفاتيح](https://5abeer.ai/ar/docs/start/keys.md#controls)). وأسعار Claude في [صفحة Claude API](https://5abeer.ai/ar/api/claude).
- **باقة 5abeer.** يجهّز تطبيق 5abeer AI لويندوز أداة Claude Code على باقتك بضغطة واحدة، دون مفتاح ودون تعديل ملفات ([ما الذي تشغّله كل باقة](https://5abeer.ai/ar/docs/subscriptions/plan-apps.md#claude-code)). الباقات مخصصة للتطبيقات المدعومة، ولاستخدام النماذج من الكود الخاص بك تحتاج إلى مفتاح API. راجع [صفحة الأسعار](https://5abeer.ai/ar/pricing) و[صفحة Claude Code](https://5abeer.ai/ar/apps/claude-code).

وكل الإعدادات مشروحة في [صفحة Claude Code في التوثيق](https://5abeer.ai/ar/docs/apps/claude-code.md).

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

### هل أحتاج إلى صلاحيات المسؤول؟

لا. تضع أداة التثبيت الأصلية Claude Code في مجلد المستخدم، فتكفيك نافذة PowerShell أو موجّه أوامر عادية.

### هل أحتاج إلى Git for Windows؟

لا، لكن Anthropic توصي به. عند تثبيته يستخدم Claude Code برنامج Git Bash لأداة Bash، ودونه ينفذ أوامر الطرفية عبر PowerShell. ولا تحتاج إليه داخل WSL.

### هل يعمل Claude Code على ويندوز 32 بت؟

لا. يحتاج إلى ويندوز 64 بت على معالج x64 أو ARM64.

### هل أحتاج إلى حساب Anthropic؟

فقط إذا أردت تسجيل الدخول باشتراك Claude أو بحساب Console. أما مع مفتاح API وعنوان أساس في ملف الإعدادات، فلا يطلب منك Claude Code تسجيل الدخول.

### كيف أحدّثه أو أزيله؟

يحدّث التثبيت الأصلي نفسه تلقائيًا، والأمر `claude update` يحدّثه في الحال. أما تثبيت WinGet فيُحدَّث بالأمر `winget upgrade Anthropic.ClaudeCode` ويُزال بالأمر `winget uninstall Anthropic.ClaudeCode`. ولإزالة التثبيت الأصلي، نفّذ في PowerShell:

```powershell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
```

تبقى إعداداتك في `%USERPROFILE%\.claude` وفي `%USERPROFILE%\.claude.json` حتى تحذفها بنفسك.

### هل أستطيع استخدام Claude Code في VS Code على ويندوز؟

نعم. تحمل إضافة VS Code نسختها الخاصة من Claude Code، فتعمل دون التثبيت من الطرفية، لكنها لا تضيف الأمر `claude` إلى PATH. ولتعطي الإضافة مفتاحًا، أضف `claudeCode.environmentVariables` إلى إعدادات المستخدم في VS Code، كما يشرح دليل [Claude Code في VS Code](https://5abeer.ai/ar/guides/claude-code-vscode).

### أي نموذج أستخدم؟

ابدأ بالنموذج الافتراضي [`claude-sonnet-5.5`](https://5abeer.ai/ar/models/claude-sonnet-5.5)، فهو يكفي أغلب مهام البرمجة. وانتقل إلى [`claude-opus-5.5`](https://5abeer.ai/ar/models/claude-opus-5.5) أو [`claude-fable-5.1`](https://5abeer.ai/ar/models/claude-fable-5.1) في أصعب المشكلات. بدّل النموذج بالإعداد `ANTHROPIC_MODEL`، أو من داخل Claude Code بالأمر `/model`. والقائمة كاملة بأسعارها في [صفحة النماذج](https://5abeer.ai/ar/models).

## المصادر

راجعناها في 2026-11-01:

- توثيق Claude Code: [Advanced setup](https://code.claude.com/docs/en/setup)
- توثيق Claude Code: [Troubleshoot installation and login](https://code.claude.com/docs/en/troubleshoot-install)
- توثيق Claude Code: [Other LLM gateways](https://code.claude.com/docs/en/llm-gateway)
- توثيق Claude Code: [Connect Claude Code to an LLM gateway](https://code.claude.com/docs/en/llm-gateway-connect)

> 5abeer خدمة مستقلة، ولا تتبع OpenAI أو Anthropic أو Google.

## ابدأ

قارن بين الاشتراك ومفتاح API في [أرخص طريقة لاستخدام Claude Code](https://5abeer.ai/ar/guides/claude-code-cheapest-way)، وتعرّف إلى الأساسيات في [ما هو مفتاح API وكيف تحصل على واحد](https://5abeer.ai/ar/guides/ai-api-key-guide)، أو جهّز [Codex CLI بمفتاح API](https://5abeer.ai/ar/guides/codex-cli-api-key).