راهنمای اتصال به API

اتصال Claude Code به 1ai؛ ANTHROPIC_BASE_URL و کلید API

Claude Code عامل برنامه‌نویسی Anthropic است: در ترمینال کد پروژه را می‌خواند، فایل‌ها را ویرایش می‌کند و دستور اجرا می‌کند. وان ای آی (1ai) قالب Anthropic را در مسیر POST /v1/messages دارد، پس Claude Code با عوض کردن آدرس و کلید به 1ai وصل می‌شود؛ مدل‌های Claude مستقیم پاسخ می‌دهند و مدل‌های چت دیگر با تبدیل قالب. اعتبار را با پرداخت ریالی می‌خرید و برای کلید سقف مصرف می‌گذارید. در این راهنما تنظیمات آماده، انتخاب مدل، موجودی لازم و خطاهای رایج را می‌بینید. این تنظیمات با Claude Code نسخه‌ی 2.1.318 آزموده شده‌اند.

ساخت کلید APIمدل‌های مناسب Claude Code (با پشتیبانی از ابزار)

چرا با 1ai

همان قالبی که Claude Code می‌فرستد

Claude Code درخواست را به POST /v1/messages می‌فرستد و 1ai همین قالب را جواب می‌دهد؛ مبدل یا پراکسی جداگانه لازم نیست.

Claude و مدل‌های دیگر

مدل‌های Claude مستقیم اجرا می‌شوند و بقیه‌ی مدل‌های چت با تبدیل قالب. نام‌هایی مثل claude-opus-5-5 خودکار به anthropic/claude-opus-5.5 می‌رسند.

Prompt caching

حافظه‌ی نهان پرامپت کار می‌کند و توکن‌هایی که از حافظه خوانده می‌شوند در سقف توکن در دقیقه حساب نمی‌شوند.

پرداخت ریالی

هزینه‌ی هر درخواست به اندازه‌ی مصرف واقعی از اعتبار 1ai کم می‌شود که با پرداخت ریالی شارژ می‌شود.

سقف مصرف برای هر کلید

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

در چند قدم

  1. ۱

    Claude Code را نصب کنید

    با روش رسمی نصبش کنید؛ در macOS و Linux با curl -fsSL https://claude.ai/install.sh | bash.

  2. ۲

    کلید API بسازید

    در پنل 1ai از بخش توسعه‌دهندگان ← کلیدها یک کلید با نام Claude Code و سقف ماهانه بسازید.

  3. ۳

    اعتبار کافی داشته باشید

    هر درخواست پیش از اجرا سقف خروجی‌اش را رزرو می‌کند؛ موجودی پیشنهادی هر مدل در بخش «چقدر اعتبار لازم است؟» آمده است.

  4. ۴

    متغیرها را تنظیم کنید

    ANTHROPIC_BASE_URL را بدون /v1 روی https://1ai.ir و کلید را در ANTHROPIC_AUTH_TOKEN بگذارید و اگر ANTHROPIC_API_KEY تنظیم است، آن را بردارید.

  5. ۵

    Claude Code را اجرا کنید

    در پوشه‌ی پروژه claude --model claude-sonnet-5-5 را بزنید و با یک کار کوچک شروع کنید.

مدل‌های مناسب Claude Code (با پشتیبانی از ابزار)

همه‌ی مدل‌ها

GPT-6 Luna

اوپن‌ای‌آی
گفتگو

سریع و بسیار ارزان؛ مدل پیش‌فرض و در نسخه‌ی رایگان

شروع پاسخ ۲٫۶ ثانیه و سرعت ۷۴ توکن در ثانیه

در نسخه‌ی رایگان
رایگانAPI

GPT-6.1 Sol

اوپن‌ای‌آی
گفتگو

پرچم‌دار اوپن‌ای‌آی برای کارهای دقیق، تحلیلی و چندمرحله‌ای

شروع پاسخ ۵٫۶ ثانیه و سرعت ۵۷ توکن در ثانیه

با اشتراک
API

Claude Sonnet 5.5

آنتروپیک
گفتگو

نویسندگی روان و برنامه‌نویسی دقیق

با اشتراک
API

Gemini 3.8 Flash

گوگل
گفتگو

سریع، چندوجهی و با حافظه‌ی متنی بسیار بلند

با اشتراک
API

Claude Haiku 5.5

آنتروپیک
گفتگو

سریع‌ترین کلود؛ در نسخه‌ی رایگان

شروع پاسخ ۴٫۶ ثانیه و سرعت ۲۹۸ توکن در ثانیه

در نسخه‌ی رایگان
رایگانAPI

Gemini 3.5 Flash Lite

گوگل
گفتگو

سبک و ارزان؛ در نسخه‌ی رایگان

در نسخه‌ی رایگان
رایگانAPI

نمونه پرامپت‌ها

پرامپت را کپی کنید، در 1ai بگذارید و جزئیات خودتان را جایگزین کنید.

شناخت پروژه

Explain the structure of this project and how a request flows through it. Do not change any file yet.

پیش از هر تغییری ببینید پروژه را درست فهمیده است.

رفع خطا

Find the cause of this error and fix it with minimal changes: [متن خطا]. Run `[دستور تست، مثلاً npm test]` afterwards and report what passed.

بازبینی تغییرها

Review the uncommitted changes in this repository for bugs and missing tests. List each issue with its file and line. Do not edit anything.

گزارش فارسی

با git log بررسی کن در ده commit آخر چه تغییرهایی داده شده و به فارسی خلاصه کن کدام بخش‌های پروژه بیشترین تغییر را داشته‌اند.

تنظیم متغیرهای محیطی برای 1ai

این خطوط را در ترمینال اجرا کنید:

bash
export ANTHROPIC_BASE_URL=https://1ai.ir
export ANTHROPIC_AUTH_TOKEN=sk-1ai-...
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=16000
claude --model claude-sonnet-5-5
  • ANTHROPIC_BASE_URL را بدون /v1 بنویسید؛ Claude Code خودش /v1/messages را به آن اضافه می‌کند.
  • ANTHROPIC_AUTH_TOKEN همان کلید sk-1ai-… شماست. اگر ANTHROPIC_API_KEY در محیط تنظیم شده است، با unset ANTHROPIC_API_KEY آن را بردارید.
  • CLAUDE_CODE_MAX_OUTPUT_TOKENS سقف خروجی هر درخواست را تعیین می‌کند و مستقیم روی موجودی لازم اثر دارد؛ بخش بعد را ببینید.
  • --model مدل جلسه را انتخاب می‌کند. نام‌هایی مثل claude-opus-5-5 خودکار به شناسه‌ی 1ai، یعنی anthropic/claude-opus-5.5، می‌رسند.

برای ماندگار شدن تنظیمات، خطوط export را در ~/.zshrc یا ~/.bashrc بگذارید و کلید را در مخزن پروژه commit نکنید.

چقدر اعتبار برای Claude Code لازم است؟

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

Claude Code به‌طور پیش‌فرض روی Sonnet سقف ۱۲۸ هزار توکن خروجی می‌خواهد که برای هر درخواست حدود ۲۰۰ اعتبار رزرو می‌کند. با CLAUDE_CODE_MAX_OUTPUT_TOKENS=16000 این رزرو کم می‌شود:

مدلرزرو هر درخواست با این تنظیم
Opusحدود ۶۰ اعتبار
Sonnetحدود ۳۰ اعتبار
Haikuحدود ۱٫۵ اعتبار

Claude Code درخواست‌ها را هم‌زمان می‌فرستد: زیرعامل‌ها و فراخوانی‌های کوچک پس‌زمینه کنار درخواست اصلی اجرا می‌شوند. اگر موجودی آن‌قدر کم باشد که یک درخواست همه‌اش را رزرو کند، درخواست بعدی با خطای اعتبار رد می‌شود. برای همین با تنظیم بالا برای Sonnet حدود ۱۰۰ اعتبار و برای Opus حدود ۲۰۰ اعتبار موجودی پیشنهاد می‌کنیم.

موجودی کم، درخواست را فوراً رد نمی‌کند: 1ai اول سقف خروجی همان درخواست را پایین می‌آورد و رد شدن وقتی پیش می‌آید که دیگر حتی یک پاسخ کوچک هم جا نشود.

این عددها تقریبی‌اند و به قیمت مدل‌ها بستگی دارند؛ قیمت روز هر مدل در جدول مدل‌ها آمده است.

اجرای Claude Code با مدل‌های دیگر

Claude Code هر مدل چت 1ai را می‌پذیرد، ولی فهرست مدل‌های خودش فقط شناسه‌هایی را نگه می‌دارد که claude یا anthropic در آن‌ها باشد. مدل‌های دیگر را با این سه متغیر به جای Opus، Sonnet و Haiku بگذارید:

bash
export ANTHROPIC_DEFAULT_OPUS_MODEL=openai/gpt-6.1-sol
export ANTHROPIC_DEFAULT_SONNET_MODEL=qwen/qwen3.8-max
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek/deepseek-v4.1-flash

Claude Code بدون فراخوانی ابزار کار نمی‌کند، پس مدلی بگذارید که tools داشته باشد. فهرست این مدل‌ها در همین صفحه آمده و مقایسه‌ی کلی خانواده‌ها در برنامه‌نویسی با هوش مصنوعی است.

حافظه‌ی نهان، جستجوی وب و شمارش توکن

  • Prompt caching کار می‌کند و توکن‌هایی که از حافظه خوانده می‌شوند در سقف توکن در دقیقه حساب نمی‌شوند.
  • جستجوی وب به‌عنوان ابزار سروری فقط روی مدل‌هایی کار می‌کند که برای جستجو قیمت دارند. ابزارهای سروری دیگر پذیرفته نمی‌شوند.
  • شمارش توکن (POST /v1/messages/count_tokens) تخمین خود 1ai است و هزینه‌ای ندارد.

خطاهای رایج Claude Code با 1ai و راه‌حل

  • 401: کلید اشتباه، باطل یا منقضی است. اگر ANTHROPIC_API_KEY هم تنظیم شده، با unset آن را بردارید.
  • 402 با billing_error: اعتبار یا سقف ماهانه‌ی کلید تمام شده، یا درخواست‌های هم‌زمان موجودی را رزرو کرده‌اند. موجودی را بالا ببرید یا CLAUDE_CODE_MAX_OUTPUT_TOKENS را کم کنید.
  • 404: ANTHROPIC_BASE_URL با /v1 نوشته شده یا شناسه‌ی مدل اشتباه است.
  • 400 با server_tool_unsupported: ابزار سروری فرستاده شده که 1ai ندارد، یا مدل برای جستجو قیمت ندارد.
  • 429: سقف درخواست یا توکن در دقیقه پر شده؛ کمی صبر کنید و جلسه‌های هم‌زمان را کم کنید.
  • 529 با overloaded_error: مدل موقتاً در دسترس نیست؛ کمی بعد دوباره امتحان کنید.
  • مدل غیر Claude در فهرست مدل‌ها نیست: طبیعی است؛ آن را با متغیرهای ANTHROPIC_DEFAULT_…_MODEL بگذارید.

چطور هزینه‌ی Claude Code را کنترل کنیم؟

  • CLAUDE_CODE_MAX_OUTPUT_TOKENS را نگه دارید تا رزرو هر درخواست کوچک بماند.
  • اگر برای رده‌ی Haiku مدل ارزان‌تری می‌خواهید، آن را در ANTHROPIC_DEFAULT_HAIKU_MODEL بگذارید.
  • برای موضوع تازه جلسه‌ی تازه باز کنید تا تاریخچه‌ی قبلی در هر درخواست فرستاده نشود.
  • برای Claude Code کلید جدا با سقف ماهانه و فهرست مدل‌های مجاز بسازید.

جزئیات در راهنمای کلیدها و کنترل هزینه آمده است. برای عامل‌های ترمینالی دیگر، راهنمای Codex CLI و راهنمای Gemini CLI را ببینید.

ابزارهای آماده

توضیح کد و رفع باگ

کد را بفهمید، خطایش را پیدا کنید و تمیزش کنید

ساخت عبارت باقاعده (Regex)

الگوی Regex با توضیح و نمونه‌ی آزمون

ساخت کوئری SQL

درخواست فارسی، کوئری درست و توضیح‌داده‌شده

دستیارهای مرتبط

برنامه‌نویس ارشد

نوشتن، مرور و اشکال‌زدایی کد با توضیح روشن

  • «این کد را مرور کن و باگ‌ها و مشکلات امنیتی‌اش را بگو: »
  • «یک API ساده برای مدیریت کارها با Node.js و Express بنویس»

سوالات متداول

برای Claude Code با 1ai به اشتراک Claude نیاز دارم؟

خیر. با این تنظیمات Claude Code با کلید 1ai کار می‌کند و هزینه‌ی هر درخواست از اعتبار API کم می‌شود. اعتبار را جدا می‌خرید و اشتراک چت 1ai شامل آن نمی‌شود. اشتراک Claude هم حساب جدایی است و به این کلید ربطی ندارد.

چرا با وجود موجودی، خطای اعتبار می‌گیرم؟

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

اعتبار رزروشده از دست می‌رود؟

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

CLAUDE_CODE_MAX_OUTPUT_TOKENS را چه عددی بگذارم؟

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

می‌توانم Claude Code را با GPT یا Qwen اجرا کنم؟

بله. هر مدل چت 1ai در این قالب کار می‌کند. چون فهرست مدل‌های Claude Code فقط نام‌های دارای claude یا anthropic را نگه می‌دارد، مدل را با ANTHROPIC_DEFAULT_OPUS_MODEL، ANTHROPIC_DEFAULT_SONNET_MODEL یا ANTHROPIC_DEFAULT_HAIKU_MODEL تعیین کنید.

چرا ANTHROPIC_BASE_URL نباید /v1 داشته باشد؟

Claude Code خودش /v1/messages را به آدرس اضافه می‌کند. اگر /v1 را هم بنویسید، مسیر نادرست می‌شود و 404 می‌گیرید. این با Codex CLI فرق دارد که آدرسش https://1ai.ir/v1 است.

چطور پیش از Claude Code مطمئن شوم کلید و آدرس درست است؟

در ترمینال curl https://1ai.ir/v1/models -H "Authorization: Bearer sk-1ai-..." را اجرا کنید. اگر فهرست مدل‌ها برگشت، کلید و آدرس سالم‌اند و مشکل در متغیرهای محیطی است.

مطالب مرتبط

دست رباتیک سرامیکی در حال کنار هم گذاشتن قطعات فلزی نرم‌افزار روی پس‌زمینه آبی و بنفش
ابزارها و مدل‌ها

Claude Code چیست؟ آموزش نصب، دسترسی و اتصال به API

Claude Code عامل برنامه‌نویسی Anthropic برای کار روی پروژه است. نصب، مسیرهای دسترسی و تفاوت آن با مدل Claude را بشناسید و یاد بگیرید چطور آن را به API وان ای آی وصل کنید.

۱۴ دقیقه مطالعه
کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه
توسعه‌دهندگان

کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه

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

۴ دقیقه مطالعه
لپ‌تاپ مینیاتوری سرامیکی و دست رباتیک در حال تکمیل قطعات هندسی روی پس‌زمینهٔ آبی و بنفش
کاربردها

بهترین هوش مصنوعی برای برنامه نویسی؛ مقایسه مدل‌ها و ابزارها

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

۱۴ دقیقه مطالعه
حباب گفت‌وگوی سه‌بعدی در حال تبدیل شدن به پنجره یک سایت روی پس‌زمینه آبی و بنفش
مفاهیم هوش مصنوعی

وایب کدینگ چیست؟ آموزش ساخت یک سایت ساده با هوش مصنوعی

با توضیح فارسی ایده، یک سایت کوچک بسازید و قدم‌به‌قدم اصلاحش کنید؛ همراه با پرامپت‌های آماده، روش تست و مرز میان نمونه اولیه و محصول قابل اعتماد.

۱۳ دقیقه مطالعه

صفحه‌های مرتبط

همه‌ی امکانات

اتصال Codex CLI

Codex CLI را با چند خط در config.toml به 1ai وصل کنید و در ترمینال با مدل‌های GPT، Gemini و Claude از یک کلید کدنویسی کنید.

اتصال Gemini CLI

Gemini CLI را با دو متغیر محیطی و یک خط در settings.json به 1ai وصل کنید و در ترمینال با Gemini یا هر مدل چت دیگر از یک کلید کدنویسی کنید.

اتصال OpenCode

OpenCode را با یک ارائه‌دهنده‌ی سفارشی در opencode.json به 1ai وصل کنید و در ترمینال با Claude، GPT، Qwen و DeepSeek از یک کلید کدنویسی کنید.

اتصال Cline

افزونه‌ی Cline را با گزینه‌ی OpenAI Compatible به 1ai وصل کنید و با Claude، GPT، Gemini و DeepSeek از یک کلید و با پرداخت ریالی کدنویسی کنید.

اتصال Claude Code به 1ai؛ ANTHROPIC_BASE_URL و کلید API

Claude Code را با چند متغیر محیطی به 1ai وصل کنید، در ترمینال با Claude یا هر مدل چت دیگر کدنویسی کنید و بدانید برای کار بدون خطای اعتبار چه موجودی‌ای لازم است.

ساخت کلید API