پرش به مطلب اصلی

Claude Code

Claude Code یک عامل کدنویسی (Coding Agent) مبتنی بر ترمینال از شرکت Anthropic است که به صورت مستقیم در محیط ترمینال اجرا می‌شود و می‌تواند فایل‌ها را بخواند، کد بنویسد، تغییرات را اعمال کند و با ابزارهای مختلف تعامل داشته باشد. با استفاده از متیس می‌توانید Claude Code را بدون نیاز به حساب کاربری Anthropic و با کلید API متیس خود راه‌اندازی کنید.

پیش‌نیازها​

روش اول: اتصال مستقیم به مدل‌های Anthropic​

برای استفاده از مدل‌های اصلی Claude از طریق متیس، کافی است دو متغیر محیطی زیر را تنظیم کنید:

export ANTHROPIC_BASE_URL=https://api.metisai.ir/anthropic
export ANTHROPIC_AUTH_TOKEN=<YOUR_METIS_API_KEY>

سپس Claude Code را طبق معمول اجرا کنید:

claude

با این تنظیمات، تمام درخواست‌های Claude Code از طریق متیس به مدل‌های Claude ارسال می‌شود و صورتحساب آن در پنل متیس شما محاسبه خواهد شد.

روش دوم: استفاده از مدل‌های DeepSeek (کاهش هزینه تا ۲۰ برابر)​

چنانچه به دنبال کاهش هزینه‌ها هستید، می‌توانید از مدل‌های DeepSeek به عنوان جایگزین مدل‌های Claude استفاده کنید. مدل‌های DeepSeek کیفیتی نزدیک به مدل‌های Anthropic دارند اما هزینه‌ی آن‌ها تا ۲۰ برابر کمتر است.

برای این کار متغیرهای محیطی زیر را تنظیم کنید:

export ANTHROPIC_BASE_URL=https://api.metisai.ir/deepseek/anthropic
export ANTHROPIC_AUTH_TOKEN=<YOUR_METIS_API_KEY>
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

توضیح متغیرها​

متغیرمقدارتوضیح
ANTHROPIC_BASE_URLhttps://api.metisai.ir/deepseek/anthropicمسیر API متیس که درخواست‌ها را به مدل‌های DeepSeek هدایت می‌کند
ANTHROPIC_AUTH_TOKENکلید API متیس شماکلید احراز هویت (با پیشوند tpsg-)
ANTHROPIC_MODELdeepseek-v4-proمدل پیش‌فرض برای تمام درخواست‌ها
ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-proمدل جایگزین برای Opus (قوی‌ترین مدل)
ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-proمدل جایگزین برای Sonnet (مدل متعادل)
ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flashمدل جایگزین برای Haiku (مدل سریع و سبک)
CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flashمدل مورد استفاده برای زیرعامل‌ها (Sub-agents)
CLAUDE_CODE_EFFORT_LEVELmaxسطح تلاش عامل روی حداکثر (دقت بالاتر)
نکته

مدل deepseek-v4-pro به صورت پیش‌فرض و بدون هیچ پسوندی از پنجره‌ی متنی ۱ میلیون توکن پشتیبانی می‌کند که برای پروژه‌های بزرگ بسیار مناسب است. پسوندی مانند [1m] به نام مدل اضافه نکنید — هر دو مدل DeepSeek به‌طور طبیعی ۱ میلیون توکن پشتیبانی می‌کنند و افزودن این پسوند یک شناسه‌ی نامعتبر می‌سازد؛ در این حالت اندپوینت DeepSeek به‌جای بازگرداندن خطا، به‌صورت خاموش به مدل ارزان‌تر سقوط می‌کند و نتیجه‌ی متفاوتی نسبت به انتظار شما تحویل می‌دهد. مدل deepseek-v4-flash نیز گزینه‌ای سریع‌تر و ارزان‌تر برای وظایف سبک‌تر است.

افزودن دائمی به تنظیمات ترمینال​

برای آنکه این تنظیمات را به صورت دائمی داشته باشید، می‌توانید دستورات export را به فایل پروفایل شل خود اضافه کنید:

echo 'export ANTHROPIC_BASE_URL=https://api.metisai.ir/anthropic' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=<YOUR_METIS_API_KEY>' >> ~/.bashrc
source ~/.bashrc

روش سوم: استفاده از مدل‌های MiMo (Xiaomi)​

مدل‌های MiMo شرکت Xiaomi گزینه‌ای قدرتمند و مقرون‌به‌صرفه با پشتیبانی از وضوح تصویر، صوت و ویدئو هستند.

export ANTHROPIC_BASE_URL=https://api.metisai.ir/mimo/anthropic
export ANTHROPIC_AUTH_TOKEN=<YOUR_METIS_API_KEY>
export ANTHROPIC_MODEL=mimo-v2.5-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=mimo-v2.5-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=mimo-v2.5-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=mimo-v2.5-pro

توضیح متغیرها​

متغیرمقدارتوضیح
ANTHROPIC_BASE_URLhttps://api.metisai.ir/mimo/anthropicمسیر API متیس که درخواست‌ها را به مدل‌های MiMo هدایت می‌کند
ANTHROPIC_AUTH_TOKENکلید API متیس شماکلید احراز هویت (با پیشوند tpsg-)
ANTHROPIC_MODELmimo-v2.5-proمدل پیش‌فرض برای تمام درخواست‌ها
ANTHROPIC_DEFAULT_OPUS_MODELmimo-v2.5-proمدل جایگزین برای Opus (قوی‌ترین مدل)
ANTHROPIC_DEFAULT_SONNET_MODELmimo-v2.5-proمدل جایگزین برای Sonnet (مدل متعادل)
ANTHROPIC_DEFAULT_HAIKU_MODELmimo-v2.5-proمدل جایگزین برای Haiku (مدل سریع و سبک)
نکته

مدل mimo-v2.5-pro قوی‌ترین مدل MiMo است که از پنجره‌ی متنی بزرگ و درک تصویر، صوت و ویدئو پشتیبانی می‌کند. برای وظایف سبک‌تر می‌توانید از مدل mimo-v2.5 با هزینه‌ی کمتر استفاده کنید.

روش چهارم: استفاده از مدل‌های GLM (Z.AI)​

مدل‌های GLM ساخته‌ی شرکت Z.AI گزینه‌ای قدرتمند و مقرون‌به‌صرفه برای کدنویسی هستند و از پنجره‌ی متنی ۱ میلیون توکن پشتیبانی می‌کنند. مدل پیش‌فرض پیشنهادی glm-5.3 است.

export ANTHROPIC_BASE_URL=https://api.metisai.ir/glm/anthropic
export ANTHROPIC_AUTH_TOKEN=<YOUR_METIS_API_KEY>
export ANTHROPIC_MODEL=glm-5.3
export ANTHROPIC_DEFAULT_OPUS_MODEL=glm-5.3
export ANTHROPIC_DEFAULT_SONNET_MODEL=glm-5.3
export ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-5.3-flash
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000

توضیح متغیرها​

متغیرمقدارتوضیح
ANTHROPIC_BASE_URLhttps://api.metisai.ir/glm/anthropicمسیر API متیس که درخواست‌ها را به مدل‌های GLM هدایت می‌کند
ANTHROPIC_AUTH_TOKENکلید API متیس شماکلید احراز هویت (با پیشوند tpsg-)
ANTHROPIC_MODELglm-5.3مدل پیش‌فرض برای تمام درخواست‌ها
ANTHROPIC_DEFAULT_OPUS_MODELglm-5.3مدل جایگزین برای Opus (قوی‌ترین مدل)
ANTHROPIC_DEFAULT_SONNET_MODELglm-5.3مدل جایگزین برای Sonnet (مدل متعادل)
ANTHROPIC_DEFAULT_HAIKU_MODELglm-5.3-flashمدل جایگزین برای Haiku (مدل سریع و سبک) — glm-5.3-flash ارزان‌تر است
CLAUDE_CODE_AUTO_COMPACT_WINDOW1000000اندازه‌ی پنجره‌ی فشرده‌سازی خودکار، متناسب با پنجره‌ی ۱ میلیون توکنی مدل
شناسه‌ی قدیمی دیگر معتبر نیست

اگر پیش‌تر zai-org/GLM-5.2 را تنظیم کرده بودید، آن را به glm-5.2 یا glm-5.3 تغییر دهید؛ شناسه‌ی قدیمی با خطای model_not_supported رد می‌شود.

چهار شناسه در این اندپوینت پذیرفته می‌شود: glm-5.3، glm-5.2، glm-5.3-flash و glm-5.3-flashx — دقیقاً با همین حروف کوچک. هر شناسه‌ی دیگری (مانند claude-sonnet-4-5 یا مدل‌های gpt-*) رد می‌شود.

همچنین پسوندی مانند [1m] به نام مدل اضافه نکنید. مستندات Z.AI این پسوند را برای سرویس اشتراکی خودِ Z.AI توصیه می‌کند، اما در این اندپوینت چنین شناسه‌ای وجود ندارد و درخواست شما رد خواهد شد.

روش پنجم: استفاده از مدل Kimi K3 (Moonshot AI)​

مدل Kimi K3 ساخته‌ی شرکت Moonshot AI یک مدل استدلالی (reasoning) قدرتمند برای کدنویسی است و از پنجره‌ی متنی ۱ میلیون توکن پشتیبانی می‌کند.

export ANTHROPIC_BASE_URL=https://api.metisai.ir/kimi/anthropic
export ANTHROPIC_AUTH_TOKEN=<YOUR_METIS_API_KEY>
export ANTHROPIC_MODEL=moonshotai/Kimi-K3
export ANTHROPIC_DEFAULT_OPUS_MODEL=moonshotai/Kimi-K3
export ANTHROPIC_DEFAULT_SONNET_MODEL=moonshotai/Kimi-K3
export ANTHROPIC_DEFAULT_HAIKU_MODEL=moonshotai/Kimi-K3
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000

توضیح متغیرها​

متغیرمقدارتوضیح
ANTHROPIC_BASE_URLhttps://api.metisai.ir/kimi/anthropicمسیر API متیس که درخواست‌ها را به مدل Kimi هدایت می‌کند
ANTHROPIC_AUTH_TOKENکلید API متیس شماکلید احراز هویت (با پیشوند tpsg-)
ANTHROPIC_MODELmoonshotai/Kimi-K3مدل پیش‌فرض برای تمام درخواست‌ها
ANTHROPIC_DEFAULT_OPUS_MODELmoonshotai/Kimi-K3مدل جایگزین برای Opus (قوی‌ترین مدل)
ANTHROPIC_DEFAULT_SONNET_MODELmoonshotai/Kimi-K3مدل جایگزین برای Sonnet (مدل متعادل)
ANTHROPIC_DEFAULT_HAIKU_MODELmoonshotai/Kimi-K3مدل جایگزین برای Haiku (مدل سریع و سبک)
CLAUDE_CODE_AUTO_COMPACT_WINDOW1000000اندازه‌ی پنجره‌ی فشرده‌سازی خودکار، متناسب با پنجره‌ی ۱ میلیون توکنی مدل
نام مدل را از پاسخ کپی نکنید

پاسخ‌های این اندپوینت مقدار "model": "kimi-k3" را برمی‌گردانند، اما این نام کوتاه‌تر به عنوان ورودی پذیرفته نمی‌شود و با خطا مواجه می‌شوید.

تنها شناسه‌ی معتبر، دقیقاً moonshotai/Kimi-K3 است — با همین حروف بزرگ و کوچک. رایج‌ترین علت بروز خطا در این روش، کپی‌کردن نام مدل از خروجی پاسخ است.

هزینه‌ی توکن‌های استدلال

Kimi K3 یک مدل استدلالی است و در هر پاسخ، پیش از تولید متن نهایی، یک زنجیره‌ی استدلال تولید می‌کند. این توکن‌ها جزو توکن‌های خروجی محاسبه و با نرخ کامل خروجی محاسبه می‌شوند، حتی اگر در پاسخ نهایی نمایش داده نشوند.

بنابراین هزینه‌ی واقعی هر درخواست می‌تواند به‌مراتب بیشتر از طول متن قابل‌مشاهده باشد. اگر هزینه برایتان اولویت اصلی است، روش دوم (DeepSeek) یا چهارم (GLM) گزینه‌های ارزان‌تری هستند.

نکته

مانند روش چهارم، در این روش نیز تنها یک مدل در دسترس است و هر سه متغیر Opus، Sonnet و Haiku باید روی همان moonshotai/Kimi-K3 تنظیم شوند. هر شناسه‌ی دیگری (مانند kimi-k3، zai-org/GLM-5.2، claude-sonnet-4-5 یا مدل‌های gpt-*) با خطای model_not_supported رد می‌شود.

این اندپوینت از ورودی تصویر پشتیبانی نمی‌کند؛ ارسال تصویر با خطا مواجه خواهد شد.

برای تنظیمات DeepSeek، MiMo، GLM یا Kimi نیز به همین شیوه عمل کنید و تمام متغیرهای ذکر شده در روش دوم، سوم، چهارم یا پنجم را جایگزین کنید.