آموزش سری Claude Code قسمت 6: نحوه احراز هویت - ورود از طریق مرورگر و تنظیم دستی API Key

فرآیند احراز هویت: ورود از طریق مرورگر و تنظیم دستی API Key

پس از نصب Claude Code، برای استفاده باید احراز هویت را تکمیل کنید. باید ابزار را به حساب Anthropic خود متصل کنید. دو روش برای اتصال وجود دارد: ورود از طریق مرورگر و تنظیم دستی API Key. نتیجه نهایی هر دو روش یکسان است، روشی را که راحت‌تر است انتخاب کنید.

روش اول: ورود از طریق مرورگر (توصیه می‌شود)

Claude Code یک دستور احراز هویت خودکار به نام claude login ارائه می‌دهد که مرورگر را باز می‌کند، شما در صفحه وب授权 می‌دهید و سپس به‌طور خودکار اعتبارنامه را به ترمینال برمی‌گرداند.

مراحل:

1. در ترمینال وارد کنید:

bash claude login

1. سیستم یک پیام نمایش می‌دهد و به‌طور خودکار صفحه授权 Anthropic را در مرورگر پیش‌فرض شما باز می‌کند.
   اگر به‌طور خودکار باز نشد، یک لینک در ترمینال چاپ می‌شود که می‌توانید آن را به صورت دستی در مرورگر کپی و باز کنید.

2. در مرورگر وارد حساب Anthropic خود شوید (اگر قبلاً وارد شده‌اید، این صفحه مستقیماً درخواست授权 می‌کند).

3. روی «اجازه» یا «تأیید» کلیک کنید، صفحه مرورگر پیام «احراز هویت موفق، می‌توانید این صفحه را ببندید» را نشان می‌دهد.

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

روش دوم: تنظیم دستی API Key

اگر از سرور بدون رابط گرافیکی، کانتینر استفاده می‌کنید یا نمی‌خواهید از مرورگر برای授权 استفاده کنید، می‌توانید مستقیماً از کنسول Anthropic API Key دریافت کرده و آن را در Claude Code تنظیم کنید.

مراحل:

1. مرورگر را باز کنید، به آدرس https://console.anthropic.com بروید و وارد حساب Anthropic خود شوید.

2. به صفحه API Keys (معمولاً در تنظیمات یا گزینه‌های توسعه‌دهنده) بروید و روی «Create API Key» کلیک کنید.

3. یک نام برای Key انتخاب کنید (مثلاً claude-code-local)، پس از تولید بلافاصله آن را کپی کنید.
   توجه: این Key فقط یک بار نمایش داده می‌شود و پس از بستن صفحه قابل مشاهده نیست. اگر ذخیره نکردید، کلید قدیمی را حذف کرده و دوباره تولید کنید.

4. به ترمینال برگردید، دو روش برای ارائه Key به Claude Code وجود دارد:

الف. روش متغیر محیطی:

bash export ANTHROPIC_API_KEY=your-api-key

این خط را به ~/.bashrc یا ~/.zshrc خود اضافه کنید تا هر بار به‌طور خودکار اعمال شود.

ب. روش نوشتن در فایل پیکربندی:

Claude Code همچنین فایل پیکربندی خود را می‌خواند. فایل ~/.claude/config.json را به صورت دستی ویرایش کنید (اگر وجود ندارد، ایجاد کنید) و بنویسید:

json { "apiKey": "your-api-key" }

توجه: توصیه می‌شود مجوز این فایل را به 600 تنظیم کنید (chmod 600 ~/.claude/config.json) تا سایر کاربران نتوانند آن را بخوانند.

1. تست اتصال:

bash claude "سلام، لطفاً یک 'OK' پاسخ بده"

اگر پاسخ عادی دریافت کردید، Key به درستی تنظیم شده است.

اشتباهات رایج در تنظیم دستی:

• آیا Key نباید با sk-ant- یا sk- شروع شود؟ نه، API Key Anthropic در واقع یک رشته طولانی است که با sk-ant-api03- شروع می‌شود. هنگام کپی کردن کاراکترها را جا نیندازید.
• اگر هم متغیر محیطی و هم فایل را تنظیم کنید، متغیر محیطی اولویت بالاتری دارد. فقط یکی را نگه دارید تا از سردرگمی جلوگیری شود.
• Key یک اعتبارنامه هزینه‌دار است، آن را در مخزن Git commits نکنید. توصیه می‌شود با .gitignore کل دایرکتوری ~/.claude یا فایل پیکربندی را نادیده بگیرید.

تغییر حساب یا خروج

برای تغییر حساب یا پاک کردن اعتبارنامه محلی:

• اگر از claude login استفاده کرده‌اید: دستور claude logout را اجرا کنید، سپس دوباره claude login کنید.
• اگر Key را به صورت دستی تنظیم کرده‌اید: متغیر محیطی یا Key قدیمی را در فایل پیکربندی حذف کرده و با Key جدید جایگزین کنید.

تست صحت احراز هویت

claude "توضیح بده دایرکتوری فعلی چه کاری انجام می‌دهد"

اگر بتواند خلاصه پروژه شما را بخواند، به این معنی است که محیط آماده است.