اتصال به برنامه‌ها

سیستم‌عامل و برنامه‌تان را انتخاب کنید؛ راهنمای قدم‌به‌قدم با کلید و مدل خودتان آماده می‌شود.

۱ سیستم‌عامل

۲ برنامه

برای اپ رسمی Claude فقط مدل‌های Claude قابل استفاده است؛ برای گفتگو با GPT روی دسکتاپ از Cherry Studio استفاده کنید.

1. ۱

   انتخاب یا ساخت کلید API

   از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمه‌ی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر می‌شوند.

   کلید کامل فقط یک بار، هنگام ساخت، نمایش داده می‌شود. آن را در جای امنی نگه دارید و در گروه‌ها یا اسکرین‌شات‌ها منتشر نکنید.

2. ۲

   نصب Node.js

   Claude Code با Node.js نسخه‌ی ۱۸ یا بالاتر اجرا می‌شود. اگر نصب ندارید، نسخه‌ی LTS را از nodejs.org دانلود و نصب کنید. ترمینال را باز کنید (معمولاً Ctrl+Alt+T). و نسخه را بررسی کنید:

   ترمینال کپی

   node -v

   اگر عددی مثل v22.x دیدید آماده‌اید. اگر خطای «not recognized» گرفتید، بعد از نصب Node.js ترمینال را بسته و دوباره باز کنید.

3. ۳

   نصب Claude Code

   ترمینال کپی

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

   اگر خطای دسترسی (EACCES) گرفتید، Node.js را با nvm نصب کنید یا دستور را با sudo اجرا کنید.

4. ۴

   ساخت فایل تنظیمات

   تنظیمات اتصال را در فایل ~/.claude/settings.json می‌گذاریم تا هر بار که Claude Code را باز می‌کنید خودکار اعمال شود. این دستور فایل را باز می‌کند:

   ترمینال کپی

   mkdir -p ~/.claude
   nano ~/.claude/settings.json

5. ۵

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

   کل محتوای فایل را با متن زیر جایگزین و ذخیره کنید:

   settings.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 را اضافه می‌کند. خط آخر ارتباط‌های غیرضروری Claude Code با سرورهای Anthropic (آمار و گزارش خطا) را خاموش می‌کند تا در ایران گیر نکند.

6. ۶

   اجرا

   ترمینال را ببندید و دوباره باز کنید، به پوشه‌ی پروژه بروید و Claude Code را اجرا کنید:

   ترمینال کپی

   cd ~/path/to/your/project
   claude

   داخل Claude Code دستور /status را بزنید؛ باید آدرس https://api.2928.ir را نشان دهد. با /model می‌توانید بین Opus، Sonnet و Haiku جابه‌جا شوید.

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