API هوش مصنوعی

آموزش اتصال Claude Code به API (ویندوز)

این راهنما مخصوص ویندوز ۱۰ و ۱۱ و برنامه Claude Code است. با دنبال کردن این ۶ قدم، Claude Code رو به آدرس https://api.2928.ir وصل می‌کنی.

۱۷ مهر ۱۴۰۵ ۲ دقیقه مطالعه ۳ بازدید
آموزش اتصال Claude Code به API (ویندوز)
فهرست مطالب
  1. قدم ۱: انتخاب یا ساخت کلید API
  2. قدم ۳: نصب Claude Code
  3. قدم ۴: ساخت فایل تنظیمات
  4. قدم ۵: وارد کردن آدرس، کلید و مدل
  5. قدم ۶: اجرا و تست

قدم ۱: انتخاب یا ساخت کلید API

  • از بالای صفحه، کلید کامل خودت رو کپی کن.

  • یا روی دکمه «ساخت کلید جدید برای این برنامه» بزن تا یک کلید تازه ساخته بشه.

  • مهم: کلید کامل فقط یک‌بار نمایش داده می‌شه. اون رو در جای امنی نگه دار و هیچ‌جا منتشر نکن.

قدم ۲: نصب Node.js

Claude Code به Node.js نسخه ۱۸ یا بالاتر نیاز داره.

  1. برو به سایت nodejs.org و نسخه LTS رو دانلود و نصب کن.

  2. PowerShell رو باز کن (کلید Win رو بزن، تایپ کن PowerShell و Enter بزن).

  3. این دستور رو اجرا کن:

node -v

اگر عددی مثل v22.x دیدی، آماده‌ای.

اگر خطای «not recognized» گرفتی، ترمینال رو ببند و دوباره باز کن.

قدم ۳: نصب Claude Code

در همون PowerShell این دستور رو بزن:

PowerShell

npm install -g @anthropic-ai/claude-code

اگر خطای Execution Policy گرفتی، اول این دستور رو بزن و بعد دوباره نصب کن:

PowerShell

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

قدم ۴: ساخت فایل تنظیمات

باید فایل تنظیمات رو در مسیر درست بسازی تا هر بار Claude Code خودکار تنظیمات رو بخونه.

این دو دستور رو یکی‌یکی اجرا کن:

PowerShell

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
notepad "$env:USERPROFILE\.claude\settings.json"

با دستور دوم، Notepad باز می‌شه.

قدم ۵: وارد کردن آدرس، کلید و مدل

کل محتوای فایل settings.json رو پاک کن و این متن رو دقیقاً جایگزین کن (کلید خودت رو به جای sk-... بذار):

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.2928.ir",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

نکته‌های مهم:

  • آدرس رو بدون /v1 بنویس (Claude Code خودش /v1/messages رو اضافه می‌کنه).

  • خط آخر ارتباط‌های غیرضروری با سرورهای Anthropic رو خاموش می‌کنه تا در ایران گیر نکنه.

  • فایل رو ذخیره کن و Notepad رو ببند.

قدم ۶: اجرا و تست

  1. ترمینال رو کامل ببند و دوباره باز کن.

  2. برو به پوشه پروژه‌ات:

PowerShell

cd C:\path\to\your\project

  1. Claude Code رو اجرا کن:

PowerShell

claude

  1. داخل Claude Code این دستور رو بزن:

text

/status

باید آدرس https://api.2928.ir رو نشون بده.

با دستور /model می‌تونی بین Opus، Sonnet و Haiku جابه‌جا بشی.

اگر Claude Code ازت خواست وارد حساب Anthropic بشی، یعنی فایل تنظیمات درست خونده نشده. مسیر فایل و صحت JSON رو چک کن.

اشتراک‌گذاری: تلگرام X
همین حالا امتحانش کنید

بعد از ثبت‌نام ۱٬۰۰۰٬۰۰۰ توکن اعتبار تست رایگان می‌گیرید.

شروع رایگان

نظرات

هنوز نظری ثبت نشده؛ اولین نفر باشید.

برای ثبت نظر وارد شوید.