اجازه بده Claude از CLI کامپیوترت را به کار بگیرد

computer use به Claude اجازه می‌دهد اپ‌ها را باز کند، صفحه‌ی نمایشت را کنترل کند، و روی ماشینت همان‌طور کار کند که خودت می‌کنی. از CLI، Claude می‌تواند یک اپِ Swift را کامپایل کند، اجرایش کند، روی تک‌تکِ دکمه‌ها کلیک کند و از نتیجه اسکرین‌شات بگیرد — همه در همان گفت‌وگویی که کد را در آن نوشت.

این صفحه نحوه‌ی کارِ computer use در CLI را پوشش می‌دهد. برای اپ Desktop روی macOS یا Windows، computer use در Desktop را ببین.

با computer use چه کارهایی می‌توانی بکنی

computer use کارهایی را انجام می‌دهد که به یک GUI نیاز دارند: هر چیزی که معمولاً مجبوری ترمینال را ترک کنی و دستی انجامش بدهی.

ساخت و اعتبارسنجیِ اپ‌های native: از Claude بخواه یک اپِ menu bar برای macOS بسازد. Claude کدِ Swift را می‌نویسد، کامپایلش می‌کند، اجرایش می‌کند و روی تک‌تکِ کنترل‌ها کلیک می‌کند تا قبل از این‌که حتی بازش کنی، از کارکردنش مطمئن شود.
تستِ سرتاسریِ UI: Claude را به یک اپِ Electron لوکال اشاره بده و بگو «جریانِ onboarding را تست کن». Claude اپ را باز می‌کند، مرحله‌های ثبت‌نام را کلیک می‌کند و از هر مرحله اسکرین‌شات می‌گیرد. نه پیکربندیِ Playwright، نه test harness.
عیب‌یابیِ مشکلاتِ بصری و چیدمان: به Claude بگو «مودال در پنجره‌های کوچک بریده می‌شود». Claude اندازه‌ی پنجره را تغییر می‌دهد، باگ را بازتولید می‌کند، از آن اسکرین‌شات می‌گیرد، CSS را وصله می‌زند و درستیِ رفع‌اشکال را تأیید می‌کند. Claude همان چیزی را می‌بیند که تو می‌بینی.
راندنِ ابزارهای فقط-GUI: با ابزارهای طراحی، پنل‌های کنترلِ سخت‌افزار، iOS Simulator، یا اپ‌های اختصاصی‌ای که هیچ CLI یا API ندارند تعامل کن.

چه زمانی computer use به کار می‌آید

Claude چند راه برای تعامل با یک اپ یا سرویس دارد. computer use گسترده‌ترین و کندترین است، پس Claude اول دقیق‌ترین ابزار را امتحان می‌کند:

اگر برای آن سرویس یک سرور MCP داری، Claude از همان استفاده می‌کند.
اگر کار یک دستورِ shell است، Claude از Bash استفاده می‌کند.
اگر کار مربوط به مرورگر است و Claude in Chrome را راه‌اندازی کرده‌ای، Claude از آن استفاده می‌کند.
اگر هیچ‌کدامِ این‌ها صدق نکرد، Claude از computer use استفاده می‌کند.

کنترلِ صفحه‌ی نمایش برای چیزهایی نگه داشته شده که هیچ‌چیزِ دیگری به آن‌ها دسترسی ندارد: اپ‌های native، شبیه‌سازها، و ابزارهای بدونِ API.

فعال‌سازیِ computer use

computer use به‌صورتِ یک سرورِ MCPِ توکار به نامِ computer-use در دسترس است. به‌صورتِ پیش‌فرض خاموش است تا زمانی که فعالش کنی.

منوی MCP را باز کن

در یک نشستِ تعاملیِ Claude Code، اجرا کن:

/mcp

computer-use را در فهرستِ سرورها پیدا کن. به‌صورتِ غیرفعال نشان داده می‌شود.

سرور را فعال کن

computer-use را انتخاب کن و Enable را بزن. این تنظیم به‌ازای هر پروژه ماندگار است، پس فقط یک‌بار برای هر پروژه‌ای که می‌خواهی در آن computer use داشته باشی این کار را می‌کنی.

مجوزهای macOS را بده

اولین باری که Claude بخواهد از کامپیوترت استفاده کند، یک درخواست برای دادنِ دو مجوزِ macOS می‌بینی:

Accessibility: به Claude اجازه می‌دهد کلیک کند، تایپ کند و اسکرول کند
Screen Recording: به Claude اجازه می‌دهد آنچه روی صفحه‌ات است را ببیند

آن درخواست شاملِ لینک‌هایی برای بازکردنِ پنلِ مربوطه در System Settings است. هر دو را بده، سپس Try again را در همان درخواست بزن. ممکن است macOS از تو بخواهد پس از دادنِ Screen Recording، Claude Code را ری‌استارت کنی.

پس از راه‌اندازی، از Claude بخواه کاری انجام دهد که به GUI نیاز دارد:

Build the app target, launch it, and click through each tab to make
sure nothing crashes. Screenshot any error states you find.

تأییدِ اپ‌ها به‌ازای هر نشست

فعال‌کردنِ سرورِ computer-use به Claude دسترسی به هر اپِ روی ماشینت را نمی‌دهد. اولین باری که Claude در یک نشست به اپِ مشخصی نیاز پیدا کند، یک درخواست در ترمینالت ظاهر می‌شود که این‌ها را نشان می‌دهد:

Claude می‌خواهد کدام اپ‌ها را کنترل کند
هر مجوزِ اضافی که درخواست شده، مثلِ دسترسی به clipboard
چند اپِ دیگر در حین کارِ Claude پنهان خواهند شد

Allow for this session یا Deny را انتخاب کن. تأییدها برای نشستِ جاری دوام می‌آورند. وقتی Claude چند اپ را با هم درخواست می‌کند، می‌توانی همه را یک‌جا تأیید کنی.

اپ‌هایی که دسترسیِ گسترده‌ای دارند یک هشدارِ اضافی در آن درخواست نشان می‌دهند تا بدانی تأییدشان چه چیزی به Claude می‌دهد:

هشدار	شامل
معادلِ دسترسیِ shell	Terminal، iTerm، VS Code، Warp، و دیگر ترمینال‌ها و IDEها
می‌تواند هر فایلی را بخواند یا بنویسد	Finder
می‌تواند تنظیماتِ سیستم را تغییر دهد	System Settings

این اپ‌ها مسدود نیستند. هشدار به تو اجازه می‌دهد تصمیم بگیری آیا کار، آن سطح از دسترسی را توجیه می‌کند یا نه.

سطحِ کنترلِ Claude بسته به دسته‌بندیِ اپ هم فرق می‌کند: مرورگرها و پلتفرم‌های ترید فقط-دیدنی‌اند، ترمینال‌ها و IDEها فقط-کلیک‌اند، و بقیه کنترلِ کامل می‌گیرند. برای تفکیکِ کاملِ سطح‌ها مجوزهای اپ در Desktop را ببین.

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

درکِ این جریان کمکت می‌کند پیش‌بینی کنی Claude چه خواهد کرد و چطور مداخله کنی.

هر بار یک نشست

computer use در حالِ فعال‌بودن، یک قفلِ سراسریِ ماشین را نگه می‌دارد. اگر نشستِ دیگری از Claude Code همین‌حالا از کامپیوترت استفاده می‌کند، تلاش‌های جدید با پیامی شکست می‌خورند که می‌گوید کدام نشست قفل را در اختیار دارد. اول آن نشست را تمام کن یا از آن خارج شو.

اپ‌ها در حین کارِ Claude پنهان می‌شوند

وقتی Claude شروع به کنترلِ صفحه‌ی نمایشت می‌کند، دیگر اپ‌های قابل‌دیدن پنهان می‌شوند تا Claude فقط با اپ‌های تأییدشده تعامل کند. پنجره‌ی ترمینالت قابل‌دیدن می‌ماند و از اسکرین‌شات‌ها کنار گذاشته می‌شود، پس می‌توانی نشست را تماشا کنی و Claude هرگز خروجیِ خودش را نمی‌بیند.

وقتی Claude نوبتش را تمام کند، اپ‌های پنهان‌شده خودکار بازگردانده می‌شوند.

اسکرین‌شات‌ها خودکار کوچک‌سازی می‌شوند

Claude Code هر اسکرین‌شات را پیش از فرستادن به مدل کوچک‌سازی (downscale) می‌کند. لازم نیست رزولوشنِ نمایشگرت را پایین بیاوری یا پنجره‌ها را روی نمایشگرهای Retina یا دیگر نمایشگرهای پررزولوشن تغییر اندازه دهی. یک MacBook Pro ۱۶اینچی در رزولوشنِ بومیِ Retina با ۳۴۵۶×۲۲۳۴ ثبت می‌کند و به حدودِ ۱۳۷۲×۸۸۷ کوچک می‌شود، با حفظِ نسبتِ ابعاد.

هیچ تنظیمی برای تغییرِ اندازه‌ی هدف وجود ندارد. اگر متن یا کنترل‌های روی صفحه پس از کوچک‌سازی برای خواندنِ Claude خیلی کوچک‌اند، به‌جای تغییرِ رزولوشنِ نمایشگرت، اندازه‌شان را در خودِ اپ بزرگ‌تر کن.

هر زمان متوقفش کن

وقتی Claude قفل را به دست می‌گیرد، یک اعلانِ macOS ظاهر می‌شود: «Claude is using your computer · press Esc to stop». از هر جا Esc را بزن تا اکشنِ جاری بلافاصله لغو شود، یا در ترمینال Ctrl+C را بزن. در هر صورت، Claude قفل را آزاد می‌کند، اپ‌هایت را از پنهانی درمی‌آورد و کنترل را به تو برمی‌گرداند.

وقتی کارِ Claude تمام شود، اعلانِ دومی ظاهر می‌شود.

ایمنی و مرزِ اعتماد

گاردریل‌های توکار، ریسک را بدونِ نیاز به پیکربندی کم می‌کنند:

تأیید به‌ازای هر اپ: Claude فقط می‌تواند اپ‌هایی را کنترل کند که در نشستِ جاری تأیید کرده‌ای.
هشدارهای Sentinel: اپ‌هایی که دسترسیِ shell، فایل‌سیستم، یا تنظیماتِ سیستم می‌دهند، پیش از تأییدِ تو علامت‌گذاری می‌شوند.
کنار گذاشتنِ ترمینال از اسکرین‌شات‌ها: Claude هرگز پنجره‌ی ترمینالت را نمی‌بیند، پس پرامپت‌های روی صفحه در نشستت نمی‌توانند به مدل بازخورد بدهند.
escapeِ سراسری: کلیدِ Esc از هر جا computer use را لغو می‌کند، و فشردنِ این کلید مصرف می‌شود تا prompt injection نتواند از آن برای بستنِ دیالوگ‌ها استفاده کند.
فایلِ قفل: هر بار فقط یک نشست می‌تواند ماشینت را کنترل کند.

نمونه ورک‌فلوها

این نمونه‌ها راه‌های رایجِ ترکیبِ computer use با کارهای کدنویسی را نشان می‌دهند.

اعتبارسنجیِ یک buildِ native

پس از اعمالِ تغییرات روی یک اپِ macOS یا iOS، از Claude بخواه در یک پاس کامپایل و تأیید کند:

Build the MenuBarStats target, launch it, open the preferences window,
and verify the interval slider updates the label. Screenshot the
preferences window when you're done.

Claude دستورِ xcodebuild را اجرا می‌کند، اپ را اجرا می‌کند، با UI تعامل می‌کند و آنچه می‌یابد را گزارش می‌دهد.

بازتولیدِ یک باگِ چیدمان

وقتی یک باگِ بصری فقط در اندازه‌های مشخصی از پنجره ظاهر می‌شود، بگذار Claude پیدایش کند:

The settings modal clips its footer on narrow windows. Resize the app
window down until you can reproduce it, screenshot the clipped state,
then check the CSS for the modal container.

Claude اندازه‌ی پنجره را تغییر می‌دهد، حالتِ خراب را ثبت می‌کند و استایل‌شیت‌های مربوطه را می‌خواند.

تستِ یک جریان در شبیه‌ساز

iOS Simulator را بدونِ نوشتنِ XCTest بران:

Open the iOS Simulator, launch the app, tap through the onboarding
screens, and tell me if any screen takes more than a second to load.

Claude شبیه‌ساز را همان‌طور کنترل می‌کند که تو با ماوس می‌کنی.

تفاوت‌ها با اپ Desktop

سطحِ CLI و Desktop همان موتورِ computer use را به اشتراک می‌گذارند، با چند تفاوت:

قابلیت	Desktop	CLI
پلتفرم‌ها	macOS و Windows	فقط macOS
فعال‌سازی	تاگل در Settings > General (زیرِ Desktop app)	فعال‌کردنِ `computer-use` در `/mcp`
فهرستِ اپ‌های رد‌شده	در Settings قابلِ پیکربندی	هنوز در دسترس نیست
تاگلِ بازنمایانِ خودکار	اختیاری	همیشه روشن
یکپارچگیِ Dispatch	نشست‌های ساخته‌شده با Dispatch می‌توانند از computer use استفاده کنند	قابلِ اعمال نیست

عیب‌یابی

«Computer use is in use by another Claude session»

نشستِ دیگری از Claude قفل را در اختیار دارد. کار را در آن نشست تمام کن یا از آن خارج شو. اگر آن نشست کرش کرده باشد، وقتی Claude تشخیص دهد فرایند دیگر در حالِ اجرا نیست، قفل خودکار آزاد می‌شود.

درخواستِ مجوزِ macOS مدام دوباره ظاهر می‌شود

macOS گاهی پس از دادنِ Screen Recording، نیاز به ری‌استارتِ فرایندِ درخواست‌کننده دارد. Claude Code را کاملاً ببند و یک نشستِ تازه شروع کن. اگر آن درخواست همچنان باقی ماند، System Settings > Privacy & Security > Screen Recording را باز کن و مطمئن شو اپِ ترمینالت در فهرست هست و فعال است.

`computer-use` در `/mcp` ظاهر نمی‌شود

این سرور فقط روی راه‌اندازی‌های واجدِشرایط ظاهر می‌شود. این‌ها را بررسی کن:

روی macOS هستی. computer use در CLI روی Linux یا Windows در دسترس نیست. روی Windows به‌جایش از computer use در Desktop استفاده کن.
Claude Code نسخه‌ی v2.1.85 یا بالاتر را اجرا می‌کنی. برای بررسی claude --version را اجرا کن.
روی پلنِ Pro یا Max هستی. برای تأییدِ اشتراکت /status را اجرا کن.
از طریقِ claude.ai احراز هویت شده‌ای. computer use با ارائه‌دهنده‌های شخصِ ثالث مثلِ Amazon Bedrock، Google Cloud Vertex AI، یا Microsoft Foundry در دسترس نیست. اگر منحصراً از طریقِ یک ارائه‌دهنده‌ی شخصِ ثالث به Claude دسترسی داری، برای استفاده از این قابلیت به یک حسابِ جداگانه‌ی claude.ai نیاز داری.
در یک نشستِ تعاملی هستی. computer use در حالتِ غیرتعاملی با پرچمِ -p در دسترس نیست.

همچنین ببین

computer use در Desktop: همان قابلیت با یک صفحه‌ی تنظیماتِ گرافیکی
Claude in Chrome: خودکارسازیِ مرورگر برای کارهای مبتنی بر وب
MCP: اتصالِ Claude به ابزارها و APIهای ساختارمند
Sandboxing: این‌که ابزارِ Bashِ Claude چطور فایل‌سیستم و دسترسیِ شبکه را ایزوله می‌کند
راهنمای ایمنیِ computer use: بهترین شیوه‌ها برای computer useِ امن