بازگشت به خانه 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://api.AIVida.ir"
  }
}

سپس 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 مربوط است.

شروع سریع

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

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