پایان‌پوشه API کلود کد برای گیت‌وی‌های سوم‌طرف با مدل‌های باز‌منظور چین

کلود کد می‌تواند برای ارتباط با یک پایگاه داده‌ای مشابه آنتروپیک (Anthropic) پیکربندی شود، در عوض از طریق یک پایگاه داده مستقیم از یک ارائه‌دهنده استفاده کند. این امکان را فراهم می‌کند تا یک کارآموزی مدیریت شده توسط گیت‌وی را با مدل‌های ID موجود در گیت‌وی، از جمله مدل‌های باز‌منظور چین موجود در فهرست مدل‌های فعلی ECAIX، تست کنید.

این راهنما دربارهٔ یک کارآموزی سازگاری خاص به ارائه‌دهنده است. مستندات رسمی گیت‌وی کلود کد آنتروپیک را توضیح می‌دهد که آنتروپیک پشتیبانی از روتینگ کلود کد به مدل‌های غیرکلود از طریق گیت‌وی را ندارند. ECAIX ادعا نمی‌کند که این کارآموزی توسط آنتروپیک رسمی پشتیبانی می‌شود، و یک مدل غیرکلود ممکن است تمام قابلیت‌های کلود کد را ارائه ندهد.

راه‌اندازی سریع

اگر به مرز سازگاری آگاه هستید، ابتدا از این مسیر کوتاه استفاده کنید:

1. در فهرست مدل‌های فعلی ECAIX مدل فعال را انتخاب کنید.
2. یک کلید API ECAIX ایجاد کنید و آن را از کنترل نسخه خارج نگه دارید.
3. ANTHROPIC_BASE_URL را به https://ecaix.com/api/ai/v1/anthropic تنظیم کنید.
4. درخواست تشخیص زیر را ارسال کنید و وضعیت HTTP را ثبت کنید.
5. در یک پروژه آزمایشی خوانا با استفاده از claude -p کلود کد را اجرا کنید.
6. ابزارها، جریان داده، محدودیت‌های متن و مجوزها را به صورت جداگانه تست کنید.

وضعیت تأیید در انتشار

این جدول عمداً است: یک نمونه پیکربندی یک نمونه سازگاری اندازه‌گیری نیست.

تغییرات این پیکربندی

این پیکربندی چهار قسمت جداگانه دارد:

1. کلود کد به عنوان یک کلاینت که وظایف برنامه‌نویسی را ایجاد و درخواست‌ها را ارسال می‌کند.
2. گیت‌وی مشابه آنتروپیک که درخواست‌ها را در یک پایگاه داده‌ای مشابه آنتروپیک دریافت می‌کند.
3. ID مدل که مدل پشت سر گیت‌وی را انتخاب می‌کند.
4. کلید API که درخواست را تأیید می‌کند و حساب، سقف و مجوزها را تعیین می‌کند.

تغییر پایگاه داده کلود کد را به یک مدل غیرکلود تبدیل نمی‌کند. تنها تغییر این است که کدام سطح API سازگار با دریافت درخواست‌ها می‌پذیرد. استفاده از ابزارها، مدیریت متن، نام‌های مدل، رفتار جریان داده و جریان مجوزها ممکن است به نسخه کلاینت و پیاده‌سازی گیت‌وی بستگی داشته باشد.

قبل از شروع

نیازهای زیر را دارید:

• یک نصب کلود کد که از پیکربندی پایگاه داده یا تنظیمات محیطی پشتیبانی می‌کند.
• یک کلید API ECAIX.
• یک ID مدل که در حال حاضر در فهرست مدل‌های ECAIX موجود است.
• یک ترمینال که می‌توانید یک درخواست کوچک را بدون قرار دادن کلید API در کنترل نسخه اجرا کنید.

فهرست مدل‌ها با زمان تغییر می‌کند. قبل از کپی کردن یک ID مدل به فایل پیکربندی، در دایرکتوری مدل‌های ECAIX مطمئن شوید که مدل فعال و برای سبک APIی که قصد استفاده از آن را دارید، موجود است.

پیکربندی گیت‌وی پایگاه داده

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

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ecaix.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_ECAIX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
  },
  "model": "deepseek-v4.1-flash"
}

فایل فوق را به یک رپوزیتوری عمومی ارسال نکنید اگر کلید API واقعی داشته باشید. ترجیحاً از یک متغیر محیطی محلی، یک مدیریت کلیدهای امن یا مکانیزم تأیید شده توسط نصب کلود کد خود استفاده کنید.

در یک جلسه اسکریپت نیز می‌توانید پایگاه داده را پیکربندی کنید:

export ANTHROPIC_BASE_URL="https://ecaix.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_ECAIX_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"

نام متغیرها و تنظیمات پشتیبانی شده توسط یک نسخه خاص کلود کد ممکن است تغییر کنند. اگر کلاینت مدل ANTHROPIC_MODEL را نادیده بگیرد، از فیلد مدل یا مکانیزم نام‌گذاری مدل مستند شده توسط نسخه خود استفاده کنید. گیت‌وی همچنان باید آخرین ID مدل را شناسایی کند.

اولویت‌بندی پایگاه داده مشابه آنتروپیک

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

دستور زیر پاسخ‌های سرور و پاسخ را به صورت جداگانه ذخیره می‌کند، سپس وضعیت HTTP را چاپ می‌کند. از کلید مجاز فقط در ترمینال خود استفاده کنید؛ هرگز آن را در مقاله، ایسوئ، یا لوج اشتراکی کپی نکنید.

curl -sS -D /tmp/ecaix-anthropic-headers.txt \
  -o /tmp/ecaix-anthropic-response.json \
  -w '\nHTTP %{http_code}\n' \
  "${ANTHROPIC_BASE_URL}/messages" \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ]
  }'

تفسیر انتظار شده:

• 200: بررسی شکل پاسخ و تأیید فیلدهای مدل یا استفاده را انجام دهید.
• 401 یا 403: قبل از تغییر پرسش، کلید، سرور، حساب و محدوده مجوز را بررسی کنید.
• 404: پایگاه داده اصلی، پسوند /messages و deploy کردن پایگاه داده را بررسی کنید.
• 400: درخواست را به کوچک‌ترین بدن معتبر کاهش دهید و فیلدهای خاص مدل را بررسی کنید.
• 5xx یا زمان‌بندی: زمان ارسال درخواست و پاسخ را ثبت کنید و سپس رفتار زمان‌بندی گیت‌وی، مدل پشت سر و کلاینت را جدا کنید.

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

انتخاب ID مدل

فهرست ECAIX شامل خانواده‌های مدل از ارائه‌دهندگان چینی است. مدل مناسب آغازین به کار بستگی دارد، نه فقط به نام مدل.

برنامه‌نویسی و توسعه عمومی

از مدل‌های فعلی DeepSeek، Qwen، GLM یا Seed که قابلیت برنامه‌نویسی دارند و در فهرست موجود هستند، شروع کنید. برای مثال، یک فهرست ممکن است IDs مانند deepseek-v4.1-flash, qwen3.8-flash, glm-5.3 یا seed-2.0-code را ارائه دهد. امکانات و دسترسی‌ها ممکن است تغییر کنند، بنابراین همیشه قبل از انتشار یک پیکربندی، صفحه مدل فعلی را بررسی کنید.

کار با متن طولانی و کار با رپوزیتوری

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

فراخوانی ابزارها و کارآموزی‌های ایجنت

اگر کارآموزی نیاز به فراخوانی ابزارها یا ابزارها دارد، مستندات مدل و پایگاه داده را بررسی کنید. برخی از ارائه‌دهندگان از طریق APIs مشابه OpenAI فراخوانی ابزارها را ارائه می‌دهند، در حالی که برخی دیگر نام‌های فیلد متفاوتی را ارائه می‌دهند یا فقط یک زیر مجموعه از رفتار ابزارها را پشتیبانی می‌کنند. با یک تست کوچک فراخوانی ابزارها شروع کنید قبل از اینکه مدل به یک رپوزیتوری واقعی یا سیستم خارجی دسترسی داشته باشد.

کار با توسعه در زبان چینی

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

تست کد کلاود پس از موفقیت درخواست API

هنگامی که درخواست مستقیم موفق شود، با یک دستور خوانا یا با ریسک کم شروع کنید:

claude -p "Explain what this repository does without editing files."

سپس یک وظیفه محدود و خاص را تست کنید، مانند:

claude -p "List the likely entry points for the web application. Do not modify files."

از تست‌های به تدریج پیچیده‌تر استفاده کنید:

1. پاسخ متن ساده.
2. توضیح کوتاه کد.
3. ناوبری رپوزیتوری.
4. ویرایش کنترل شده در یک شاخه موقت.
5. استفاده از ابزار یا وظیفه چند مرحله‌ای.
6. رفتار جریان و رفتار متنوع محتوای طولانی.

نکته: یک پاسخ متن موفق نمی‌تواند تضمین کند که رفتارهای مربوط به پرمیشن، فراخوانی ابزار، جریان، محدودیت محتوای طولانی، و ویرایش فایل‌ها دقیقاً مانند یک سیشن با کلاود عمل کنند.

انتخاب مسیر API مناسب

کلاود کد تنها یک کارخانه کارهای API است. مسیر API مناسب به کارخانه و مجموعه ویژگی‌های مورد نیاز شما بستگی دارد:

برای ECAIX، از مستندات پیام‌های انثروپیک برای مسیر سبک انثروپیک و مستندات کمپلیشن چت برای کلاینت‌های سازگار با OpenAI استفاده کنید. از دایرکتوری مدل‌ها برای تأیید مدل فعلی و از صفحه قیمت‌ها برای قیمت‌های نمایش داده شده استفاده کنید.

ماتریس سازگاری

این ماتریس مرز اثباتی در زمان انتشار است، نه یک ادعا که همه ویژگی‌ها پشتیبانی می‌شوند:

این تفکیک از یک درخواست حداقل موفق به عنوان یک گواهی کامل سازگاری کلاود کد جلوگیری می‌کند.

صفحات جزئی مدل و IDs فعلی

از صفحات جزئی مدل استفاده کنید، نه از نام مدل قدیمی که از یک پست وبلاگ کپی شده است:

• DeepSeek v4.1 Flash
• Qwen 3.8 Flash
• GLM 5.3
• Kimi K3

این لینک‌ها راهنمایی برای بررسی ID مدل فعلی، اطلاعات محتوای مدل و جزئیات صفحه هستند. امکانات در زمان انتشار ممکن است تغییر کند.

در صورت خطا، از این ترتیب استفاده کنید، نه تغییر چند متغیر در یکبار:

1. ذخیره وضعیت HTTP و بدن پاسخ.
2. تأیید آدرس پایگاه داده اصلی و پسوند مسیر.
3. تأیید اینکه کلید API محلی وجود دارد و دارای محدوده انتظار است.
4. تأیید ID مدل دقیق در کتالوگ زنده کتالوگ مدل‌ها.
5. مجدداً با درخواست کوچک‌ترین شکل مجاز اجرا کنید.
6. نتیجه را با درخواست کلاینتی که توسط کلاود کد ارسال شده مقایسه کنید.
7. تنها پس از آن به روتینگ، زمان انتظار یا تفاوت‌های اسکیما ابزارهای فرعی بررسی کنید.

برای مدل یافت نشد، این تفاوت بین یک خطا در کلمه‌زنی، یک مشکل در پرمیشن، یک مشکل در روتینگ گیت‌ویث و یک شکست در ارائه دهنده فرعی است. برای 401 و 403، تغییر مدل معمولاً اولین مشکل نیست. برای یک مورد موفقیت متن/خطا ابزار، تست بعدی باید اسکیما ابزار باشد، نه یک پرسش متن ساده دیگر.

خطاها رایج

امنیت و مدیریت داده‌ها

گیت‌ویث را به عنوان یک مرز سرویس جداگانه در نظر بگیرید. قبل از ارسال کد منبع یا داده‌های مشتری، بررسی کنید:

• کدام سرویس درخواست‌ها و محتوای فایل را دریافت می‌کند.
• آیا درخواست‌ها و پاسخ‌ها ثبت می‌شوند؟
• چگونه کلیدهای API ذخیره و چرخش می‌شوند؟
• آیا مسیر مدل یک اتصال فرعی واقعی است یا یک مسیر جایگزین ارائه دهنده دیگر؟
• ابزارهای کدام کلاینت قابل فراخوانی هستند؟
• چگونه پس از تست کلید را لغو کنید.

هرگز کلید تولیدی را در یک ایشو عمومی، مقاله، اسکرین شات یا تاریخچه شل که با دیگران به اشتراک گذاشته می‌شود، کپی نکنید.

چگونه این با پشتیبانی رسمی کلاود کد متفاوت است

مستندات رسمی انثروپیک، Authority برای پشتیبانی کلاود کد هستند. یک گیت‌ویث سوم‌تایمی ممکن است یک فرمت درخواست سازگار را ارائه دهد، اما سازگاری با پشتیبانی رسمی متفاوت است. روش ایمن برای توصیف این کارخانه کار است:

• سازگار با این پیکربندی گیت‌ویث: مسیر، سرآدرس سرور، IDs مدل و ویژگی‌هایی که ECAIX را تست کرده‌اند.
• به‌طور خودکار پشتیبانی نمی‌شود: همه ویژگی‌های کلاود کد، رفتار مدل غیرکلاود، معنای ابزارهای خاص ارائه دهنده و نسخه‌های جدید کلاینت.
• نیاز به تست مجدد پس از تغییرات: امکانات مدل، فیلدهای درخواست، محدودیت‌های محتوای طولانی، جریان، فراخوانی ابزار و قیمت‌ها.

پرسش و پاسخ متداول

آیا برای این کارخانه کار نیاز به ابزاری کلاود دارم؟

این بستگی به نصب کلاود کد، شرایط حساب و پیکربندی گیت‌ویث دارد. این مقاله شرایط ابزاری یا محصول انثروپیک را تغییر نمی‌دهد. مستندات رسمی کلاود کد فعلی و شرایط گیت‌ویث مورد استفاده را بررسی کنید.

آیا می‌توانم هر ID مدل از کتالوگ را استفاده کنم؟

نه. از یک ID مدل استفاده کنید که در حال حاضر قابل مشاهده، فعال و با مسیر و حساب سازگار است. یک مدل ممکن است در کتالوگ موجود باشد اما برای یک سبک API خاص یا کلید خاص غیرقابل دسترس باشد.

آیا یک پایان نقطه سازگار با انثروپیک تضمین فراخوانی ابزار را دارد؟

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

کجا باید مدل‌ها و قیمت‌ها را بررسی کنم؟

از دایرکتوری مدل‌های ECAIX و صفحه قیمت‌ها استفاده کنید. این صفحات منبع حقیقی برای امکانات فعلی و قیمت‌های نمایش داده شده هستند؛ از کپی کردن IDs مدل یا قیمت‌های قدیمی از این مقاله خودداری کنید.

خلاصه

یک دنباله ایمن برای ادغام است:

1. مستندات رسمی کلاود کد و گیت‌ویث را خوانید.
2. یک کلید API ECAIX را بدون نمایش عمومی آن ایجاد کنید.
3. از یک ID مدل موجود در /models انتخاب کنید.
4. ANTHROPIC_BASE_URL و کلید را محلی پیکربندی کنید.
5. با یک درخواست حداقل /api/ai/v1/anthropic/messages را تست کنید.
6. کلاود کد را با یک وظیفه خوانا تست کنید.
7. ابزارها، جریان، محتوای طولانی و پرمیشن‌ها را به صورت جداگانه تست کنید.
8. هرگاه کلاینت، گیت‌ویث، مدل یا مسیر تغییر کند، سازگاری را دوباره بررسی کنید.

برای مرحله بعد، مستندات API پیام‌های انثروپیک را مطالعه کنید، کتالوگ مدل‌های فعلی را بررسی کنید و کلید خود را از کلیدهای API ایجاد کنید.

چک لیست عملی سازگاری

در پیش از این که ادغام را برای تیم خود مفید بدانید، نتیجه هر تست را ثبت کنید:

این چک لیست از یک پاسخ موفق به یک سلامت مفیدتر است. یک دروازه می‌تواند یک درخواست متن را پذیرفته اما برای ابزارها، استریمینگ، پنجره‌های متن طولانی یا نام‌های مدل نیاز به تنظیمات متفاوتی داشته باشد.

زمانی که از پیکربندی استفاده نکنید

از این پیکربندی برای رپوزیتوری‌های تولید حساس استفاده نکنید، مگر اینکه در مورد ثبت‌نام، نگهداری، روتینگ و کنترل دسترسی به اطلاعات آشنا باشید. نباید فرض کنید که یک پایان‌نامه سازگار با ارائه‌دهنده، همان رفتار امنیتی، پرس و جو سیستم، مجوز ابزارها یا حساب کردن متن را با ارائه‌دهنده اصلی ارائه می‌دهد. برای کارهای تنظیم‌شده یا محرمانه، بررسی امنیتی داخلی کامل انجام دهید و از یک مسیر deploy که توسط سازمان شما تأیید شده‌است استفاده کنید.

نگهداری پیکربندی در حال حاضر

هنگام هر تغییر زیر، پیکربندی را بررسی کنید:

• کلاود کد از نسخه‌های جدیدی استفاده می‌کند.
• دروازه تغییرات پیاده‌سازی سازگار با انثروپیک خود را تغییر می‌دهد.
• ID مدل تغییر می‌کند، حذف می‌شود یا به مدل سراسری دیگری مرتبط می‌شود.
• محدودیت‌های استریمینگ، ابزارها، متن، یا رفتار خطا تغییر می‌کنند.
• ECAIX مدل‌ها یا محدودیت‌های API نمایش داده شده در کاتالوگ زنده را تغییر می‌دهد.

پیکربندی را در یک پروژه آزمایشی کوچک و مستند نگه دارید. این کار را آسان‌تر می‌کند تا رفتار پس از یک به روزرسانی کلاینت یا مدل را با نگهداری یک رپوزیتوری تولید در معرض خطر نگهداری نکنید.

منابع

• کلاود کد انثروپیک: سایر دروازه‌های LLM
• دокуمنتاسیون API دپ سیک
• قوین شروع سریع
• سازگاری API زیپو با OpenAI