رفتن به محتوا
Claude Code Docs غیر رسمی

متغیرهای محیطی

متغیرهای محیطی می‌توانند رفتارِ Claude Code را کنترل کنند، مثلِ انتخابِ مدل، احراز هویت، مسیریابیِ درخواست و روشن/خاموش‌کردنِ قابلیت‌ها. بسیاری از همین رفتارها را می‌توان از طریقِ یک فیلد در فایلِ تنظیمات، یک پرچمِ CLI، یا یک دستورِ درون‌نشست مثلِ /model هم پیکربندی کرد.

این صفحه پوشش می‌دهد که چطور:

تنظیمِ متغیرهای محیطی

Section titled “تنظیمِ متغیرهای محیطی”

متغیری که در شلت تنظیم می‌کنی برای آن نشستِ ترمینال دوام می‌آورد، در حالی که متغیری در یک فایلِ تنظیمات هر بار که claude اجرا می‌شود اعمال می‌شود.

در شلت

Section titled “در شلت”

متغیر را پیش از اجرای claude تنظیم کن:

Terminal window
export API_TIMEOUT_MS="1200000"
claude

برای تنظیمش در هر نشست، خطِ export را به ~/.bashrc، ~/.zshrc یا فایلِ profile شلت اضافه کن.

در فایل‌های تنظیمات

Section titled “در فایل‌های تنظیمات”

متغیرها را زیرِ کلیدِ env در یک فایلِ settings.json اضافه کن. Claude Code آن‌ها را هنگامِ شروع مستقیم از فایل می‌خواند، پس مهم نیست claude چطور اجرا شده باشد، اثر می‌گذارند.

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

فایلی که انتخاب می‌کنی تعیین می‌کند متغیرها برای چه کسی اعمال می‌شوند:

فایلاعمال می‌شود برای
~/.claude/settings.jsonتو، در هر پروژه
.claude/settings.jsonهرکسی که روی پروژه کار می‌کند، واردشده در سورس‌کنترل
.claude/settings.local.jsonتو، فقط در همین پروژه (اگر دستی می‌سازیش، آن را به gitignore اضافه کن)
تنظیماتِ مدیریت‌شدههرکسی در سازمانت، مستقرشده توسطِ یک مدیر

برای اینکه هر فایل کجا قرار دارد، فایل‌های تنظیمات را ببین، و برای اینکه چطور وقتی بیش از یکی همان متغیر را تنظیم می‌کنند با هم ترکیب می‌شوند، تقدمِ تنظیمات را ببین.

تقدم

Section titled “تقدم”

جایی که یک رفتار هم متغیرِ محیطی دارد و هم فیلدِ تنظیمات، متغیرِ محیطی ارجح است. مثلاً ANTHROPIC_MODEL بر تنظیمِ model و CLAUDE_CODE_AUTO_CONNECT_IDE بر autoConnectIde ارجح است. فیلدِ تنظیمات وقتی اعمال می‌شود که متغیرِ محیطی تنظیم نشده باشد.

اینکه یک متغیرِ محیطی چطور با پرچم‌های CLI و دستورهای درون‌نشست تعامل می‌کند به‌ازای هر قابلیت فرق می‌کند: --model و /model بر ANTHROPIC_MODEL ارجح‌اند، در حالی که CLAUDE_CODE_EFFORT_LEVEL بر /effort ارجح است. وقتی یک متغیر با منبعِ پیکربندیِ دیگری تعامل می‌کند، ردیفِ آن در فهرستِ متغیرها تقدم را بیان می‌کند یا به صفحه‌ای که آن را مستند کرده لینک می‌دهد.

Claude Code متغیرهای محیطی را هنگامِ شروع می‌خواند، پس تغییرات دفعه‌ی بعد که claude را اجرا می‌کنی اثر می‌کنند.

متغیرها

Section titled “متغیرها”
متغیرهدف
ANTHROPIC_API_KEYکلیدِ API که به‌صورت هدرِ X-Api-Key فرستاده می‌شود. وقتی تنظیم شود، این کلید به‌جای اشتراکِ Claude Pro، Max، Team یا Enterprise تو استفاده می‌شود، حتی اگر وارد شده باشی. در حالتِ غیرتعاملی (-p)، اگر کلید موجود باشد همیشه استفاده می‌شود. در حالتِ تعاملی، یک‌بار از تو خواسته می‌شود کلید را تأیید کنی پیش از آنکه بر اشتراکت ارجح شود. برای استفاده از اشتراکت به‌جایش، unset ANTHROPIC_API_KEY را اجرا کن
ANTHROPIC_AUTH_TOKENمقدارِ سفارشی برای هدرِ Authorization (مقداری که اینجا می‌گذاری با Bearer پیشوند می‌خورد)
ANTHROPIC_AWS_API_KEYکلیدِ API فضای‌کاری برای Claude Platform on AWS، تولیدشده در AWS Console. به‌صورت x-api-key فرستاده می‌شود و بر AWS SigV4 ارجح است
ANTHROPIC_AWS_BASE_URLبازنویسیِ URL endpoint برای Claude Platform on AWS. برای مناطقِ سفارشی یا هنگامِ مسیریابی از طریقِ یک LLM gateway استفاده کن. پیش‌فرض https://aws-external-anthropic.{AWS_REGION}.api.aws است
ANTHROPIC_AWS_WORKSPACE_IDبرای Claude Platform on AWS لازم است. روی هر درخواست به‌صورت هدرِ anthropic-workspace-id فرستاده می‌شود
ANTHROPIC_BASE_URLبازنویسیِ endpoint API برای مسیریابیِ درخواست‌ها از طریقِ یک پراکسی یا gateway. وقتی روی یک هاستِ غیرِ first-party تنظیم شود، MCP tool search به‌صورت پیش‌فرض غیرفعال می‌شود. اگر پراکسیت بلوک‌های tool_reference را forward می‌کند، ENABLE_TOOL_SEARCH=true را تنظیم کن
ANTHROPIC_BEDROCK_BASE_URLبازنویسیِ URL endpoint برای Bedrock. برای endpointهای سفارشیِ Bedrock یا هنگامِ مسیریابی از طریقِ یک LLM gateway استفاده کن. Amazon Bedrock را ببین
ANTHROPIC_BEDROCK_MANTLE_BASE_URLبازنویسیِ URL endpoint برای Bedrock Mantle. Mantle endpoint را ببین
ANTHROPIC_BEDROCK_SERVICE_TIERservice tier در Bedrock (default، flex یا priority). به‌صورت هدرِ X-Amzn-Bedrock-Service-Tier فرستاده می‌شود. Amazon Bedrock را ببین
ANTHROPIC_BETASفهرستِ کاما-جداشده از مقدارهای اضافیِ هدرِ anthropic-beta برای گنجاندن در درخواست‌های API. Claude Code هدرهای beta موردنیازش را از قبل می‌فرستد؛ از این برای فعال‌کردنِ یک بتای API Anthropic پیش از آنکه Claude Code پشتیبانیِ بومی اضافه کند استفاده کن. برخلافِ پرچمِ --betas که به احراز هویتِ کلیدِ API نیاز دارد، این متغیر با همه‌ی روش‌های احراز هویت از جمله اشتراکِ Claude.ai کار می‌کند
ANTHROPIC_CUSTOM_HEADERSهدرهای سفارشی برای افزودن به درخواست‌ها (قالبِ Name: Value، برای چند هدر با خطِ جدید جدا می‌شوند)
ANTHROPIC_CUSTOM_MODEL_OPTIONشناسه‌ی مدلی که به‌عنوان یک ورودیِ سفارشی به انتخابگرِ /model افزوده می‌شود. از این برای قابل‌انتخاب‌کردنِ یک مدلِ غیراستاندارد یا مخصوصِ gateway بدونِ جایگزینیِ نام‌های مستعارِ داخلی استفاده کن. پیکربندیِ مدل را ببین
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTIONتوضیحِ نمایشی برای ورودیِ مدلِ سفارشی در انتخابگرِ /model. وقتی تنظیم نشده باشد، پیش‌فرض Custom model (<model-id>) است
ANTHROPIC_CUSTOM_MODEL_OPTION_NAMEنامِ نمایشی برای ورودیِ مدلِ سفارشی در انتخابگرِ /model. وقتی تنظیم نشده باشد، پیش‌فرض شناسه‌ی مدل است
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIESپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_FABLE_MODELپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTIONپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_FABLE_MODEL_NAMEپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIESپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_HAIKU_MODELپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTIONپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAMEپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIESپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_OPUS_MODELپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTIONپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_OPUS_MODEL_NAMEپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIESپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_SONNET_MODELپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTIONپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_SONNET_MODEL_NAMEپیکربندیِ مدل را ببین
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIESپیکربندیِ مدل را ببین
ANTHROPIC_FOUNDRY_API_KEYکلیدِ API برای احراز هویتِ Microsoft Foundry (Microsoft Foundry را ببین)
ANTHROPIC_FOUNDRY_BASE_URLbase URL کاملِ منبعِ Foundry (مثلاً https://my-resource.services.ai.azure.com/anthropic). جایگزینِ ANTHROPIC_FOUNDRY_RESOURCE (Microsoft Foundry را ببین)
ANTHROPIC_FOUNDRY_RESOURCEنامِ منبعِ Foundry (مثلاً my-resource). اگر ANTHROPIC_FOUNDRY_BASE_URL تنظیم نشده باشد لازم است (Microsoft Foundry را ببین)
ANTHROPIC_MODELنامِ تنظیمِ مدل برای استفاده (پیکربندیِ مدل را ببین)
ANTHROPIC_SMALL_FAST_MODEL[منسوخ] نامِ مدلِ کلاسِ Haiku برای کارهای پس‌زمینه
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGIONبازنویسیِ منطقه‌ی AWS برای مدلِ کلاسِ Haiku هنگامِ استفاده از Bedrock یا Bedrock Mantle. روی Bedrock، این فقط وقتی اثر می‌کند که ANTHROPIC_DEFAULT_HAIKU_MODEL یا ANTHROPIC_SMALL_FAST_MODEL منسوخ هم تنظیم شده باشد، چون Bedrock وگرنه برای کارهای پس‌زمینه از مدلِ اصلی استفاده می‌کند
ANTHROPIC_VERTEX_BASE_URLبازنویسیِ URL endpoint برای Vertex AI. برای endpointهای سفارشیِ Vertex یا هنگامِ مسیریابی از طریقِ یک LLM gateway استفاده کن. Google Vertex AI را ببین
ANTHROPIC_VERTEX_PROJECT_IDشناسه‌ی پروژه‌ی GCP برای درخواست‌های Vertex AI. با GCLOUD_PROJECT، GOOGLE_CLOUD_PROJECT یا پروژه‌ی موجود در فایلِ اعتبارنامه‌ی GOOGLE_APPLICATION_CREDENTIALS تو بازنویسی می‌شود. Google Vertex AI را ببین
ANTHROPIC_WORKSPACE_IDشناسه‌ی فضای‌کاری برای workload identity federation. این را وقتی تنظیم کن که قاعده‌ی federation تو به بیش از یک فضای‌کاری محدود است تا تبادلِ توکن بداند کدام فضای‌کاری را هدف بگیرد
API_FORCE_IDLE_TIMEOUT{/* min-version: 2.1.169 */}بازنویسیِ مهلتِ بی‌کاریِ ۵-دقیقه‌ای که یک پاسخِ استریمیِ مدل را وقتی هیچ بایتی نمی‌رسد لغو می‌کند. روی 0 بگذار تا مهلت غیرفعال شود، مثلاً وقتی یک gateway کند یا مدلِ محلی بیش از ۵ دقیقه بینِ تکه‌ها مکث می‌کند. روی 1 بگذار تا مهلت روی هر ارائه‌دهنده‌ای فعال بماند. وقتی تنظیم نشده باشد، مهلت روی اتصال‌های مستقیمِ Anthropic API و Claude Platform on AWS غیرفعال است، جایی که نگهبانِ سطح-بایتِ خودِ Claude Code اجرا می‌شود، و روی هر ارائه‌دهنده‌ی دیگری فعال است، از جمله Vertex AI، Foundry، Mantle، Bedrock و اتصال‌های gateway، پس یک استریمِ متوقف‌شده به‌جای معلق‌ماندن لغو می‌شود. از نسخه‌ی v2.1.169
API_TIMEOUT_MSمهلت برای درخواست‌های API به میلی‌ثانیه (پیش‌فرض: 600000 یا ۱۰ دقیقه؛ بیشینه: 2147483647). وقتی درخواست‌ها روی شبکه‌های کند یا هنگامِ مسیریابی از طریقِ پراکسی تایم‌اوت می‌شوند این را افزایش بده. مقدارهای بالاتر از بیشینه، تایمرِ زیرین را سرریز می‌کنند و باعثِ شکستِ فوریِ درخواست‌ها می‌شوند
AWS_BEARER_TOKEN_BEDROCKکلیدِ API Bedrock برای احراز هویت (Bedrock API keys را ببین)
BASH_DEFAULT_TIMEOUT_MSمهلتِ پیش‌فرض برای دستورهای طولانی‌مدتِ bash (پیش‌فرض: 120000 یا ۲ دقیقه)
BASH_MAX_OUTPUT_LENGTHبیشینه‌ی تعدادِ کاراکترها در خروجی‌های bash پیش از آنکه خروجیِ کامل در یک فایل ذخیره شود و Claude مسیر به‌علاوه‌ی یک پیش‌نمایشِ کوتاه دریافت کند. رفتارِ ابزارِ Bash را ببین
BASH_MAX_TIMEOUT_MSبیشینه مهلتی که مدل می‌تواند برای دستورهای طولانی‌مدتِ bash تنظیم کند (پیش‌فرض: 600000 یا ۱۰ دقیقه)
CCR_FORCE_BUNDLEروی 1 بگذار تا claude --remote را مجبور کند مخزنِ محلی‌ات را bundle و آپلود کند حتی وقتی دسترسیِ GitHub موجود است
CLAUDECODEدر زیرفرآیندهایی که Claude Code می‌سازد روی 1 تنظیم می‌شود (ابزارهای Bash و PowerShell، نشست‌های tmux، دستورهای hook، دستورهای status line، زیرفرآیندهای stdio MCP server). افزونه‌های IDE هم این را در ترمینال‌های یکپارچه‌شان تنظیم می‌کنند. برای تشخیصِ اینکه یک اسکریپت داخلِ زیرفرآیندی که Claude Code ساخته اجرا می‌شود استفاده کن. برای بررسیِ اینکه آیا فرآیندِ فعلی مستقیماً با یک فراخوانیِ ابزار یا hook ساخته شده، نه داخلِ یک stdio MCP serverی که Claude Code شروع کرده، به‌جایش از CLAUDE_CODE_CHILD_SESSION استفاده کن
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTSروی 1 بگذار تا همه‌ی انواعِ ساب‌ایجنتِ داخلی مثلِ Explore و Plan غیرفعال شوند. فقط در حالتِ غیرتعاملی (پرچمِ -p) اعمال می‌شود. برای کاربرانِ SDK که صفحه‌ی خالی می‌خواهند مفید است
CLAUDE_AGENT_SDK_MCP_NO_PREFIXروی 1 بگذار تا پیشوندِ mcp__<server>__ روی نام‌های ابزار از MCP serverهای ساخته‌شده با SDK رد شود. ابزارها از نام‌های اصلی‌شان استفاده می‌کنند. فقط استفاده‌ی SDK
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MSمهلتِ توقف به میلی‌ثانیه برای ساب‌ایجنت‌های پس‌زمینه. پیش‌فرض 600000 (۱۰ دقیقه). تایمر روی هر رویدادِ پیشرفتِ استریمی ریست می‌شود؛ اگر در آن بازه هیچ پیشرفتی نرسد، ساب‌ایجنت لغو می‌شود و کار شکست‌خورده علامت می‌خورد و هر نتیجه‌ی جزئی به والد نمایان می‌شود
CLAUDE_AUTOCOMPACT_PCT_OVERRIDEدرصدِ (۱ تا ۱۰۰) پنجره‌ی auto-compaction که در آن auto-compaction فعال می‌شود را تنظیم کن. از مقدارهای پایین‌تر مثلِ 50 استفاده کن تا زودتر فشرده‌سازی شود. این متغیر فقط وقتی باعثِ فشرده‌سازیِ زودتر می‌شود که Claude Code فعالانه فشرده‌سازی کند: وقتی CLAUDE_CODE_AUTO_COMPACT_WINDOW تنظیم شده باشد، در نشست‌های ابری، در نشست‌های Remote Control و روی Sonnet 4.6 و Opus 4.6 بدونِ کانتکستِ گسترده، که به‌صورت پیش‌فرض روی مرزِ ۲۰۰K فشرده می‌شوند. در موارد دیگر، مثلِ یک نشستِ محلیِ پیش‌فرض، auto-compaction وقتی فعال می‌شود که مکالمه به حدِ کانتکستِ مدل برسد. این بازنویسی فقط می‌تواند آستانه را پایین بیاورد، پس مقدارهای بالاتر از پیش‌فرض اثری ندارند. هم بر مکالمه‌های اصلی و هم ساب‌ایجنت‌ها اعمال می‌شود
CLAUDE_AUTO_BACKGROUND_TASKSروی 1 بگذار تا پس‌زمینه‌کردنِ خودکارِ کارهای طولانی‌مدتِ agent به‌اجبار فعال شود. وقتی فعال باشد، ساب‌ایجنت‌ها پس از حدوداً دو دقیقه اجرا به پس‌زمینه منتقل می‌شوند
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIRپس از هر دستورِ Bash یا PowerShell در نشستِ اصلی به دایرکتوریِ کاریِ اصلی برگرد
CLAUDE_CODE_ACCESSIBILITYروی 1 بگذار تا مکان‌نمای بومیِ ترمینال نمایان بماند و نشانگرِ مکان‌نمای متنِ معکوس غیرفعال شود. به ذره‌بین‌های صفحه مثلِ Zoom در macOS اجازه می‌دهد مکانِ مکان‌نما را دنبال کنند
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MDروی 1 بگذار تا فایل‌های حافظه از دایرکتوری‌های مشخص‌شده با --add-dir بارگذاری شوند. CLAUDE.md، .claude/CLAUDE.md، .claude/rules/*.md و CLAUDE.local.md را بارگذاری می‌کند. به‌صورت پیش‌فرض، دایرکتوری‌های اضافی فایل‌های حافظه را بارگذاری نمی‌کنند
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINTروی 1 بگذار تا در رندرِ تمام‌صفحه کلِ صفحه روی هر فریم بازترسیم شود به‌جای فرستادنِ به‌روزرسانی‌های افزایشی. اگر حالتِ تمام‌صفحه قطعه‌های متنیِ کهنه یا جابه‌جا نشان می‌دهد از این استفاده کن. Claude Code این را به‌صورت خودکار برای نشست‌های پس‌زمینه و agent view روی Windows فعال می‌کند
CLAUDE_CODE_ALWAYS_ENABLE_EFFORTروی 1 بگذار تا پارامترِ effort با هر درخواست فرستاده شود، حتی وقتی Claude Code شناسه‌ی مدل را به‌عنوان دارای قابلیتِ effort نشناسد. این را وقتی استفاده کن که از طریقِ یک LLM gateway یا ارائه‌دهنده‌ی شخصِ ثالثی مسیریابی می‌کنی که مدل‌ها را با شناسه‌های سفارشی ارائه می‌دهد. مدل‌هایی که پارامترِ effort را در API رد می‌کنند، از جمله مدل‌های Claude 3، Sonnet 4.0 و 4.5، Opus 4.0 و 4.1 و Haiku 4.5، همچنان مستثنا می‌شوند تا درخواست‌ها شکست نخورند
CLAUDE_CODE_API_KEY_HELPER_TTL_MSبازه‌ای به میلی‌ثانیه که در آن اعتبارنامه‌ها باید تازه شوند (هنگامِ استفاده از apiKeyHelper)
CLAUDE_CODE_ATTRIBUTION_HEADERروی 0 بگذار تا بلوکِ attribution (نسخه‌ی کلاینت و اثرانگشتِ پرامپت) از ابتدای system prompt حذف شود. غیرفعال‌کردنش نرخِ اصابتِ کشِ پرامپت را هنگامِ مسیریابی از طریقِ یک LLM gateway بهبود می‌دهد. کشِ Anthropic API بی‌تأثیر می‌ماند
CLAUDE_CODE_AUTO_COMPACT_WINDOWظرفیتِ کانتکست به توکن که برای محاسباتِ auto-compaction استفاده می‌شود را تنظیم کن. پیش‌فرض پنجره‌ی کانتکستِ مدل است: ۲۰۰K برای مدل‌های استاندارد یا ۱M برای مدل‌های کانتکستِ گسترده. از یک مقدارِ پایین‌تر مثلِ 500000 روی یک مدلِ ۱M استفاده کن تا پنجره را برای منظورِ فشرده‌سازی ۵۰۰K تلقی کنی. مقدار به پنجره‌ی کانتکستِ واقعیِ مدل سقف می‌خورد. CLAUDE_AUTOCOMPACT_PCT_OVERRIDE به‌عنوان درصدی از این مقدار اعمال می‌شود. تنظیمِ این متغیر، آستانه‌ی فشرده‌سازی را از used_percentage در status line جدا می‌کند، که همیشه از پنجره‌ی کانتکستِ کاملِ مدل استفاده می‌کند
CLAUDE_CODE_AUTO_CONNECT_IDEبازنویسیِ اتصالِ خودکارِ IDE. به‌صورت پیش‌فرض، Claude Code وقتی داخلِ ترمینالِ یکپارچه‌ی یک IDE پشتیبانی‌شده اجرا شود به‌صورت خودکار متصل می‌شود. روی false بگذار تا جلویش گرفته شود. روی true بگذار تا وقتی تشخیصِ خودکار شکست می‌خورد، مثلاً وقتی tmux ترمینالِ والد را پنهان می‌کند، یک تلاشِ اتصال را اجبار کنی. بر تنظیمِ سراسریِ autoConnectIde ارجح است
CLAUDE_CODE_CERT_STOREفهرستِ کاما-جداشده از منابعِ گواهیِ CA برای اتصال‌های TLS. bundled مجموعه‌ی CA Mozilla است که با Claude Code عرضه می‌شود. system فروشگاهِ اعتمادِ سیستم‌عامل است. پیش‌فرض bundled,system است
CLAUDE_CODE_CHILD_SESSION{/* min-version: 2.1.172 */}در زیرفرآیندهایی که Claude Code از طریقِ ابزارهای Bash، PowerShell و Monitor، دستورهای hook و دستورهای status line می‌سازد روی 1 تنظیم می‌شود. برای زیرفرآیندهای stdio MCP server تنظیم نمی‌شود، که طولانی‌عمرند و از نشستی که آن‌ها را ساخته بیشتر دوام می‌آورند. برخلافِ CLAUDECODE، این فقط با مسیرِ ساختِ خودِ Claude Code تنظیم می‌شود و نه با افزونه‌های IDE، پس به‌طورِ قابل‌اتکا یک نشستِ تودرتو را از یک claude سطح‌بالا که در ترمینالِ یکپارچه‌ی IDE اجرا شده متمایز می‌کند. یک TUI تعاملیِ تودرتوی claude که این‌طور شروع شود به‌صورت خودکار از --resume، --continue، تاریخچه‌ی فلشِ بالا و فهرستِ claude agents مستثنا می‌شود. نشست‌های غیرتعاملیِ claude -p همچنان باقی می‌مانند. CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 را تنظیم کن تا این استثنا را بازنویسی کنی. به Claude Code نسخه‌ی v2.1.172 یا بالاتر نیاز دارد
CLAUDE_CODE_CLIENT_CERTمسیرِ فایلِ گواهیِ کلاینت برای احراز هویتِ mTLS
CLAUDE_CODE_CLIENT_KEYمسیرِ فایلِ کلیدِ خصوصیِ کلاینت برای احراز هویتِ mTLS
CLAUDE_CODE_CLIENT_KEY_PASSPHRASEعبارتِ عبور برای CLAUDE_CODE_CLIENT_KEY رمزگذاری‌شده (اختیاری)
CLAUDE_CODE_DEBUG_LOGS_DIRبازنویسیِ مسیرِ فایلِ لاگِ دیباگ. برخلافِ نام، این یک مسیرِ فایل است، نه دایرکتوری. نیاز دارد که حالتِ دیباگ جداگانه از طریقِ --debug، /debug یا متغیرِ محیطیِ DEBUG فعال شود: تنظیمِ تنهای این متغیر لاگ را فعال نمی‌کند. پرچمِ --debug-file هر دو را با هم انجام می‌دهد. پیش‌فرض ~/.claude/debug/<session-id>.txt است
CLAUDE_CODE_DEBUG_LOG_LEVELکمینه‌سطحِ لاگی که در فایلِ لاگِ دیباگ نوشته می‌شود. مقدارها: verbose، debug (پیش‌فرض)، info، warn، error. روی verbose بگذار تا diagnosticهای پرحجم مثلِ خروجیِ کاملِ دستورِ status line گنجانده شوند، یا به error ببر تا نویز کم شود
CLAUDE_CODE_DISABLE_1M_CONTEXTروی 1 بگذار تا پشتیبانیِ پنجره‌ی کانتکستِ ۱M غیرفعال شود. وقتی تنظیم شود، گونه‌های ۱Mِ مدل در انتخابگرِ مدل در دسترس نیستند. برای محیط‌های سازمانی با الزاماتِ انطباق مفید است
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKINGروی 1 بگذار تا استدلالِ تطبیقی روی Opus 4.6 و Sonnet 4.6 غیرفعال شود و به بودجه‌ی تفکرِ ثابتِ کنترل‌شده با MAX_THINKING_TOKENS برگردد. {/* min-version: 2.1.111 */}از نسخه‌ی v2.1.111، روی Fable 5، یا روی Opus 4.7 و بالاتر که همیشه از استدلالِ تطبیقی استفاده می‌کنند، اثری ندارد
CLAUDE_CODE_DISABLE_ADVISOR_TOOL{/* min-version: 2.1.98 */}روی 1 بگذار تا ابزارِ advisor غیرفعال شود. دستورِ /advisor و پرچمِ --advisor در دسترس نمی‌مانند و هر advisorModel پیکربندی‌شده نادیده گرفته می‌شود. به Claude Code نسخه‌ی v2.1.98 یا بالاتر نیاز دارد
CLAUDE_CODE_DISABLE_AGENT_VIEWروی 1 بگذار تا agentهای پس‌زمینه و agent view خاموش شوند: claude agents، --bg، /background و سرپرستِ on-demand. معادلِ تنظیمِ disableAgentView است
CLAUDE_CODE_DISABLE_ALTERNATE_SCREENروی 1 بگذار تا رندرِ تمام‌صفحه غیرفعال شود و از رندرِ کلاسیکِ صفحه‌اصلی استفاده شود. مکالمه در scrollback بومیِ ترمینالت می‌ماند پس Cmd+f و حالتِ copy در tmux مثلِ همیشه کار می‌کنند. بر CLAUDE_CODE_NO_FLICKER و تنظیمِ tui ارجح است. با /tui default هم می‌توانی سوییچ کنی. روی نشست‌های پس‌زمینه‌ای که از agent view باز می‌شوند اعمال نمی‌شود، که همیشه از رندرِ تمام‌صفحه استفاده می‌کنند
CLAUDE_CODE_DISABLE_ATTACHMENTSروی 1 بگذار تا پردازشِ پیوست غیرفعال شود. اشاره‌های فایلی با نحوِ @ به‌جای بسط به محتوای فایل، به‌صورت متنِ ساده فرستاده می‌شوند
CLAUDE_CODE_DISABLE_AUTO_MEMORYروی 1 بگذار تا auto memory غیرفعال شود. روی 0 بگذار تا auto memory به‌اجبار روشن شود حتی وقتی حالتِ --bare یا autoMemoryEnabled: false وگرنه آن را غیرفعال می‌کرد. وقتی غیرفعال باشد، Claude فایل‌های auto memory نمی‌سازد و بارگذاری نمی‌کند
CLAUDE_CODE_DISABLE_BACKGROUND_TASKSروی 1 بگذار تا همه‌ی عملکردِ کارِ پس‌زمینه غیرفعال شود، از جمله پارامترِ run_in_background روی ابزارهای Bash و subagent، پس‌زمینه‌کردنِ خودکار و میان‌برِ Ctrl+B
CLAUDE_CODE_DISABLE_BUNDLED_SKILLSروی 1 بگذار تا skillها و ورک‌فلوهایی که با Claude Code عرضه می‌شوند غیرفعال شوند: skillها و ورک‌فلوهای bundled به‌کلی حذف می‌شوند، در حالی که دستورهای اسلشِ داخلی مثلِ /init قابل‌تایپ می‌مانند اما از مدل پنهان می‌شوند. skillهای plugin، .claude/skills/ و .claude/commands/ بی‌تأثیرند. معادلِ تنظیمِ disableBundledSkills است؛ 0 آن را بازنویسی نمی‌کند
CLAUDE_CODE_DISABLE_CLAUDE_MDSروی 1 بگذار تا از بارگذاریِ هر فایلِ حافظه‌ی CLAUDE.md در کانتکست جلوگیری شود، از جمله فایل‌های کاربر، پروژه و auto-memory
CLAUDE_CODE_DISABLE_CRONروی 1 بگذار تا کارهای زمان‌بندی‌شده غیرفعال شوند. skillِ /loop و ابزارهای cron در دسترس نمی‌مانند و هر کارِ از پیش زمان‌بندی‌شده دیگر اجرا نمی‌شود، از جمله کارهایی که همین حالا وسطِ نشست در حالِ اجرا هستند
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASروی 1 بگذار تا هدرهای درخواستِ مخصوصِ Anthropic با نامِ anthropic-beta و فیلدهای schema-ابزارِ beta (مثلِ defer_loading و eager_input_streaming) از درخواست‌های API حذف شوند. این را وقتی استفاده کن که یک gateway پراکسی درخواست‌ها را با خطاهایی مثلِ «Unexpected value(s) for the anthropic-beta header» یا «Extra inputs are not permitted» رد می‌کند. فیلدهای استاندارد (name، description، input_schema، cache_control) حفظ می‌شوند.
CLAUDE_CODE_DISABLE_FAST_MODEروی 1 بگذار تا fast mode غیرفعال شود
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEYروی 1 بگذار تا نظرسنجی‌های کیفیتِ نشستِ «How is Claude doing?» غیرفعال شوند. نظرسنجی‌ها همچنین وقتی DISABLE_TELEMETRY، DO_NOT_TRACK یا CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC تنظیم شود غیرفعال می‌شوند، مگر اینکه CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL دوباره آن را روشن کند. برای تنظیمِ یک نرخِ نمونه‌گیری به‌جای غیرفعال‌کردنِ کامل، از تنظیمِ feedbackSurveyRate استفاده کن. نظرسنجی‌های کیفیتِ نشست را ببین
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTINGروی 1 بگذار تا checkpointing فایل غیرفعال شود. دستورِ /rewind نمی‌تواند تغییراتِ کد را بازگرداند
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONSروی 1 بگذار تا دستورالعمل‌های داخلیِ ورک‌فلوِ commit و PR و عکسِ فوریِ git status از system prompt در Claude حذف شوند. وقتی از skillهای ورک‌فلوِ git خودت استفاده می‌کنی مفید است. وقتی تنظیم شود بر تنظیمِ includeGitInstructions ارجح است
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAPروی 1 بگذار تا از remap خودکارِ Opus 4.0 و 4.1 به نسخه‌ی فعلیِ Opus در Anthropic API جلوگیری شود. وقتی عمداً می‌خواهی یک مدلِ قدیمی‌تر را پین کنی استفاده کن. remap روی Bedrock، Vertex یا Foundry اجرا نمی‌شود
CLAUDE_CODE_DISABLE_MOUSEروی 1 بگذار تا ردیابیِ موس در رندرِ تمام‌صفحه غیرفعال شود. اسکرولِ صفحه‌کلید با PgUp و PgDn همچنان کار می‌کند. از این برای حفظِ رفتارِ بومیِ copy-on-select ترمینالت استفاده کن
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICمعادلِ تنظیمِ DISABLE_AUTOUPDATER، DISABLE_FEEDBACK_COMMAND، DISABLE_ERROR_REPORTING و DISABLE_TELEMETRY
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACKروی 1 بگذار تا fallbackِ غیرِ استریمی وقتی یک درخواستِ استریمی وسطِ استریم شکست می‌خورد غیرفعال شود. خطاهای استریمی به‌جایش به لایه‌ی retry منتشر می‌شوند. وقتی یک پراکسی یا gateway باعث می‌شود fallback اجرای تکراریِ ابزار تولید کند مفید است
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALLروی 1 بگذار تا افزودنِ خودکارِ مارکت‌پلیسِ رسمیِ plugin در اولین اجرا رد شود
CLAUDE_CODE_DISABLE_POLICY_SKILLSروی 1 بگذار تا بارگذاریِ skillها از دایرکتوریِ skillهای مدیریت‌شده‌ی سراسریِ سیستم رد شود. برای نشست‌های کانتینر یا CI که نباید skillهای فراهم‌شده توسطِ اپراتور را بارگذاری کنند مفید است
CLAUDE_CODE_DISABLE_TERMINAL_TITLEروی 1 بگذار تا به‌روزرسانی‌های خودکارِ عنوانِ ترمینال بر اساسِ کانتکستِ مکالمه غیرفعال شوند. در نشست‌های Agent SDK و claude -p، این درخواستِ پس‌زمینه‌ی Haiku که عنوانِ نشست را تولید می‌کند را هم رد می‌کند
CLAUDE_CODE_DISABLE_THINKINGروی 1 بگذار تا پارامترِ thinking به‌کلی از درخواست‌های API حذف شود. این یک گزینه‌ی سازگاری برای پراکسی‌ها و gatewayهایی است که پارامتر را رد می‌کنند. رفتارِ این متغیر نسبت به نسخه‌های قبل تغییری نکرده؛ روی مدل‌هایی که به‌صورت پیش‌فرض فکر می‌کنند، حذفِ پارامتر یعنی مدل ممکن است همچنان فکر کند. برای غیرفعال‌کردنِ صریحِ extended thinking در Anthropic API، به‌جایش از MAX_THINKING_TOKENS=0 استفاده کن، که روی Fable 5 هم بی‌اثر است چون تفکرش را نمی‌توان خاموش کرد. روی ارائه‌دهنده‌های شخصِ ثالث، 0 هم به‌همین‌ترتیب پارامتر را حذف می‌کند، پس دو متغیر آنجا یکسان رفتار می‌کنند
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLLروی 1 بگذار تا اسکرولِ مجازی در رندرِ تمام‌صفحه غیرفعال شود و هر پیامِ رونوشت رندر شود. اگر اسکرول در حالتِ تمام‌صفحه نواحیِ خالی نشان می‌دهد که پیام‌ها باید آنجا ظاهر شوند از این استفاده کن
CLAUDE_CODE_DISABLE_WORKFLOWSروی 1 بگذار تا ورک‌فلوها غیرفعال شوند. معادلِ تنظیمِ disableWorkflows است
CLAUDE_CODE_EFFORT_LEVELسطحِ effort را برای مدل‌های پشتیبانی‌شده تنظیم کن. مقدارها: low، medium، high، xhigh، max، یا auto برای استفاده از پیش‌فرضِ مدل. سطح‌های موجود به مدل بستگی دارند. بر /effort و تنظیمِ effortLevel ارجح است. تنظیمِ سطحِ effort را ببین
CLAUDE_CODE_ENABLE_AUTO_MODE{/* min-version: 2.1.158 */}روی 1 بگذار تا auto mode روی Amazon Bedrock، Google Cloud Vertex AI و Microsoft Foundry در دسترس شود. به Claude Code نسخه‌ی v2.1.158 یا بالاتر نیاز دارد. روی Anthropic API که auto mode به‌صورت پیش‌فرض در دسترس است اثری ندارد. فعال‌کردنِ auto mode روی Bedrock، Vertex AI یا Foundry را ببین
CLAUDE_CODE_ENABLE_AWAY_SUMMARYبازنویسیِ در دسترس‌بودنِ خلاصه‌ی نشست. روی 0 بگذار تا خلاصه‌ها صرف‌نظر از کلیدِ /config به‌اجبار خاموش شوند. روی 1 بگذار تا خلاصه‌ها وقتی awaySummaryEnabled برابرِ false است به‌اجبار روشن شوند. بر تنظیم و کلیدِ /config ارجح است
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESHروی 1 بگذار تا وضعیتِ plugin در مرزهای نوبت در حالتِ غیرتعاملی پس از اتمامِ نصبِ پس‌زمینه تازه شود. به‌صورت پیش‌فرض خاموش است چون این تازه‌سازی system prompt را وسطِ نشست تغییر می‌دهد، که کشِ پرامپت را برای آن نوبت بی‌اعتبار می‌کند
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTELروی 1 بگذار تا نظرسنجیِ کیفیتِ نشستِ «How is Claude doing?» به جمع‌آورِ OpenTelemetry خودت مسیریابی شود وقتی ترافیکِ غیرضروریِ مقصدِ Anthropic مسدود است. امتیازهای نظرسنجی فقط به‌صورت رویدادهای OTEL به جمع‌آورِ پیکربندی‌شده‌ات منتشر می‌شوند. در این حالت هیچ داده‌ی نظرسنجی به Anthropic فرستاده نمی‌شود. وقتی CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC، DISABLE_TELEMETRY یا DO_NOT_TRACK تنظیم شود اعمال می‌شود، و وگرنه اثری ندارد. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY و سیاستِ بازخوردِ محصولِ سازمان ارجح‌اند
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMINGکنترل می‌کند که آیا ورودی‌های فراخوانیِ ابزار همان‌طور که Claude تولیدشان می‌کند از API استریم شوند. با خاموش‌بودنِ این، یک ورودیِ بزرگِ ابزار مثلِ نوشتنِ یک فایلِ بلند تنها پس از اتمامِ تولیدِ Claude می‌رسد، که می‌تواند مثلِ معلق‌ماندن به نظر برسد. روی Anthropic API به‌صورت پیش‌فرض فعال است. روی Bedrock و Vertex، به‌ازای هر مدلی که کانتینرِ مستقرشده پشتیبانی کند فعال است. روی 0 بگذار تا انصراف بدهی. روی 1 بگذار تا هنگامِ مسیریابی از طریقِ یک پراکسی با ANTHROPIC_BASE_URL، ANTHROPIC_VERTEX_BASE_URL یا ANTHROPIC_BEDROCK_BASE_URL به‌اجبار روشن شود. روی Foundry و اتصال‌های gateway به‌صورت پیش‌فرض خاموش است
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERYروی 1 بگذار تا انتخابگرِ /model از endpoint /v1/models گیت‌وی‌ات پر شود وقتی ANTHROPIC_BASE_URL به یک gateway سازگار با Anthropic مثلِ LiteLLM، Kong یا یک پراکسیِ داخلی اشاره می‌کند. به‌صورت پیش‌فرض خاموش است چون gatewayهای پشتیبانی‌شده با یک کلیدِ API مشترک وگرنه به هر کاربر هر مدلی را که کلید به آن دسترسی دارد نشان می‌دادند. مدل‌های کشف‌شده همچنان با فهرستِ مجازِ availableModels فیلتر می‌شوند
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE{/* max-version: 2.1.141 */}در v2.1.142 حذف شد، وقتی پیش‌فرضِ fast mode از Opus 4.6 به Opus 4.7 منتقل شد
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONروی false بگذار تا پیشنهادهای پرامپت (کلیدِ «Prompt suggestions» در /config) غیرفعال شوند. این‌ها همان پیش‌بینی‌های خاکستریِ کم‌رنگ هستند که پس از پاسخِ Claude در ورودیِ پرامپتت ظاهر می‌شوند. پیشنهادهای پرامپت را ببین
CLAUDE_CODE_ENABLE_TASKSکنترل می‌کند که آیا نشست‌ها از ابزارهای ساختاریافته‌ی Task (TaskCreate، TaskUpdate، TaskGet، TaskList) یا ابزارِ قدیمیِ TodoWrite استفاده کنند. {/* min-version: 2.1.142 */}از Claude Code نسخه‌ی v2.1.142، ابزارهای Task پیش‌فرض در همه‌ی حالت‌ها هستند. روی 0 بگذار تا به TodoWrite برگردی. فهرستِ Task و مهاجرت به ابزارهای Task را ببین
CLAUDE_CODE_ENABLE_TELEMETRYروی 1 بگذار تا جمع‌آوریِ داده‌ی OpenTelemetry برای متریک‌ها و لاگ فعال شود. پیش از پیکربندیِ exporterهای OTel لازم است. پایش را ببین
CLAUDE_CODE_EXIT_AFTER_STOP_DELAYزمان به میلی‌ثانیه برای انتظار پس از بی‌کار شدنِ حلقه‌ی query پیش از خروجِ خودکار. برای ورک‌فلوها و اسکریپت‌های خودکار که از حالتِ SDK استفاده می‌کنند مفید است
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSروی 1 بگذار تا agent teams فعال شود. agent teams آزمایشی است و به‌صورت پیش‌فرض غیرفعال است
CLAUDE_CODE_EXTRA_BODYشیء JSON برای ادغام در سطحِ بالای بدنه‌ی هر درخواستِ API. برای پاس‌دادنِ پارامترهای مخصوصِ ارائه‌دهنده که Claude Code مستقیم نمایان نمی‌کند مفید است
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENSبازنویسیِ حدِ توکنِ پیش‌فرض برای خواندنِ فایل. وقتی نیاز داری فایل‌های بزرگ‌تری را به‌صورت کامل بخوانی مفید است
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE{/* min-version: 2.1.172 */}روی 1 بگذار تا ماندگاریِ رونوشت، تاریخچه‌ی پرامپت و ثبتِ claude agents به‌اجبار انجام شوند حتی وقتی این claude از داخلِ یک نشستِ Claude Code دیگر اجرا شده. وقتی استفاده کن که یک مقدارِ به‌ارث‌رسیده‌ی CLAUDE_CODE_CHILD_SESSION، مثلاً از یک سرورِ tmux که اول با ابزارِ Bash در Claude Code شروع شده، باعث می‌شود یک نشستِ سطح‌بالای واقعی اشتباهاً تودرتو دسته‌بندی شود. روی v2.1.169 و قبل‌تر هم رعایت می‌شود؛ روی v2.1.170 و v2.1.171 اثری ندارد، که در آن‌ها تشخیصِ نشستِ تودرتویی که این بازنویسی‌اش می‌کند حذف شد
CLAUDE_CODE_FORCE_SYNC_OUTPUTروی 1 بگذار تا حالتِ خصوصیِ DEC شماره‌ی 2026 یعنی خروجیِ همگام‌شده به‌اجبار فعال شود وقتی ترمینالت پشتیبانی می‌کند اما تشخیصِ خودکار نمی‌شود. برای شبیه‌سازهایی مثلِ eat در Emacs که BSU/ESU را پیاده می‌کنند اما به probe قابلیت پاسخ نمی‌دهند مفید است. زیرِ tmux اثری ندارد
CLAUDE_CODE_FORK_SUBAGENTروی 1 بگذار تا ساب‌ایجنت‌های fork‌شده پیش‌فرضِ مدل شوند، یا 0 تا غیرفعالشان کنی، با بازنویسیِ هر rollout سمتِ سرور. وقتی فعال باشد، Claude یک fork می‌سازد — ساب‌ایجنتی که به‌جای شروعِ تازه، کلِ کانتکستِ مکالمه را به ارث می‌برد — هرگاه وگرنه از ساب‌ایجنتِ همه‌منظوره استفاده می‌کرد، و همه‌ی ساختِ ساب‌ایجنت‌ها در پس‌زمینه اجرا می‌شوند. دستورِ صریحِ /fork بدونِ این متغیر کار می‌کند. در حالتِ تعاملی و از طریقِ SDK یا claude -p کار می‌کند
CLAUDE_CODE_GIT_BASH_PATHفقط Windows: مسیرِ فایلِ اجراییِ Git Bash (bash.exe). وقتی Git Bash نصب است اما در PATH تو نیست استفاده کن. راه‌اندازی Windows را ببین
CLAUDE_CODE_GLOB_HIDDENروی false بگذار تا dotfileها وقتی Claude ابزارِ Glob را فراخوانی می‌کند از نتایج حذف شوند. به‌صورت پیش‌فرض گنجانده می‌شوند. بر autocomplete فایلِ @، ls، Grep یا Read اثری ندارد
CLAUDE_CODE_GLOB_NO_IGNOREروی false بگذار تا ابزارِ Glob الگوهای .gitignore را رعایت کند. به‌صورت پیش‌فرض، Glob همه‌ی فایل‌های منطبق را برمی‌گرداند از جمله فایل‌های gitignore‌شده. بر autocomplete فایلِ @ اثری ندارد، که تنظیمِ respectGitignore خودش را دارد
CLAUDE_CODE_GLOB_TIMEOUT_SECONDSمهلت به ثانیه برای کشفِ فایل با ابزارِ Glob. به‌صورت پیش‌فرض ۲۰ ثانیه روی بیشترِ پلتفرم‌ها و ۶۰ ثانیه روی WSL است
CLAUDE_CODE_HIDE_CWDروی 1 بگذار تا دایرکتوریِ کاری در لوگوی شروع پنهان شود. برای اشتراکِ صفحه یا ضبط که مسیر نامِ کاربریِ OS تو را افشا می‌کند مفید است
CLAUDE_CODE_IDE_HOST_OVERRIDEبازنویسیِ آدرسِ هاستی که برای اتصال به افزونه‌ی IDE استفاده می‌شود. به‌صورت پیش‌فرض Claude Code آدرسِ درست را به‌صورت خودکار تشخیص می‌دهد، از جمله مسیریابیِ WSL-به-Windows
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALLاز نصبِ خودکارِ افزونه‌های IDE رد شو. معادلِ تنظیمِ autoInstallIdeExtension روی false است
CLAUDE_CODE_IDE_SKIP_VALID_CHECKروی 1 بگذار تا اعتبارسنجیِ ورودی‌های lockfile در IDE هنگامِ اتصال رد شود. وقتی اتصالِ خودکار با وجودِ اجرای IDE آن را پیدا نمی‌کند استفاده کن
CLAUDE_CODE_MAX_CONTEXT_TOKENSبازنویسیِ اندازه‌ی پنجره‌ی کانتکستی که Claude Code برای مدلِ فعال فرض می‌کند. فقط وقتی اثر می‌کند که DISABLE_COMPACT هم تنظیم شده باشد. این را وقتی استفاده کن که به مدلی از طریقِ ANTHROPIC_BASE_URL مسیریابی می‌کنی که پنجره‌ی کانتکستش با اندازه‌ی داخلیِ نامش نمی‌خواند
CLAUDE_CODE_MAX_OUTPUT_TOKENSبیشینه‌ی تعدادِ توکن‌های خروجی برای بیشترِ درخواست‌ها را تنظیم کن. پیش‌فرض‌ها و سقف‌ها بسته به مدل فرق می‌کنند؛ بیشینه توکن‌های خروجی را ببین. افزایشِ این مقدار، پنجره‌ی کانتکستِ مؤثرِ موجود را پیش از فعال‌شدنِ auto-compaction کاهش می‌دهد.
CLAUDE_CODE_MAX_RETRIESبازنویسیِ تعدادِ دفعاتِ retry برای درخواست‌های ناموفقِ API (پیش‌فرض: 10)
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCYبیشینه‌ی تعدادِ ابزارهای فقط‌خواندنی و ساب‌ایجنت‌هایی که می‌توانند موازی اجرا شوند (پیش‌فرض: 10). مقدارهای بالاتر موازی‌سازی را افزایش می‌دهند اما منابعِ بیشتری مصرف می‌کنند
CLAUDE_CODE_MAX_TURNSتعدادِ نوبت‌های ایجنتیک را وقتی هیچ حدِ صریحی پاس داده نشده محدود کن. معادلِ پاس‌دادنِ --max-turns است، که وقتی هردو تنظیم شوند ارجح است. مقداری که عددِ صحیحِ مثبت نباشد هنگامِ شروع با خطا رد می‌شود به‌جای آنکه به‌عنوان بی‌حد تلقی شود
CLAUDE_CODE_MCP_ALLOWLIST_ENVروی 1 بگذار تا stdio MCP serverها با تنها یک محیطِ پایه‌ی ایمن به‌علاوه‌ی env پیکربندی‌شده‌ی server ساخته شوند، به‌جای ارث‌بردنِ محیطِ شلت
CLAUDE_CODE_NATIVE_CURSORروی 1 بگذار تا مکان‌نمای خودِ ترمینال روی محلِ ورودی نشان داده شود به‌جای یک بلوکِ ترسیم‌شده. مکان‌نما به تنظیماتِ چشمک، شکل و فوکوسِ ترمینال احترام می‌گذارد
CLAUDE_CODE_NEW_INITروی 1 بگذار تا /init یک جریانِ راه‌اندازیِ تعاملی اجرا کند. این جریان می‌پرسد کدام فایل‌ها تولید شوند، از جمله CLAUDE.md، skillها و hookها، پیش از کاوشِ کدبیس و نوشتنشان. بدونِ این متغیر، /init یک CLAUDE.md را به‌صورت خودکار بدونِ پرسش تولید می‌کند.
CLAUDE_CODE_NO_FLICKERروی 1 بگذار تا رندرِ تمام‌صفحه فعال شود، یک پیش‌نمایشِ پژوهشی که سوسوزدن را کم می‌کند و حافظه را در مکالمه‌های طولانی هموار نگه می‌دارد. معادلِ تنظیمِ tui است؛ با /tui fullscreen هم می‌توانی سوییچ کنی
CLAUDE_CODE_OAUTH_REFRESH_TOKENتوکنِ refresh OAuth برای احراز هویتِ Claude.ai. وقتی تنظیم شود، claude auth login این توکن را مستقیم تبادل می‌کند به‌جای بازکردنِ مرورگر. به CLAUDE_CODE_OAUTH_SCOPES نیاز دارد. برای تأمینِ احراز هویت در محیط‌های خودکار مفید است
CLAUDE_CODE_OAUTH_SCOPESscopeهای OAuth فاصله-جداشده که توکنِ refresh با آن‌ها صادر شده، مثلِ "user:profile user:inference user:sessions:claude_code". وقتی CLAUDE_CODE_OAUTH_REFRESH_TOKEN تنظیم شده باشد لازم است
CLAUDE_CODE_OAUTH_TOKENتوکنِ دسترسیِ OAuth برای احراز هویتِ Claude.ai. جایگزینِ /login برای SDK و محیط‌های خودکار. بر اعتبارنامه‌های ذخیره‌شده در keychain ارجح است. یکی را با claude setup-token تولید کن
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE{/* max-version: 2.1.159 */}در v2.1.160 حذف شد و حالا بی‌اثر است. پیش‌تر fast mode را به‌جای پیش‌فرضِ فعلی به Claude Opus 4.6 پین می‌کرد. برای اجرای fast mode روی Opus 4.6 تا زمانِ بازنشستگی‌اش، اول مدل را با /model انتخاب کن، سپس /fast on
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MSمهلت به میلی‌ثانیه برای flush کردنِ spanهای معلقِ OpenTelemetry (پیش‌فرض: 5000). پایش را ببین
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MSبازه برای تازه‌کردنِ هدرهای پویای OpenTelemetry به میلی‌ثانیه (پیش‌فرض: 1740000 / ۲۹ دقیقه). هدرهای پویا را ببین
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MSمهلت به میلی‌ثانیه برای اتمامِ کارِ exporter OpenTelemetry هنگامِ خاموش‌شدن (پیش‌فرض: 2000). اگر متریک‌ها هنگامِ خروج افتاده می‌شوند افزایش بده. پایش را ببین
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEروی 1 بگذار تا به Claude Code اجازه دهی دستورِ upgrade مدیرِ پکیجت را در پس‌زمینه اجرا کند وقتی نسخه‌ی جدیدی در دسترس است. روی نصب‌های Homebrew و WinGet اعمال می‌شود. سایر مدیرهای پکیج همچنان دستورِ upgrade را بدونِ اجرا نشان می‌دهند. به‌روزرسانی‌های خودکار را ببین
CLAUDE_CODE_PERFORCE_MODEروی 1 بگذار تا محافظتِ نوشتنِ آگاه از Perforce فعال شود. وقتی تنظیم شود، Edit، Write و NotebookEdit با یک راهنماییِ p4 edit <file> شکست می‌خورند اگر فایلِ هدف بیتِ نوشتنِ مالک را نداشته باشد، که Perforce روی فایل‌های sync‌شده پاکش می‌کند تا p4 edit بازشان کند. این جلوی دور زدنِ ردیابیِ تغییرِ Perforce توسطِ Claude Code را می‌گیرد
CLAUDE_CODE_PLUGIN_CACHE_DIRبازنویسیِ دایرکتوریِ ریشه‌ی pluginها. برخلافِ نام، این دایرکتوریِ والد را تنظیم می‌کند، نه خودِ کش را: مارکت‌پلیس‌ها و کشِ plugin در زیردایرکتوری‌هایی زیرِ این مسیر قرار می‌گیرند. پیش‌فرض ~/.claude/plugins است
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MSمهلت به میلی‌ثانیه برای عملیاتِ git هنگامِ نصب یا به‌روزرسانیِ pluginها (پیش‌فرض: 120000). این مقدار را برای مخزن‌های بزرگ یا اتصال‌های شبکه‌ی کند افزایش بده. تایم‌اوتِ عملیاتِ git را ببین
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILUREروی 1 بگذار تا کشِ مارکت‌پلیسِ موجود را وقتی یک git pull شکست می‌خورد نگه داری به‌جای پاک‌کردن و کلونِ دوباره. در محیط‌های آفلاین یا airgapped که کلونِ دوباره به‌همان‌شکل شکست می‌خورد مفید است. شکستِ به‌روزرسانیِ مارکت‌پلیس در محیط‌های آفلاین را ببین
CLAUDE_CODE_PLUGIN_PREFER_HTTPSروی 1 بگذار تا منابعِ کوتاه‌نوشتِ owner/repo در GitHub به‌جای SSH از طریقِ HTTPS کلون شوند. روی نصب و به‌روزرسانیِ plugin و روی /plugin marketplace add و update اعمال می‌شود. در CI runnerها، کانتینرها یا هر محیطی بدونِ کلیدِ SSH پیکربندی‌شده برای github.com مفید است
CLAUDE_CODE_PLUGIN_SEED_DIRمسیر به یک یا چند دایرکتوریِ seed فقط‌خواندنیِ plugin، جداشده با : در Unix یا ; در Windows. از این برای بسته‌بندیِ یک دایرکتوریِ از پیش پرشده‌ی plugin در یک ایمیجِ کانتینر استفاده کن. Claude Code مارکت‌پلیس‌ها را از این دایرکتوری‌ها هنگامِ شروع ثبت می‌کند و از pluginهای از پیش کش‌شده بدونِ کلونِ دوباره استفاده می‌کند. از پیش پرکردنِ pluginها برای کانتینرها را ببین
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICYروی 1 بگذار تا Claude Code هنگامِ ساختِ PowerShell برای فراخوانی‌های ابزار، hookها و دستورهای status line -ExecutionPolicy Bypass را پاس ندهد و به‌جایش به سیاستِ اجرایِ مؤثرِ ماشین احترام بگذارد. به‌صورت پیش‌فرض Claude Code سیاستِ اجرا را در دامنه‌ی فرآیند دور می‌زند تا اسکریپت‌های .ps1 و importهای ماژول روی نصب‌های پیش‌فرض-Restricted Windows کار کنند. دور زدنِ دامنه‌ی فرآیند صرف‌نظر از این تنظیم هیچ‌وقت بر Group Policy MachinePolicy یا UserPolicy غلبه نمی‌کند
CLAUDE_CODE_PROPAGATE_TRACEPARENT{/* min-version: 2.1.152 */}روی 1 بگذار تا کانتکستِ trace استانداردِ W3C وقتی ANTHROPIC_BASE_URL به یک پراکسیِ سفارشی اشاره می‌کند انتشار یابد. انتشار شاملِ هدرِ traceparent روی درخواست‌های مدل و HTTP MCP و متغیرِ محیطیِ TRACEPARENT برای زیرفرآیندهای Bash، PowerShell و hook است. به‌صورت پیش‌فرض، انتشار فقط وقتی فعال است که مستقیم به Anthropic API متصل باشی. در v2.1.152 افزوده شد. Traces (beta) را ببین
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOSTتوسطِ پلتفرم‌های میزبانی که Claude Code را تعبیه می‌کنند و مسیریابیِ ارائه‌دهنده‌ی مدل را از طرفش مدیریت می‌کنند تنظیم می‌شود. وقتی تنظیم شود، متغیرهای انتخابِ ارائه‌دهنده، endpoint و احراز هویت مثلِ CLAUDE_CODE_USE_BEDROCK، ANTHROPIC_BASE_URL و ANTHROPIC_API_KEY در فایل‌های تنظیمات نادیده گرفته می‌شوند تا تنظیماتِ کاربر نتواند مسیریابیِ میزبان را بازنویسی کند. انصرافِ خودکارِ تله‌متری برای Bedrock، Vertex و Foundry هم رد می‌شود، پس تله‌متری از انصرافِ استانداردِ DISABLE_TELEMETRY پیروی می‌کند. رفتارهای پیش‌فرض به‌ازای ارائه‌دهنده‌ی API را ببین
CLAUDE_CODE_PROXY_RESOLVES_HOSTSروی 1 بگذار تا اجازه دهی پراکسی به‌جای فراخواننده DNS را resolve کند. انتخابی برای محیط‌هایی که پراکسی باید resolve نام میزبان را مدیریت کند
CLAUDE_CODE_REMOTEوقتی Claude Code به‌عنوان یک نشستِ ابری اجرا می‌شود به‌صورت خودکار روی true تنظیم می‌شود. این را از یک hook یا اسکریپتِ راه‌اندازی بخوان تا تشخیص دهی آیا در یک محیطِ ابری هستی
CLAUDE_CODE_REMOTE_SESSION_IDدر نشست‌های ابری به‌صورت خودکار روی شناسه‌ی نشستِ فعلی تنظیم می‌شود. این را بخوان تا یک لینکِ بازگشت به رونوشتِ نشست بسازی. لینک‌کردنِ آرتیفکت‌ها به نشست را ببین
CLAUDE_CODE_RESUME_INTERRUPTED_TURNروی 1 بگذار تا اگر نشستِ قبلی وسطِ نوبت تمام شد به‌صورت خودکار ازسرگرفته شود. در حالتِ SDK استفاده می‌شود تا مدل بدونِ نیاز به ارسالِ دوباره‌ی پرامپت توسطِ SDK ادامه دهد
CLAUDE_CODE_RESUME_PROMPTبازنویسیِ پیامِ ادامه که هنگامِ ازسرگیریِ نشستی که وسطِ نوبت تمام شده تزریق می‌شود. پیش‌فرض Continue from where you left off. است. اسکریپت‌های ساختِ agentهای طولانی‌مدت می‌توانند این را روی یک پیامِ شروعِ هدایت‌کننده‌تر بگذارند. یک رشته‌ی خالی از پیش‌فرض استفاده می‌کند
CLAUDE_CODE_SAFE_MODEروی 1 بگذار تا در حالتِ امن شروع شود: CLAUDE.md، skillها، pluginها، hookها، MCP serverها، دستورها و agentهای سفارشی، سبک‌های خروجی، ورک‌فلوها، تم‌های سفارشی، keybindingهای سفارشی، دستورهای status line و file-suggestion، LSP serverها و auto-memory بارگذاری نمی‌شوند، برای عیب‌یابیِ یک پیکربندیِ خراب. سیاستِ تنظیماتِ مدیریت‌شده همچنان اعمال می‌شود، از جمله hookها، status line و دستورهای file-suggestion پیکربندی‌شده با سیاست؛ pluginهای مدیریت‌شده، skillهای مدیریت‌شده، CLAUDE.md مدیریت‌شده و MCP serverهای پیکربندی‌شده با سیاست اعمال نمی‌شوند. معادلِ پاس‌دادنِ --safe-mode است. فرآیندهای فرزندِ مستقیماً ساخته‌شده این متغیر را به ارث می‌برند
CLAUDE_CODE_SCRIPT_CAPSشیء JSON که محدود می‌کند اسکریپت‌های مشخص هر نشست چند بار می‌توانند فراخوانی شوند وقتی CLAUDE_CODE_SUBPROCESS_ENV_SCRUB تنظیم شده باشد. کلیدها زیررشته‌هایی هستند که با متنِ دستور مطابقت داده می‌شوند؛ مقدارها حدِ فراخوانیِ عددِ صحیح‌اند. مثلاً {"deploy.sh": 2} اجازه می‌دهد deploy.sh حداکثر دو بار فراخوانی شود. مطابقت بر اساسِ زیررشته است پس ترفندهای بسطِ شل مثلِ ./scripts/deploy.sh $(evil) همچنان به حساب می‌آیند. fan-out زمانِ-اجرا از طریقِ xargs یا find -exec تشخیص داده نمی‌شود؛ این یک کنترلِ defense-in-depth است
CLAUDE_CODE_SCROLL_SPEEDضریبِ اسکرولِ چرخِ موس در رندرِ تمام‌صفحه را تنظیم کن. مقدارهای ۱ تا ۲۰ و مقدارهای کسریِ زیرِ ۱ مثلِ 0.5 را می‌پذیرد تا اسکرولِ شتاب‌دارِ trackpad و چرخ را در ترمینال‌ها روی مسیرِ اسکرولِ بومی کند کند. روی 3 بگذار تا با vim بخواند اگر ترمینالت هر نوچ یک رویدادِ چرخ بدونِ تقویت می‌فرستد. در ترمینالِ IDE JetBrains نادیده گرفته می‌شود، جایی که Claude Code از مدیریتِ اسکرولِ خودش استفاده می‌کند
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MSبازنویسیِ بودجه‌ی زمانی به میلی‌ثانیه برای hookهای SessionEnd. روی خروجِ نشست، /clear و سوییچِ نشست از طریقِ /resume تعاملی اعمال می‌شود. به‌صورت پیش‌فرض بودجه ۱٫۵ ثانیه است، که به‌صورت خودکار به بالاترین timeout به‌ازای هر hook پیکربندی‌شده در فایل‌های تنظیمات افزایش می‌یابد، تا ۶۰ ثانیه. تایم‌اوتِ hookهای فراهم‌شده توسطِ plugin بودجه را افزایش نمی‌دهند
CLAUDE_CODE_SESSION_IDدر زیرفرآیندهای ابزارِ Bash و PowerShell، زیرفرآیندهای دستورِ hook و زیرفرآیندهای stdio MCP server به‌صورت خودکار روی شناسه‌ی نشستِ فعلی تنظیم می‌شود. برای Bash، PowerShell و hookها این با فیلدِ session_id در ورودیِ JSON hook می‌خواند و روی /clear به‌روز می‌شود. یک زیرفرآیندِ MCP server شناسه‌ای را که با آن ساخته شده نگه می‌دارد. روی --resume <session-id> شناسه‌ی ازسرگرفته‌شده را دریافت می‌کند، که با hookها و Bash می‌خواند. روی --continue یا --resume بدونِ شناسه‌ی صریح ممکن است به‌جایش شناسه‌ی شروعِ اولیه را دریافت کند. برای همبسته‌کردنِ اسکریپت‌ها و ابزارهای بیرونی با نشستِ Claude Code که آن‌ها را اجرا کرده استفاده کن
CLAUDE_CODE_SHELLبازنویسیِ تشخیصِ خودکارِ شل. وقتی شلِ ورودت با شلِ کاریِ موردِعلاقه‌ات فرق می‌کند مفید است (مثلاً bash در برابرِ zsh)
CLAUDE_CODE_SHELL_PREFIXپیشوندِ دستوری که دستورهای شلی را که Claude Code می‌سازد می‌پیچد: فراخوانی‌های ابزارِ Bash، دستورهای hook، دستورهای status line و دستورهای شروعِ stdio MCP server. hookهای PowerShell و hookهای فرم-exec بدونِ پیشوند اجرا می‌شوند. برای لاگ‌گیری یا ممیزی مفید است. تنظیمِ یک مسیرِ اجراییِ خالی مثلِ /path/to/logger.sh هر دستور را به‌صورت /path/to/logger.sh '<command>' اجرا می‌کند. wrapper خطِ دستور را به‌صورت یک آرگومانِ تک‌شل-کوت‌شده در $1 دریافت می‌کند، پس wrapper باید $1 را با یک شل دوباره ارزیابی کند، مثلاً exec bash -c "$1". تلقیِ $1 به‌عنوان یک مسیرِ اجراییِ خالی، stdio MCP serverهایی را که آرگومان‌هایی مثلِ npx -y <package> پاس می‌دهند می‌شکند. برای فراخوانی‌های ابزارِ Bash، $1 کلِ فراخوانیِ شلی را که Claude Code مونتاژ می‌کند در بر دارد، از جمله راه‌اندازیِ محیط، نه فقط دستوری که Claude اجرا کرد
CLAUDE_CODE_SIMPLEروی 1 بگذار تا با یک system prompt کمینه و فقط ابزارهای Bash، خواندنِ فایل و ویرایشِ فایل اجرا شود. ابزارهای MCP از --mcp-config همچنان در دسترس‌اند. کشفِ خودکارِ hookها، skillها، pluginها، MCP serverها، auto memory و CLAUDE.md را غیرفعال می‌کند. توکن‌های OAuth و اعتبارنامه‌های keychain خوانده نمی‌شوند، پس احراز هویتِ Anthropic باید از ANTHROPIC_API_KEY یا یک apiKeyHelper در --settings بیاید. معادلِ پاس‌دادنِ --bare است
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPTروی 1 بگذار تا روی هر مدلی از یک system prompt کوتاه‌تر و توصیف‌های مختصرترِ ابزار استفاده شود. روی 0، false، no یا off بگذار تا حتی روی مدل‌هایی که آزمایش یا پیکربندیِ سرور وگرنه فعالش می‌کرد، انصراف بدهی. مجموعه‌ی کاملِ ابزار، hookها، MCP serverها و کشفِ CLAUDE.md فعال می‌مانند
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTHاز احراز هویتِ سمتِ کلاینت برای Claude Platform on AWS رد شو، برای gatewayهایی که خودشان درخواست‌ها را امضا می‌کنند
CLAUDE_CODE_SKIP_BEDROCK_AUTHاز احراز هویتِ AWS برای Bedrock رد شو (مثلاً هنگامِ استفاده از یک LLM gateway)
CLAUDE_CODE_SKIP_FOUNDRY_AUTHاز احراز هویتِ Azure برای Microsoft Foundry رد شو (مثلاً هنگامِ استفاده از یک LLM gateway)
CLAUDE_CODE_SKIP_MANTLE_AUTHاز احراز هویتِ AWS برای Bedrock Mantle رد شو (مثلاً هنگامِ استفاده از یک LLM gateway)
CLAUDE_CODE_SKIP_PROMPT_HISTORYروی 1 بگذار تا از نوشتنِ تاریخچه‌ی پرامپت و رونوشتِ نشست روی دیسک رد شود. نشست‌هایی که با این متغیرِ تنظیم‌شده شروع شوند در --resume، --continue یا تاریخچه‌ی فلشِ بالا ظاهر نمی‌شوند. برای نشست‌های اسکریپتیِ زودگذر مفید است
CLAUDE_CODE_SKIP_VERTEX_AUTHاز احراز هویتِ Google برای Vertex رد شو (مثلاً هنگامِ استفاده از یک LLM gateway)
CLAUDE_CODE_STOP_HOOK_BLOCK_CAPبیشینه‌ی تعدادِ دفعاتِ متوالی که یک hook از نوعِ Stop یا SubagentStop می‌تواند جلوی پایانِ نوبت را بگیرد پیش از آنکه Claude Code آن را بازنویسی کند و نوبت را به‌هرحال تمام کند (پیش‌فرض: 8). روی 0 بگذار تا این حد غیرفعال شود. اگر hookت واقعاً به تکرارهای بیشتری برای حل نیاز دارد این را افزایش بده
CLAUDE_CODE_SUBAGENT_MODELپیکربندیِ مدل را ببین
CLAUDE_CODE_SUBPROCESS_ENV_SCRUBروی 1 بگذار تا اعتبارنامه‌های Anthropic و ارائه‌دهنده‌ی ابری از محیطِ زیرفرآیندها (ابزارِ Bash، hookها، MCP stdio serverها) حذف شوند. فرآیندِ والدِ Claude این اعتبارنامه‌ها را برای فراخوانی‌های API نگه می‌دارد، اما فرآیندهای فرزند نمی‌توانند بخوانندشان، که نمایان‌شدن به حمله‌های prompt injection که می‌کوشند سکرت‌ها را از طریقِ بسطِ شل استخراج کنند کاهش می‌دهد. روی Linux، این همچنین زیرفرآیندهای Bash را در یک namespace PID ایزوله اجرا می‌کند تا نتوانند محیطِ فرآیندهای میزبان را از طریقِ /proc بخوانند؛ به‌عنوان یک اثرِ جانبی، ps، pgrep و kill نمی‌توانند فرآیندهای میزبان را ببینند یا سیگنال دهند. claude-code-action این را وقتی allowed_non_write_users پیکربندی شده باشد به‌صورت خودکار تنظیم می‌کند
CLAUDE_CODE_SYNC_PLUGIN_INSTALLدر حالتِ غیرتعاملی (پرچمِ -p) روی 1 بگذار تا پیش از اولین query منتظرِ اتمامِ نصبِ plugin بماند. بدونِ این، pluginها در پس‌زمینه نصب می‌شوند و ممکن است در نوبتِ اول در دسترس نباشند. با CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS ترکیب کن تا انتظار را محدود کنی
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MSمهلت به میلی‌ثانیه برای نصبِ همگامِ plugin. وقتی فراتر رود، Claude Code بدونِ pluginها ادامه می‌دهد و یک خطا لاگ می‌کند. بدونِ پیش‌فرض: بدونِ این متغیر، نصبِ همگام تا اتمام منتظر می‌ماند
CLAUDE_CODE_SYNC_SKILLSروی 1 بگذار تا skillهای فعالِ claude.ai تو در ~/.claude/skills/ پیش از اولین query دانلود شوند و هر ۱۰ دقیقه دوباره همگام شوند. فقط در حالتِ غیرتعاملی با پرچمِ -p اعمال می‌شود. به احراز هویتِ claude.ai نیاز دارد. نشست‌های Claude Code on the web skillهای فعالِ claude.ai تو را به‌صورت خودکار دریافت می‌کنند؛ آنجا نیازی به تنظیمِ این نداری
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MSمهلت به میلی‌ثانیه برای یک همگام‌سازیِ دوباره‌ی skill وسطِ نشست وقتی CLAUDE_CODE_SYNC_SKILLS تنظیم شده باشد (پیش‌فرض: 30000). دانلودی را که وقتی میزبان وسطِ نشست بارگذاریِ دوباره‌ی skill را درخواست می‌کند آغاز می‌شود محدود می‌کند. وقتی فراتر رود، همگام‌سازیِ دوباره متوقف می‌شود و دانلودهای باقی‌مانده در پس‌زمینه ادامه می‌یابند
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MSمهلت به میلی‌ثانیه برای انتظارِ اولین query روی همگام‌سازیِ اولیه‌ی skill وقتی CLAUDE_CODE_SYNC_SKILLS تنظیم شده باشد (پیش‌فرض: 5000). وقتی فراتر رود، query ادامه می‌یابد و دانلودهای باقی‌مانده‌ی skill در پس‌زمینه ادامه می‌یابند
CLAUDE_CODE_SYNTAX_HIGHLIGHTروی false بگذار تا برجسته‌سازیِ نحو در خروجیِ diff غیرفعال شود. وقتی رنگ‌ها با راه‌اندازیِ ترمینالت تداخل دارند مفید است. برای غیرفعال‌کردنِ برجسته‌سازی در بلوک‌های کد و پیش‌نمایش‌های فایل هم، از تنظیمِ syntaxHighlightingDisabled استفاده کن
CLAUDE_CODE_TASK_LIST_IDیک فهرستِ task را بینِ نشست‌ها به اشتراک بگذار. همان شناسه را در چند نمونه‌ی Claude Code تنظیم کن تا روی یک فهرستِ task مشترک هماهنگ شوید. فهرستِ Task را ببین
CLAUDE_CODE_TEAM_NAMEنامِ تیمِ agent که این هم‌تیمی به آن تعلق دارد. روی اعضای agent team به‌صورت خودکار تنظیم می‌شود
CLAUDE_CODE_TMPDIRبازنویسیِ دایرکتوریِ temp که برای فایل‌های موقتِ داخلی استفاده می‌شود. Claude Code روی Unix /claude-{uid}/ یا روی Windows /claude/ را به این مسیر می‌افزاید. پیش‌فرض: /tmp روی macOS، os.tmpdir() روی Linux و Windows. {/* min-version: 2.1.161 */}از نسخه‌ی v2.1.161، روی macOS و Linux، زیرفرآیندهای Bash که sandbox شده‌اند یک $TMPDIR کوتاهِ fallback زیرِ پیش‌فرضِ سیستم دریافت می‌کنند وقتی بازنویسی‌ات یک مسیرِ بلند است، چون برخی ابزارها وقتی مسیرهای temp خیلی بلند شوند شکست می‌خورند. دستورهای Bash غیرِ sandbox شده $TMPDIR شلت را بدونِ تغییر به ارث می‌برند. فایل‌های موقتِ خودِ Claude Code همیشه از بازنویسی‌ات استفاده می‌کنند
CLAUDE_CODE_TMUX_TRUECOLORروی 1 بگذار تا خروجیِ ۲۴-بیتیِ truecolor داخلِ tmux مجاز شود. به‌صورت پیش‌فرض، Claude Code وقتی $TMUX تنظیم شده باشد به ۲۵۶ رنگ محدود می‌کند چون tmux دنباله‌های escape مربوط به truecolor را عبور نمی‌دهد مگر پیکربندی شده باشد. این را پس از افزودنِ set -ga terminal-overrides ',*:Tc' به ~/.tmux.conf خود تنظیم کن. برای سایر تنظیماتِ tmux، پیکربندیِ ترمینال را ببین
CLAUDE_CODE_USE_ANTHROPIC_AWSاستفاده از Claude Platform on AWS
CLAUDE_CODE_USE_BEDROCKاستفاده از Bedrock
CLAUDE_CODE_USE_FOUNDRYاستفاده از Microsoft Foundry
CLAUDE_CODE_USE_MANTLEاستفاده از Mantle endpoint در Bedrock
CLAUDE_CODE_USE_NATIVE_FILE_SEARCHروی 1 بگذار تا دستورهای سفارشی، ساب‌ایجنت‌ها و سبک‌های خروجی با APIهای فایلِ Node.js به‌جای ripgrep کشف شوند. این را وقتی تنظیم کن که باینریِ ripgrep عرضه‌شده در محیطت در دسترس نیست یا مسدود است. بر ابزارهای Grep یا جست‌وجوی فایل اثری ندارد
CLAUDE_CODE_USE_POWERSHELL_TOOLابزارِ PowerShell را کنترل می‌کند. روی Windows بدونِ Git Bash، ابزار به‌صورت خودکار فعال است؛ روی 0 بگذار تا غیرفعالش کنی. روی Windows با Git Bash نصب‌شده، ابزار به‌صورت تدریجی منتشر می‌شود: روی 1 بگذار تا انتخاب کنی یا 0 تا انصراف بدهی. روی Linux، macOS و WSL، روی 1 بگذار تا فعالش کنی، که به pwsh در PATH تو نیاز دارد. وقتی روی Windows فعال باشد، Claude می‌تواند دستورهای PowerShell را به‌صورت بومی اجرا کند به‌جای مسیریابی از طریقِ Git Bash. ابزارِ PowerShell را ببین
CLAUDE_CODE_USE_VERTEXاستفاده از Vertex
CLAUDE_CONFIG_DIRبازنویسیِ دایرکتوریِ پیکربندی (پیش‌فرض: ~/.claude). همه‌ی تنظیمات، اعتبارنامه‌ها، تاریخچه‌ی نشست و pluginها زیرِ این مسیر ذخیره می‌شوند. برای اجرای چند حساب کنارِ هم مفید است: مثلاً alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'
CLAUDE_EFFORTدر زیرفرآیندهای ابزارِ Bash و دستورهای hook به‌صورت خودکار روی سطحِ effort فعالِ آن نوبت تنظیم می‌شود: low، medium، high، xhigh یا max. Ultracode سطحی متمایز نیست و به‌عنوان xhigh گزارش می‌شود. با فیلدِ effort.level که به hookها پاس می‌شود می‌خواند. فقط وقتی تنظیم می‌شود که مدلِ فعلی پارامترِ effort را پشتیبانی کند
CLAUDE_ENABLE_BYTE_WATCHDOGروی 1 بگذار تا نگهبانِ بی‌کاریِ استریمیِ سطح-بایت به‌اجبار فعال شود، یا روی 0 تا به‌اجبار غیرفعالش کنی. وقتی تنظیم نشده باشد، نگهبان به‌صورت پیش‌فرض برای اتصال‌های مستقیمِ Anthropic API و Claude Platform on AWS فعال است. نگهبانِ بایت یک اتصال را وقتی هیچ بایتی روی سیم نمی‌رسد به‌صورت پیش‌فرض پس از ۱۸۰ ثانیه روی اتصال‌های مستقیمِ Anthropic API، ۳۰۰ ثانیه روی Claude Platform on AWS و وقتی روی Bedrock فعال باشد، یا برای مقدارِ CLAUDE_STREAM_IDLE_TIMEOUT_MS وقتی تنظیم شده باشد لغو می‌کند، که به کمینه‌ی ۵ دقیقه clamp می‌شود، مستقل از نگهبانِ سطح-رویداد
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCKروی 1 بگذار تا نگهبانِ بی‌کاریِ استریمیِ سطح-بایت روی پاسخ‌های vnd.amazon.eventstream در Amazon Bedrock فعال شود. به‌صورت پیش‌فرض خاموش است. مهلت را با CLAUDE_STREAM_IDLE_TIMEOUT_MS پیکربندی کن
CLAUDE_ENABLE_STREAM_WATCHDOGروی 1 بگذار تا نگهبانِ بی‌کاریِ استریمیِ سطح-رویداد به‌اجبار فعال شود، یا روی 0 تا به‌اجبار غیرفعالش کنی. وقتی تنظیم نشده باشد، پیش‌فرض روی Anthropic API مستقیم سرور-کنترل است و روی سایر ارائه‌دهنده‌ها خاموش. {/* min-version: 2.1.169 */}از نسخه‌ی v2.1.169، ارائه‌دهنده‌های دیگر به‌جز Anthropic API مستقیم و Claude Platform on AWS هم یک مهلتِ بی‌کاریِ بدنه‌ی ۵-دقیقه‌ای پیش‌فرض-روشن مستقل از این متغیر دارند؛ API_FORCE_IDLE_TIMEOUT را ببین. روی Bedrock، می‌توانی نگهبانِ سطح-بایتِ مستقل را هم با CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK فعال کنی؛ وقتی هردو تنظیم شوند با هم اجرا می‌شوند. مهلت را با CLAUDE_STREAM_IDLE_TIMEOUT_MS پیکربندی کن
CLAUDE_ENV_FILEمسیر به یک اسکریپتِ شل که Claude Code محتوایش را پیش از هر دستورِ Bash در همان فرآیندِ شل اجرا می‌کند، پس exportهای موجود در فایل برای دستور قابل‌دید است. برای پایدارکردنِ فعال‌سازیِ virtualenv یا conda در طولِ دستورها استفاده کن. همچنین به‌صورت پویا توسطِ hookهای SessionStart، Setup، CwdChanged و FileChanged پر می‌شود
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIXپیشوند برای نام‌های نشستِ خودکارِ Remote Control وقتی هیچ نامِ صریحی داده نشده باشد. به‌صورت پیش‌فرض نامِ میزبانِ ماشینت است، که نام‌هایی مثلِ myhost-graceful-unicorn تولید می‌کند. پرچمِ CLI --remote-control-session-name-prefix همین مقدار را برای یک فراخوانیِ تکی تنظیم می‌کند
CLAUDE_STREAM_IDLE_TIMEOUT_MSمهلت به میلی‌ثانیه پیش از آنکه نگهبانِ بی‌کاریِ استریمی یک اتصالِ متوقف‌شده را ببندد. وقتی این متغیر را صریحاً تنظیم می‌کنی، کمینه 300000 (۵ دقیقه) است؛ مقدارهای پایین‌تر بی‌صدا clamp می‌شوند تا مکث‌های extended thinking و بافرینگِ پراکسی را جذب کنند. وقتی تنظیم نشده باشد، نگهبانِ سطح-رویداد به‌صورت پیش‌فرض ۳۰۰ ثانیه و نگهبانِ سطح-بایت به‌صورت پیش‌فرض ۱۸۰ ثانیه روی اتصال‌های مستقیمِ Anthropic API است (۳۰۰ ثانیه روی Claude Platform on AWS و سایر ارائه‌دهنده‌ها). پیش‌فرضِ تنظیم‌نشده‌ی ۱۸۰-ثانیه‌ای نگهبانِ بایت یک مقدارِ جداگانه است و تابعِ clamp ۵-دقیقه‌ای نیست. برای نگهبانِ سطح-رویداد روی ارائه‌دهنده‌های شخصِ ثالث، به CLAUDE_ENABLE_STREAM_WATCHDOG=1 نیاز دارد؛ مهلتِ بی‌کاریِ بدنه که زیرِ API_FORCE_IDLE_TIMEOUT توصیف شده مستقل اعمال می‌شود. روی Bedrock، وقتی CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1 باشد هم اعمال می‌شود
DEBUGروی 1 بگذار تا حالتِ دیباگ فعال شود، معادلِ اجرا با --debug. لاگ‌های دیباگ در ~/.claude/debug/<session-id>.txt یا در مسیرِ تنظیم‌شده با CLAUDE_CODE_DEBUG_LOGS_DIR نوشته می‌شوند. فقط مقدارهای درستِ 1، true، yes و on حالتِ دیباگ را فعال می‌کنند، پس الگوهای namespace مثلِ DEBUG=express:* که برای ابزارهای دیگر تنظیم شده آن را فعال نمی‌کنند
DISABLE_AUTOUPDATERروی 1 بگذار تا به‌روزرسانی‌های خودکارِ پس‌زمینه غیرفعال شوند. claude update دستی همچنان کار می‌کند. از DISABLE_UPDATES برای مسدودکردنِ هردو استفاده کن
DISABLE_AUTO_COMPACTروی 1 بگذار تا فشرده‌سازیِ خودکار هنگامِ نزدیک‌شدن به حدِ کانتکست غیرفعال شود. دستورِ دستیِ /compact در دسترس می‌ماند. وقتی می‌خواهی کنترلِ صریح روی زمانِ فشرده‌سازی داشته باشی استفاده کن
DISABLE_COMPACTروی 1 بگذار تا همه‌ی فشرده‌سازی غیرفعال شود: هم فشرده‌سازیِ خودکار و هم دستورِ دستیِ /compact
DISABLE_COST_WARNINGSروی 1 بگذار تا پیام‌های هشدارِ هزینه غیرفعال شوند
DISABLE_DOCTOR_COMMANDروی 1 بگذار تا دستورِ /doctor پنهان شود. برای استقرارهای مدیریت‌شده که کاربران نباید عیب‌یابیِ نصب را اجرا کنند مفید است
DISABLE_ERROR_REPORTINGروی 1 بگذار تا از گزارشِ خطای Sentry انصراف بدهی
DISABLE_EXTRA_USAGE_COMMANDروی 1 بگذار تا دستورِ /usage-credits که به کاربران اجازه می‌دهد استفاده‌ی اضافی فراتر از حدودِ نرخ بخرند پنهان شود
DISABLE_FEEDBACK_COMMANDروی 1 بگذار تا دستورِ /feedback غیرفعال شود. نامِ قدیمی‌ترِ DISABLE_BUG_COMMAND هم پذیرفته می‌شود
DISABLE_GROWTHBOOKروی 1 بگذار تا واکشیِ feature-flag در GrowthBook غیرفعال شود و برای هر flag از پیش‌فرض‌های کد استفاده شود. لاگ‌گیریِ رویدادِ تله‌متری روشن می‌ماند مگر DISABLE_TELEMETRY هم تنظیم شود
DISABLE_INSTALLATION_CHECKSروی 1 بگذار تا هشدارهای نصب غیرفعال شوند. فقط وقتی محلِ نصب را دستی مدیریت می‌کنی استفاده کن، چون این می‌تواند مشکل‌های نصب‌های استاندارد را پنهان کند
DISABLE_INSTALL_GITHUB_APP_COMMANDروی 1 بگذار تا دستورِ /install-github-app پنهان شود. هنگامِ استفاده از ارائه‌دهنده‌های شخصِ ثالث (Bedrock، Vertex یا Foundry) از قبل پنهان است
DISABLE_INTERLEAVED_THINKINGروی 1 بگذار تا از فرستادنِ هدرِ beta مربوط به interleaved-thinking جلوگیری شود. وقتی LLM gateway یا ارائه‌دهنده‌ات از interleaved thinking پشتیبانی نمی‌کند مفید است
DISABLE_LOGIN_COMMANDروی 1 بگذار تا دستورِ /login پنهان شود. وقتی احراز هویت به‌صورت بیرونی از طریقِ کلیدهای API یا apiKeyHelper مدیریت می‌شود مفید است
DISABLE_LOGOUT_COMMANDروی 1 بگذار تا دستورِ /logout پنهان شود
DISABLE_PROMPT_CACHINGروی 1 بگذار تا کشِ پرامپت برای همه‌ی مدل‌ها غیرفعال شود (بر تنظیماتِ به‌ازای هر مدل ارجح است)
DISABLE_PROMPT_CACHING_FABLEروی 1 بگذار تا کشِ پرامپت برای مدل‌های Fable غیرفعال شود
DISABLE_PROMPT_CACHING_HAIKUروی 1 بگذار تا کشِ پرامپت برای مدل‌های Haiku غیرفعال شود
DISABLE_PROMPT_CACHING_OPUSروی 1 بگذار تا کشِ پرامپت برای مدل‌های Opus غیرفعال شود
DISABLE_PROMPT_CACHING_SONNETروی 1 بگذار تا کشِ پرامپت برای مدل‌های Sonnet غیرفعال شود
DISABLE_TELEMETRYروی 1 بگذار تا از تله‌متری انصراف بدهی. رویدادهای تله‌متری داده‌ی کاربر مثلِ کد، مسیرهای فایل یا دستورهای bash را در بر ندارند. همچنین واکشیِ feature-flag را با همان اثرِ DISABLE_GROWTHBOOK غیرفعال می‌کند، پس برخی قابلیت‌های flag‌دار ممکن است در دسترس نباشند
DISABLE_UPDATESروی 1 بگذار تا همه‌ی به‌روزرسانی‌ها از جمله claude update و claude install دستی مسدود شوند. سخت‌گیرانه‌تر از DISABLE_AUTOUPDATER. وقتی Claude Code را از طریقِ کانال‌های خودت توزیع می‌کنی و کاربران نباید خودشان به‌روز کنند استفاده کن
DISABLE_UPGRADE_COMMANDروی 1 بگذار تا دستورِ /upgrade پنهان شود
DO_NOT_TRACKروی 1 بگذار تا از تله‌متری انصراف بدهی. معادلِ تنظیمِ DISABLE_TELEMETRY است. Claude Code این را به‌عنوان قراردادِ بین‌ابزاریِ شناخته‌شده توسطِ بسیاری از CLIهای توسعه رعایت می‌کند
ENABLE_CLAUDEAI_MCP_SERVERSروی false بگذار تا MCP serverهای claude.ai در Claude Code غیرفعال شوند. برای کاربرانِ واردشده به‌صورت پیش‌فرض فعال است
ENABLE_PROMPT_CACHING_1Hروی 1 بگذار تا یک TTL کشِ پرامپتِ ۱-ساعته به‌جای پیش‌فرضِ ۵ دقیقه درخواست شود. برای کاربرانِ کلیدِ API، Bedrock، Vertex، Foundry و Claude Platform on AWS در نظر گرفته شده. کاربرانِ اشتراکی درونِ استفاده‌ی شامل، TTL ۱-ساعته را به‌صورت خودکار دریافت می‌کنند. نوشتن‌های کشِ ۱-ساعته با نرخِ بالاتری هزینه می‌شوند
ENABLE_PROMPT_CACHING_1H_BEDROCKمنسوخ. به‌جایش از ENABLE_PROMPT_CACHING_1H استفاده کن
ENABLE_TOOL_SEARCHMCP tool search را کنترل می‌کند. تنظیم‌نشده: همه‌ی ابزارهای MCP به‌صورت پیش‌فرض به تعویق می‌افتند، اما روی Vertex AI یا وقتی ANTHROPIC_BASE_URL به یک هاستِ غیرِ first-party اشاره می‌کند از پیش بارگذاری می‌شوند. مقدارها: true (همیشه تعویق و فرستادنِ هدرِ beta، روی مدل‌های Vertex AI قبل از Sonnet 4.5 یا Opus 4.5، یا روی پراکسی‌هایی که tool_reference را پشتیبانی نمی‌کنند درخواست‌ها شکست می‌خورند)، auto (حالتِ آستانه: اگر ابزارها در ۱۰٪ کانتکست جا شوند از پیش بارگذاری می‌شوند)، auto:N (آستانه‌ی سفارشی، مثلاً auto:5 برای ۵٪)، false (همه از پیش بارگذاری می‌شوند)
FALLBACK_FOR_ALL_PRIMARY_MODELSروی هر مقدارِ ناخالی بگذار تا همه‌ی مدل‌ها، نه فقط Opus، با یک خطای overload تکراری وقتی هیچ مدلِ fallback پیکربندی نشده دیگر retry نکنند. {/* min-version: 2.1.160 */}از نسخه‌ی v2.1.160، یک زنجیره‌ی مدلِ fallback پیکربندی‌شده روی خطاهای overload تکراری برای هر مدلِ اصلی فعال می‌شود، پس این متغیر بر سوییچ به یک مدلِ fallback اثری ندارد
FORCE_AUTOUPDATE_PLUGINSروی 1 بگذار تا به‌روزرسانی‌های خودکارِ plugin به‌اجبار انجام شوند حتی وقتی به‌روزرسانِ اصلی از طریقِ DISABLE_AUTOUPDATER غیرفعال است
FORCE_PROMPT_CACHING_5Mروی 1 بگذار تا TTL کشِ پرامپتِ ۵-دقیقه‌ای به‌اجبار انجام شود حتی وقتی TTL ۱-ساعته وگرنه اعمال می‌شد. بر ENABLE_PROMPT_CACHING_1H ارجح است
HTTP_PROXYسرورِ پراکسیِ HTTP برای اتصال‌های شبکه را مشخص کن
HTTPS_PROXYسرورِ پراکسیِ HTTPS برای اتصال‌های شبکه را مشخص کن
IS_DEMOروی 1 بگذار تا حالتِ دمو فعال شود: ایمیل و نامِ سازمانت را از هدر و خروجیِ /status پنهان می‌کند و onboarding را رد می‌کند. هنگامِ استریم یا ضبطِ یک نشست مفید است
MAX_MCP_OUTPUT_TOKENSبیشینه‌ی تعدادِ توکن‌های مجاز در پاسخ‌های ابزارِ MCP. Claude Code وقتی خروجی از ۱۰٬۰۰۰ توکن فراتر رود یک هشدار نشان می‌دهد. ابزارهایی که anthropic/maxResultSizeChars را اعلام می‌کنند به‌جایش از آن حدِ کاراکتر برای محتوای متنی استفاده می‌کنند، اما محتوای تصویریِ آن ابزارها همچنان تابعِ این متغیر است (پیش‌فرض: 25000)
MAX_STRUCTURED_OUTPUT_RETRIESتعدادِ دفعاتِ retry وقتی پاسخِ مدل در برابرِ --json-schema در حالتِ غیرتعاملی (پرچمِ -p) اعتبارسنجی را رد می‌کند. پیش‌فرض ۵ است
MAX_THINKING_TOKENSبازنویسیِ بودجه‌ی توکنِ extended thinking. سقف، بیشینه توکن‌های خروجیِ مدل منهای یک است. روی 0 بگذار تا تفکر در Anthropic API غیرفعال شود به‌جز روی Fable 5، که تفکرش را نمی‌توان خاموش کرد. روی ارائه‌دهنده‌های شخصِ ثالث، 0 به‌جایش پارامترِ thinking را حذف می‌کند، و مدل‌های دارای استدلالِ تطبیقی ممکن است همچنان فکر کنند. برای مقدارهای ناصفر روی مدل‌های استدلالِ تطبیقی، بودجه نادیده گرفته می‌شود مگر استدلالِ تطبیقی از طریقِ CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING غیرفعال شود
MCP_CLIENT_SECRETclient secret OAuth برای MCP serverهایی که به اعتبارنامه‌های از پیش پیکربندی‌شده نیاز دارند. از پرامپتِ تعاملی هنگامِ افزودنِ یک server با --client-secret جلوگیری می‌کند
MCP_CONNECTION_NONBLOCKINGکنترل می‌کند که آیا شروع منتظرِ اتصالِ MCP serverها پیش از اولین query بماند. {/* min-version: 2.1.142 */}از Claude Code نسخه‌ی v2.1.142، شروعِ MCP به‌صورت پیش‌فرض ناایست است: serverها در پس‌زمینه متصل می‌شوند و ابزارهایشان همان‌طور که تمام می‌کنند در دسترس می‌شوند. روی 0 بگذار تا انتظارِ اتصالِ ۵-ثانیه‌ایِ مسدودکننده بازگردد. serverهای پیکربندی‌شده با alwaysLoad: true همچنان صرف‌نظر از این شروع را مسدود می‌کنند، چون ابزارهایشان باید هنگامِ ساختِ اولین پرامپت حاضر باشند
MCP_CONNECT_TIMEOUT_MSچقدر شروعِ مسدودکننده‌ی MCP، به میلی‌ثانیه، برای دسته‌ی اتصال پیش از عکس‌برداری از فهرستِ ابزار منتظر می‌ماند (پیش‌فرض: 5000). وقتی MCP_CONNECTION_NONBLOCKING=0 باشد یا برای serverهای علامت‌خورده با alwaysLoad: true اعمال می‌شود. serverهایی که در ضرب‌الاجل همچنان معلق‌اند در پس‌زمینه متصل می‌مانند اما تا query بعدی ظاهر نمی‌شوند. متمایز از MCP_TIMEOUT است، که تلاشِ اتصالِ یک server را محدود می‌کند
MCP_OAUTH_CALLBACK_PORTپورتِ ثابت برای callback ریدایرکتِ OAuth، به‌عنوان جایگزینی برای --callback-port هنگامِ افزودنِ یک MCP server با اعتبارنامه‌های از پیش پیکربندی‌شده
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZEبیشینه‌ی تعدادِ MCP serverهای ریموت (HTTP/SSE) برای اتصالِ موازی هنگامِ شروع (پیش‌فرض: 20)
MCP_SERVER_CONNECTION_BATCH_SIZEبیشینه‌ی تعدادِ MCP serverهای محلی (stdio) برای اتصالِ موازی هنگامِ شروع (پیش‌فرض: 3)
MCP_TIMEOUTمهلت به میلی‌ثانیه برای شروعِ MCP server (پیش‌فرض: 30000 یا ۳۰ ثانیه)
MCP_TOOL_TIMEOUTمهلت به میلی‌ثانیه برای اجرای ابزارِ MCP (پیش‌فرض: 100000000، حدودِ ۲۸ ساعت). یک فیلدِ timeout به‌ازای هر server در .mcp.json این را برای آن server بازنویسی می‌کند. برای متغیرِ env، مقدارهای زیرِ 1000 به یک ثانیه کف می‌خورند؛ برای فیلدِ به‌ازای هر server، مقدارهای زیرِ 1000 نادیده گرفته می‌شوند
NO_PROXYفهرستِ دامنه‌ها و IPهایی که درخواست‌ها مستقیم به آن‌ها صادر می‌شوند، با دور زدنِ پراکسی
OTEL_LOG_RAW_API_BODIESJSON درخواست و پاسخِ Anthropic Messages API را به‌عنوان رویدادهای لاگِ api_request_body / api_response_body منتشر کن. روی 1 بگذار برای بدنه‌های inline که در ۶۰ KB کوتاه شده‌اند، یا file:<dir> تا بدنه‌های کوتاه‌نشده را روی دیسک بنویسی و به‌جایش یک مسیرِ body_ref منتشر کنی. به‌صورت پیش‌فرض غیرفعال است؛ بدنه‌ها کلِ تاریخچه‌ی مکالمه را در بر دارند. پایش را ببین
OTEL_LOG_TOOL_CONTENTروی 1 بگذار تا محتوای ورودی و خروجیِ ابزار در رویدادهای span OpenTelemetry گنجانده شود. به‌صورت پیش‌فرض برای محافظت از داده‌ی حساس غیرفعال است. پایش را ببین
OTEL_LOG_TOOL_DETAILSروی 1 بگذار تا آرگومان‌های ورودیِ ابزار، نام‌های MCP server، رشته‌های خطای خام روی شکستِ ابزار و سایر جزئیاتِ ابزار در traceها و لاگ‌های OpenTelemetry گنجانده شوند. به‌صورت پیش‌فرض برای محافظت از PII غیرفعال است. پایش را ببین
OTEL_LOG_USER_PROMPTSروی 1 بگذار تا متنِ پرامپتِ کاربر در traceها و لاگ‌های OpenTelemetry گنجانده شود. به‌صورت پیش‌فرض غیرفعال است (پرامپت‌ها سانسور می‌شوند). پایش را ببین
OTEL_METRICS_INCLUDE_ACCOUNT_UUIDروی false بگذار تا UUID حساب از ویژگی‌های متریک حذف شود (پیش‌فرض: گنجانده‌شده). پایش را ببین
OTEL_METRICS_INCLUDE_ENTRYPOINT{/* min-version: 2.1.152 */}روی true بگذار تا نقطه‌ی ورودِ نشست در ویژگی‌های متریک گنجانده شود (پیش‌فرض: حذف‌شده). در v2.1.152 افزوده شد. پایش را ببین
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES{/* min-version: 2.1.161 */}از نسخه‌ی v2.1.161، Claude Code کلیدهای OTEL_RESOURCE_ATTRIBUTES را به برچسب‌های datapoint متریک می‌چسباند. روی false بگذار تا حذفشان کنی (پیش‌فرض: گنجانده‌شده). پایش را ببین
OTEL_METRICS_INCLUDE_SESSION_IDروی false بگذار تا شناسه‌ی نشست از ویژگی‌های متریک حذف شود (پیش‌فرض: گنجانده‌شده). پایش را ببین
OTEL_METRICS_INCLUDE_VERSIONروی true بگذار تا نسخه‌ی Claude Code در ویژگی‌های متریک گنجانده شود (پیش‌فرض: حذف‌شده). پایش را ببین
SLASH_COMMAND_TOOL_CHAR_BUDGETبازنویسیِ بودجه‌ی کاراکتر برای متادیتای skill که به ابزارِ Skill نشان داده می‌شود. بودجه به‌صورت پویا روی ۱٪ پنجره‌ی کانتکست مقیاس می‌خورد، با fallback ۸٬۰۰۰ کاراکتری. نامِ قدیمی برای سازگاریِ رو به عقب نگه داشته شده
TASK_MAX_OUTPUT_LENGTHبیشینه‌ی تعدادِ کاراکترها در خروجیِ ساب‌ایجنت پیش از کوتاه‌شدن (پیش‌فرض: 32000، بیشینه: 160000). وقتی کوتاه شود، خروجیِ کامل روی دیسک ذخیره می‌شود و مسیر در پاسخِ کوتاه‌شده گنجانده می‌شود
USE_BUILTIN_RIPGREPروی 0 بگذار تا از rg نصب‌شده‌ی سیستم به‌جای rg گنجانده‌شده با Claude Code استفاده شود
VERTEX_REGION_CLAUDE_3_5_HAIKUبازنویسیِ منطقه برای Claude 3.5 Haiku هنگامِ استفاده از Vertex AI
VERTEX_REGION_CLAUDE_3_5_SONNETبازنویسیِ منطقه برای Claude 3.5 Sonnet هنگامِ استفاده از Vertex AI
VERTEX_REGION_CLAUDE_3_7_SONNETبازنویسیِ منطقه برای Claude 3.7 Sonnet هنگامِ استفاده از Vertex AI
VERTEX_REGION_CLAUDE_4_0_OPUSبازنویسیِ منطقه برای Claude 4.0 Opus هنگامِ استفاده از Vertex AI
VERTEX_REGION_CLAUDE_4_0_SONNETبازنویسیِ منطقه برای Claude 4.0 Sonnet هنگامِ استفاده از Vertex AI
VERTEX_REGION_CLAUDE_4_1_OPUSبازنویسیِ منطقه برای Claude 4.1 Opus هنگامِ استفاده از Vertex AI
VERTEX_REGION_CLAUDE_4_5_OPUSبازنویسیِ منطقه برای Claude Opus 4.5 هنگامِ استفاده از Vertex AI
VERTEX_REGION_CLAUDE_4_5_SONNETبازنویسیِ منطقه برای Claude Sonnet 4.5 هنگامِ استفاده از Vertex AI
VERTEX_REGION_CLAUDE_4_6_OPUSبازنویسیِ منطقه برای Claude Opus 4.6 هنگامِ استفاده از Vertex AI
VERTEX_REGION_CLAUDE_4_6_SONNETبازنویسیِ منطقه برای Claude Sonnet 4.6 هنگامِ استفاده از Vertex AI
VERTEX_REGION_CLAUDE_4_7_OPUS{/* min-version: 2.1.111 */}بازنویسیِ منطقه برای Claude Opus 4.7 هنگامِ استفاده از Vertex AI. در v2.1.111 افزوده شد
VERTEX_REGION_CLAUDE_4_8_OPUS{/* min-version: 2.1.154 */}بازنویسیِ منطقه برای Claude Opus 4.8 هنگامِ استفاده از Vertex AI. در v2.1.154 افزوده شد
VERTEX_REGION_CLAUDE_FABLE_5{/* min-version: 2.1.170 */}بازنویسیِ منطقه برای Claude Fable 5 هنگامِ استفاده از Vertex AI. در v2.1.170 افزوده شد
VERTEX_REGION_CLAUDE_HAIKU_4_5بازنویسیِ منطقه برای Claude Haiku 4.5 هنگامِ استفاده از Vertex AI

متغیرهای استانداردِ exporter در OpenTelemetry (OTEL_METRICS_EXPORTER، OTEL_LOGS_EXPORTER، OTEL_EXPORTER_OTLP_ENDPOINT، OTEL_EXPORTER_OTLP_PROTOCOL، OTEL_EXPORTER_OTLP_HEADERS، OTEL_METRIC_EXPORT_INTERVAL، OTEL_RESOURCE_ATTRIBUTES و گونه‌های مخصوصِ هر سیگنال) هم پشتیبانی می‌شوند. برای جزئیاتِ پیکربندی، پایش را ببین.

همچنین ببین

Section titled “همچنین ببین”