مرجع CLI

دستورهای CLI

با این دستورها می‌توانی نشست‌ها را شروع کنی، محتوا را pipe کنی، گفت‌وگوها را از سر بگیری و به‌روزرسانی‌ها را مدیریت کنی:

دستور	توضیح	مثال
`claude`	شروع نشست تعاملی	`claude`
`claude "query"`	شروع نشست تعاملی با یک پرامپت اولیه	`claude "explain this project"`
`claude -p "query"`	پرس‌وجو از طریق SDK، سپس خروج	`claude -p "explain this function"`
`cat file \| claude -p "query"`	پردازش محتوای pipe‌شده	`cat logs.txt \| claude -p "explain"`
`claude -c`	ادامهٔ آخرین گفت‌وگو در دایرکتوری فعلی	`claude -c`
`claude -c -p "query"`	ادامه از طریق SDK	`claude -c -p "Check for type errors"`
`claude -r "<session>" "query"`	از سر گرفتن نشست با شناسه یا نام	`claude -r "auth-refactor" "Finish this PR"`
`claude update`	به‌روزرسانی به آخرین نسخه	`claude update`
`claude install [version]`	نصب یا نصب مجدد باینری نیتیو. نسخه‌ای مثل `2.1.118` یا `stable` یا `latest` را می‌پذیرد. ببین نصب یک نسخهٔ مشخص	`claude install stable`
`claude auth login`	ورود به حساب Anthropic‌ات. از `--email` برای پیش‌پرکردن آدرس ایمیلت، از `--sso` برای اجبار احراز هویت SSO، و از `--console` برای ورود با Anthropic Console جهت هزینهٔ مصرف API به‌جای اشتراک Claude استفاده کن	`claude auth login --console`
`claude auth logout`	خروج از حساب Anthropic‌ات	`claude auth logout`
`claude auth status`	نمایش وضعیت احراز هویت به‌صورت JSON. از `--text` برای خروجی خوانا برای انسان استفاده کن. اگر وارد شده باشی با کد ۰ و در غیر این صورت با کد ۱ خارج می‌شود	`claude auth status`
`claude agents`	باز کردن نمای ایجنت برای پایش و اعزام نشست‌های پس‌زمینهٔ موازی. از `--cwd <path>` برای نمایش فقط نشست‌هایی که زیر آن دایرکتوری شروع شده‌اند، یا از `--json` برای چاپ نشست‌های فعال به‌صورت آرایهٔ JSON جهت اسکریپت‌نویسی استفاده کن (`--json --all` نشست‌های پس‌زمینهٔ تمام‌شده را هم شامل می‌شود). برای تعیین پیش‌فرض‌های نشست‌های اعزام‌شده، `--permission-mode`، `--model`، `--effort` یا `--agent` را بده. مانند دستور سطح‌بالای `claude`، `--settings`، `--add-dir`، `--plugin-dir` و `--mcp-config` را می‌پذیرد. باز کردن نمای ایجنت به یک ترمینال تعاملی نیاز دارد	`claude agents --json`
`claude attach <id>`	اتصال به یک نشست پس‌زمینه در این ترمینال	`claude attach 7c5dcf5d`
`claude auto-mode defaults`	چاپ قواعد دسته‌بندِ داخلی حالت خودکار به‌صورت JSON. از `claude auto-mode config` برای دیدن پیکربندی مؤثرت با تنظیمات اعمال‌شده استفاده کن	`claude auto-mode defaults > rules.json`
`claude daemon status`	چاپ وضعیت، نسخه، دایرکتوری سوکت و تعداد کارگرهای سرپرستِ نشست‌های پس‌زمینه برای عیب‌یابی. اگر سرپرست در حال اجرا نباشد با کد ۱ خارج می‌شود	`claude daemon status`
`claude daemon stop --any`	توقف سرپرستِ نشست‌های پس‌زمینه و نشست‌هایی که میزبانی می‌کند. `--keep-workers` را بده تا نشست‌های پس‌زمینه در حال اجرا بمانند و سرپرست بعدی به آن‌ها وصل شود. `--any` توقف یک سرپرستِ on-demand را که حالت پیش‌فرض است تأیید می‌کند. از این برای بازیابی از یک سرپرست بی‌پاسخ استفاده کن	`claude daemon stop --any --keep-workers`
`claude logs <id>`	چاپ خروجی اخیر یک نشست پس‌زمینه	`claude logs 7c5dcf5d`
`claude mcp`	پیکربندی سرورهای Model Context Protocol (MCP)	ببین مستندات MCP در Claude Code.
`claude plugin`	مدیریت پلاگین‌های Claude Code. نام مستعار: `claude plugins`. برای زیردستورها ببین مرجع پلاگین	`claude plugin install code-review@claude-plugins-official`
`claude project purge [path]`	حذف همهٔ وضعیت محلی Claude Code برای یک پروژه: رونوشت‌ها، فهرست‌های تسک، لاگ‌های دیباگ، تاریخچهٔ ویرایش فایل، خطوط تاریخچهٔ پرامپت، و ورودیِ پروژه در `~/.claude.json`. `[path]` را حذف کن تا از یک فهرست تعاملی انتخاب کنی. پرچم‌ها: `--dry-run` برای پیش‌نمایش، `-y`/`--yes` برای رد شدن از تأیید، `-i`/`--interactive` برای تأیید هر مورد، `--all` برای همهٔ پروژه‌ها. ببین پاک کردن داده‌های محلی	`claude project purge ~/work/repo --dry-run`
`claude remote-control`	راه‌اندازی یک سرور Remote Control برای کنترل Claude Code از Claude.ai یا اپ Claude. در حالت سرور اجرا می‌شود (بدون نشست تعاملی محلی). ببین پرچم‌های حالت سرور	`claude remote-control --name "My Project"`
`claude respawn <id>`	راه‌اندازی مجدد یک نشست پس‌زمینه، در حال اجرا یا متوقف‌شده، با حفظ کامل گفت‌وگو. از `--all` برای راه‌اندازی مجدد هر نشست در حال اجرا استفاده کن، مثلاً برای برداشتن باینری به‌روزشدهٔ Claude Code	`claude respawn 7c5dcf5d`
`claude rm <id>`	حذف یک نشست پس‌زمینه از فهرست. رونوشت گفت‌وگو روی دستگاه محلی‌ات می‌ماند و از طریق `claude --resume` در دسترس است	`claude rm 7c5dcf5d`
`claude setup-token`	تولید یک توکن OAuth با عمر طولانی برای CI و اسکریپت‌ها. توکن را روی ترمینال چاپ می‌کند بدون اینکه آن را ذخیره کند. به اشتراک Claude نیاز دارد. ببین تولید یک توکن با عمر طولانی	`claude setup-token`
`claude stop <id>`	توقف یک نشست پس‌زمینه. `claude kill` را هم می‌پذیرد	`claude stop 7c5dcf5d`
`claude ultrareview [target]`	اجرای ultrareview به‌صورت غیرتعاملی. یافته‌ها را در stdout چاپ می‌کند و در صورت موفقیت با کد ۰ و در صورت شکست با کد ۱ خارج می‌شود. از `--json` برای payload خام و از `--timeout <minutes>` برای جایگزینی پیش‌فرض ۳۰ دقیقه‌ای استفاده کن	`claude ultrareview 1234 --json`

اگر یک زیردستور را اشتباه تایپ کنی، Claude Code نزدیک‌ترین تطابق را پیشنهاد می‌دهد و بدون شروع نشست خارج می‌شود. برای مثال، claude udpate پیام Did you mean claude update? را چاپ می‌کند.

پرچم‌های CLI

رفتار Claude Code را با این پرچم‌های خط فرمان سفارشی کن. claude --help همهٔ پرچم‌ها را فهرست نمی‌کند، پس نبودن یک پرچم در --help به معنای در دسترس نبودن آن نیست.

پرچم	توضیح	مثال
`--add-dir`	افزودن دایرکتوری‌های کاری بیشتر برای خواندن و ویرایش فایل توسط Claude. دسترسی به فایل را اعطا می‌کند؛ بیشتر پیکربندی‌های `.claude/` از این دایرکتوری‌ها کشف نمی‌شوند. وجود هر مسیر را به‌عنوان یک دایرکتوری اعتبارسنجی می‌کند. برای ماندگار کردن این دایرکتوری‌ها در نشست‌ها، `permissions.additionalDirectories` را در تنظیمات تعیین کن	`claude --add-dir ../apps ../lib`
`--advisor <model>`	{/* min-version: 2.1.98 /}فعال کردن ابزار مشاورِ سمت سرور برای این نشست با یک نام مستعار مدل: `opus`، `sonnet` یا `fable` ({/ min-version: 2.1.170 */}نسخهٔ v2.1.170 به بعد)، یا یک شناسهٔ کامل مدل. برای این نشست بر تنظیم `advisorModel` اولویت دارد. به Claude Code نسخهٔ v2.1.98 یا بالاتر نیاز دارد	`claude --advisor opus`
`--agent`	تعیین یک ایجنت برای نشست فعلی (تنظیم `agent` را بازنویسی می‌کند)	`claude --agent my-custom-agent`
`--agents`	تعریف پویای ساب‌ایجنت‌های سفارشی از طریق JSON. از همان نام‌فیلدهای frontmatter ساب‌ایجنت، به‌علاوهٔ یک فیلد `prompt` برای دستورالعمل‌های ایجنت استفاده می‌کند	`claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'`
`--allow-dangerously-skip-permissions`	افزودن `bypassPermissions` به چرخهٔ حالت `Shift+Tab` بدون شروع در آن. به تو اجازه می‌دهد در حالت دیگری مثل `plan` شروع کنی و بعداً به `bypassPermissions` سوئیچ کنی. ببین حالت‌های دسترسی	`claude --permission-mode plan --allow-dangerously-skip-permissions`
`--allowedTools`, `--allowed-tools`	ابزارهایی که بدون درخواست مجوز اجرا می‌شوند. برای تطبیق الگو ببین نحو قواعد دسترسی. برای محدود کردن اینکه چه ابزارهایی در دسترس‌اند، به‌جای آن از `--tools` استفاده کن	`"Bash(git log )" "Bash(git diff )" "Read"`
`--append-system-prompt`	افزودن متن سفارشی به انتهای سیستم‌پرامپت پیش‌فرض	`claude --append-system-prompt "Always use TypeScript"`
`--append-system-prompt-file`	بارگذاری متن سیستم‌پرامپت اضافی از یک فایل و افزودن آن به پرامپت پیش‌فرض	`claude --append-system-prompt-file ./extra-rules.txt`
`--bare`	حالت کمینه: رد شدن از کشف خودکار hooks، skills، پلاگین‌ها، سرورهای MCP، حافظهٔ خودکار و CLAUDE.md تا فراخوانی‌های اسکریپتی سریع‌تر شروع شوند. Claude به ابزارهای Bash، خواندن فایل و ویرایش فایل دسترسی دارد. `CLAUDE_CODE_SIMPLE` را تنظیم می‌کند. ببین حالت bare	`claude --bare -p "query"`
`--betas`	هدرهای Beta برای گنجاندن در درخواست‌های API (فقط کاربران کلید API)	`claude --betas interleaved-thinking`
`--bg`	شروع نشست به‌صورت یک ایجنت پس‌زمینه و بازگشت فوری. شناسهٔ نشست و دستورهای مدیریت را چاپ می‌کند. با `--exec` ترکیب کن تا یک دستور شل را به‌عنوان یک کار پس‌زمینه به‌جای نشست Claude اجرا کنی، یا با `--agent` تا یک ساب‌ایجنت مشخص را اجرا کنی	`claude --bg "investigate the flaky test"`
`--channels`	(پیش‌نمایش پژوهشی) سرورهای MCP‌ای که Claude باید در این نشست به اعلان‌های channel آن‌ها گوش بدهد. فهرستی جداشده با فاصله از ورودی‌های `plugin:<name>@<marketplace>`. به احراز هویت Claude.ai نیاز دارد	`claude --channels plugin:my-notifier@my-marketplace`
`--chrome`	فعال کردن یکپارچگی مرورگر Chrome برای خودکارسازی و تست وب	`claude --chrome`
`--continue`, `-c`	بارگذاری آخرین گفت‌وگو در دایرکتوری فعلی. شامل نشست‌هایی است که این دایرکتوری را با `/add-dir` افزوده‌اند	`claude --continue`
`--dangerously-load-development-channels`	فعال کردن channelهایی که در فهرست مجاز تأییدشده نیستند، برای توسعهٔ محلی. ورودی‌های `plugin:<name>@<marketplace>` و `server:<name>` را می‌پذیرد. برای تأیید درخواست می‌دهد	`claude --dangerously-load-development-channels server:webhook`
`--dangerously-skip-permissions`	رد شدن از درخواست‌های مجوز. معادل `--permission-mode bypassPermissions`. برای اینکه چه چیزی را رد می‌کند و چه چیزی را نمی‌کند ببین حالت‌های دسترسی	`claude --dangerously-skip-permissions`
`--debug`	فعال کردن حالت دیباگ با فیلتر دسته‌ای اختیاری (برای مثال، `"api,hooks"` یا `"!statsig,!file"`)	`claude --debug "api,mcp"`
`--debug-file <path>`	نوشتن لاگ‌های دیباگ در یک مسیر فایل مشخص. به‌طور ضمنی حالت دیباگ را فعال می‌کند. بر `CLAUDE_CODE_DEBUG_LOGS_DIR` اولویت دارد	`claude --debug-file /tmp/claude-debug.log`
`--disable-slash-commands`	غیرفعال کردن همهٔ skillها و دستورها برای این نشست	`claude --disable-slash-commands`
`--disallowedTools`, `--disallowed-tools`	قواعد منع. یک نام ابزار خالی ابزارهای منطبق را از کانتکست مدل حذف می‌کند: `"Edit"` ابزار Edit را حذف می‌کند، `""` هر ابزاری را حذف می‌کند، و `"mcp__"` هر ابزار MCP را حذف می‌کند. یک قاعدهٔ دامنه‌دار مثل `Bash(rm *)` ابزار را در دسترس می‌گذارد و فقط فراخوانی‌های منطبق را منع می‌کند	`"Bash(git log )" "Bash(git diff )" "Edit"`
`--effort`	تعیین سطح تلاش برای نشست فعلی. گزینه‌ها: `low`، `medium`، `high`، `xhigh`، `max`؛ سطوح در دسترس به مدل بستگی دارد. برای این نشست تنظیم `effortLevel` را بازنویسی می‌کند و ماندگار نیست	`claude --effort high`
`--enable-auto-mode`	{/* max-version: 2.1.110 */}در v2.1.111 حذف شد. حالت خودکار اکنون به‌طور پیش‌فرض در چرخهٔ `Shift+Tab` است؛ برای شروع در آن از `--permission-mode auto` استفاده کن	`claude --permission-mode auto`
`--exclude-dynamic-system-prompt-sections`	انتقال بخش‌های مختص هر دستگاه از سیستم‌پرامپت (دایرکتوری کاری، اطلاعات محیط، مسیرهای حافظه، پرچم git-repo) به اولین پیام کاربر. بازاستفادهٔ کش پرامپت را در میان کاربران و دستگاه‌های مختلفی که همان تسک را اجرا می‌کنند بهبود می‌دهد. فقط با سیستم‌پرامپت پیش‌فرض اعمال می‌شود؛ وقتی `--system-prompt` یا `--system-prompt-file` تنظیم شده باشد نادیده گرفته می‌شود. برای بارهای کاری اسکریپتی و چندکاربره از آن با `-p` استفاده کن	`claude -p --exclude-dynamic-system-prompt-sections "query"`
`--exec`	اجرای یک دستور شل به‌عنوان یک کار پس‌زمینهٔ متکی بر PTY به‌جای شروع یک نشست Claude. برای راه‌اندازی از شل، با `--bg` استفاده کن	`claude --bg --exec 'pytest -x'`
`--fallback-model`	فعال کردن fallback خودکار به مدل(های) مشخص‌شده وقتی مدل اصلی بیش‌ازحد بارگذاری شده یا در دسترس نیست، مثلاً یک مدل بازنشسته. فهرستی جداشده با کاما را می‌پذیرد که به ترتیب امتحان می‌شوند. ببین زنجیره‌های مدل fallback. برای ماندگار کردن یک زنجیره در نشست‌ها، از تنظیم `fallbackModel` استفاده کن که این پرچم آن را بازنویسی می‌کند	`claude --fallback-model sonnet,haiku`
`--fork-session`	هنگام از سر گرفتن، به‌جای استفادهٔ مجدد از شناسهٔ اصلی، یک شناسهٔ نشست جدید بساز (با `--resume` یا `--continue` استفاده کن)	`claude --resume abc123 --fork-session`
`--from-pr`	از سر گرفتن نشست‌های مرتبط با یک pull request مشخص. یک شمارهٔ PR، یک URL از PR در GitHub یا GitHub Enterprise، یک URL از merge request در GitLab، یا یک URL از pull request در Bitbucket را می‌پذیرد. وقتی Claude این pull request را می‌سازد، نشست‌ها به‌طور خودکار مرتبط می‌شوند	`claude --from-pr 123`
`--ide`	اتصال خودکار به IDE هنگام راه‌اندازی، اگر دقیقاً یک IDE معتبر در دسترس باشد	`claude --ide`
`--init`	اجرای hookهای Setup با matcher مقدار `init` پیش از نشست (فقط حالت چاپ)	`claude -p --init "query"`
`--init-only`	اجرای hookهای Setup و `SessionStart`، سپس خروج بدون شروع گفت‌وگو	`claude --init-only`
`--include-hook-events`	گنجاندن همهٔ رویدادهای چرخهٔ عمر hook در جریان خروجی. به `--output-format stream-json` نیاز دارد	`claude -p --output-format stream-json --verbose --include-hook-events "query"`
`--include-partial-messages`	گنجاندن رویدادهای جزئیِ streaming در خروجی. به `--print` و `--output-format stream-json` نیاز دارد	`claude -p --output-format stream-json --verbose --include-partial-messages "query"`
`--input-format`	تعیین فرمت ورودی برای حالت چاپ (گزینه‌ها: `text`، `stream-json`)	`claude -p --output-format json --input-format stream-json`
`--json-schema`	دریافت خروجی JSON اعتبارسنجی‌شده منطبق با یک JSON Schema پس از اینکه ایجنت ورک‌فلوش را کامل کرد (فقط حالت چاپ، ببین خروجی‌های ساختاریافته)	`claude -p --json-schema '{"type":"object","properties":{...}}' "query"`
`--maintenance`	اجرای hookهای Setup با matcher مقدار `maintenance` پیش از نشست (فقط حالت چاپ)	`claude -p --maintenance "query"`
`--max-budget-usd`	بیشترین مبلغ دلاری برای خرج کردن در فراخوانی‌های API پیش از توقف (فقط حالت چاپ)	`claude -p --max-budget-usd 5.00 "query"`
`--max-turns`	محدود کردن تعداد نوبت‌های ایجنتیک (فقط حالت چاپ). وقتی به حد برسد با خطا خارج می‌شود. به‌طور پیش‌فرض بدون محدودیت	`claude -p --max-turns 3 "query"`
`--mcp-config`	بارگذاری سرورهای MCP از فایل‌ها یا رشته‌های JSON (جداشده با فاصله)	`claude --mcp-config ./mcp.json`
`--model`	مدل را برای نشست فعلی با یک نام مستعار برای آخرین مدل (`sonnet`، `opus`، `haiku` یا `fable`) یا نام کامل یک مدل تعیین می‌کند. تنظیم `model` و `ANTHROPIC_MODEL` را بازنویسی می‌کند	`claude --model claude-sonnet-4-6`
`--name`, `-n`	تعیین یک نام نمایشی برای نشست، که در `/resume` و عنوان ترمینال نشان داده می‌شود. می‌توانی یک نشست نام‌دار را با `claude --resume <name>` از سر بگیری. `/rename` نام را در میانهٔ نشست تغییر می‌دهد و آن را روی نوار پرامپت هم نشان می‌دهد	`claude -n "my-feature-work"`
`--no-chrome`	غیرفعال کردن یکپارچگی مرورگر Chrome برای این نشست	`claude --no-chrome`
`--no-session-persistence`	غیرفعال کردن ماندگاری نشست تا نشست‌ها روی دیسک ذخیره نشوند و قابل از سر گرفتن نباشند. فقط حالت چاپ. متغیر محیطی `CLAUDE_CODE_SKIP_PROMPT_HISTORY` در هر حالتی همین کار را می‌کند	`claude -p --no-session-persistence "query"`
`--output-format`	تعیین فرمت خروجی برای حالت چاپ (گزینه‌ها: `text`، `json`، `stream-json`)	`claude -p "query" --output-format json`
`--permission-mode`	شروع در یک حالت دسترسی مشخص. مقادیر `default`، `acceptEdits`، `plan`، `auto`، `dontAsk` یا `bypassPermissions` را می‌پذیرد. `defaultMode` از فایل‌های تنظیمات را بازنویسی می‌کند	`claude --permission-mode plan`
`--permission-prompt-tool`	تعیین یک ابزار MCP برای رسیدگی به درخواست‌های مجوز در حالت غیرتعاملی	`claude -p --permission-prompt-tool mcp_auth_tool "query"`
`--plugin-dir`	بارگذاری یک پلاگین از یک دایرکتوری یا آرشیو `.zip` فقط برای این نشست. هر پرچم یک مسیر می‌گیرد. برای چند پلاگین پرچم را تکرار کن: `--plugin-dir A --plugin-dir B.zip`	`claude --plugin-dir ./my-plugin`
`--plugin-url`	واکشی یک آرشیو `.zip` پلاگین از یک URL فقط برای این نشست. پرچم را برای چند پلاگین تکرار کن، یا URLهای جداشده با فاصله را در یک مقدار نقل‌قول‌شده بده	`claude --plugin-url https://example.com/plugin.zip`
`--print`, `-p`	چاپ پاسخ بدون حالت تعاملی (برای جزئیات استفادهٔ برنامه‌نویسی‌شده ببین مستندات Agent SDK)	`claude -p "query"`
`--prompt-suggestions`	پس از هر نوبت یک پیام `prompt_suggestion` با پرامپت کاربر پیش‌بینی‌شدهٔ بعدی منتشر می‌کند. به `--print`، `--output-format stream-json` و `--verbose` نیاز دارد. ببین پیشنهادهای پرامپت	`claude -p --prompt-suggestions --output-format stream-json --verbose "query"`
`--remote`	ساختن یک نشست وب جدید روی claude.ai با شرح تسک ارائه‌شده	`claude --remote "Fix the login bug"`
`--remote-control`, `--rc`	شروع یک نشست تعاملی با Remote Control فعال‌شده تا بتوانی آن را از claude.ai یا اپ Claude هم کنترل کنی. به‌اختیار یک نام برای نشست بده	`claude --remote-control "My Project"`
`--remote-control-session-name-prefix <prefix>`	پیشوند برای نام‌های نشستِ Remote Control که به‌طور خودکار تولید می‌شوند وقتی نام صریحی تنظیم نشده باشد. به‌طور پیش‌فرض نام میزبان دستگاهت است که نام‌هایی مثل `myhost-graceful-unicorn` تولید می‌کند. برای همین اثر `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` را تنظیم کن	`claude remote-control --remote-control-session-name-prefix dev-box`
`--replay-user-messages`	انتشار مجدد پیام‌های کاربر از stdin به stdout برای تأیید دریافت. به `--input-format stream-json` و `--output-format stream-json` نیاز دارد	`claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages`
`--resume`, `-r`	از سر گرفتن یک نشست مشخص با شناسه یا نام، یا نمایش یک انتخابگر تعاملی برای انتخاب یک نشست. انتخابگر و جست‌وجوی نام شامل نشست‌هایی است که این دایرکتوری را با `/add-dir` افزوده‌اند؛ دادن یک شناسهٔ نشست فقط در دایرکتوری پروژهٔ فعلی و worktreeهای git آن جست‌وجو می‌کند. از نسخهٔ v2.1.144، نشست‌های پس‌زمینه در انتخابگر با علامت `bg` ظاهر می‌شوند	`claude --resume auth-refactor`
`--safe-mode`	{/* min-version: 2.1.169 */}شروع با همهٔ سفارشی‌سازی‌های غیرفعال‌شده برای عیب‌یابی یک پیکربندی خراب: CLAUDE.md، skillها، پلاگین‌ها، hooks، سرورهای MCP، دستورها و ایجنت‌های سفارشی، سبک‌های خروجی، ورک‌فلوها، تم‌های سفارشی، کلیدهای میان‌بر سفارشی، نوار وضعیت و دستورهای پیشنهاد فایل، سرورهای LSP و حافظهٔ خودکار بارگذاری نمی‌شوند. احراز هویت، انتخاب مدل، ابزارهای داخلی و دسترسی‌ها به‌طور عادی کار می‌کنند، که با `--bare` فرق دارد. سیاستِ تنظیمات مدیریت‌شده همچنان اعمال می‌شود، از جمله hooks، نوار وضعیت و دستورهای پیشنهاد فایلِ پیکربندی‌شده با سیاست؛ پلاگین‌های مدیریت‌شده، skillهای مدیریت‌شده، CLAUDE.md مدیریت‌شده و سرورهای MCP پیکربندی‌شده با سیاست بارگذاری نمی‌شوند. برای بررسی اینکه آیا یک سفارشی‌سازی همان چیزی است که fallback خودکار از Fable 5 را تحریک می‌کند مفید است. `CLAUDE_CODE_SAFE_MODE` را تنظیم می‌کند	`claude --safe-mode`
`--session-id`	استفاده از یک شناسهٔ نشست مشخص برای گفت‌وگو (باید یک UUID معتبر باشد)	`claude --session-id "550e8400-e29b-41d4-a716-446655440000"`
`--setting-sources`	فهرستی جداشده با کاما از منابع تنظیماتی که باید بارگذاری شوند (`user`، `project`، `local`)	`claude --setting-sources user,project`
`--settings`	مسیر یک فایل JSON تنظیمات یا یک رشتهٔ JSON درون‌خطی. مقادیری که اینجا تنظیم می‌کنی همان کلیدها را در فایل‌های `settings.json`‌ات برای این نشست بازنویسی می‌کنند. کلیدهایی که حذف می‌کنی مقادیر مبتنی بر فایلشان را حفظ می‌کنند. ببین اولویت تنظیمات	`claude --settings ./settings.json`
`--strict-mcp-config`	فقط از سرورهای MCP موجود در `--mcp-config` استفاده کن و همهٔ پیکربندی‌های MCP دیگر را نادیده بگیر	`claude --strict-mcp-config --mcp-config ./mcp.json`
`--system-prompt`	جایگزینی کل سیستم‌پرامپت با متن سفارشی	`claude --system-prompt "You are a Python expert"`
`--system-prompt-file`	بارگذاری سیستم‌پرامپت از یک فایل، با جایگزینی پرامپت پیش‌فرض	`claude --system-prompt-file ./custom-prompt.txt`
`--teleport`	از سر گرفتن یک نشست وب در ترمینال محلی‌ات	`claude --teleport`
`--teammate-mode`	تعیین نحوهٔ نمایش هم‌تیمی‌های تیم ایجنت: `auto` (پیش‌فرض)، `in-process` یا `tmux`. برای این نشست تنظیم `teammateMode` را بازنویسی می‌کند. ببین انتخاب یک حالت نمایش	`claude --teammate-mode in-process`
`--tmux`	ساختن یک نشست tmux برای worktree. به `--worktree` نیاز دارد. وقتی در دسترس باشد از پنل‌های نیتیو iTerm2 استفاده می‌کند؛ برای tmux سنتی `--tmux=classic` را بده	`claude -w feature-auth --tmux`
`--tools`	محدود کردن اینکه Claude چه ابزارهای داخلی‌ای می‌تواند استفاده کند. از `""` برای غیرفعال کردن همه، `"default"` برای همه، یا نام ابزارهایی مثل `"Bash,Edit,Read"` استفاده کن. ابزارهای MCP تحت تأثیر قرار نمی‌گیرند؛ برای منع آن‌ها هم، از `--disallowedTools "mcp__*"` استفاده کن، یا `--strict-mcp-config` را بدون `--mcp-config` بده تا هیچ سرور MCP‌ای بارگذاری نشود	`claude --tools "Bash,Edit,Read"`
`--verbose`	فعال کردن لاگ‌گیری مفصل، خروجی کامل نوبت‌به‌نوبت را نشان می‌دهد. برای این نشست تنظیم `viewMode` را بازنویسی می‌کند	`claude --verbose`
`--version`, `-v`	خروجی دادن شمارهٔ نسخه	`claude -v`
`--worktree`, `-w`	شروع Claude در یک git worktree ایزوله در `<repo>/.claude/worktrees/<name>`. اگر نامی داده نشود، یکی به‌طور خودکار تولید می‌شود. `#<number>` یا یک URL از pull request در GitHub را بده تا آن PR را از `origin` واکشی کند و worktree را از آن شاخه بزند	`claude -w feature-auth`

پرچم‌های سیستم‌پرامپت

Claude Code چهار پرچم برای سفارشی‌سازی سیستم‌پرامپت فراهم می‌کند. هر چهار پرچم هم در حالت تعاملی و هم در حالت غیرتعاملی کار می‌کنند.

پرچم	رفتار	مثال
`--system-prompt`	کل پرامپت پیش‌فرض را جایگزین می‌کند	`claude --system-prompt "You are a Python expert"`
`--system-prompt-file`	با محتوای فایل جایگزین می‌کند	`claude --system-prompt-file ./prompts/review.txt`
`--append-system-prompt`	به پرامپت پیش‌فرض اضافه می‌کند	`claude --append-system-prompt "Always use TypeScript"`
`--append-system-prompt-file`	محتوای فایل را به پرامپت پیش‌فرض اضافه می‌کند	`claude --append-system-prompt-file ./style-rules.txt`

--system-prompt و --system-prompt-file متقابلاً انحصاری‌اند. پرچم‌های append را می‌توان با هر یک از دو پرچم جایگزینی ترکیب کرد.

بر اساس اینکه آیا هویت پیش‌فرض Claude Code هنوز با تسک تو جور درمی‌آید انتخاب کن. وقتی Claude باید یک دستیار کدنویسی بماند که قواعد اضافی تو را هم دنبال می‌کند از یک پرچم append استفاده کن: دستورالعمل‌های مختص هر فراخوانی، قالب‌بندی خروجی، یا کانتکست دامنه برای یک اسکریپت -p. افزودن، راهنمایی ابزار، دستورالعمل‌های ایمنی و قراردادهای کدنویسی پیش‌فرض را حفظ می‌کند، پس تو فقط آنچه را که متفاوت است فراهم می‌کنی. وقتی سطح، هویت یا مدل دسترسی با Claude Code فرق دارد از یک پرچم جایگزینی استفاده کن، مثل یک ایجنت غیرکدنویسی در یک pipeline که هیچ انسانی آن را تماشا نمی‌کند. جایگزینی همهٔ پرامپت پیش‌فرض را، از جمله راهنمایی ابزار و دستورالعمل‌های ایمنی، حذف می‌کند، پس مسئولیت هر چیزی که تسکت هنوز نیاز دارد بر عهدهٔ توست.

این پرچم‌ها فقط برای فراخوانی فعلی اعمال می‌شوند. برای پرسوناهای ماندگار که می‌توانی بینشان سوئیچ کنی و در یک پروژه به اشتراک بگذاری، از سبک‌های خروجی استفاده کن. برای قراردادهای پروژه‌ای که Claude باید همیشه دنبال کند، از CLAUDE.md استفاده کن. راهنمای Agent SDK دربارهٔ سیستم‌پرامپت‌ها همین تصمیم را با عمق بیشتری پوشش می‌دهد.

همچنین ببین

افزونهٔ Chrome - خودکارسازی مرورگر و تست وب
حالت تعاملی - میان‌برها، حالت‌های ورودی و قابلیت‌های تعاملی
راهنمای شروع سریع - شروع کار با Claude Code
ورک‌فلوهای رایج - ورک‌فلوها و الگوهای پیشرفته
تنظیمات - گزینه‌های پیکربندی
مستندات Agent SDK - استفادهٔ برنامه‌نویسی‌شده و یکپارچگی‌ها