اجرای Claude Code با ANTHROPIC_BASE_URL و پیکو هوش
Claude Code را با متغیرهای ANTHROPIC_BASE_URL و کلید پیکو هوش روی اندپوینت سازگار با Anthropic (/v1/messages) اجرا کنید؛ مرحله‌به‌مرحله و با عیب‌یابی.
پیکو هوش·انتشار: ·۶ دقیقه مطالعه
خلاصه: پیکو هوش علاوه بر مسیر OpenAI، اندپوینت سازگار با Anthropic یعنی /v1/messages دارد. Claude Code و SDK رسمی Anthropic را میتوان با تنظیم ANTHROPIC_BASE_URL به آن وصل کرد. نکته: برخلاف کلاینت‌های OpenAI، اینجا Base URL بدون/v1 داده میشود چون کلاینت خودش /v1/messages را اضافه می‌کند.
پیش‌نیاز
نصب Claude Code (طبق مستندات رسمی Anthropic)
کلید پیکو هوش
مدل Claude موجود در کاتالوگ: claude-sonnet-5-5، claude-opus-5-5 یا claude-haiku-5-5
افزونهی Cline را با گزینهی OpenAI Compatible به پیکو هوش وصل کنید؛ تنظیم Base URL، کلید و Model ID، نکات هزینه و امنیت ایجنت کدنویسی.
·۵ دقیقه مطالعه
خبرنامه
آموزش‌ها و تغییرات جدید را به‌موقع بگیرید
فقط مطالب مفید درباره‌ی API هوش مصنوعی؛ بدون هرزنامه.
$env:ANTHROPIC_BASE_URL = "https://api.picoai.ir"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-5-5"
claude
توضیح: ANTHROPIC_AUTH_TOKEN کلید را به‌صورت Bearer می‌فرستد؛ به‌جای آن می‌توانید ANTHROPIC_API_KEY را هم بگذارید (به‌صورت x-api-key). طبق مستندات رسمی، ANTHROPIC_AUTH_TOKEN در هدر Authorization: Bearer و ANTHROPIC_API_KEY در هدر x-api-key فرستاده میشود (هر دو را پیکو هوش میپذیرد). متغیر قدیمی ANTHROPIC_SMALL_FAST_MODEL منسوخ (deprecated) شده و جایگزین آن ANTHROPIC_DEFAULT_HAIKU_MODEL است که کارهای پس‌زمینه را هم انجام می‌دهد؛ برای sonnet و opus هم ANTHROPIC_DEFAULT_SONNET_MODEL و ANTHROPIC_DEFAULT_OPUS_MODEL وجود دارد. با ANTHROPIC_API_KEY در حالت تعاملی یک بار از شما تأیید گرفته میشود تا جایگزین اشتراک شود؛ با ANTHROPIC_AUTH_TOKEN متغیر بلافاصله اولویت دارد. برای دیدن اینکه کدام نشانی و اعتبارنامه فعال است، دستور /status را بزنید (باید خط Anthropic base URL را ببینید). اگر هشدار تداخل با لاگین قبلی دیدید، /logout بزنید. نکته‌ی مستندات: وقتی ANTHROPIC_BASE_URL به میزبانی غیر از api.anthropic.com اشاره کند، قابلیت Remote Control غیرفعال میشود. همچنین Anthropic مسیریابی Claude Code به مدلهای غیر Claude را پشتیبانی نمی‌کند؛ این مقاله فقط مدلهای Claude را نشان می‌دهد.
ذخیره‌ی دائمی
می‌توانید متغیرها را در فایل تنظیمات Claude Code (کلید env در ~/.claude/settings.json) بگذارید تا در هر اجرا خوانده شوند:
اگر مقدار در shell و در env فایل تنظیمات هر دو تعریف شده باشد، مقدار فایل تنظیمات اعمال میشود. اعتبارنامه را در .claude/settings.json پروژه (که commit میشود) نگذارید؛ از ~/.claude/settings.json یا .claude/settings.local.json استفاده کنید.
به یاد داشته باشید این فایل کلید را به‌صورت متن ساده نگه می‌دارد؛ آن را در Git نگذارید.
SDK نیز /v1/messages را خودش به نشانی اضافه می‌کند؛ پس base_url بدون /v1 است.
محدودیت‌ها و نکات
اندپوینت /v1/messages پیام، ابزار (tools با input_schema)، استریم و پارامترهای رایج مثل temperature و top_p را میپذیرد. ویژگی‌های اختصاصی دیگر سرویس Anthropic را فرض نکنید و با تست بسنجید.
Claude Code حجم زیادی زمینه (فایل‌ها، ابزارها) می‌فرستد. هزینه بر اساس توکن‌های واقعی است؛ سقف ماهانه‌ی کلید را تعریف کنید.
بعضی قابلیت‌های اختصاصی سرویس Anthropic (مثل ویژگی‌های بتا یا ابزارهای خاص آن) ممکن است در مسیر سازگار پشتیبانی نشوند. ابتدا روی پروژه‌ی کوچک تست کنید.
استریم در /v1/messages به‌صورت SSE است؛ رجوع به راهنمای SSE.
اگر شبکه‌تان فقط به پیکو هوش دسترسی دارد، CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 ترافیک غیرضروری (به‌روزرسانی خودکار، telemetry و ...) را خاموش می‌کند؛ هر مقدار غیرخالی (حتی 0) آن را فعال می‌کند.
اگر خطای 400 درباره‌ی فیلدهای ناشناخته (مثل Extra inputs are not permitted یا context_management) دیدید، مستندات رسمی تنظیم CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 را پیشنهاد می‌کند.
برای تیم‌ها، به‌جای یک کلید مشترک برای همه، برای هر توسعه‌دهنده کلید جدا بسازید تا مصرف قابل تفکیک و کلید قابل ابطال باشد. روی هر کلید سقف درخواست در دقیقه و سقف ماهانه بگذارید. Claude Code می‌تواند فایل‌ها را بخواند و دستور اجرا کند؛ دسترسی‌ها را در حالت پیش‌فرض (تأیید دستی) نگه دارید و فقط در محیط ایزوله اجازه‌ی اجرای خودکار بدهید.
انتخاب مدل برای کارها
برای کارهای عمومی کدنویسی claude-sonnet-5-5 تعادل خوبی دارد؛ برای وظایف پس‌زمینه و کوتاه (مثل ساخت عنوان یا خلاصه) مدل claude-haiku-5-5 ارزان‌تر است و برای مسائل بسیار پیچیده claude-opus-5-5 را بسنجید. قیمت‌های دقیق هر مدل در صفحه‌ی claude-sonnet-5-5 و pricing آمده است. زمینه‌ی طولانی جلسه‌ها هزینه‌ی توکن ورودی را بالا می‌برد؛ هرجا ممکن است جلسه را با /clear یا /compact سبک کنید (نام دستورها را در نسخه‌ی خود تأیید کنید).
کش پرامپت
بخش ثابت ابتدای پرامپت (مثل دستورهای سیستم و فایل‌های تکراری) ممکن است از کش بهره ببرد و توکن‌های کش‌شده با ۲۵٪ قیمت ورودی حساب می‌شوند. کش‌شدن هر درخواست تضمین‌شده نیست و به مسیر پردازش بستگی دارد. جزئیات حسابداری در تخمین هزینه.
بررسی اینکه ترافیک واقعاً از پیکو هوش می‌گذرد
بعد از تنظیم متغیرها، یک پرسش کوتاه در Claude Code بپرسید و در داشبورد پیکو هوش بررسی کنید که یک رکورد مصرف جدید با مدل انتخابی ثبت شده باشد. اگر رکوردی دیده نشد، احتمالاً متغیرها در همان پوسته‌ای که claude را اجرا می‌کنید تنظیم نشده‌اند یا حساب قبلی هنوز فعال است. با echo $ANTHROPIC_BASE_URL مقدار را بررسی کنید. اگر پروکسی شرکتی دارید، متغیرهای HTTPS_PROXY را هم تنظیم کنید.
سوالات متداول
چرا Base URL بدون /v1 است؟
کلاینت Anthropic مسیر /v1/messages را خودش میسازد. اگر /v1 بگذارید به /v1/v1/messages میرسد و ۴۰۴ میگیرید.
آیا مدلهای غیر Claude را هم میتوان از /v1/messages صدا زد؟
این مسیر ساختار پیام Anthropic را میپذیرد و داخل پیکو هوش به قالب چت تبدیل میشود؛ برای مدلهای Claude توصیه میشود. برای سایر مدلها مسیر OpenAI-سازگار مرجع اصلی و آزمایششدهتر است.