اتصال Claude Code به پیکو هوش

Claude Code ابزار خط‌فرمان Anthropic برای کدنویسی در ترمینال است. این ابزار از قالب پیام‌های Anthropic استفاده می‌کند و آدرس پایه‌اش را با متغیر ANTHROPIC_BASE_URL می‌توان عوض کرد. پیکو هوش نقطه‌ی /v1/messages با قالب Anthropic دارد، بنابراین Claude Code می‌تواند از طریق کلید پیکو هوش کار کند.

مهم: Claude Code خودش مسیر /v1/messages را به آدرس پایه اضافه می‌کند، پس ANTHROPIC_BASE_URL را بدون /v1 تنظیم کنید. نام متغیرها در نسخه‌های جدید ممکن است تغییر کند؛ مستندات رسمی Claude Code را هم نگاه کنید.

پیش‌نیازها

• یک حساب پیکو هوش و یک کلید API از داشبورد (کلید فقط یک‌بار کامل نمایش داده می‌شود).
• شناسه‌ی دقیق مدل از کاتالوگ؛ در مثال‌ها از gpt-6-sol و claude-sonnet-5-5 استفاده شده است.
• کمی موجودی در کیف پول تومانی یا اعتبار؛ تعرفه را در صفحه‌ی قیمت‌ها ببینید.

راه‌اندازی گام‌به‌گام

1. ۱نصب Claude Code

   مطابق مستندات رسمی نصب کنید (نیازمند Node.js).

   کپی

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

2. ۲تنظیم متغیرهای محیطی

   آدرس پایه بدون /v1 و کلید پیکو هوش را تنظیم کنید.

   کپی

   export ANTHROPIC_BASE_URL="https://api.picoai.ir"
   export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
   # اگر نسخه‌ی شما فقط ANTHROPIC_API_KEY را می‌شناسد:
   # export ANTHROPIC_API_KEY="YOUR_API_KEY"

3. ۳انتخاب مدل

   نام مدل را با متغیر ANTHROPIC_MODEL یا دستور /model تعیین کنید.

   کپی

   export ANTHROPIC_MODEL="claude-sonnet-5-5"
   claude

4. ۴تنظیم دائمی در settings.json

   می‌توانید همین متغیرها را در فایل تنظیمات کاربر هم بگذارید.

   کپی

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://api.picoai.ir",
       "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
       "ANTHROPIC_MODEL": "claude-sonnet-5-5"
     }
   }

تست سریع اتصال

پیش از نوشتن منطق برنامه، یک بار فهرست مدل‌ها را بگیرید. اگر پاسخ ۲۰۰ و فهرستی از شناسه‌ها برگشت، کلید، شبکه و آدرس درست است و هر مشکل بعدی مربوط به تنظیمات Claude Code خواهد بود.

curl https://api.picoai.ir/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

نکته‌های کاربردی برای Claude Code

• برای مدل سبک پس‌زمینه ممکن است Claude Code مدل دوم هم بخواهد؛ نام مدل اقتصادی کاتالوگ را در متغیر مربوط بنویسید.
• نشست‌های کدنویسی زمینه‌ی بزرگ ارسال می‌کنند؛ سقف ماهانه برای کلید مخصوص این ابزار بگذارید.
• قابلیت‌هایی که به سرویس‌های خود Anthropic وابسته‌اند (مثل ورود با حساب) با کلید سفارشی ممکن است در دسترس نباشند.

عیب‌یابی

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

هر درخواست قبل از اجرا مقداری از موجودی را رزرو می‌کند و پس از پاسخ موفق بر پایه‌ی توکن‌های واقعی تسویه می‌شود؛ مابه‌التفاوت برمی‌گردد و درخواست ناموفق چیزی کم نمی‌کند. جدول قیمت هر مدل در صفحه‌ی قیمت‌ها منتشر شده و مصرف هر درخواست در داشبورد قابل مشاهده است. اگر قبلاً از سرویس دیگری استفاده می‌کردید، راهنمای مهاجرت و صفحه‌ی مقایسه را ببینید.