نکته

چنانچه به سرویس‌های متیس از داخل ایران دسترسی دارید از آدرس https://api.metisai.ir استفاده کنید. و چنانچه از سرویس‌هایی که ایران را تحریم کرده‌اند استفاده می‌کنید از https://api.tapsage.com برای استفاده از سرویس‌های متیس استفاده کنید (مانند Colab، یا Kaggle).

Claude Code

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

پیش‌نیازها

• کلید API متیس (با پیشوند tpsg-)
• نصب Claude Code

روش اول: اتصال مستقیم به مدل‌های 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_URL	https://api.metisai.ir/deepseek/anthropic	مسیر API متیس که درخواست‌ها را به مدل‌های DeepSeek هدایت می‌کند
ANTHROPIC_AUTH_TOKEN	کلید API متیس شما	کلید احراز هویت (با پیشوند tpsg-)
ANTHROPIC_MODEL	deepseek-v4-pro	مدل پیش‌فرض برای تمام درخواست‌ها
ANTHROPIC_DEFAULT_OPUS_MODEL	deepseek-v4-pro	مدل جایگزین برای Opus (قوی‌ترین مدل)
ANTHROPIC_DEFAULT_SONNET_MODEL	deepseek-v4-pro	مدل جایگزین برای Sonnet (مدل متعادل)
ANTHROPIC_DEFAULT_HAIKU_MODEL	deepseek-v4-flash	مدل جایگزین برای Haiku (مدل سریع و سبک)
CLAUDE_CODE_SUBAGENT_MODEL	deepseek-v4-flash	مدل مورد استفاده برای زیرعامل‌ها (Sub-agents)
CLAUDE_CODE_EFFORT_LEVEL	max	سطح تلاش عامل روی حداکثر (دقت بالاتر)

نکته

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

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

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

Bash

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

Zsh

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

روش سوم: استفاده از مدل‌های 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_URL	https://api.metisai.ir/mimo/anthropic	مسیر API متیس که درخواست‌ها را به مدل‌های MiMo هدایت می‌کند
ANTHROPIC_AUTH_TOKEN	کلید API متیس شما	کلید احراز هویت (با پیشوند tpsg-)
ANTHROPIC_MODEL	mimo-v2.5-pro	مدل پیش‌فرض برای تمام درخواست‌ها
ANTHROPIC_DEFAULT_OPUS_MODEL	mimo-v2.5-pro	مدل جایگزین برای Opus (قوی‌ترین مدل)
ANTHROPIC_DEFAULT_SONNET_MODEL	mimo-v2.5-pro	مدل جایگزین برای Sonnet (مدل متعادل)
ANTHROPIC_DEFAULT_HAIKU_MODEL	mimo-v2.5-pro	مدل جایگزین برای Haiku (مدل سریع و سبک)

نکته

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

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

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

export ANTHROPIC_BASE_URL=https://api.metisai.ir/glm/anthropic
export ANTHROPIC_AUTH_TOKEN=<YOUR_METIS_API_KEY>
export ANTHROPIC_MODEL=zai-org/GLM-5.2
export ANTHROPIC_DEFAULT_OPUS_MODEL=zai-org/GLM-5.2
export ANTHROPIC_DEFAULT_SONNET_MODEL=zai-org/GLM-5.2
export ANTHROPIC_DEFAULT_HAIKU_MODEL=zai-org/GLM-5.2
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000

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

متغیر	مقدار	توضیح
ANTHROPIC_BASE_URL	https://api.metisai.ir/glm/anthropic	مسیر API متیس که درخواست‌ها را به مدل GLM هدایت می‌کند
ANTHROPIC_AUTH_TOKEN	کلید API متیس شما	کلید احراز هویت (با پیشوند tpsg-)
ANTHROPIC_MODEL	zai-org/GLM-5.2	مدل پیش‌فرض برای تمام درخواست‌ها
ANTHROPIC_DEFAULT_OPUS_MODEL	zai-org/GLM-5.2	مدل جایگزین برای Opus (قوی‌ترین مدل)
ANTHROPIC_DEFAULT_SONNET_MODEL	zai-org/GLM-5.2	مدل جایگزین برای Sonnet (مدل متعادل)
ANTHROPIC_DEFAULT_HAIKU_MODEL	zai-org/GLM-5.2	مدل جایگزین برای Haiku (مدل سریع و سبک)
CLAUDE_CODE_AUTO_COMPACT_WINDOW	1000000	اندازه‌ی پنجره‌ی فشرده‌سازی خودکار، متناسب با پنجره‌ی ۱ میلیون توکنی مدل

نام مدل را از پاسخ کپی نکنید

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

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

نکته

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

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

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