Claude في التيرمنال، بيفتح موقعك في Chrome، وبيشتغل بطريقتك

تشغيل Claude Code في التيرمنال

Claude Code أداة بتشتغل جوه فولدر مشروعك: بتقرا الملفات، تعدّل الكود، تشغّل أوامر، وتتكلم معاها بالعربي عادي.

1. اتأكد إن معاك اشتراك

   محتاج اشتراك Claude (Pro أو Max أو Team أو Enterprise)، أو حساب Claude Console بـ API. الاشتراك هو الأنسب، وكمان ضروري لو عايز تستخدم إضافة Chrome بعدين.

2. ثبّت Claude Code
   macOS / Linux / WSL

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

   نسخ
   Windows PowerShell

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

   نسخ
   أو لو بتستخدم Homebrew / WinGet

   brew install --cask claude-code
   winget install Anthropic.ClaudeCode

   نسخ

   على ويندوز يُفضّل تنزّل Git for Windows عشان Claude يقدر يستخدم Bash. اتأكد إن التثبيت تمام:

   claude --version

   نسخ
3. ادخل فولدر المشروع وشغّله

   cd path/to/my-website
   claude

   نسخ

   أول مرة هيفتح المتصفح عشان تسجّل دخول. لو عايز تغيّر الحساب بعدين اكتب /login جوه الجلسة.

4. خليه يفهم المشروع الأول

   قبل أي تعديل، اسأله يستكشف. هو بيقرا الملفات لوحده، مش محتاج تلزق له كود.

   المشروع ده بيعمل إيه؟ واشرحلي هيكل الفولدرات

   إيه التقنيات المستخدمة هنا؟ وفين نقطة البداية؟

   وبعدها اكتب /init عشان يعمل ملف CLAUDE.md فيه ملخص المشروع وأوامره، وده بيتقري في كل جلسة جديدة.

5. ابدأ اشتغل

   كلّمه زي زميل: كن محدد. بدل «صلّح البج» قول «صلّح مشكلة إن صفحة اللوجين بتبقى فاضية لما الباسورد يبقى غلط». لما يطلب إذن قبل تعديل، وافق أو ارفض. اضغط Shift+Tab عشان تبدّل وضع الأذونات (مثلاً Plan mode اللي بيخطط من غير ما يعدّل).

أهم الأوامر

ربط Claude Code بإضافة Claude in Chrome

من غير الإضافة، Claude شايف الكود بس. بالإضافة بيفتح موقعك فعلاً في المتصفح: يضغط، يملا فورمز، يقرا أخطاء الـ Console، ياخد سكرين شوت، ويرجع يصلّح الكود اللي عمل المشكلة.

المتطلبات

متصفح Chrome أو Edge (أو Brave وArc وVivaldi وOpera)، وإضافة Claude in Chrome إصدار 1.0.36 أو أحدث، واشتراك Anthropic مباشر (Pro أو Max أو Team أو Enterprise)، وتكون داخل بـ /login.

1. نزّل الإضافة وسجّل دخول بنفس الحساب

   من Chrome Web Store، وبعد التثبيت اقفل Chrome وافتحه تاني.

2. شغّل Claude Code مع Chrome

   claude --chrome

   نسخ

   أول مرة هتظهر رسالة تعريفية، اضغط Enter. ولو Claude احتاج المتصفح ومش لاقي الإضافة، هيعرض عليك يثبتها ويكمّل في نفس الجلسة.

3. اتأكد من الاتصال

   /chrome

   نسخ

   المفروض تشوف Status: Enabled وExtension: Installed. من نفس القايمة تقدر تختار «Enabled by default» عشان متكتبش --chrome كل مرة (بس خلي بالك إنه بيستهلك context أكتر).

4. جرّب
   افتح localhost:3000 وجرّب فورم التسجيل ببيانات غلط، وقولي رسائل الخطأ بتظهر صح ولا لأ

   افتح صفحة الداشبورد وشوف فيه أخطاء في الـ Console وقت التحميل، وصلّح سببها في الكود

Claude بيفتح تابات جديدة في مجموعة خاصة بالجلسة، وبيستخدم نفس تسجيلات الدخول اللي عندك. لما يقابل صفحة لوجين أو CAPTCHA بيقف ويطلب منك تعملها بإيدك. الصلاحيات لكل موقع بتتحدد من إعدادات الإضافة نفسها.

إضافة سكيلز للمشروع

السكيل ببساطة ملف SKILL.md فيه تعليمات لشغلانة معينة. بدل ما تلزق نفس الخطوات كل مرة، تكتبها مرة واحدة، وClaude يستخدمها لوحده لما تبقى مناسبة، أو تناديها انت بـ /اسم-السكيل.

تحطها فين؟

شكل المشروع بعد الإضافة

my-website/
├── CLAUDE.md                  ← معلومات عامة عن المشروع (بتتقري دايماً)
├── .claude/
│   └── skills/
│       ├── site-audit/
│       │   ├── SKILL.md       ← تحليل الموقع
│       │   └── checklist.md   ← ملف مساعد اختياري
│       └── new-page/
│           └── SKILL.md       ← إنشاء صفحة بنفس ستايل الموقع
└── src/ ...

تركيب ملف SKILL.md

جزئين: فوق بين علامتين --- فيه name (بيبقى اسم الأمر) وdescription (Claude بيقراها عشان يقرر يستخدم السكيل إمتى، فاكتبها واضحة). وتحتها التعليمات نفسها بالماركداون.

1. اعمل الفولدر

   mkdir -p .claude/skills/site-audit

   نسخ
2. اكتب الملف (المثال ده جاهز لتحليل موقعك، عدّله على مزاجك)
   .claude/skills/site-audit/SKILL.md

   ---
   name: site-audit
   description: تحليل شامل لموقع ويب: الأداء، السيو، الأخطاء، الموبايل، وسهولة الاستخدام. استخدمها لما المستخدم يطلب يحلل أو يراجع أو يفحص الموقع.
   ---
   
   # تحليل الموقع
   
   ## الخطوات
   1. افتح الرابط اللي المستخدم إداه في Chrome (لو مفيش رابط، شغّل المشروع محلياً وافتح localhost).
   2. اقرا أخطاء وتحذيرات الـ Console في الصفحة الرئيسية وأهم ٣ صفحات.
   3. راجع السيو: title و meta description و h1 واحد لكل صفحة و alt للصور.
   4. جرّب الموقع بعرض موبايل وخد سكرين شوت لأي حاجة مكسورة.
   5. جرّب أهم رحلة للمستخدم (تسجيل، شراء، تواصل) وسجّل أي خطوة بتعطّل.
   6. ارجع للكود واعرف سبب كل مشكلة.
   
   ## شكل التقرير
   - ابدأ بأخطر ٣ مشاكل.
   - لكل مشكلة: فين، ليه بتحصل، الملف المسؤول، والحل المقترح.
   - متعدّلش أي كود غير لما المستخدم يوافق.
   - اكتب التقرير بالعربي في ملف reports/audit-تاريخ-اليوم.md

   نسخ
3. استخدمها

   افتح جلسة جديدة (claude --chrome) واكتب / هتلاقيها في القايمة. نادِها مباشرة:

   /site-audit https://mysite.com

   نسخ

   أو قول «حلّل الموقع» وهو هيختارها لوحده بناءً على الـ description.

أفكار لسكيلز تانية

أيوه، ممكن تطلب من Claude نفسه يكتبلك السكيل ويحطها في المكان الصح.

سيناريو كامل: حلّل موقعي وصلّحه

كل حاجة فوق مع بعض، من أول ما تفتح التيرمنال لحد ما التعديلات تتعمل.

1. افتح الجلسة في فولدر الموقع

   cd my-website
   claude --chrome

   نسخ
2. اطلب التحليل

   /site-audit https://mysite.com

   نسخ

   هتشوف Chrome بيفتح تاب وبيتنقل في الموقع قدامك.

3. راجع التقرير واختار
   ابدأ بالمشكلة الأولى والتانية بس، ووريني التعديل قبل ما تحفظه

   بعد التصليح افتح الصفحة تاني واتأكد إن الخطأ اختفى من الـ Console
4. احفظ الشغل
   اعمل commit للتعديلات برسالة واضحة

   حدّث CLAUDE.md بأي حاجة اتعلمناها عن المشروع النهارده

الصلاحيات: تسمح بإيه وتمنع إيه

بتقول لـ Claude Code يعمل إيه لوحده، يسألك قبل إيه، ويرفض إيه خالص، على مستوى الملفات والمسارات والأوامر والمواقع. القواعد دي Claude Code نفسه هو اللي بينفذها، مش مجرد تعليمات للموديل.

ملفات الإعدادات فين؟

وأسهل طريقة تشوف وتعدّل: اكتب /permissions جوه الجلسة، هيعرضلك كل القواعد وكل قاعدة جاية من أنهي ملف.

التلات قوايم

allow: يعملها من غير ما يسألك. ask: يسألك كل مرة. deny: ممنوعة. الترتيب دايماً deny ثم ask ثم allow، وأول واحدة تنطبق هي اللي بتكسب. يعني لو فيه deny على حاجة، مفيش allow يقدر يستثنيها، ولو اتمنعت في أي ملف إعدادات محدش يقدر يسمح بيها من ملف تاني.

كتابة القواعد

المسارات في Read وEdit: //path مسار كامل من جذر الجهاز، ~/path من الهوم، /path من جذر المشروع (في إعدادات المشروع)، وpath أو ./path من الفولدر الحالي. * جوه فولدر واحد، و** في كل الفولدرات اللي تحت.

مثال جاهز لمشروع موقع

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(npm install *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git commit *)",
      "Edit(/src/**)",
      "Edit(/public/**)",
      "WebFetch(domain:mysite.com)"
    ],
    "ask": [
      "Bash(git push *)",
      "Bash(ssh *)",
      "Edit(/package.json)"
    ],
    "deny": [
      "Read(.env)",
      "Read(.env.*)",
      "Read(secrets/**)",
      "Read(~/.ssh/**)",
      "Read(~/.aws/**)",
      "Bash(rm -rf *)",
      "Bash(sudo *)",
      "Bash(curl *)",
      "Bash(wget *)"
    ],
    "additionalDirectories": ["../shared-assets"],
    "defaultMode": "default"
  }
}

منعنا curl وwget وسبنا WebFetch لدومين موقعك بس، عشان التحكم في الشبكة يبقى من مكان واحد. وخلي بالك: قواعد allow اللي في إعدادات المشروع مش بتشتغل غير لما توافق على رسالة «trust this folder» أول مرة تفتح المشروع.

أوضاع الأذونات (defaultMode أو Shift+Tab)

تديله بيانات: ملفات، خدمات، SSH، ومفاتيح

القاعدة الذهبية: ادّي Claude القدرة إنه يستخدم الحاجة، مش الحاجة نفسها. يعني يوصل للسيرفر من غير ما يشوف المفتاح، ويستخدم الـ API key من غير ما تلزقه في الشات.

١. ملفات وداتا يشتغل عليها

أي حاجة جوه فولدر المشروع بيقدر يقراها. عشان توجهه لحاجة معينة:

# My Website
- Stack: Next.js + Tailwind
- Run: npm run dev (port 3000)

## مراجع
@docs/brand-guide.md
@docs/seo-keywords.md
@data/products-schema.json

الملفات المستوردة بتتحمّل في كل جلسة وبتاكل من الـ context، فخليها مختصرة. الداتا الكبيرة (CSV ضخم مثلاً) متعملهاش import، اذكر مكانها بس وهو يقراها لما يحتاج.

٢. خدمات خارجية: قاعدة بيانات، Notion، GitHub…

الطريقة الصح هي سيرفر MCP، بيدّي Claude أدوات جاهزة للخدمة بدل ما تدّيله باسووردات:

claude mcp add my-service --transport http https://example.com/mcp

وبعدها تتحكم فيه بالصلاحيات: "allow": ["mcp__my-service__search"] للقراية، و"ask": ["mcp__my-service"] لأي حاجة تانية. اكتب /mcp عشان تشوف السيرفرات المتوصلة وأدواتها.

٣. SSH للسيرفر

متدّيش Claude المفتاح الخاص (id_rsa أو id_ed25519) أبداً. جهّز الاتصال عندك، وهو يستخدم أمر ssh زيك بالظبط، والمفتاح يفضل مع برنامج ssh.

1. اعمل اسم مختصر للسيرفر
   ~/.ssh/config

   Host mysite-staging
       HostName 203.0.113.10
       User deploy
       IdentityFile ~/.ssh/id_ed25519

   نسخ

   واستخدم يوزر على السيرفر صلاحياته محدودة (زي deploy) مش root، ويُفضّل سيرفر staging الأول.

2. اقفل قراية المفاتيح وخلي أوامر السيرفر بإذن

   {
     "permissions": {
       "allow": [
         "Bash(ssh mysite-staging 'tail -n 200 /var/log/nginx/error.log')"
       ],
       "ask": ["Bash(ssh *)", "Bash(scp *)", "Bash(rsync *)"],
       "deny": ["Read(~/.ssh/**)"]
     }
   }

   نسخ

   Read(~/.ssh/**) بتمنع أدوات Claude تفتح ملفات المفاتيح، لكن برنامج ssh نفسه بيقراها عادي، وده بالظبط اللي عايزينه. أي أمر تاني على السيرفر هيسألك الأول، وأمر قراية اللوج اللي بتستخدمه كتير سمحنا بيه بالنص.

3. عرّفه في CLAUDE.md

   اكتب سطر زي: «سيرفر الـ staging اسمه mysite-staging، اللوجات في /var/log/nginx، ممنوع أي تعديل على production». ودلوقتي تقدر تقوله: «ادخل السيرفر وشوف آخر أخطاء في اللوج وقارنها بالكود».

٤. API keys وباسووردات

متلزقهاش في الشات ولا في CLAUDE.md. عندك طريقتين:

{
  "env": {
    "STAGING_API_URL": "https://staging.mysite.com/api",
    "STAGING_API_KEY": "sk_test_xxxxxxxx"
  }
}

المتغيرات دي بتبقى متاحة للأوامر اللي Claude بيشغلها، فالسكربتات بتاعتك تستخدم process.env.STAGING_API_KEY وخلاص. أو سيب المفاتيح في .env زي ما هي، وامنع قرايتها بـ Read(.env) في deny، وخلي الكود هو اللي يقراها وقت التشغيل.

لو حاجة مشتغلتش