Felo APIs

پیکربندی Claude Code و Codex

Claude Code و Codex را طوری پیکربندی کنید که فراخوانی‌های مدل از Felo API Platform عبور کنند.

این راهنما نشان می‌دهد چگونه کلاینت‌های عامل را برای استفاده از LLM API در Felo API Platform پیکربندی کنید. وقتی می‌خواهید Claude Code یا Codex فراخوانی‌های مدل را از Felo API Platform عبور دهند، نه اینکه مستقیم فروشنده مدل را صدا بزنند، از این صفحه استفاده کنید.

پیش از استفاده از هر کلاینت، FELO_API_KEY را روی کلید Felo API Platform خود تنظیم کنید.

export FELO_API_KEY="YOUR_API_KEY"

مسیرهای پشتیبانی‌شده کلاینت

کلاینت یا سطح API	endpoint پیشنهادی Felo	نمونه مدل	یادداشت‌ها
Claude Code	`POST /api/v1/messages`	`claude-sonnet-4-6`	Claude Code از قالب انتقال Anthropic Messages استفاده می‌کند.
Codex	`POST /api/v1/responses`	`gpt-5.6-sol`	ارائه‌دهندگان سفارشی Codex باید از Responses API استفاده کنند.
Chat Completions	`POST /api/v1/chat/completions`	`gpt-5.6-sol`	از SDKها یا یکپارچگی‌های سمت سرور استفاده کنید. پشتیبانی Chat Completions در Codex در مستندات Codex منسوخ شده است.

Claude Code

Claude Code باید از endpoint سازگار با Anthropic Messages استفاده کند.

Claude Code می‌تواند از هر مدل منتشرشده فهرست‌شده در مدل‌ها و قیمت‌گذاری استفاده کند، از جمله claude-sonnet-5 که تازه در دسترس قرار گرفته است:

claude --model claude-sonnet-5

پیکربندی Shell

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

claude

base URL سازگار با Anthropic عمداً /v1 را حذف می‌کند، چون Claude Code و Anthropic SDK مسیر /v1/messages را به میزبان API پیکربندی‌شده می‌افزایند.

پیکربندی فایل تنظیمات

وقتی می‌خواهید endpoint و مدل هر بار که claude شروع می‌شود اعمال شوند، از یک فایل تنظیمات Claude Code استفاده کنید. کلیدهای API را در shell یا مدیر رمز خود نگه دارید، نه اینکه آن‌ها را در تنظیمات پروژه ثبت کنید.

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

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

claude --model claude-sonnet-4-6

Codex

Codex باید از endpoint سازگار با OpenAI Responses استفاده کند. gpt-5.6-sol پله پرچم‌دار GPT-5.6 برای استدلال پیچیده، کدنویسی و گردش‌کارهای عاملی است.

پیکربندی کاربر

یک ارائه‌دهنده Felo به پیکربندی Codex در سطح کاربر خود در ~/.codex/config.toml اضافه کنید.

model_provider = "felo"
model = "gpt-5.6-sol"

[model_providers.felo]
name = "Felo API Platform LLM API"
base_url = "https://openapi.felo.ai/api/v1"
env_key = "FELO_API_KEY"
wire_api = "responses"

احراز هویت و انتخاب endpoint در Codex باید در پیکربندی سطح کاربر Codex باشند. Codex مقادیر model_provider، model_providers و openai_base_url را از فایل‌های .codex/config.toml در محدوده پروژه نادیده می‌گیرد.

انتخاب مدل برای یک اجرا

پس از پیکربندی ارائه‌دهنده Felo، می‌توانید مدل را برای یک اجرای CLI انتخاب کنید:

codex --model gpt-5.6-sol

برای اجراهای غیرتعاملی:

codex exec --model gpt-5.6-sol "Review this change"