بازگشت به خانه Documentation

راهنمای کامل استفاده از Claude Code با AIVida

در این صفحه، مراحل نصب، تنظیم، نکات امنیتی و عیب‌یابی Claude Code را به شکلی ساده و حرفه‌ای می‌بینید تا سریع و بدون خطا شروع به کار کنید.

منوی سریع

پیش‌نیازها نصب Claude Code تنظیمات AIVida عیب‌یابی

۱) پیش‌نیازها

  • داشتن API Key معتبر از AIVida با پیشوند `sk-`
  • نصب بودن Git روی سیستم
  • سیستم‌عامل پشتیبانی‌شده: Windows، Linux یا macOS

۲) نصب Claude Code

در ویندوز می‌توانید نصب را با PowerShell انجام دهید: 

irm https://claude.ai/install.ps1 | iex

بعد از نصب، نسخه را بررسی کنید: 

claude --version

۳) تنظیم Claude Code برای AIVida

فایل تنظیمات را ایجاد یا ویرایش کنید:

  • Windows: %USERPROFILE%\.claude\settings.json
  • macOS / Linux: ~/.claude/settings.json

محتوای فایل: 

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-AIVida-key",
    "ANTHROPIC_BASE_URL": "https://your-domain.example"
  }
}

Base URL باید فقط ریشهٔ دامنه باشد (بدون /v1). برای توسعهٔ محلی ترجیحاً از http://127.0.0.1:7000 استفاده کنید، نه https://localhost:7001 — گواهی dev معمولاً در Node/Claude Code تأیید نمی‌شود.

سپس Claude Code را از مسیر پروژه اجرا کنید: 

cd your-project && claude

نکته امنیتی: کلید API را داخل مخزن Git قرار ندهید، در اسکرین‌شات‌ها ماسک کنید، و دسترسی فایل تنظیمات را فقط برای کاربر سیستم محدود نگه دارید.

۴) عیب‌یابی خطاهای رایج

`settings.json` اعمال نمی‌شود

ترمینال را کامل ببندید و دوباره باز کنید. اگر ادامه داشت، فایل `~/.claude.json` را با مقدار `hasCompletedOnboarding: true` بسازید.

خطای `Invalid API Key` یا پیام `Please run /login`

صحت JSON فایل تنظیمات را بررسی کنید (عدم trailing comma و quote صحیح). اگر قبلاً لاگین رسمی Anthropic داشته‌اید، `logout` انجام دهید و مجدد تست کنید.

نمایش `offline` در وضعیت

این وضعیت لزوماً به معنی مشکل در AIVida نیست و معمولاً به بررسی اتصال خارجی Claude Code مربوط است.

`API Error: 405` (no body)

معمولاً یعنی درخواست با متد HTTP اشتباه به API رفته (مثلاً GET به‌جای POST) یا ANTHROPIC_BASE_URL اشتباه است.

Base URL: فقط ریشهٔ دامنه — https://your-domain.com یا برای محلی http://127.0.0.1:7000 — بدون پسوند /v1 و بدون اسلش اضافه در انتها.

Claude Code باید POST /v1/messages و POST /v1/messages/count_tokens بزند؛ با مرورگر آدرس را باز نکنید (GET می‌شود و 405 می‌گیرید).

`SSL certificate verification failed` در VS Code

این خطا از Claude Code روی سیستم شما است (قبل از رسیدن درخواست به API AIVida). یعنی TLS به آدرس ANTHROPIC_BASE_URL تأیید نشده است.

توسعهٔ محلی: در settings.json مقدار "ANTHROPIC_BASE_URL": "http://127.0.0.1:7000" بگذارید (پورت مطابق launchSettings.json). اگر حتماً HTTPS می‌خواهید: dotnet dev-certs https --trust و VS Code/ترمینال را کامل ببندید و دوباره باز کنید.

سرور واقعی: گواهی معتبر از CA عمومی (مثلاً Let's Encrypt)، دامنهٔ صحیح در URL، و زنجیرهٔ کامل (full chain). با مرورگر همان URL را باز کنید؛ اگر هشدار امنیتی دیدید، Claude Code هم رد می‌کند.

پروکسی سازمانی / VPN: اگر ترافیک SSL را intercept می‌کند، CA سازمان را به سیستم اضافه کنید یا موقتاً پروکسی را برای این آدرس خاموش کنید. متغیرهای HTTP_PROXY / HTTPS_PROXY در VS Code را بررسی کنید.

فقط برای تست محلی (ناامن): NODE_TLS_REJECT_UNAUTHORIZED=0 در env — در production استفاده نکنید.

شروع سریع

اگر می‌خواهید سریع شروع کنید، ابتدا نصب را انجام دهید، سپس مقداردهی متغیرهای `ANTHROPIC_AUTH_TOKEN` و `ANTHROPIC_BASE_URL` را تکمیل کنید و یک پروژه تستی را با دستور `claude` اجرا کنید.

بازگشت به خانه شروع استفاده از AIVIDA