Claude Code و یوتاپن — چرا مستقیم وصل نمی‌شود

Claude Code فقط با API پیام‌محور Anthropic کار می‌کند و یوتاپن آن مسیر را سرو نمی‌کند. توضیح وضعیت، مسیرهای واسط و ابزارهایی که مدل‌های Claude را می‌دهند.

به‌روزرسانی: ۳۱ شهریور ۱۴۰۵

Claude Code را نمی‌شود مستقیم به یوتاپن وصل کرد. این ابزار فقط API پیام‌محور Anthropic (/v1/messages) را می‌فهمد و یوتاپن این مسیر را سرو نمی‌کند. متغیر ANTHROPIC_BASE_URL هم فقط وقتی جواب می‌دهد که آدرس مقصد همان API را ارائه کند.

دقیق‌تر

یوتاپن یک دروازهٔ سازگار با OpenAI است و این مسیرها را دارد: /v1/chat/completions، /v1/completions، /v1/embeddings و /v1/models (سازگاری و مهاجرت). Claude Code انتظار قالب دیگری از درخواست و پاسخ دارد؛ راهنمای رسمی خودش هم می‌گوید یک سرویس واسط (gateway) باید یکی از قالب‌های پیام‌محور Anthropic را ارائه کند.

ولی مدل‌های Claude در یوتاپن هستند. anthropic/claude-sonnet-5، anthropic/claude-opus-5 و anthropic/claude-haiku-4.5 را در هر ابزار سازگار با Chat Completions می‌توانی استفاده کنی — مثلاً opencode، Cline، Kilo Code، Crush یا Aider. محدودیت مربوط به خود برنامهٔ Claude Code است، نه به مدل‌ها.

واسط‌های شخص ثالث

پروژه‌های متن‌بازی وجود دارند که روی لپ‌تاپ خودت اجرا می‌شوند، درخواست پیام‌محور را می‌گیرند و به Chat Completions ترجمه می‌کنند (مثل پروکسی LiteLLM یا claude-code-router). این‌ها می‌توانند Claude Code را به هر سرویس سازگار با OpenAI وصل کنند، ولی:

  • ما آن‌ها را تست نکرده‌ایم و پشتیبانی نمی‌کنیم؛
  • کلید یوتاپن‌ات از یک لایهٔ اضافه رد می‌شود، پس فقط روی ماشین خودت و با کلیدی با سقف ماهانه‌ی محدود این کار را بکن (کلیدها)؛
  • سازندهٔ Claude Code هم هدایت این ابزار به مدل‌های غیر خودش را پشتیبانی نمی‌کند.

اگر روزی مسیر پیام‌محور به یوتاپن اضافه شود، همین صفحه به‌روزرسانی می‌شود. فهرست ابزارهایی که امروز کار می‌کنند در یکپارچه‌سازی است. مقایسهٔ Claude Code با opencode و Cline و راه‌اندازی قدم‌به‌قدم را در راهنمای Claude Code در ایران نوشته‌ایم.

هنوز کلید API نداری؟

با شماره موبایل ثبت‌نام کن، کیف پول را از ۱۰۰٬۰۰۰ تومان شارژ کن و کلید بساز. مدل‌های رایگان بدون شارژ هم کار می‌کنند — تا ۵۰ درخواست در روز. ساخت کلید API ←