Claude Code: الوضع التفاعلي ودليل العمليات

آخر تحديث: 2026-08-31

يقدم Claude Code أنماط تفاعل متعددة، من محادثات الطرفية إلى أتمتة خط الأنابيب، كلٌ يناسب سيناريوهات مختلفة.

💡 نصيحة: الوضع التفاعلي للمحادثة مع Claude Code؛ وضع خط الأنابيب للسكريبتات التي تستدعي Claude Code؛ وضع بلا واجهة للأتمتة بدون واجهة مستخدم.

📋 المتطلبات المسبقة: الفصل 6 - تهيئة المشروع والهيكل

1. ما ستتعلمه


2. ثلاثة أنماط تفاعل

(1) نظرة عامة على الأنماط

النمط طريقة الإطلاق حالة الاستخدام التفاعل البشري
تفاعلي claude التطوير اليومي، البرمجة الاستكشافية تفاعل كامل
خط أنابيب echo "..." | claude مهام سريعة لمرة واحدة شبه تفاعلي
بلا واجهة claude --headless CI/CD، سكريبتات أتمتة بلا تفاعل

(2) قرار اختيار النمط

100%
graph TD
    A[Need Claude Code] --> B{Need interaction?}
    B -->|Yes| C{Single or multi-turn?}
    B -->|No| D[Headless mode]
    C -->|Multi-turn| E[Interactive]
    C -->|Single| F[Pipeline mode]
    D --> D1[CI/CD]
    D --> D2[Batch scripts]
    E --> E1[Daily development]
    E --> E2[Complex refactoring]
    F --> F1[Quick query]
    F --> F2[Single file modification]

3. الوضع التفاعلي

(1) الإطلاق والعمليات

BASH
# Standard launch
claude

# Launch with initial instruction
claude "Analyze project structure"

# Resume last session
claude --resume

# Specify model
claude --model claude-opus-4-20250514

(2) التحكم في العمليات داخل الجلسة

العملية المفتاح/الأمر الوصف
إرسال تعليمة Enter إرسال الإدخال الحالي
سطر جديد Shift+Enter إدخال متعدد الأسطر
مقاطعة Ctrl+C إيقاف العملية الحالية
خروج Ctrl+D أو /exit الخروج من Claude Code
مسح السياق /clear مسح سجل المحادثة
عرض المساعدة /help عرض الأوامر المتاحة

▶ مثال 1: سير الجلسة التفاعلية

TEXT 📖 للعرض فقط
$ claude

> Show me the utility functions under src/utils/

Claude: Reading src/utils/...
  - date.ts      formatDate(), relativeTime()
  - string.ts    capitalize(), truncate()
  - validation.ts isValidEmail(), isValidPhone()

> Add a slugify function to string.ts

Claude: Adding slugify() to src/utils/string.ts...
  → Reading src/utils/string.ts
  → Adding slugify function with tests
  → Running: npm test -- string.test.ts
  ✅ All tests passed

> Also add a camelToSnake conversion function

Claude: Adding camelToSnake() to src/utils/string.ts...
  → Reading src/utils/string.ts
  → Adding camelToSnake with tests
  → Running: npm test -- string.test.ts
  ✅ All tests passed

4. وضع خط الأنابيب

(1) الاستخدام الأساسي

BASH
# Pass instruction from stdin
echo "Explain this function's purpose" | claude

# Pass file content to Claude Code
cat src/auth.ts | claude "Review this code's security"

# Combine usage
git diff | claude "Review these changes, identify potential issues"

(2) التحكم في الإخراج

BASH
# Plain text output (no interactive confirmation)
claude -p "List all TODO comments" --output text

# JSON format output
claude -p "Analyze project dependencies" --output json

# Quiet mode (output results only)
echo "Run tests" | claude --quiet

▶ مثال 2: تطبيقات عملية لوضع خط الأنابيب

BASH
# Code review automation
git diff main..feature | claude "Review changes:
1. Security vulnerabilities
2. Code style compliance
3. Missing tests"

# Batch documentation generation
for file in src/*.ts; do
  echo "Generate JSDoc comments for $file" | claude --quiet >> docs/api.md
done

# Quick query
echo "What outdated dependencies are in package.json?" | claude

5. وضع بلا واجهة

(1) طريقة الإطلاق

BASH
# No UI (auto-approve operations)
claude --headless "Run full tests and fix all failing cases"

# Specify output format
claude --headless --output json "Analyze code quality"

# With CI/CD
claude --headless --allow-full-auto "Code review and auto-fix lint issues"

(2) اعتبارات الأمان

المعامل مستوى المخاطرة الوصف
--headless متوسط تشغيل تلقائي لكن يحتاج صلاحيات معتمدة مسبقاً
--allow-full-auto عالي تلقائي بالكامل، جميع العمليات بدون تأكيد
--allowed-tools منخفض يسمح فقط بأدوات محددة

▶ مثال 3: وضع بلا واجهة في CI/CD

YAML
# GitHub Actions config
name: AI Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: Run AI Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude --headless --output json \
            "Review this PR's changes, check:
            1. Security vulnerabilities
            2. Performance issues
            3. Code style
            Output JSON format report"

6. إدارة الجلسات المتعددة

(1) استئناف الجلسة

BASH
# List historical sessions
claude --list-sessions

# Resume specific session
claude --resume <session-id>

# Resume most recent session
claude --resume

(2) التبديل بين الجلسات

TEXT 📖 للعرض فقط
# Alice handling multiple tasks simultaneously

# Task 1: Frontend refactoring
cd frontend && claude
> Refactor component structure...

# Ctrl+D to exit

# Task 2: Backend API
cd backend && claude
> Add new endpoint...

# Resume task 1
cd frontend && claude --resume

7. مثال شامل: تعاون الأنماط المتعددة

BASH
# Alice's daily development workflow

# Morning: Interactive mode exploration
claude "Check yesterday's TODOs, help me handle each one"

# Noon: Pipeline mode quick fix
git diff | claude "Fix these lint errors" | git apply

# Afternoon: Interactive mode deep development
claude "Implement RBAC model for user permission system"

# Evening: Headless mode full check
claude --headless --allowed-tools Read,Write,Bash \
  "Run full tests, fix all failing cases, don't modify test assertions"

# CI: Headless mode auto review
claude --headless --output json "Code review"

❓ أسئلة شائعة

س هل يمكنني التبديل بين الوضع التفاعلي وخط الأنابيب؟
ج لا. النمط يُختار عند الإطلاق ولا يمكن تبديله أثناء التشغيل. اخروج وأعد الإطلاق لنمط مختلف.
س هل وضع بلا واجهة آمن؟
ج --headless يزيل فقط واجهة المستخدم؛ العمليات لا تزال تحتاج التحكم في الصلاحيات. لكن --allow-full-auto يوافق تلقائياً على جميع العمليات — مخاطرة عالية، يُوصى به فقط في بيئات CI.
س كيف أقاطع تنفيذ Claude Code؟
ج اضغط Ctrl+C لمقاطعة العملية الحالية دون فقدان التعديلات الموجودة. Ctrl+D يخرج من الجلسة بالكامل.
س كم تُحفظ سجلات الجلسة؟
ج سجلات الجلسة تُحفظ محلياً، مع الاحتفاظ بآخر 30 يوماً افتراضياً. اعرضها بـ --list-sessions.
س هل يدعم وضع خط الأنابيب محادثة متعددة الأدوار؟
ج لا. وضع خط الأنابيب إدخال/إخراج واحد. استخدم الوضع التفاعلي لمتعدد الأدوار.
س كيف أحدد إن كان Claude Code نُفّذ بنجاح في سكريبت؟
ج تحقق من رموز الخروج: 0=نجاح، 1=فشل، 2=مقاطعة.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): أتمت نفس المهمة باستخدام الوضع التفاعلي وخط الأنابيب، قارن فروق التشغيل.
  2. متوسط (⭐⭐): نفّذ سير مراجعة أكواد آلي بـ git diff | claude "code review".
  3. متقدم (⭐⭐⭐): اضبط سير عمل إجراءات جيتهب لتشغيل مراجعة أكواد Claude Code تلقائياً على PRs.
Web-Tutorial.com

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

100%