Claude Code کے ایرر کوڈز کا ازالہ

پہلے یہ پہچانیں کہ ایرر کس سطح پر ہے

INSTALL

انسٹالیشن / رن ٹائم

command not found، Node ورژن، npm کی اجازتیں، WSL پاتھ اور native installer کے مسائل۔

AUTH

لاگ ان / تصدیق

OAuth کال بیک، API کلید، Console ادارہ، SSO اور مقامی auth حالت کے مسائل۔

NETWORK

نیٹ ورک / پراکسی

کاروباری پراکسی، فائر وال، سرٹیفکیٹس، ٹائم آؤٹس، 403/429 اور ضروری ڈومینز تک رسائی نہ ہونا۔

عام ایررز اور ان کا حل

claude: command not found

عام وجہ: انسٹالیشن ڈائریکٹری PATH میں شامل نہیں، یا موجودہ shell نے اپنی کنفیگریشن دوبارہ لوڈ نہیں کی۔

حل: نیا ٹرمینل کھولیں، یا Claude Code کی انسٹالیشن ڈائریکٹری کو PATH میں شامل کر کے shell کنفیگریشن دوبارہ لوڈ کریں۔

export PATH="$PATH:$HOME/.local/bin"
source ~/.zshrc

Node version not supported / silent crash

عام وجہ: Node ورژن سرکاری شرط سے کم ہے، یا WSL، Windows والا Node استعمال کر رہا ہے۔

حل: Node اپ گریڈ کریں، یا سرکاری native installer استعمال کریں۔ WSL میں which node / which npm سے پاتھ چیک کر کے یقینی بنائیں کہ یہ Linux ماحول سے آ رہا ہے۔

node -v
which node
which npm

EACCES / permission denied

عام وجہ: گلوبل npm ڈائریکٹری کا مالک root ہے، یا پہلے sudo سے انسٹالیشن کی وجہ سے اجازتیں خراب ہو گئی ہیں۔

حل: Claude Code کو sudo سے انسٹال نہ کریں۔ npm کا پریفکس (prefix) یوزر ڈائریکٹری میں تبدیل کریں، یا native installer استعمال کریں۔

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

Waiting for authentication...

عام وجہ: براؤزر کا OAuth کال بیک مقامی CLI تک نہیں پہنچ رہا — remote SSH، devcontainers، سخت فائر والز یا بلاک شدہ localhost کال بیکس میں یہ عام ہے۔

حل: تصدیق کریں کہ ایک ہی مشین پر براؤزر اور CLI ایک دوسرے تک پہنچ سکتے ہیں۔ ضرورت ہو تو لاگ آؤٹ کریں، Claude Code دوبارہ شروع کریں اور تصدیق دوبارہ مکمل کریں۔

/logout
# 关闭 Claude Code 后重新运行
claude

SELF_SIGNED_CERT_IN_CHAIN / certificate error

عام وجہ: کوئی کاروباری پراکسی یا سیکیورٹی گیٹ وے ایک سیلف سائنڈ CA داخل کر رہا ہے جس پر Node بطور ڈیفالٹ اعتماد نہیں کرتا۔

حل: IT سے کاروباری CA bundle حاصل کریں اور اسے NODE_EXTRA_CA_CERTS کے ذریعے متعین کریں۔

export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem

proxy connection failed / timeout

عام وجہ: پراکسی ویری ایبلز غلط سیٹ ہیں، پراکسی پروٹوکول سپورٹ نہیں ہے، NO_PROXY ہدف ڈومین کو اوور رائیڈ کر رہا ہے، یا کاروباری فائر وال رسائی بلاک کر رہی ہے۔

حل: Claude Code معیاری HTTP/HTTPS پراکسی انوائرنمنٹ ویری ایبلز استعمال کرتا ہے؛ دستاویزات کے مطابق SOCKS پراکسیز سپورٹ نہیں ہیں۔ پہلے HTTPS_PROXY کے ساتھ دوبارہ ٹیسٹ کریں۔

export HTTPS_PROXY=http://proxy.example.com:8080
echo $HTTPS_PROXY
echo $NO_PROXY

403 Forbidden

عام وجہ: ادارے نے Claude Code فعال نہیں کیا، کاروباری وائٹ لسٹ میں موجودہ ایگزٹ شامل نہیں، اکاؤنٹ / علاقے / پالیسی کی پابندیاں لاگو ہیں، یا پراکسی کو مسترد کیا جا رہا ہے۔

حل: ذاتی اکاؤنٹس کے لیے پہلے معاون علاقوں اور اکاؤنٹ کی حالت کی تصدیق کریں؛ کاروباری اکاؤنٹس کے لیے ایڈمن سے Claude Code کی اجازتیں، SSO، IP وائٹ لسٹ اور فائر وال کے قواعد چیک کروائیں۔

429 / rate limit

عام وجہ: درخواستیں بہت جلدی جلدی بھیجی جا رہی ہیں، بیک وقت درخواستوں کی تعداد بہت زیادہ ہے، یا اکاؤنٹ کے پلان یا ادارے کی ریٹ لمٹ پوری ہو گئی ہے۔

حل: بیرونی سطح پر بیک وقت درخواستیں کم کریں، دوبارہ کوشش کے لوپس روکیں اور حد ری سیٹ ہونے کا انتظار کریں۔ رفتار زبردستی بڑھانے کے لیے Claude Code کو متعدد workers میں نہ لپیٹیں۔

API key not recognized / SSO mismatch

عام وجہ: API کلید کسی دوسرے shell سے آئی ہے، Console کلید OAuth سیشن سے متصادم ہے، یا ادارہ SSO لاگ ان کا تقاضا کرتا ہے۔

حل: چیک کریں کہ آیا ANTHROPIC_API_KEY موجودہ shell میں سیٹ ہے۔ کاروباری اکاؤنٹس کو ایڈمن کا مقرر کردہ Console/SSO لاگ ان کا طریقہ اپنانا چاہیے۔

echo $ANTHROPIC_API_KEY

پراکسی اور کاروباری نیٹ ورک کی بنیادی ترتیب

سرکاری دستاویزات کے مطابق Claude Code معیاری HTTPS_PROXY / HTTP_PROXY / NO_PROXY انوائرنمنٹ ویری ایبلز کو سپورٹ کرتا ہے، لیکن SOCKS پراکسیز کو سپورٹ نہیں کرتا۔ کاروباری سیلف سائنڈ سرٹیفکیٹس کے لیے NODE_EXTRA_CA_CERTS کے ذریعے CA bundle متعین کریں۔

export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY="localhost,127.0.0.1"
export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem

کم سے کم ری پروڈکشن کا طریقہ

تصدیق کریں کہ `node -v` سرکاری شرط پوری کرتا ہے، یا Claude Code کا native installer استعمال کریں۔
تمام ریپر اسکرپٹس اور workers بند کریں، اور `claude` صرف ایک ٹرمینل ونڈو میں چلائیں۔
تصدیق کریں کہ پراکسی ویری ایبلز درست سیٹ ہیں: اس کے لیے `echo $HTTPS_PROXY` اور `echo $NO_PROXY` استعمال کریں۔
چیک کریں کہ api.anthropic.com، claude.ai، statsig.anthropic.com اور sentry.io تک رسائی کی فائر وال میں اجازت ہے یا نہیں۔
اگر لاگ ان اٹک جائے تو `/logout` چلائیں اور Claude Code دوبارہ شروع کریں؛ ضرورت ہو تو دوبارہ لاگ ان کرنے سے پہلے مقامی auth فائلیں صاف کر دیں۔

سرکاری حوالہ جات

Claude Code کی کاروباری نیٹ ورک کنفیگریشن

پراکسی، CA، mTLS اور رسائی کے لیے ضروری URLs۔

Claude Code کی انسٹالیشن اور تصدیق کے مسائل کا ازالہ

انسٹالیشن، Node، اجازتوں، پراکسی اور لاگ ان کے عام مسائل کی سرکاری فہرست۔

Claude Code کا ڈیٹا اور ٹیلی میٹری

Statsig، Sentry، /bug اور غیر ضروری ٹریفک بند کرنے کے انوائرنمنٹ ویری ایبلز۔

Claude Code کے عمومی سوالات

کاروباری پراکسیز، Console ادارے اور اجازتوں کے عام مسائل۔