SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

آموزش تنظیم و تغییر outputStyle در Claude Code

با نحوه عملکرد outputStyle در Claude Code و تاثیر آن بر پاسخ‌های Claude آشنا شوید. تفاوت نسخه‌های قبل و بعد از v2.1.251 و روش شخصی‌سازی دستورات سیستم را بیاموزید.

سبک خروجی در Claude Code چیست

سبک خروجی (output style) در Claude Code مجموعه‌ای از دستورالعمل‌ها است که Claude Code در هر درخواست، به همراه پیام اصلی برای Claude ارسال می‌کند. این سبک نحوه پاسخ‌دهی Claude به شما را تغییر می‌دهد: نقشی که ایفا می‌کند و ساختار متنی که چاپ می‌کند. این قابلیت هیچ اطلاعاتی درباره codebase شما به Claude نمی‌آموزد و نمی‌تواند مجوزی برای اجرای هیچ دستوری به Claude بدهد.

Claude Code دارای 5 سبک داخلی است. انتخاب شما در یک کلید تنظیمات به نام outputStyle ذخیره می‌شود. در نسخه v2.1.251 یا بالاتر از Claude Code، سبکی که در میانه یک نشست تغییر می‌دهید، از پیام بعدی شما اعمال می‌شود. از نسخه v2.1.73 تا v2.1.251، این تغییر ذخیره می‌شد اما تا زمانی که آن را پاک نمی‌کردید نادیده گرفته می‌شد؛ همین یک نکته، دلیل اصلی سردرگمی‌هایی است که هنوز در راهنماهای قدیمی‌تر درباره این قابلیت مشاهده می‌کنید.

روی یک VPS، این موضوع فراتر از یک ترجیح ظاهری است. رونوشت (transcript) همان چیزی است که شما از طریق یک لینک SSH (secure shell) می‌خوانید، که معمولاً درون یک پنجره tmux قرار دارد؛ بنابراین هر خطی که Claude روایت می‌کند، خطی است که شما باید منتظر آن بمانید و بخشی از حافظه scrollback با اندازه ثابت را اشغال می‌کند.

محل قرارگیری تنظیمات outputStyle

یک سبک را از منوی /config، در بخش Output style انتخاب کنید. Claude Code انتخاب شما را در .claude/settings.local.json در پروژه‌ای که روی آن کار می‌کنید، می‌نویسد.

دستور /output-style همین کار را از طریق پرامپت انجام می‌دهد. برای تغییر سبک، /output-style concise را اجرا کنید، یا برای مشاهده لیست سبک‌ها و اطلاع از سبک فعلی، /output-style را بدون آرگومان به کار ببرید. این دستور در همان فایل .claude/settings.local.json ذخیره می‌شود، به بزرگی و کوچکی حروف حساس نیست و در حالت غیرتعاملی (non-interactive) نیز کار می‌کند. دستوری که در اینجا توضیح داده شد، در نسخه v2.1.269 از Claude Code معرفی شده است. یک دستور قدیمی‌تر به نام /output-style تا نسخه v2.0.30 وجود داشت که در نسخه v2.1.73 به نفع /config منسوخ شد؛ بنابراین بیلد‌های بین این دو نسخه ممکن است رفتاری متفاوت از آنچه در این صفحه آمده است داشته باشند. پیش از دنبال کردن هر راهنمایی، از جمله این راهنما، نسخه در حال اجرای خود را بررسی کنید. نسخه‌های ذکر شده در این صفحه در اکتبر 2026 بررسی شده‌اند.

claude --version

شما همچنین می‌توانید این کلید را به‌صورت دستی تنظیم کنید. چهار فایل تنظیمات می‌توانند این مقدار را در خود نگه دارند و فایلی که محدودتر (narrower) است، بر فایل گسترده‌تر اولویت دارد.

  • ~/.claude/settings.json فایل کاربری شماست. این فایل در تمامی پروژه‌های آن ماشین اعمال می‌شود.
  • .claude/settings.json فایل پروژه است. این فایل در git کامیت می‌شود، بنابراین برای هر کسی که مخزن را کلون کند، اعمال خواهد شد.
  • .claude/settings.local.json فایل پروژه محلی است. این فایل کامیت نمی‌شود و بر هر دو مورد بالا اولویت دارد. این همان فایلی است که منوی /config و دستور /output-style در آن می‌نویسند.
  • تنظیمات مدیریت‌شده (Managed settings) که توسط تیم IT از یک مسیر سیستمی مانند /etc/claude-code/ در لینوکس مستقر می‌شوند، بر همه چیز اولویت دارند.

مقدار این کلید، نام سبک است:

{
  "outputStyle": "Concise"
}

این مقدار به بزرگی و کوچکی حروف حساس است. نام‌های پیش‌فرض را به‌صورت Proactive، Concise، Explanatory و Learning بنویسید. مقداری که دقیقاً با نام یک سبک مطابقت نداشته باشد، مانند concise، به‌طور خودکار سبک Default را برای شما فعال می‌کند.

برای یک نشست (session) واحد، همان کلید را در خط فرمان وارد کنید. فلگ --settings یک مسیر یا یک رشته JSON درون‌خطی (inline) می‌گیرد و مقادیر آن در طول آن اجرا، بر کلیدهای مشابه در فایل‌های تنظیمات کاربری، پروژه و محلی شما اولویت می‌یابند. تنظیمات مدیریت‌شده همچنان بر این مورد نیز اولویت دارند:

claude --settings '{"outputStyle": "Concise"}'

مستندات چهار روش برای انتخاب سبک ذکر کرده‌اند که تنها دو مورد از آن‌ها دارای حداقل نسخه هستند. منوی /config در ترمینال هیچ محدودیتی ندارد. دستور /output-style در شکل فعلی خود به نسخه v2.1.269 نیاز دارد و منوی Output styles در افزونه VS Code به نسخه v2.1.257 نیاز دارد. در اپلیکیشن دسکتاپ، شما فیلد outputStyle را در یک فایل تنظیمات مقداردهی می‌کنید. خود کلید outputStyle حداقل نسخه ندارد، بنابراین مطمئن‌ترین گزینه برای تکیه کردن است. هرگاه اسکرین‌شات موجود در هر راهنمایی با آنچه می‌بینید مطابقت نداشت، کلید را مستقیماً تنظیم کنید و آن را با /status که منابع تنظیمات فعال را لیست می‌کند، تأیید نمایید.

زمان اعمال سبک خروجی جدید

در نسخه v2.1.251 یا بالاتر Claude Code، سبکی که در میانه نشست (session) از طریق دستور، منو یا فایل تنظیمات تغییر می‌دهید، از پیام بعدی شما اعمال می‌شود. نیازی به پاک‌سازی (clear) نیست. از نسخه v2.1.73 تا v2.1.251، نشست در حال اجرا همان سبکی را حفظ می‌کرد که با آن شروع شده بود و سبک جدید تنها در /clear بعدی یا راه‌اندازی مجدد بارگذاری می‌شد.

در ترمینال، Claude Code فایل‌های سبک را هنگام شروع می‌خواند؛ بنابراین اگر در حین اجرای یک نشست، فایل سبک سفارشی ایجاد یا ویرایش کردید، پیش از انتخاب آن، Claude Code را مجدداً راه‌اندازی کنید. در نسخه v2.1.261 یا بالاتر VS Code، راهنمای Build a custom style در منوی Output styles فایل را ایجاد کرده و سبک جدید را بلافاصله فهرست می‌کند. در نسخه‌های قدیمی‌تر یا پس از راه‌اندازی مجدد برای ویرایش فایل سبک در ترمینال، این دو دستور یک محیط تمیز به شما می‌دهند و آنچه بارگذاری شده است را نمایش می‌دهند:

/clear
/context

دستور /context محتوای فعلی پنجره context را به تفکیک دسته‌بندی، از جمله system prompt، چاپ می‌کند. آن را در یک نشست تازه تحت هر سبک اجرا کنید؛ خط system prompt همان سمت ورودی مقایسه شماست. این همچنین سریع‌ترین راه برای اثبات بارگذاری یک سبک سفارشی است. برای دیدن تصویر کلی‌تری از آنچه این پنجره را پر می‌کند، به نحوه پر شدن context در یک نشست طولانی Claude Code مراجعه کنید.

دلیل این نحوه عملکرد تغییر سبک، Caching است. API درخواست‌های تکراری را از یک prompt cache پاسخ می‌دهد که با ابتدای هر درخواست مطابقت دارد و system prompt دقیقاً در همان ابتدا قرار می‌گیرد. بازنویسی آن در میانه گفتگو، تمام محتوای پس از آن را نامعتبر می‌کند، بنابراین نوبت بعدی، کل تاریخچه شما را به عنوان ورودی جدید پردازش خواهد کرد. نسخه‌های v2.1.73 تا v2.1.251 با ثابت نگه داشتن سبک در شروع نشست، از این هزینه جلوگیری می‌کردند. نسخه‌های فعلی، دستورالعمل‌های سبک جدید را به عنوان یک پیام در گفتگو ارسال می‌کنند تا درخواست پس از تغییر سبک، همچنان system prompt و گفتگوی قبلی را از cache بخواند. در هر دو حالت، تغییر سبک کم‌هزینه است.

تغییرات هر سبک خروجی پیش‌فرض در رونوشت

  • Default (پیش‌فرض): همان پرامپت سیستمی عادی Claude Code است که برای کارهای مهندسی نرم‌افزار نوشته شده است.
  • Concise (مختصر): با نتیجه شروع می‌شود. این سبک مقدمه‌چینی و روایت گام‌به‌گام را حذف می‌کند و پاسخ‌ها را تا زمانی که جزئیات بیشتری نخواهید، کوتاه نگه می‌دارد. کارهای مهندسی پشت این پاسخ‌ها تغییری نمی‌کند. این سبک هرگز گزارش خطا یا هشدار امنیتی را کوتاه نمی‌کند و همچنان پیش از انجام هرگونه اقدام مخرب، به‌طور کامل از شما اجازه می‌گیرد. این سبک به Claude Code نسخه 2.1.237 یا بالاتر نیاز دارد.
  • Explanatory (توضیحی): بین مراحل انجام یک کار، «بینش‌هایی» (Insights) آموزشی اضافه می‌کند که توضیح می‌دهد چرا یک انتخاب پیاده‌سازی انجام شده و کدبیس شما از چه الگویی استفاده می‌کند. رونوشت به‌طور هدفمند طولانی‌تر می‌شود.
  • Learning (آموزشی): فراتر می‌رود. Claude آن بینش‌ها را به اشتراک می‌گذارد و سپس از شما می‌خواهد بخش‌های کوچکی از کد را خودتان بنویسید و هر نقطه را با یک کامنت TODO(human) در فایل مشخص می‌کند.
  • Proactive (پیش‌دستانه): باعث می‌شود Claude به‌جای پرسیدن، عمل کند. این سبک در تصمیمات روتین، فرضیات منطقی در نظر می‌گیرد و به‌جای توقف برای تأیید، کار را پیش می‌برد.

مورد آخر را با دقت بخوانید، زیرا همان موردی است که افراد به‌اشتباه برداشت می‌کنند. Proactive یک راهنما در پرامپت سیستمی است. این سبک چیزی را که Claude تلاش می‌کند انجام دهد تغییر می‌دهد. حالت مجوز (permission mode) شما همچنان تعیین می‌کند که چه چیزی بدون پرسش از شما اجرا شود؛ این همان تنظیمی است که در سروری که بدون نظارت رها می‌کنید، اهمیت دارد. این موضوع در حالت خودکار و حالت‌های مجوز Claude Code پوشش داده شده است.

تفاوت سبک خروجی با CLAUDE.md، هوک و زیر-عامل (subagent)

این سطوح همگی به نوعی تعیین‌کنندهٔ نحوهٔ رفتار Claude هستند، اما در لایه‌های متفاوتی عمل می‌کنند.

  • سبک خروجی (output style) بخشی از دستورالعمل‌هایی است که Claude Code با هر درخواست ارسال می‌کند. این سبک بر تمام پاسخ‌ها در گفتگوی اصلی اعمال می‌شود.
  • فایل CLAUDE.md به عنوان یک پیام کاربر پس از system prompt اضافه می‌شود. این فایل محل قرارگیری قراردادهای پروژه و حقایق مربوط به codebase است.
  • --append-system-prompt متن را برای یک فراخوانی واحد به system prompt اضافه می‌کند، بدون آنکه چیزی را حذف کند. این در واقع نسخهٔ یک‌بارمصرفِ سبک خروجی است.
  • هوک (hook) یک دستور shell است که Claude Code هنگام وقوع یک رویداد، خودش آن را اجرا می‌کند. این مورد توسط harness اعمال می‌شود، بنابراین فارغ از اینکه Claude آن را انتخاب کند یا نه، اجرا خواهد شد. ببینید هوک Claude Code چه کارهایی می‌تواند و نمی‌تواند انجام دهد.
  • یک زیر-عامل (subagent) با system prompt و مجموعه ابزارهای اختصاصی خود اجرا می‌شود.

یک تست کوتاه برای انتخاب بین دو مورد اول کافی است. حقایق مربوط به پروژهٔ شما باید در CLAUDE.md قرار بگیرند، زیرا Claude باید از آن‌ها آگاه باشد. نحوهٔ بیان و لحن در سبک خروجی قرار می‌گیرد، زیرا به چگونگی خوانده شدن پاسخ مربوط است. هر چیزی که باید در هر شرایطی و صرف‌نظر از تصمیم مدل اجرا شود، یک هوک است. اینکه هر سطح در کدام لایه قرار می‌گیرد، ویژگی برنامه‌ای است که مدل را اجرا می‌کند و نه خودِ مدل؛ به همین دلیل است که یک سبک فقط می‌تواند تأثیرگذار باشد، در حالی که یک هوک می‌تواند اجرا را الزامی کند.

سبک‌های خروجی فقط بر گفتگوی اصلی اعمال می‌شوند. یک زیر-عامل سبک شما را به ارث نمی‌برد، زیرا گفتگوی مستقلی را با system prompt مخصوص به خود آغاز می‌کند. استثنا در این مورد، انشعاب (fork) از گفتگوی فعلی است، زیرا انشعاب دقیقاً system prompt والد را به ارث می‌برد. اگر زیر-عاملی به شیوه‌ای که نمی‌پسندید پاسخ می‌دهد، به جای تغییر سبک خود، فایل مربوط به آن عامل را ویرایش کنید. یک نشست (session) دوم از Claude Code روی همان سیستم نیز از همین مرز پیروی می‌کند و فایل‌های تنظیمات را هنگام شروع برای خود می‌خواند؛ بنابراین وقتی کار را به نشست دیگری که همزمان با شما در حال اجراست می‌سپارید، پاسخ‌های آن با هر سبکی که آن نشست بارگذاری کرده است بازمی‌گردد، نه سبک شما.

نحوه نوشتن استایل خروجی اختصاصی

یک استایل خروجی سفارشی، فایلی با فرمت markdown است که دارای frontmatter می‌باشد. آن را در دایرکتوری home ذخیره کنید تا در تمام پروژه‌ها در دسترس باشد، یا درون مخزن پروژه قرار دهید تا همراه با کد باقی بماند. دایرکتوری کاربر ~/.claude/output-styles/ و دایرکتوری پروژه .claude/output-styles/ است.

mkdir -p ~/.claude/output-styles
cat > ~/.claude/output-styles/terse-ops.md <<'EOF'
---
name: Terse ops
description: Command first, explanation after, for SSH sessions
keep-coding-instructions: true
---

Lead with the command or the file change. Put the explanation after it, in two sentences or fewer.

Do not narrate what you are about to do. Report what you did.

When a command can fail, print the one check that proves it worked and say what a healthy result looks like.
EOF

یک نشست (session) را شروع کرده و /config را باز کنید. استایل شما در لیست Output style به همراه توضیحی که نوشته‌اید ظاهر می‌شود. اگر استایل در لیست نیست، فایل خوانده نمی‌شود: مسیر را بررسی کنید و اگر نشست هنگام ذخیره فایل در حال اجرا بوده، Claude Code را مجدداً راه‌اندازی کنید. اگر استایل فقط با نام فایل و بدون توضیحات ظاهر می‌شود، frontmatter به درستی تجزیه (parse) نشده است و claude --debug خطای تجزیه را نشان می‌دهد. نام فایل به عنوان نام استایل در نظر گرفته می‌شود مگر اینکه در frontmatter مقدار name تعیین شده باشد؛ بنابراین این فایل Terse ops نامیده می‌شود و نه terse-ops.

آن را انتخاب کنید یا کلید مربوطه را دقیقاً با همان نام و حروف بزرگ و کوچک تنظیم نمایید:

{
  "outputStyle": "Terse ops"
}

یک فیلد تعیین می‌کند که فایل شما یک اصلاحیه است یا یک جایگزین. مقدار پیش‌فرض keep-coding-instructions برابر با false است؛ این یعنی یک استایل سفارشی، دستورالعمل‌های مهندسی نرم‌افزار داخلی Claude Code را حذف کرده و فقط بر اساس متن شما عمل می‌کند. آن دستورالعمل‌های داخلی همان مواردی هستند که به Claude می‌گویند چگونه دامنه یک تغییر را تعیین کند و چگونه کار خود را تأیید نماید. برای یک دستیار نویسندگی یا تحلیلگر داده که این موارد در آن کاربردی ندارد، این فیلد را خالی بگذارید. برای هر کاری که با کد در ارتباط است، آن را روی true تنظیم کنید، در غیر این صورت تعجب خواهید کرد که چرا یک مهندس دقیق، ناگهان بررسی کار خود را متوقف کرده است. فقط system prompt کامل Claude Code شامل آن بخش است، بنابراین در system prompt کوتاه‌تر، این فیلد تأثیری ندارد. تنظیم متغیر محیطی CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT روی 0، prompt کامل را روی هر مدلی انتخاب می‌کند. اگر هدف شما تغییر لحن نیست، بلکه تعریف دقیق‌تری از میزان کاری است که یک وظیفه می‌طلبد، این موضوع به دستورالعمل‌های مهندسی مربوط می‌شود تا فایل استایل: مهارت Ponytail یک نمونه عملی است؛ قانونی واحد که عامل را به سمت کوچک‌ترین تغییرِ کارآمد سوق می‌دهد.

description خطی است که انتخابگر /config در کنار نام نمایش می‌دهد. آن را برای زمانی بنویسید که شش ماه دیگر می‌خواهید بین دو استایل خود یکی را انتخاب کنید.

چرا سبک مختصر در SSH متفاوت است

روی یک VPS، شما متن خروجی را از طریق لایه‌هایی می‌خوانید که ترمینال محلی ندارد و هر لایه برای پرگویی، هزینه‌ای به شما تحمیل می‌کند.

اولین مورد، Scrollback است. در tmux، هر pane تعداد ثابتی خط نگه می‌دارد که توسط history-limit تعیین می‌شود و مقدار پیش‌فرض آن 2000 است. یک متن خروجیِ روایی، این بافر را سریع‌تر پر می‌کند، بنابراین بخش‌های ابتدایی نشست شما زودتر حذف می‌شوند و خروجی‌ای که می‌خواستید به آن برگردید، از دست می‌رود. اگر فضای بیشتری می‌خواهید، آن را افزایش دهید:

echo 'set -g history-limit 20000' >> ~/.tmux.conf
tmux source-file ~/.tmux.conf

paneهایی که پس از آن ایجاد می‌شوند، هر کدام 20000 خط را نگه می‌دارند که به قیمت مصرف حافظه بیشتر برای هر pane تمام می‌شود. در نسخه 3.7 یا بالاتر tmux، تغییر history-limit paneهای باز را نیز به‌روز می‌کند؛ نسخه‌های قدیمی‌تر فقط آن را برای paneهای جدید اعمال می‌کنند. اگر هنوز در حال ساخت چیدمان نشست هستید، اجرای Claude Code داخل tmux روی یک VPS این موضوع را پوشش می‌دهد.

دومین مورد، تأخیر (Latency) است. پاسخ هم‌زمان با تولید، به ترمینال شما سرازیر می‌شود. در یک ارتباط با زمان رفت‌وبرگشت (RTT) بالا، مقدمه‌چینی طولانی یعنی زمانی که صرف تماشای متن‌های بی‌اهمیت می‌کنید تا پاسخ اصلی ظاهر شود.

سومین مورد، توکن‌های خروجی است. هر خط روایی به‌عنوان خروجی محاسبه و هزینه می‌شود. سبک‌های Explanatory و Learning ذاتاً طولانی‌تر هستند. سبک Concise ذاتاً کوتاه‌تر است، زیرا به Claude دستور می‌دهد که پاسخ‌ها را به‌طور پیش‌فرض کوتاه نگه دارد.

به درصد اعلامی هیچ‌کس، از جمله این صفحه، اعتماد نکنید. میزان تفاوت به پرامپت‌ها، مدل و کاری که درخواست می‌کنید بستگی دارد، بنابراین قبل و بعد از تغییر را خودتان اندازه‌گیری کنید. یک کار واقعی یکسان را در دو نشست تازه اجرا کنید، یکی با حالت Default و دیگری با Concise، سپس مقایسه کنید. یک statusline ساده‌ترین ابزار اندازه‌گیری است، زیرا Claude Code یک شیء JSON را از طریق stdin به اسکریپت شما می‌فرستد که شامل نام سبک، توکن‌های خروجی آخرین پاسخ و برآورد هزینه جاری نشست است:

cat > ~/.claude/statusline.sh <<'EOF'
#!/bin/bash
input=$(cat)
style=$(echo "$input" | jq -r '.output_style.name // "default"')
out=$(echo "$input" | jq -r '.context_window.total_output_tokens // 0')
cost=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
echo "style=$style out=$out cost=$cost"
EOF
chmod +x ~/.claude/statusline.sh

تنظیم statusLine را به آن اشاره دهید:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

نوار پایین نشست اکنون سبک فعال را در کنار اندازه آخرین پاسخ و هزینه برآورد شده نشست تا این لحظه نشان می‌دهد. out فقط آخرین پاسخ را پوشش می‌دهد، بنابراین نشان می‌دهد هر پاسخ چقدر طول می‌کشد. cost انباشته می‌شود، بنابراین عدد در پایان هر اجرا، همان مقایسه قبل و بعد شماست. قبل از پاک کردن، آن را بخوانید، زیرا وقتی /clear یک نشست جدید را شروع می‌کند، هزینه به 0 بازنشانی می‌شود؛ همچنین آن را به‌عنوان یک برآورد در نظر بگیرید، نه صورت‌حساب نهایی. این اسکریپت به jq، یعنی مفسر JSON خط فرمان نیاز دارد، پس ابتدا آن را با sudo apt install -y jq نصب کنید. اگر نوار خالی ماند، اسکریپت را به‌صورت دستی اجرا کنید و مقداری JSON به آن pipe کنید، زیرا statuslineای که با کد غیر صفر خارج شود، چیزی چاپ نمی‌کند و گزارشی نمی‌دهد. یک statusline سفارشی برای Claude Code بقیه فیلدهای آن شیء را فهرست کرده است. برای بخش صورت‌حساب به‌جای بخش نشست، توکن‌های Claude Code واقعاً کجا مصرف می‌شوند و ابزارهایی که هزینه‌های Claude Code را ردیابی می‌کنند را بخوانید.

نحوه بررسی اینکه کدام سبک خروجی در حال حاضر بارگذاری شده است

به‌جای حدس زدن، از این بررسی‌ها استفاده کنید.

  • دستور /status منابع تنظیمات فعال برای این نشست را فهرست می‌کند، از جمله اینکه آیا تنظیمات مدیریت‌شده توسط یک سازمان در حال اعمال هستند یا خیر.
  • دستور /context پرامپت سیستمی بارگذاری‌شده را به‌عنوان یک دسته‌بندی در تفکیک پنجره context نمایش می‌دهد.
  • دستور claude doctor، اگر از shell و بدون شروع یک نشست اجرا شود، عیب‌یابی نصب و تنظیمات را چاپ کرده و فایل‌های تنظیماتی که نامعتبر هستند را گزارش می‌کند.

هنگامی که یک سبک اعمال نمی‌شود، علت تقریباً همیشه یکی از دو مورد زیر است. اول زمان‌بندی است: در بیلد v2.1.73 تا v2.1.251، تغییر در میانه نشست منتظر /clear می‌ماند و در ترمینال، فایل سبکی که در میانه نشست ایجاد یا ویرایش کرده‌اید، منتظر راه‌اندازی مجدد می‌ماند. دوم اولویت است: .claude/settings.local.json بر .claude/settings.json مقدم است و هر دو بر ~/.claude/settings.json اولویت دارند. از آنجا که انتخابگر /config و دستور /output-style در فایل محلی می‌نویسند، سبکی که تیم شما در .claude/settings.json کامیت کرده است، در هر سیستمی که شخصی از یکی از این دو استفاده کرده باشد، به‌طور بی‌صدا نادیده گرفته می‌شود. دستور /status به شما می‌گوید کدام فایل‌ها بارگذاری شده‌اند اما مشخص نمی‌کند کدام‌یک کلید را تأمین کرده است؛ بنابراین هر فایلی که فهرست می‌کند را باز کرده و به دنبال outputStyle بگردید.

یک خطای نحوی JSON علائم مشابهی دارد اما راه‌حل آن متفاوت است. دستور claude doctor فایلی که قادر به تجزیه آن نبوده را نام می‌برد، که ارزش دارد پیش از جستجو برای موارد پیچیده‌تر، آن را اجرا کنید. مقداری که حروف آن اشتباه باشد، مانند explanatory، یک JSON معتبر است و همچنان سبک Default را به شما می‌دهد؛ بنابراین حروف بزرگ و کوچک را نیز بررسی کنید.

FAQ

چرا دستور /output-style دیگر کار نمی‌کند؟

در نسخهٔ فعلی، این دستور از کار نیفتاده است. /output-style سبک‌ها را فهرست می‌کند و /output-style concise سبک فعال را تغییر می‌دهد. این دستور در تاریخچهٔ خود یک وقفه دارد: نسخهٔ v2.1.73 آن را به نفع /config منسوخ کرد و نسخهٔ v2.1.269 فرمت فعلی /output-style [name] را اضافه کرد، بنابراین در نسخه‌های بین این دو، ممکن است دستور آن‌طور که اینجا توضیح داده شده کار نکند. برای مشاهدهٔ نسخهٔ خود، claude --version را اجرا کنید. در هر نسخه‌ای می‌توانید سبک را از /config در بخش Output style انتخاب کنید یا کلید outputStyle را در فایل تنظیمات مقداردهی کنید. مستندات برای این کلید حداقل نسخه‌ای تعیین نکرده‌اند، بنابراین تنظیم مستقیم آن دستوری است که ارزش یادداشت‌برداری شخصی دارد.

سبک خروجی را تغییر دادم اما تغییری رخ نداد. چرا؟

ابتدا نسخهٔ خود را بررسی کنید. در Claude Code نسخهٔ v2.1.251 یا بالاتر، سبکی که در میانهٔ نشست (session) تغییر می‌دهید، از پیام بعدی اعمال می‌شود. از نسخهٔ v2.1.73 تا v2.1.251، تغییر ذخیره می‌شد اما تنها پس از /clear یا شروع یک نشست جدید اعمال می‌گردید. در ترمینال، فایل سبک سفارشی که در طول نشست ایجاد یا ویرایش کرده‌اید نیاز به راه‌اندازی مجدد دارد، زیرا Claude Code فایل‌های سبک را هنگام شروع می‌خواند. اگر همچنان اعمال نشد، بررسی کنید که مقدار دقیقاً با نام سبک، شامل حروف بزرگ و کوچک، مطابقت داشته باشد، سپس /status را اجرا کنید تا ببینید کدام فایل‌های تنظیمات بارگذاری شده‌اند، زیرا .claude/settings.local.json بر .claude/settings.json اولویت دارد و هر دو بر ~/.claude/settings.json مقدم هستند.

آیا سبک خروجی Concise باعث صرفه‌جویی در هزینه می‌شود؟

این سبک توکن‌های خروجی را در جهتی که انتظار دارید تغییر می‌دهد، زیرا به Claude دستور می‌دهد پاسخ‌ها را به‌صورت پیش‌فرض کوتاه نگه دارد. میزان صرفه‌جویی به پرامپت‌ها و مدل شما بستگی دارد، بنابراین هر درصدی که منتشر شده را به‌عنوان اندازه‌گیری کار دیگران در نظر بگیرید. عملکرد خود را بسنجید: برای ورودی، /context را در یک نشست تازه تحت هر سبک اجرا کنید، سپس همان وظیفه را تحت هر سبک انجام دهید و توکن‌های خروجی و هزینهٔ تخمینی را مقایسه کنید. سبک Concise هرگز گزارش خطا یا هشدار امنیتی را کوتاه نمی‌کند، بنابراین بخش‌هایی که بیشترین نیاز را به خواندن آن‌ها دارید، کامل باقی می‌مانند.

آیا تغییر سبک خروجی بر نحوهٔ نوشتن subagentها تأثیر می‌گذارد؟

خیر. سبک‌های خروجی فقط برای گفتگوی اصلی اعمال می‌شوند، زیرا هر subagent گفتگوی خاص خود را با پرامپت سیستمی و مجموعه ابزارهای اختصاصی خود آغاز می‌کند. استثنا، انشعاب (fork) از گفتگوی فعلی است، زیرا انشعاب دقیقاً پرامپت سیستمی والد را به ارث می‌برد. برای تغییر نحوهٔ پاسخ‌دهی یک subagent، فایل اختصاصی همان agent را ویرایش کنید.

آیا سبک خروجی می‌تواند به Claude اجازه دهد بدون پرسش، دستورات را اجرا کند؟

خیر. سبک خروجی متنی در پرامپت سیستمی است، بنابراین فقط می‌تواند بر آنچه Claude تلاش می‌کند انجام دهد تأثیر بگذارد. سبک Proactive باعث می‌شود Claude به‌جای توقف در تصمیمات روتین، فرض را بر انجام کار بگذارد و عمل کند، اما همچنان نمی‌تواند دستوری را تأیید کند. حالت مجوز (permission mode) شما تعیین می‌کند چه چیزی بدون پرسش اجرا شود، و این همان تنظیمی است که باید پیش از رها کردن یک نشست در حال اجرا روی سرور، بررسی کنید.

آیا این مقاله مفید بود؟