راه‌اندازی ابزارهای AI

Claude Code

Claude Code را طوری پیکربندی کنید که فراخوانی‌های سازگار با Anthropic از Felo API Platform عبور کنند.

از این راهنما استفاده کنید وقتی می‌خواهید Claude Code به‌جای فراخوانی مستقیم فروشنده مدل از Felo API Platform استفاده کند. Claude Code از یک endpoint سازگار با Anthropic Messages استفاده می‌کند.

ترجیح می‌دهید دستی پیکربندی نکنید؟ CC Switch را نصب کنید، یک برنامه دسکتاپ متن‌باز شخص ثالث که تنظیمات ارائه‌دهنده Claude Code شما را ذخیره می‌کند و با یک کلیک بین آن‌ها جابه‌جا می‌شود. Felo را به‌عنوان یک ارائه‌دهنده اضافه کنید و می‌توانید بدون ویرایش متغیرهای محیطی بین Felo API و اشتراک Claude خود جابه‌جا شوید. نخستین بازگشت به اشتراک از جریان ورود معمول Claude Code استفاده می‌کند؛ گام‌های زیر افزودن Felo را طی می‌کنند.

راه‌اندازی CC Switch

نمونه زیر Felo را به‌عنوان یک ارائه‌دهنده Claude Code اضافه می‌کند. همین گام‌ها برای هر ارائه‌دهنده سازگار با Anthropic دیگری هم کار می‌کند — فقط endpoint، کلید و شناسه‌های مدل تغییر می‌کنند.

در CC Switch، Claude Code را انتخاب کنید، روی Add provider کلیک کنید و Custom Configuration را انتخاب کنید.

انتخاب Custom Configuration در CC Switch

یک نام وارد کنید، کلید Felo API را که در صفحه API Keys در Felo API Platform ساخته‌اید جای‌گذاری کنید و API Endpoint را روی https://openapi.felo.ai/api تنظیم کنید. URL وب‌سایت اختیاری است.

وارد کردن endpoint و کلید API Felo در CC Switch

Advanced Options را باز کنید. Upstream Format را روی Anthropic Messages (Native) تنظیم کنید و Auth Field را روی ANTHROPIC_AUTH_TOKEN (Default) بگذارید. زیر Model Mapping، Sonnet و Opus را به مدل Felo که می‌خواهید استفاده کنید نگاشت کنید، مثلاً gpt-6.1-sol.

نگاشت Sonnet و Opus به یک مدل Felo در CC Switch

روی Add کلیک کنید، ارائه‌دهنده را فعال کنید، سپس Claude Code را شروع کنید. اگر نخستین درخواست موفق شود، راه‌اندازی کامل است.

برای بازگشت به اشتراک Claude، در CC Switch گزینه Claude Official را انتخاب کنید و جریان ورود را دنبال کنید. جابه‌جایی ارائه‌دهنده فقط endpoint، کلید و نگاشت مدل را جایگزین می‌کند — افزونه‌ها، hookها و تنظیمات MCP شما سر جای خود می‌مانند.

راه‌اندازی پیشنهادی

مورد	مقدار
بهترین برای	ویرایش مخزن، عامل‌های کدنویسی، پژوهش با زمینه بلند و توسعه ترمینال‌محور
پروتکل	Anthropic-compatible Messages API
Base URL	`https://openapi.felo.ai/api`
نمونه مدل	`claude-sonnet-4-6`
کلید API	`FELO_API_KEY` شما

پیکربندی Claude Code

برای پیکربندی دستی Claude Code، در صفحه API Keys در Felo API Platform یک کلید بسازید و متغیرهای محیطی را تنظیم کنید. همان کلید در پروتکل‌های مدل، کلاینت‌های عامل و APIهای Search، Web Fetch، PPT، Mindmap، LiveDocs، X Search، YouTube Subtitling، Landing Page و SuperAgent کار می‌کند.

export FELO_API_KEY="YOUR_API_KEY"
export ANTHROPIC_API_KEY="$FELO_API_KEY"
export ANTHROPIC_BASE_URL="https://openapi.felo.ai/api"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

فایل تنظیمات اختیاری

وقتی می‌خواهید base URL و مدل هر بار که Claude Code شروع می‌شود اعمال شوند، از یک فایل تنظیمات استفاده کنید. کلید API را در shell یا مدیر رمز خود نگه دارید.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openapi.felo.ai/api",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

همچنین می‌توانید برای یک نشست مدل انتخاب کنید:

claude --model claude-sonnet-5

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

پس از ذخیره پیکربندی یک وظیفه کوچک اجرا کنید:

claude

اگر ابزار شروع شود و با مدل انتخاب‌شده پاسخ دهد، راه‌اندازی ارائه‌دهنده آماده است.

عیب‌یابی

مشکل	چه چیزی را بررسی کنید
احراز هویت شکست می‌خورد	تأیید کنید کلید درست کپی و به‌عنوان `FELO_API_KEY` صادر شده است
ابزار ارائه‌دهنده اشتباه را صدا می‌زند	بررسی کنید ارائه‌دهنده Felo برای workspace یا نشست جاری انتخاب شده است
خطای Base URL	برای کلاینت‌های سازگار با OpenAI از `https://openapi.felo.ai/api/v1` و برای کلاینت‌های سازگار با Anthropic از `https://openapi.felo.ai/api` استفاده کنید
مدل پیدا نشد	مدلی را انتخاب کنید که در فهرست مدل‌های Felo شما ظاهر می‌شود
ابزار پیکربندی محلی را نادیده می‌گیرد	اگر کلاینت لازم می‌داند، تنظیمات ارائه‌دهنده را به پیکربندی سطح کاربر منتقل کنید