Claude Code: أنماط الإخراج
آخر تحديث: 2026-08-31
أنماط الإخراج تتحكم في كيفية "تحدث" Claude Code — من المختصر إلى المفصّل، ومن النص العادي إلى JSON، اختيار النمط الصحيح يجعل المعلومات أسهل فهماً.
💡 نصيحة: أنماط الإخراج لا تؤثر على قدرات Claude Code، فقط على طريقة عرض النتائج. استخدم الافتراضي للتطوير اليومي، وJSON لسكربتات الأتمتة.
📋 المتطلبات السابقة: الفصل 16 - مهارات الوكيل ومُنشئ المهارات
1. ما ستتعلمه
- أنماط الإخراج المدمجة
- تنسيقات الإخراج المخصصة
- اختيار النمط حسب السيناريو
- إخراج JSON لتكامل السكربتات
- تهيئة نمط الإخراج
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 "لا حاجة لشرح الخطوات".
📖 ملخص
- خمسة أنماط مدمجة: default، concise، verbose، code، plan
- يومياً: الافتراضي؛ سريع: المختصر؛ تعلم: المفصّل
- إخراج JSON مناسب لتكامل السكربتات والأتمتة
- CLAUDE.md يمكنه تعريف تفضيلات الإخراج على مستوى المشروع
- النمط يؤثر على العرض فقط، لا على جودة الكود
📝 تمارين
- أساسي (⭐): أكمل نفس المهمة بثلاثة أنماط مختلفة، وقارن الفروق في الإخراج.
- متوسط (⭐⭐): اكتب سكربت مراجعة كود بسيط باستخدام تنسيق إخراج JSON.
- متقدم (⭐⭐⭐): صمّم معايير أنماط إخراج الفريق في CLAUDE.md لتجربة متسقة.