مهم‌ترین تغییرات آپدیت Claude Code 2.1.307
آپدیت Claude Code 2.1.307 بر پایداری MCP، شفافیت رویدادهای ایمنی و بازیابی مطمئن‌تر نشست‌ها تمرکز دارد. این نسخه همچنین چند خطای مرتبط با مدل‌های دارای زمینه یک‌میلیونی، کش پرامپت و اجرای بدون رابط گرافیکی را برطرف می‌کند.
- MCP پایدارتر: جلوگیری از تکرار ناخواسته بعضی تماس‌های HTTP و اصلاح اتصال پس از Sleep سیستم.
- ایمنی قابل‌رصد: ثبت رویداد OpenTelemetry هنگام توقف، درخواست تأیید یا بازگرداندن فراخوانی ابزار.
- نشست مطمئن‌تر: رفع بازگشت مکالمه پاک‌شده و حفظ تنظیمات Autocompact پس از راه‌اندازی مجدد.
مهم‌ترین رفع خطای MCP به تماس‌هایی مربوط است که هنگام قطع اتصال، احتمال داشت دوباره ارسال شوند. اکنون فقط ابزارهای صرفاً خواندنی یا عملیات idempotent به‌صورت خودکار تکرار می‌شوند؛ تغییری که خطر اجرای دوباره فرمان‌های اثرگذار را کاهش می‌دهد.
رویداد جدید claude_code.safety_event مشخص می‌کند کدام قانون مجوز، Auto Mode، بررسی ایمنی، Hook یا Sandbox یک فراخوانی ابزار را متوقف یا برای تأیید ارسال کرده است. این قابلیت برای ممیزی و عیب‌یابی محیط‌های تیمی ارزشمند است.
نسخه 2.1.307 همچنین پیام احراز هویت MCP در macOS را دقیق‌تر کرده و خطای Timeout ناشی از Sleep در macOS و Linux را رفع می‌کند. پس از بازشدن Keychain نیز اتصال بعدی بدون ورود دوباره انجام می‌شود.
اصلاح خطای aliasهای دارای پسوند [1m]، دریافت ابزارهای جدید SDK MCP در حضور وظایف پس‌زمینه و کاهش خطاهای Autocompact از دیگر تغییرات‌اند. برای مقایسه روند توسعه می‌توانید تغییرات Claude Code 2.1.305 را نیز مرور کنید.
رفع ارسال تکراری تماس‌های HTTP در MCP
یکی از اصلاحات مهم در آپدیت Claude Code 2.1.307، جلوگیری از اجرای دوباره برخی تماس‌های HTTP ابزارهای MCP است. این مشکل زمانی رخ می‌داد که اتصال حین فراخوانی بسته می‌شد و تلاش مجدد می‌توانست همان عملیات را دوباره اجرا کند.
- تلاش مجدد فقط برای ابزارهای خواندنی یا تکرارپذیر انجام می‌شود.
- عملیات تغییردهنده پس از قطع اتصال، خودکار دوباره ارسال نمی‌شوند.
- ریسک ثبت سفارش، ارسال پیام یا تغییر داده تکراری کاهش یافته است.
در نسخه جدید، Claude Code میان ابزارهای امن برای تکرار و عملیات حساس تفاوت می‌گذارد. ابزارهای idempotent حتی با چند بار اجرا، نتیجه نهایی یکسانی دارند؛ برای مثال، دریافت وضعیت یک وظیفه معمولاً تکرارپذیر است، اما ایجاد وظیفه جدید لزوماً چنین ویژگی‌ای ندارد.
این رفع خطای MCP برای توسعه‌دهندگانی اهمیت بیشتری دارد که Claude Code را به پایگاه داده، سامانه تیکتینگ یا سرویس پرداخت متصل کرده‌اند. پیش‌تر، قطع ارتباط در میانه درخواست می‌توانست وضعیت نامشخصی بسازد؛ یعنی کلاینت مطمئن نبود سرور عملیات را اجرا کرده است یا خیر.
با وجود این اصلاح، بهتر است ابزارهای سفارشی MCP همچنان از شناسه یکتای درخواست، ثبت لاگ و کنترل عملیات تکراری استفاده کنند. همچنین مجوز ابزارهای تغییردهنده را جداگانه بازبینی کنید؛ راهنمای امنیت MCP در Claude Code نکات تکمیلی مفیدی ارائه می‌دهد.
تله‌متری رویدادهای ایمنی چگونه شفاف‌تر شد؟
در Claude Code 2.1.307 رویداد OpenTelemetry جدید claude_code.safety_event امکان مشاهده منظم‌تر مداخله‌های ایمنی را فراهم می‌کند. در نتیجه، تیم‌های توسعه بهتر می‌فهمند چرا اجرای یک ابزار متوقف شده، به تأیید کاربر نیاز داشته یا برای اصلاح بازگردانده شده است.
این رویداد هنگام مداخله قانون مجوز، Auto Mode، بررسی ایمنی، Hook یا Sandbox ثبت می‌شود. بنابراین به‌جای اتکا به گزارش کاربران، می‌توان الگوهای توقف فراخوانی ابزارها را در زیرساخت مانیتورینگ OpenTelemetry بررسی کرد.
- ممیزی بهتر: تشخیص اینکه کدام سازوکار ایمنی بیشتر وارد عمل شده است.
- عیب‌یابی سریع‌تر: تفکیک محدودیت امنیتی از خطای عادی ابزار یا اتصال.
- اصلاح سیاست‌ها: شناسایی مجوزهای بیش‌ازحد سخت‌گیرانه یا گردش‌کارهای پرریسک.
برای نمونه، افزایش توقف فرمان‌های پوسته می‌تواند نشانه نیاز به بازبینی قوانین مجوز یا نحوه تعریف وظیفه باشد. مدیران فنی همچنین می‌توانند اثر تغییر تنظیمات را پیش و پس از استقرار مقایسه کنند؛ بدون آنکه صرفاً رفتار ظاهری نشست را معیار قرار دهند.
البته تله‌متری جایگزین کنترل دسترسی و بررسی انسانی نیست؛ بلکه لایه‌ای برای مشاهده و ممیزی است. برای درک زمینه این تغییر، مرور Auto Mode و امنیت در Claude Code 2.1.304 نیز مفید است.
رفع خطاهای اتصال MCP پس از خواب سیستم
در Claude Code 2.1.307 اختلالی اصلاح شده که هنگام Sleep شدن macOS یا Linux در میانه اتصال به سرور MCP رخ می‌داد. این مشکل می‌توانست اتصال را منقضی نشان دهد و در اجرای بدون رابط یا Headless، سرور را در وضعیت ناموفق نگه دارد.
- دامنه خطا: اتصال‌های MCP در حال برقراری هنگام خواب سیستم
- محیط‌های درگیر: رایانه‌های macOS و Linux
- اثر اصلاح: جلوگیری از ماندگاری وضعیت Timeout اشتباه پس از بیدارشدن
این رفع خطای MCP برای لپ‌تاپ‌ها و محیط‌های توسعه‌ای اهمیت دارد که مرتب میان حالت فعال و Sleep جابه‌جا می‌شوند. پیش‌تر ممکن بود خواب سیستم به‌اشتباه مانند پایان مهلت واقعی سرور ثبت شود، درحالی‌که علت اصلی توقف موقت شبکه و پردازش‌ها بود.
اثر این اصلاح در اجرای Headless مهم‌تر است؛ زیرا اپراتوری حضور ندارد تا اتصال شکست‌خورده را دستی بررسی کند. کارهای زمان‌بندی‌شده، Runnerهای محلی و فرایندهای خودکار اکنون کمتر در وضعیت شکست کاذب باقی می‌مانند و مدیریت اتصال پس از بیداری مطمئن‌تر می‌شود.
پس از نصب آپدیت Claude Code، یک آزمایش ساده انجام دهید: اتصال MCP را آغاز کنید، سیستم را موقتاً بخوابانید و پس از بیداری وضعیت سرور و لاگ‌ها را کنترل کنید. اگر با سازوکار این ابزار آشنا نیستید، راهنمای Claude Code چیست نقطه شروع مناسبی است.
این تغییر همه Timeoutها را حذف نمی‌کند؛ خطاهای واقعی شبکه، تنظیمات اشتباه سرور یا احراز هویت همچنان باید جداگانه بررسی شوند. بنابراین هنگام عیب‌یابی، زمان Sleep سیستم را با لاگ اتصال تطبیق دهید تا اختلال محلی از مشکل واقعی MCP تفکیک شود.
منابع خبر
تاریخ انتشار منبع اصلی:
ناشر: گپ‌جی‌پی‌تی · سیاست تحریریه و اصلاحات · تماس با تحریریه
Claude و مدل‌های برتر را یک‌جا تجربه کن
با انتخاب پلن مناسب، به ابزارهای هوش مصنوعی دسترسی داشته باش و سریع‌تر و حرفه‌ای‌تر کار کن.
