Claude Code — شيت شيت 📋

"الورقة اللي تطبعها وتعلقها جنب الشاشة"

Sectionالتنصيب والإعداد

Claude Code هو أداة Anthropic الرسمية للـcoding من جوه الترمنال — بتقرا وتعدل ملفات، بتشغل أوامر shell، بتستخدم MCP servers، وبتفوّض لـsubagents، وتقدر تشتغل headless.

# macOS / Linux / WSL — التنصيب الأصلي (المفضّل)
curl-fsSLhttps://claude.ai/install.sh|bash

# Windows PowerShell
irmhttps://claude.ai/install.ps1|iex

# Windows CMD
curl-fsSLhttps://claude.ai/install.cmd-oinstall.cmd&&install.cmd&&delinstall.cmd

# القناة المستقرة (stable) بدل أحدث إصدار
curl-fsSLhttps://claude.ai/install.sh|bash-sstable

# نسخة معيّنة بالظبط
curl-fsSLhttps://claude.ai/install.sh|bash-s2.1.89

# Homebrew (من غير auto-update)
brewinstall--caskclaude-code

# WinGet
wingetinstallAnthropic.ClaudeCode

# npm (محتاج Node.js 22+ — بيثبّت نفس الـbinary الأصلي، مش بيستخدم الـNode وقت التشغيل)
npminstall-g@anthropic-ai/claude-code
# ⚠️ متعملش أبداً: sudo npm install -g

التوثيق: لو الـenv var ANTHROPIC_API_KEY متظبّط، Claude بيطلب موافقة على المفتاح مرة واحدة بدل ما يفتح المتصفح. مزودو المؤسسات: Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry.

متطلبات النظام: macOS 13+ / Windows 10 1809+ / Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+، 4GB+ RAM، x64/ARM64، وripgrep مدمج. على Windows الأصلي، Git for Windows اختياري (بيفعّل الـBash tool عبر Git Bash، وإلا بيستخدم الـPowerShell tool).

Sectionأوامر الـCLI الأساسية

SectionالـFlags المهمة

Sectionالوضع البرمجي — Headless & Programmatic

# سؤال واحد: يطبع ويخرج
claude-p"explain the root cause"

# خرج JSON منظم (result, cost, session_id...)
claude-p"summarize this diff"--output-formatjson

# streaming NDJSON events — مع input streaming
claude-p"refactor auth"--output-formatstream-json--input-formatstream-json

# pipe لمحتوى من أداة تانية
caterror.log|claude-p"explain the root cause"

# حواجز الأتمتة (guardrails)
claude-p"fix failing tests"\
--max-turns8\
--max-budget-usd2.00\
--allowedTools"Read,Edit,Bash(npm test:*)"\
--permission-modeacceptEdits\
--session-id123e4567-e89b-12d3-a456-426614174000

# توثيق طويل العمر للـCI
claudesetup-token

الـClaude Agent SDK (TypeScript / Python) بيغلّف كل ده عشان تبني agents مخصصة.

Sectionأوضاع الأذونات — Permission Modes

التبديل: Shift+Tab بيدوّر بين الأوضاع (default → acceptEdits → plan → …). أو ابدأ في وضع مباشرة بـ--permission-mode.

Sectionإدارة الجلسة والمحادثة

Sectionكل الـSlash Commands

الأوامر المدمجة (Built-in)

الـSkills المدمجة (بتيجي مع Claude Code)

الـAliases: /settings=/config · /reset,/new=/clear · /cost=/usage · /bug,/share=/feedback · /quit=/exit · /checkup=/doctor · /allowed-tools=/permissions · /bg=/background · /app=/desktop · /proactive=/loop.

SectionالـDelegation والـSubagents

الـsubagents = مساعدين AI متخصصين بيتعاملوا مع نوع مهمة معيّن في context window خاص بيهم، بـsystem prompt وأدوات وأذونات خاصة — وبيرجّعوا ملخّص بس للمحادثة الرئيسية.

ليه مهمين: (1) يحافظوا على الـcontext الرئيسي، (2) يفرضوا قيود على الأدوات، (3) تعيد استخدام الإعداد عبر المشاريع، (4) تخصيص السلوك، (5) تحكّم في التكلفة بتوجيه المهام لـmodels رخيصة/سريعة زي Haiku.

إزاي بيتم التفويض: Claude بيقرا الـdescription بتاع كل subagent ويفوّض تلقائياً لما المهمة تطابق. تقدر تجبره كمان:

>Usethecode-reviewersubagenttocheckmychanges

الإدارة والملفات:

حقول الـFrontmatter: name · description (إمتى تستخدمه — اكتبها كويس!) · tools (اختياري؛ لو مكتوبتهاش = يرث الكل) · model (اختياري: sonnet/opus/haiku أو 'inherit').

---
name: code-reviewer
description: Expert code review specialist. Use PROACTIVELY after writing or changing code.
tools: Read, Grep, Glob, Bash
model: sonnet
---
You are a senior code reviewer. When invoked: run git diff, focus on changed files, review for
readability, bugs, security. Give feedback grouped by priority.

النموذج الذهني: الـagent الرئيسي = orchestrator؛ الـsubagents = عمال مركّزين بـcontext نضيف؛ الملخّص بس هو اللي بيرجع.

Sectionأوامر مخصصة (Skills) — Custom Commands

الأوامر المخصصة اتدمجت مع الـskills. .claude/commands/deploy.md و.claude/skills/deploy/SKILL.md الاتنين بيعملوا /deploy.

حقول الـFrontmatter: description · argument-hint · allowed-tools · model · (الـskills بتضيف) تحكّم الاستدعاء + run-in: subagent.

عناصر خاصة في الـbody:

• $ARGUMENTS = كل اللي اتكتب بعد الأمر · $1, $2, … = arguments بالترتيب.
• ! في أول السطر = يشغّل bash ويدمج الخرج (محتاج allowed-tools Bash).
• @path/to/file = يدمج محتوى ملف.

Namespacing: subdirectories → /frontend:lint, /backend:deploy. الـskills بتحمّل الـbody بتاعها بس لما تتستخدم (رخيصة لحد ما تحتاجها). Claude يقدر يستدعي skill تلقائياً لما تكون relevant، أو تستدعيها بـ/name.

---
description: Create a git commit
argument-hint: [message]
allowed-tools: Bash(git add:*), Bash(git commit:*)
model: claude-haiku-4-5
---
## Context
- Current status: !`git status`
- Current diff: !`git diff HEAD`
## Task
Create a single commit with message: $ARGUMENTS

Sectionالذاكرة والإعداد — Memory & Config

CLAUDE.md = تعليمات مستمرة بتتحمّل تلقائياً. الهرمية (كلها بتتجمّع concatenate، المتأخر بيضيف على المتقدّم):

• الـnested CLAUDE.md في الـsubdirs بتتحمّل عند الحاجة لما Claude يلمس ملفات هناك.
• /init = يعمل scaffold لـCLAUDE.md للمشروع.
• /memory = يفتح ويعدّل ملفات الذاكرة.
• # في أول الإدخال = "افتكر ده" → بيضيف سطر لملف ذاكرة.
• @path/import.md جوه CLAUDE.md = يستورد ملف تاني (بحد أقصى 5 hops).
• Auto-memory: Claude بيكتب ملاحظات في ~/.claude/projects/<project>/memory/ (فهرس MEMORY.md). بيعيش بعد /compact. gitignored.
• Path-scoped rules: .claude/rules/*.md بـpaths: frontmatter globs، بتتحمّل بس لما Claude يقرا ملفات مطابقة.

هرمية settings.json (الأولوية من الأعلى للأدنى)

Managed(org)→command-lineflags→.claude/settings.local.json(شخصي،gitignored)
  → .claude/settings.json (مشروع، مشترك) → ~/.claude/settings.json (مستخدم)

الحقول الأساسية: model · permissions {allow, ask, deny, defaultMode} · env · hooks · autoUpdatesChannel · minimumVersion · editorMode ("vim"/"normal") · autoMemoryEnabled · outputStyle.

SectionالـHooks

handlers حتمية (shell/HTTP/…) بتشتغل عند أحداث دورة الحياة (settings.json → hooks).

وفيه كمان: PermissionRequest, PermissionDenied, TaskCreated/Completed, FileChanged, WorktreeCreate/Remove، وغيرها.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "if": "Bash(rm *)",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.sh",
            "args": []
          }
        ]
      }
    ]
  }
}

• Matcher: ""/"*"/محذوف = الكل · نص عادي = مطابقة (مثلاً "Edit|Write") · أي رموز تانية = regex.
• أنواع الـHook: command, http, mcp_tool, prompt, agent. حقول شائعة: if, timeout (افتراضي 600s), statusMessage.
• Exit codes: 0 = تمام (الـstdout ممكن يحمل JSON) · 2 = BLOCK (الـstderr → Claude) · غير كده = خطأ غير حاجب.
• تحكّم JSON (PreToolUse): {"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"..."}} — القيم allow/deny/ask/defer.
• JSON عام: continue (false يوقف Claude) · stopReason · suppressOutput · systemMessage · additionalContext.
• متغيرات المسار: ${CLAUDE_PROJECT_DIR} · ${CLAUDE_PLUGIN_ROOT}.

SectionالـMCP

ربط أدوات/بيانات خارجية.

# stdio
claudemcpadd<name>--<command>[args]

# SSE / HTTP
claudemcpadd--transportsse<name><url>
claudemcpadd--transporthttp<name><url>

# من JSON
claudemcpadd-json<name>'<json>'

# استيراد من Claude Desktop
claudemcpadd-from-claude-desktop

# عرض / تفاصيل / حذف
claudemcplist
claudemcpget<name>
claudemcpremove<name>

• في الـREPL: /mcp يعرض الـservers وحالتها، يعمل OAuth login (/mcp → authenticate)، reconnect/enable/disable.
• استخدام الـresources في الـprompt: @server:protocol://resource.
• الـMCP servers ممكن تعرض prompts كـslash commands: /mcp__server__promptname.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "..." }
    }
  }
}

Sectionقواعد الأذونات — Permission Rules

قواعد allow/ask/deny في settings.json (permissions.allow/ask/deny):

/permissions يفتح واجهة القواعد. defaultMode في الـsettings بيحدد وضع البداية.

Sectionاختصارات الكيبورد والإدخال

Prefixes في أول السطر:

إدخال الصور: اسحب/الصق screenshots عشان Claude يحللها.

Sectionمتغيرات البيئة وملفات الإعداد

Sectionمقارنة سريعة