استفاده از Claude Code با Chrome (beta)

این یک ترجمهٔ غیررسمی از مستندات Claude Code است که توسط مسیر تهیه شده. نسخهٔ مرجع و معتبر، مستندات رسمی انگلیسی است.

یادداشت

یکپارچگی با Chrome در نسخه‌ی beta است و در حال حاضر با Google Chrome و Microsoft Edge کار می‌کند. هنوز روی Brave، Arc یا دیگر مرورگرهای مبتنی بر Chromium پشتیبانی نمی‌شود. WSL (Windows Subsystem for Linux) هم پشتیبانی نمی‌شود.

Claude Code با افزونه‌ی مرورگرِ Claude in Chrome یکپارچه می‌شود تا از CLI یا افزونه‌ی VS Code قابلیت‌های خودکارسازیِ مرورگر را در اختیارت بگذارد. کدت را بساز، بعد بدون جابه‌جاییِ کانتکست در مرورگر تستش کن و عیب‌یابی کن.

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

قابلیت‌ها

با اتصالِ Chrome می‌توانی اکشن‌های مرورگری را در یک ورک‌فلوِ واحد به کارهای کدنویسی زنجیر کنی:

• عیب‌یابیِ زنده: خطاهای کنسول و وضعیتِ DOM را مستقیم بخوان، بعد کدی را که آن‌ها را ساخته اصلاح کن
• راستی‌آزماییِ طراحی: یک UI را از روی ماک‌آپِ Figma بساز، بعد آن را در مرورگر باز کن تا تطابقش را بررسی کنی
• تستِ وب‌اپلیکیشن: اعتبارسنجیِ فرم را تست کن، رگرسیون‌های بصری را وارسی کن یا جریان‌های کاربر را راستی‌آزمایی کن
• وب‌اپلیکیشن‌های احرازهویت‌شده: بدون connectorهای API با Google Docs، Gmail، Notion یا هر اپی که واردش شده‌ای کار کن
• استخراجِ داده: اطلاعاتِ ساختاریافته را از صفحه‌های وب بیرون بکش و محلی ذخیره کن
• خودکارسازیِ کارها: کارهای تکراریِ مرورگری مثل ورودِ داده، پرکردنِ فرم یا ورک‌فلوهای چندسایتی را خودکار کن
• ضبطِ نشست: تعامل‌های مرورگری را به‌صورت GIF ضبط کن تا آنچه رخ داده را مستند یا به اشتراک بگذاری

پیش‌نیازها

پیش از استفاده از Claude Code با Chrome، به این‌ها نیاز داری:

• مرورگر Google Chrome یا Microsoft Edge
• افزونه‌ی Claude in Chrome نسخه‌ی ۱.۰.۳۶ یا بالاتر، که در Chrome Web Store برای هر دو مرورگر موجود است
• Claude Code نسخه‌ی ۲.۰.۷۳ یا بالاتر
• یک پلنِ مستقیمِ Anthropic (Pro، Max، Team یا Enterprise)

یادداشت

یکپارچگی با Chrome از طریق ارائه‌دهندگانِ ثالث مانند Amazon Bedrock، Google Cloud Vertex AI یا Microsoft Foundry در دسترس نیست. اگر منحصراً از طریق یک ارائه‌دهنده‌ی ثالث به Claude دسترسی داری، برای استفاده از این قابلیت به یک حسابِ claude.ai جداگانه نیاز داری.

شروع در CLI

راه‌اندازیِ Claude Code با Chrome

Claude Code را با پرچمِ --chrome شروع کن:

claude --chrome

همچنین می‌توانی از درونِ یک نشستِ موجود با اجرای /chrome، Chrome را فعال کنی.

از Claude بخواه از مرورگر استفاده کند

این مثال به یک صفحه می‌رود، با آن تعامل می‌کند و آنچه می‌یابد را گزارش می‌دهد، همه از ترمینال یا ویرایشگرت:

Go to code.claude.com/docs, click on the search box,
type "hooks", and tell me what results appear

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

برای VS Code، خودکارسازیِ کارهای مرورگری در VS Code را ببین.

فعال‌کردنِ Chrome به‌صورت پیش‌فرض

برای اینکه مجبور نباشی هر نشست --chrome را پاس بدهی، /chrome را اجرا کن و “Enabled by default” را انتخاب کن.

در افزونه‌ی VS Code، Chrome هر وقت افزونه‌ی Chrome نصب باشد در دسترس است. هیچ پرچمِ اضافه‌ای لازم نیست.

یادداشت

فعال‌کردنِ پیش‌فرضِ Chrome در CLI مصرفِ کانتکست را بالا می‌برد، چون ابزارهای مرورگری همیشه بارگذاری می‌شوند. اگر متوجهِ افزایشِ مصرفِ کانتکست شدی، این تنظیم را غیرفعال کن و فقط هنگام نیاز از --chrome استفاده کن.

مدیریتِ دسترسیِ سایت‌ها

دسترسی‌های در سطحِ سایت از افزونه‌ی Chrome ارث می‌رسند. دسترسی‌ها را در تنظیماتِ افزونه‌ی Chrome مدیریت کن تا کنترل کنی Claude کدام سایت‌ها را بتواند مرور کند، روی آن‌ها کلیک کند و تایپ کند.

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

این مثال‌ها راه‌های رایجِ ترکیبِ اکشن‌های مرورگری با کارهای کدنویسی را نشان می‌دهند. /mcp را اجرا کن و claude-in-chrome را انتخاب کن تا فهرستِ کاملِ ابزارهای مرورگریِ در دسترس را ببینی.

تستِ یک وب‌اپلیکیشنِ محلی

هنگام توسعه‌ی یک وب‌اپ، از Claude بخواه درست‌کارکردنِ تغییراتت را راستی‌آزمایی کند:

I just updated the login form validation. Can you open localhost:3000,
try submitting the form with invalid data, and check if the error
messages appear correctly?

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

عیب‌یابی با لاگ‌های کنسول

Claude می‌تواند خروجیِ کنسول را بخواند تا به تشخیصِ مشکل‌ها کمک کند. به‌جای درخواستِ کلِ خروجیِ کنسول، به Claude بگو دنبالِ چه الگوهایی بگردد، چون لاگ‌ها می‌توانند طولانی باشند:

Open the dashboard page and check the console for any errors when
the page loads.

Claude پیام‌های کنسول را می‌خواند و می‌تواند برای الگوها یا انواعِ خطای مشخص فیلتر کند.

خودکارسازیِ پرکردنِ فرم

کارهای تکراریِ ورودِ داده را سریع‌تر کن:

I have a spreadsheet of customer contacts in contacts.csv. For each row,
go to the CRM at crm.example.com, click "Add Contact", and fill in the
name, email, and phone fields.

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

نگارشِ محتوا در Google Docs

از Claude استفاده کن تا بدون راه‌اندازیِ API مستقیم در اسنادت بنویسد:

Draft a project update based on the recent commits and add it to my
Google Doc at docs.google.com/document/d/abc123

Claude سند را باز می‌کند، داخلِ ویرایشگر کلیک می‌کند و محتوا را تایپ می‌کند. این با هر وب‌اپی که واردش شده‌ای کار می‌کند: Gmail، Notion، Sheets و بیشتر.

استخراجِ داده از صفحه‌های وب

اطلاعاتِ ساختاریافته را از وب‌سایت‌ها بیرون بکش:

Go to the product listings page and extract the name, price, and
availability for each item. Save the results as a CSV file.

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

اجرای ورک‌فلوهای چندسایتی

کارها را میانِ چند وب‌سایت هماهنگ کن:

Check my calendar for meetings tomorrow, then for each meeting with
an external attendee, look up their company website and add a note
about what they do.

Claude میانِ تب‌ها کار می‌کند تا اطلاعات را جمع و ورک‌فلو را تکمیل کند.

ضبطِ یک GIF نمایشی

ضبط‌های قابلِ‌اشتراکِ تعامل‌های مرورگری بساز:

Record a GIF showing how to complete the checkout flow, from adding
an item to the cart through to the confirmation page.

Claude توالیِ تعامل را ضبط و آن را به‌صورت فایلِ GIF ذخیره می‌کند.

عیب‌یابی

افزونه شناسایی نمی‌شود

اگر خطِ setup-issues در Claude Code شاملِ chrome بود:

1. مطمئن شو افزونه‌ی Chrome در chrome://extensions نصب و فعال است
2. با اجرای claude --version مطمئن شو Claude Code به‌روز است
3. بررسی کن که Chrome در حالِ اجراست
4. /chrome را اجرا کن و “Reconnect extension” را انتخاب کن تا اتصال دوباره برقرار شود
5. اگر مشکل ادامه داشت، هم Claude Code و هم Chrome را ری‌استارت کن

اولین باری که یکپارچگیِ Chrome را فعال می‌کنی، Claude Code یک فایلِ پیکربندیِ native messaging host نصب می‌کند. Chrome این فایل را هنگامِ راه‌اندازی می‌خواند، پس اگر افزونه در تلاشِ اول شناسایی نشد، Chrome را ری‌استارت کن تا پیکربندیِ تازه را بردارد.

اگر اتصال هنوز هم برقرار نشد، تأیید کن که فایلِ پیکربندیِ host در این مسیر وجود دارد:

برای Chrome:

• macOS: ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Linux: ~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Windows: در Windows Registry مسیرِ HKCU\Software\Google\Chrome\NativeMessagingHosts\ را بررسی کن

برای Edge:

• macOS: ~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Linux: ~/.config/microsoft-edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Windows: در Windows Registry مسیرِ HKCU\Software\Microsoft\Edge\NativeMessagingHosts\ را بررسی کن

مرورگر پاسخ نمی‌دهد

اگر دستورهای مرورگریِ Claude از کار افتادند:

1. بررسی کن آیا یک دیالوگِ modal (alert، confirm، prompt) صفحه را مسدود کرده است. دیالوگ‌های جاوااسکریپت رخدادهای مرورگر را مسدود می‌کنند و مانعِ دریافتِ دستور توسطِ Claude می‌شوند. دیالوگ را دستی ببند، بعد به Claude بگو ادامه بدهد.
2. از Claude بخواه یک تبِ تازه بسازد و دوباره امتحان کند
3. افزونه‌ی Chrome را با غیرفعال و دوباره‌فعال‌کردنش در chrome://extensions ری‌استارت کن

افتِ اتصال در نشست‌های طولانی

service workerِ افزونه‌ی Chrome ممکن است در نشست‌های طولانی idle شود، که اتصال را قطع می‌کند. اگر ابزارهای مرورگری پس از مدتی بی‌فعالیت از کار افتادند، /chrome را اجرا کن و “Reconnect extension” را انتخاب کن.

مشکلاتِ مختصِ Windows

روی Windows ممکن است با این‌ها روبه‌رو شوی:

• تعارضِ named pipe (EADDRINUSE): اگر فرایندِ دیگری از همان named pipe استفاده می‌کند، Claude Code را ری‌استارت کن. هر نشستِ دیگرِ Claude Code را که شاید از Chrome استفاده می‌کند ببند.
• خطاهای native messaging host: اگر native messaging host هنگامِ راه‌اندازی crash کرد، نصبِ دوباره‌ی Claude Code را امتحان کن تا پیکربندیِ host دوباره ساخته شود.

پیام‌های خطای رایج

این‌ها پرتکرارترین خطاها و راهِ رفعشان هستند:

خطا	علت	رفع
”Browser extension is not connected”	native messaging host نمی‌تواند به افزونه برسد	Chrome و Claude Code را ری‌استارت کن، بعد /chrome را اجرا کن تا دوباره وصل شود
”Extension not detected”	افزونه‌ی Chrome نصب نیست یا غیرفعال است	افزونه را در chrome://extensions نصب یا فعال کن
”No tab available”	Claude پیش از آماده‌شدنِ یک تب تلاش به اکشن کرد	از Claude بخواه یک تبِ تازه بسازد و دوباره امتحان کند
”Receiving end does not exist”	service workerِ افزونه idle شد	/chrome را اجرا کن و “Reconnect extension” را انتخاب کن

همچنین ببین

• Computer use: کنترلِ اپلیکیشن‌های بومیِ macOS وقتی کاری در مرورگر شدنی نیست
• استفاده از Claude Code در VS Code: خودکارسازیِ مرورگر در افزونه‌ی VS Code
• مرجعِ CLI: پرچم‌های خطِ فرمان از جمله --chrome
• ورک‌فلوهای رایج: راه‌های بیشترِ استفاده از Claude Code
• داده و حریمِ خصوصی: اینکه Claude Code چطور داده‌هایت را مدیریت می‌کند
• شروعِ کار با Claude in Chrome: مستنداتِ کاملِ افزونه‌ی Chrome، شاملِ میان‌برها، زمان‌بندی و دسترسی‌ها