Claude Code: الوضع التفاعلي ودليل العمليات
آخر تحديث: 2026-08-31
يقدم Claude Code أنماط تفاعل متعددة، من محادثات الطرفية إلى أتمتة خط الأنابيب، كلٌ يناسب سيناريوهات مختلفة.
💡 نصيحة: الوضع التفاعلي للمحادثة مع Claude Code؛ وضع خط الأنابيب للسكريبتات التي تستدعي Claude Code؛ وضع بلا واجهة للأتمتة بدون واجهة مستخدم.
📋 المتطلبات المسبقة: الفصل 6 - تهيئة المشروع والهيكل
1. ما ستتعلمه
- ثلاثة أنماط تفاعل وحالات الاستخدام
- نصائح تشغيل الجلسة التفاعلية
- إدخال/إخراج وضع خط الأنابيب
- سيناريوهات أتمتة وضع بلا واجهة
- المقاطعة والاستئناف وإدارة الجلسات المتعددة
2. ثلاثة أنماط تفاعل
(1) نظرة عامة على الأنماط
| النمط | طريقة الإطلاق | حالة الاستخدام | التفاعل البشري |
|---|---|---|---|
| تفاعلي | claude |
التطوير اليومي، البرمجة الاستكشافية | تفاعل كامل |
| خط أنابيب | echo "..." | claude |
مهام سريعة لمرة واحدة | شبه تفاعلي |
| بلا واجهة | claude --headless |
CI/CD، سكريبتات أتمتة | بلا تفاعل |
(2) قرار اختيار النمط
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=مقاطعة.
📖 ملخص
- ثلاثة أنماط: تفاعلي (يومي)، خط أنابيب (سريع لمرة واحدة)، بلا واجهة (أتمتة)
- الوضع التفاعلي يدعم محادثة متعددة الأدوار، مقاطعة Ctrl+C، خروج Ctrl+D
- وضع خط الأنابيب يناسب المهام الفردية، قابل للدمج مع git diff وأوامر أخرى
- وضع بلا واجهة لـ CI/CD؛
--allow-full-autoيتطلب الحذر - الجلسات يمكن استئنافها، تدعم التوازي متعدد المهام
📝 تمارين
- أساسي (⭐): أتمت نفس المهمة باستخدام الوضع التفاعلي وخط الأنابيب، قارن فروق التشغيل.
- متوسط (⭐⭐): نفّذ سير مراجعة أكواد آلي بـ
git diff | claude "code review". - متقدم (⭐⭐⭐): اضبط سير عمل إجراءات جيتهب لتشغيل مراجعة أكواد Claude Code تلقائياً على PRs.