مرورگر کار می‌کند اما Claude Code وصل نمی‌شود؟ تنظیم پروکسی ترمینال

Claude در مرورگر باز می‌شود، اما دستور claude در ترمینال به پایان مهلت می‌رسد یا ورود را کامل نمی‌کند؟ ابتدا مطمئن شوید ترمینال واقعاً از پروکسی استفاده می‌کند. افزونه مرورگر، پروکسی سیستم و متغیرهای پوسته تنظیمات جداگانه‌ای هستند.

این راهنما برای CLI مستقل Claude Code است، نه Claude Desktop. همچنان باید حساب واجد شرایط و موقعیت رسمی پشتیبانی‌شده داشته باشید؛ برقراری اتصال این شرایط را تغییر نمی‌دهد.

این تنظیمات موقت برای CLI است که در پیش‌زمینه همین ترمینال اجرا می‌شود. برای --bg یا عامل‌های پس‌زمینه، تنظیمات رسمی جداگانه را دنبال کنید؛ نمی‌توان به ارث‌بری تغییرات بعدی پوسته توسط فرایند ناظر دائمی تکیه کرد.

۱. ابتدا کلاینت را متصل کنید

اشتراک JMS گره‌ها را در کلاینت تنظیم می‌کند. مسیر واقعی درخواست چنین است:

Claude Code → پورت HTTP/mixed محلی کلاینت → گره انتخاب‌شده JMS → سرویس Anthropic.

اشتراک فعلی را به کلاینتی وارد کنید که پروتکل واقعی گره‌ها را پشتیبانی کند. JMS در سال ۲۰۲۶ پروتکل‌هایی را تغییر داده است؛ تصور نکنید کلاینت قدیمی مخصوص Shadowsocks همچنان مناسب است. ابتدا عیب‌یابی VLESS/Reality یا راهنمای Clash Verge را بخوانید.

پورت شنونده محلی HTTP یا mixed را پیدا کنید و کلاینت را روشن نگه دارید. این پورت با پورت سرور دور، نشانی اشتراک، UUID یا کلید عمومی Reality فرق دارد. شنونده را به همین دستگاه محدود کنید؛ نیازی به فعال کردن اشتراک‌گذاری LAN نیست.

طبق مستندات رسمی شبکه، Claude Code از پروکسی HTTP/HTTPS پشتیبانی می‌کند، اما SOCKS را مستقیماً نمی‌پذیرد. شنونده HTTP/mixed را فعال کنید یا کلاینت سازگار دیگری به کار ببرید.

۲. ترمینالی را تنظیم کنید که Claude را اجرا می‌کند

برای آزمایش اول یک ترمینال جدا باز کنید. در دستگاه خود بررسی کنید آیا https_proxy، HTTPS_PROXY، http_proxy، HTTP_PROXY، all_proxy، ALL_PROXY، no_proxy یا NO_PROXY از قبل تنظیم شده‌اند. مقدار آن‌ها را منتشر نکنید؛ نشانی پروکسی ممکن است رمز عبور داشته باشد.

Claude Code نخستین مقدار موجود را به ترتیب https_proxy، HTTPS_PROXY، http_proxy، HTTP_PROXY انتخاب می‌کند. مقدار قدیمی با حروف کوچک ممکن است بر مقدار جدید با حروف بزرگ مقدم باشد. ابزارهای دیگر قواعد متفاوتی دارند؛ ALL_PROXY پشتیبانی SOCKS به Claude اضافه نمی‌کند. پیش از جایگزینی، مقادیر قبلی را خصوصی نگه دارید و تعارض را برطرف کنید.

macOS یا لینوکس: Bash/Zsh

7890 فقط نمونه است. پیش از اجرا آن را با پورت واقعی HTTP/mixed کلاینت جایگزین کنید:

JMS_PROXY_PORT=7890
export HTTPS_PROXY="http://127.0.0.1:${JMS_PROXY_PORT}"
export HTTP_PROXY="$HTTPS_PROXY"
export NO_PROXY="localhost,127.0.0.1,::1"
claude

ویندوز: PowerShell

اینجا نیز 7890 را به پورت واقعی HTTP/mixed تغییر دهید. دستورها را در PowerShell اجرا کنید، نه Command Prompt:

$JmsProxyPort = 7890
$env:HTTPS_PROXY = "http://127.0.0.1:$JmsProxyPort"
$env:HTTP_PROXY = $env:HTTPS_PROXY
$env:NO_PROXY = "localhost,127.0.0.1,::1"
claude

http:// روش اتصال به پروکسی محلی را مشخص می‌کند و HTTPS مقصد را به HTTP بدون رمزنگاری تبدیل نمی‌کند. NO_PROXY درخواست‌های محلی را مستقیم نگه می‌دارد تا بازگشت ورود از مرورگر به CLI برسد.

متغیرها روی همین ترمینال و پردازش‌هایی که از آن اجرا می‌شوند اثر دارند. نشست باز Claude Code تغییرات بعدی پوسته را دوباره نمی‌خواند. خارج شوید، متغیرها را تنظیم کنید و claude را در همین ترمینال دوباره اجرا کنید. تا موفقیت آزمایش، فایل راه‌اندازی پوسته را دائمی تغییر ندهید.

در WSL، کانتینر یا SSH، نشانی 127.0.0.1 به محیط اجرای دستور اشاره دارد، نه لزوماً دستگاهی که کلاینت روی آن است. دسترسی را بررسی کنید و پروکسی را در اینترنت عمومی نکنید.

۳. بدون ارسال اطلاعات محرمانه آزمایش کنید

از Claude Code خارج شوید و آزمایش را در ترمینال تنظیم‌شده اجرا کنید. این درخواست صریحاً از پروکسی محلی به میزبان عمومی API می‌رود و هیچ کلید API نمی‌فرستد.

macOS/Linux:

curl --proxy "$HTTPS_PROXY" --noproxy "localhost,127.0.0.1,::1" --connect-timeout 10 --max-time 20 --output /dev/null --silent --show-error --write-out 'HTTP %{http_code}\n' https://api.anthropic.com/

در ویندوز از curl.exe استفاده کنید تا نام مستعار curl در PowerShell قدیمی مزاحم نشود:

curl.exe --proxy $env:HTTPS_PROXY --noproxy "localhost,127.0.0.1,::1" --connect-timeout 10 --max-time 20 --output NUL --silent --show-error --write-out "HTTP %{http_code}\n" https://api.anthropic.com/

مهلت اتصال ۱۰ ثانیه و کل درخواست ۲۰ ثانیه است. پاسخ HTTP 401، 403 یا 404 همچنان می‌تواند نشانه رسیدن پاسخ HTTP باشد؛ ریشه API یک فراخوانی احراز هویت‌شده مدل نیست. خطا را بخوانید: پاسخ خارج از 2xx به‌تنهایی خرابی پروکسی را ثابت نمی‌کند و دریافت پاسخ، مجاز بودن حساب را نشان نمی‌دهد.

HTTP 000 همراه خطای اتصال یا پایان مهلت یعنی پاسخ عادی HTTP دریافت نشده است. خطاهای گواهی را جداگانه بررسی کنید. اعتبارسنجی TLS را روشن نگه دارید؛ -k اضافه نکنید و بررسی گواهی را غیرفعال نکنید. نشانی اشتراک، کد ورود، توکن یا گزارش خصوصی تشخیص را منتشر نکنید.

۴. بر اساس نشانه، مرحله بعد را انتخاب کنید

با claude --version نسخه را ببینید، claude doctor را اجرا کنید و مطابق روش نصب خود در راهنمای رسمی به‌روز کنید. اشکال نسخه، منقضی شدن ورود و اختلال سرویس می‌تواند شبیه خطای شبکه باشد.

۵. تنظیمات موقت را پاک کنید

اگر متغیرها پیش از آزمایش وجود نداشتند، فقط مقادیر افزوده‌شده را حذف کنید:

Bash/Zsh:

unset HTTPS_PROXY HTTP_PROXY NO_PROXY JMS_PROXY_PORT

PowerShell:

Remove-Item Env:HTTPS_PROXY, Env:HTTP_PROXY, Env:NO_PROXY -ErrorAction SilentlyContinue
Remove-Variable JmsProxyPort -ErrorAction SilentlyContinue

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

انتخاب سرویس اتصال

JMS گره‌هایی برای کلاینت سازگار فراهم می‌کند و کلاینت و تنظیم ترمینال، CLI را متصل می‌کنند. اشتراک Anthropic ارائه نمی‌دهد و تأیید حساب یا جلوگیری از تعلیق را تضمین نمی‌کند. پروکسی محلی مسیر خروج اتصال‌دهنده MCP ابری را نیز تغییر نمی‌دهد.

طرح‌ها و راهنمای دریافت کلاینت را با دستگاه و پروتکل فعلی خود مقایسه کنید. اگر این روش مناسب است، سرویس Just My Socks را ببینید.

افشای همکاری در فروش: ممکن است از خرید از طریق این پیوند کمیسیون دریافت کنیم.