EN

ایجنت‌ها و ابزارهای آماده

OpenClaw، Hermes، Cursor، Continue، LangChain و هر چیزی که base_url می‌گیرد.

هر ابزاری که base_url و کلید می‌گیرد با IranRouter کار می‌کند — بدون افزونه، بدون آداپتور. این صفحه پیکربندی رایج‌ترین‌ها را می‌دهد.

متغیرهای محیطی (بیشتر ابزارها)

Shell
export OPENAI_BASE_URL="https://iranrouter.com/v1"
export OPENAI_API_KEY="ir-..."

برای دائمی‌شدن، همین دو خط را در ~/.zshrc یا ~/.bashrc بگذارید. بعضی کتابخانه‌های قدیمی به‌جای OPENAI_BASE_URL دنبال OPENAI_API_BASE می‌گردند؛ اگر وصل نشد هر دو را ست کنید.

OpenClaw

Shell
export OPENAI_BASE_URL="https://iranrouter.com/v1"
export OPENAI_API_KEY="ir-..."
openclaw

Hermes

YAML
provider:
  type: openai
  base_url: https://iranrouter.com/v1
  api_key: ir-...
  model: anthropic/claude-sonnet-4.5

ابزارهایی که فرمت آنتروپیک دارند

Shell
export ANTHROPIC_BASE_URL="https://iranrouter.com/anthropic"
export ANTHROPIC_API_KEY="ir-..."

پیشوند /anthropic است، نه /v1: SDK و Claude Code خودشان «/v1/messages» را به آدرس پایه اضافه می‌کنند.

جزئیات مسیر /v1/messages ←

Cursor

در Settings → Models، گزینهٔ «Override OpenAI Base URL» را روشن کنید و آدرس پایه و کلید ir- را بدهید؛ سپس مدل را با شناسهٔ کامل (مثلاً anthropic/claude-sonnet-4.5) به فهرست مدل‌های سفارشی اضافه کنید.

Text
Base URL: https://iranrouter.com/v1
API key:  ir-...

Continue

YAML
models:
  - name: Claude via IranRouter
    provider: openai
    model: anthropic/claude-sonnet-4.5
    apiBase: https://iranrouter.com/v1
    apiKey: ir-...

LangChain

Python
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="openai/gpt-4o-mini",
    api_key="ir-...",
    base_url="https://iranrouter.com/v1",
)

پیش از رهاکردن یک ایجنت

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

  1. برای هر ایجنت یک کلید جدا بسازید. اگر لازم شد یکی را ببندید بقیه از کار نمی‌افتند، و در گزارش مصرف می‌دانید کدام ایجنت چقدر خرج کرده.
  2. روی همان کلید سقف روزانه بگذارید. سقف یعنی حتی اگر کد اشتباه کند، خرج از عدد شما بالاتر نمی‌رود.

ایجنت می‌تواند پیش از کار سنگین ظرفیت باقی‌مانده را هم بخواند: GET /v1/key