Claude Code: أنماط الإخراج

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

أنماط الإخراج تتحكم في كيفية "تحدث" Claude Code — من المختصر إلى المفصّل، ومن النص العادي إلى JSON، اختيار النمط الصحيح يجعل المعلومات أسهل فهماً.

💡 نصيحة: أنماط الإخراج لا تؤثر على قدرات Claude Code، فقط على طريقة عرض النتائج. استخدم الافتراضي للتطوير اليومي، وJSON لسكربتات الأتمتة.

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

1. ما ستتعلمه


2. أنماط الإخراج المدمجة

(1) قائمة الأنماط

النمط الوصف حالة الاستخدام
default معلومات متوازنة التطوير اليومي
concise الإخراج الأكثر إيجازاً الاستعلامات السريعة
verbose شروحات مفصّلة التعلم/التنقيح
code يركز على الكود توليد كود بحت
plan التخطيط قبل التنفيذ المهام المعقدة

(2) تبديل الأنماط

BASH
# سطر الأوامر
claude --style concise
claude --style verbose

# داخل الجلسة
> /style concise
> /style verbose

# في CLAUDE.md
## Output Preferences
- Use concise style
- Show diff for code modifications

▶ مثال 1: مقارنة إخراج الأنماط

TEXT 📖 للعرض فقط
# الافتراضي: معلومات متوازنة عن التغييرات والنتائج
# المختصر: فقط ✅ Added resetPassword() to user.service.ts, 4 tests, 2 files changed
# المفصّل: تحليل كامل خطوة بخطوة، تفاصيل التنفيذ، أوصاف الاختبارات

3. تنسيقات الإخراج المخصصة

(1) التعريف في CLAUDE.md

MARKDOWN
## Output Preferences
- Only show diff for code changes, not full file
- Use English for code, native language for descriptions
- Auto-run tests after file modification
- Show failure reason and fix plan when tests fail
- No need to explain each step (unless asked)

(2) التحكم في التنسيق على مستوى المهمة

TEXT 📖 للعرض فقط
> List all TODO comments, output in JSON format
> Compare Express vs Fastify performance, show as table
> Generate API documentation, Markdown format
> Refactor this function, only output modified code

▶ مثال 2: إخراج منسّق

TEXT 📖 للعرض فقط
> List test coverage for all services under src/services/, show as table

Claude Code:
  | Service | Coverage | Missing |
  |:--------|:---------|:--------|
  | user.service.ts | 92% | delete method |
  | auth.service.ts | 85% | refresh token |
  | payment.service.ts | 0% | **no tests** |

  Average: 64% | Below 80%: 3 services

4. إخراج JSON للسكربتات

(1) إخراج JSON من سطر الأوامر

BASH
claude -p "List all TypeScript errors" --output json

# Output structure
{
  "task": "list TypeScript errors",
  "result": { "errors": [...], "total": 1 },
  "usage": { "tokens": 15420, "cost_usd": 0.31 }
}

▶ مثال 3: سكربت مراجعة كود آلي

BASH
#!/bin/bash
# auto-review.sh - Auto-review git changes

CHANGED_FILES=$(git diff --name-only HEAD~1)

for file in $CHANGED_FILES; do
  RESULT=$(claude -p "Review $file code quality, focus on security" --output json)
  ISSUES=$(echo "$RESULT" | jq '.result.issues | length')
  if [ "$ISSUES" -gt 0 ]; then
    echo "⚠️ Found $ISSUES issues in $file"
  else
    echo "✅ $file looks good"
  fi
done

5. تهيئة نمط الإخراج

(1) النمط الافتراضي العام

JSON
// ~/.claude/settings.json
{
  "output": {
    "defaultStyle": "concise",
    "showDiff": true,
    "language": "en",
    "autoTest": true
  }
}

(2) التبديل الديناميكي

TEXT 📖 للعرض فقط
> From now on use verbose style
> /style concise  # Switch back
> This task use JSON output  # Single-task specification

6. مثال شامل: استراتيجية أنماط متعددة السيناريوهات

TEXT 📖 للعرض فقط
# التطوير اليومي (الافتراضي)
claude
> Refactor UserService

# إصلاح سريع (مختصر)
claude --style concise
> Fix this typo

# تعلم مشروع جديد (مفصّل)
claude --style verbose
> Explain this project's architecture

# سكربتات الأتمتة (JSON)
claude -p "Code review" --output json | jq '.result'

❓ أسئلة شائعة

س هل تستهلك الأنماط المختلفة Tokens مختلفة؟
ج نعم. المفصّل يستهلك الأكثر، والمختصر الأقل. الفرق قد يصل إلى 2-3 أضعاف. الاستخدام اليومي: الافتراضي أو المختصر.
س هل تنسيق إخراج JSON مستقر؟
ج مستقر في الغالب لكن قد يتغير مع الإصدارات. أضف معالجة الأخطاء في السكربتات.
س هل يمكن تخصيص قوالب Markdown؟
ج يمكنك وصف متطلبات تنسيق الإخراج في CLAUDE.md؛ وسيحاول Claude Code الالتزام بها. لا يوجد نظام قوالب صارم.
س كيف أجعل الإخراج أكثر إيجازاً؟
ج استخدم النمط المختصر + تعليمات دقيقة + اكتب في CLAUDE.md "لا حاجة لشرح الخطوات".

📖 ملخص


📝 تمارين

  1. أساسي (⭐): أكمل نفس المهمة بثلاثة أنماط مختلفة، وقارن الفروق في الإخراج.
  2. متوسط (⭐⭐): اكتب سكربت مراجعة كود بسيط باستخدام تنسيق إخراج JSON.
  3. متقدم (⭐⭐⭐): صمّم معايير أنماط إخراج الفريق في CLAUDE.md لتجربة متسقة.
Web-Tutorial.com

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

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

100%