کدنماAI-Coding.irتازه‌های هوش مصنوعی و کدنویسی
دلار (تتر) ۲۷۰٬۳۵۴ تومانAVGO ۳۵۵٫۷۳ ▲ +۴٫۱٪AMD ۵۲۲٫۰۰ ▲ +۳٫۷٪AMZN ۲۶۷٫۳۰ ▲ +۳٫۷٪NVDA ۱۵۰٫۷۵ ▼ −۳٫۰٪SPCX ۱۴۳٫۹۷ ▲ +۱٫۶٪BABA ۸۵٫۲۷ ▼ −۱٫۶٪پرکاربردترین مدل برنامه‌نویسی DeepSeek V4.1 Flash 1017

آموزش / ابزارها در عمل / درس ۵ از ۱۵

اتصال ابزارهای کدنویسی به سرویس‌های ایرانی (API سازگار با OpenAI)

با عوض کردن دو مقدار — آدرس پایه و کلید — بیشتر ابزارها و کتابخانه‌ها به درواره، اول‌ای‌آی، گپ‌جی‌پی‌تی یا هر سرویس سازگار دیگر وصل می‌شوند.

مقدماتی، ۸ دقیقه مطالعه

در این آموزش
  1. پایتون
  2. جاوااسکریپت / Node.js
  3. Cline و Roo Code و Kilo Code
  4. Continue
  5. Aider
  6. OpenCode
  7. Cursor
  8. Claude Code
  9. نکته‌های امنیتی

بیشتر سرویس‌های ایرانی API خود را سازگار با OpenAI ارائه می‌کنند. یعنی هر ابزار یا کتابخانه‌ای که با OpenAI کار می‌کند، با تغییر دو مقدار به آن‌ها هم وصل می‌شود:

  • آدرس پایه (Base URL): مثلاً https://api.darvareh.ir/v1 یا https://api.avalai.ir/v1 یا https://api.gapgpt.app/v1
  • کلید API: از پنل همان سرویس

شناسه‌ی دقیق مدل‌ها (مثلاً نام مدل Claude یا GPT) در هر سرویس ممکن است کمی فرق کند؛ آن را از فهرست مدل‌های پنل بردارید.

پایتون

python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.avalai.ir/v1",   # آدرس پایه‌ی سرویس شما
    api_key="YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="MODEL_ID",                       # شناسه‌ی مدل از پنل سرویس
    messages=[{"role": "user", "content": "یک تابع پایتون برای اعتبارسنجی کد ملی بنویس."}],
)
print(resp.choices[0].message.content)

جاوااسکریپت / Node.js

javascript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.darvareh.ir/v1",
  apiKey: process.env.AI_API_KEY,
});

const r = await client.chat.completions.create({
  model: "MODEL_ID",
  messages: [{ role: "user", content: "این خطا را توضیح بده: ..." }],
});
console.log(r.choices[0].message.content);

Cline و Roo Code و Kilo Code

در تنظیمات افزونه، ارائه‌دهنده را OpenAI Compatible بگذارید، سپس Base URL، کلید و شناسه‌ی مدل را وارد کنید.

Continue

در فایل تنظیمات Continue یک مدل با ارائه‌دهنده‌ی openai و مقدار apiBase تعریف کنید:

yaml
models:
  - name: My Coding Model
    provider: openai
    model: MODEL_ID
    apiBase: https://api.gapgpt.app/v1
    apiKey: YOUR_API_KEY

Aider

bash
export OPENAI_API_BASE=https://api.avalai.ir/v1
export OPENAI_API_KEY=YOUR_API_KEY
aider --model openai/MODEL_ID

OpenCode

در فایل opencode.json یک ارائه‌دهنده تعریف کنید:

json
{
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "My Provider",
      "options": { "baseURL": "https://api.darvareh.ir/v1", "apiKey": "YOUR_API_KEY" },
      "models": { "MODEL_ID": {} }
    }
  }
}

Cursor

در تنظیمات مدل‌ها، گزینه‌ی بازنویسی آدرس پایه‌ی OpenAI را فعال کنید و آدرس و کلید سرویس را بدهید. درواره راهنمای تصویری این کار را منتشر کرده است.

Claude Code

Claude Code با API به سبک Anthropic کار می‌کند. اگر سرویس شما مسیر سازگار با Anthropic دارد (مثلاً درواره راهنمای اتصال Claude Code را منتشر کرده)، کافی است این متغیرها را تنظیم کنید:

bash
export ANTHROPIC_BASE_URL=آدرس-اعلام‌شده-در-راهنمای-سرویس
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
claude

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

  • کلید را هرگز داخل کد یا مخزن گیت نگذارید؛ از متغیر محیطی یا فایل .env (در .gitignore) استفاده کنید.
  • برای هر پروژه یک کلید جدا بسازید تا اگر لو رفت، فقط همان را باطل کنید.
  • برای کلیدها سقف مصرف تعیین کنید؛ یک ایجنت در حلقه‌ی بی‌پایان می‌تواند در چند ساعت اعتبار زیادی مصرف کند.