API هوش مصنوعی

اتصال به برنامه‌ها

سیستم‌عامل و برنامه‌تان را انتخاب کنید؛ راهنمای قدم‌به‌قدم با کلید و مدل خودتان آماده می‌شود.

۱ سیستم‌عامل

Windows
ویندوز ۱۰ و ۱۱
macOS
مک
Linux
اوبونتو، فدورا و…
Android
گوشی و تبلت اندروید

۲ برنامه

Harnes
اپ اختصاصی ۲۹۲۸ — ایجنت کدنویسی با رابط فارسی
Claude Code
ایجنت کدنویسی Anthropic در ترمینال
Cursor
ویرایشگر کد هوشمند
VS Code
ویرایشگر + افزونه
Codex CLI
ایجنت کدنویسی OpenAI در ترمینال
Cherry Studio
اپ چت دسکتاپ (جایگزین اپ ChatGPT/Claude)

برای اپ رسمی Claude فقط مدل‌های Claude قابل استفاده است؛ برای گفتگو با GPT روی دسکتاپ از Cherry Studio استفاده کنید.

کلید فقط در مرورگر شما جایگزین می‌شود و جایی ارسال نمی‌شود.

وارد شوید تا بتوانید همین‌جا کلید بسازید.

ضریب مصرف هر مدل در صفحه‌ی مدل‌ها آمده است.

راهنمای اتصال Harnes

Windows · ۶ قدم
  1. ۱

    انتخاب یا ساخت کلید API

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

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

  2. ۲

    پیش‌نیاز: Node.js و Claude Code

    Harnes رابط فارسی و گرافیکی ایجنت Claude Code است و برای کار به خود Claude Code نیاز دارد. اگر Node.js ندارید، نسخه‌ی LTS را از nodejs.org نصب کنید. سپس PowerShell را باز کنید و Claude Code را نصب کنید:

    PowerShell
    npm install -g @anthropic-ai/claude-code
    claude --version

    اگر دستور دوم شماره‌ی نسخه را نشان داد، نصب درست است.

  3. ۳

    دانلود و اجرای Harnes

    فایل زیپ (حدود ۱۶۰ مگابایت) را دانلود کنید. یک پوشه‌ی جدید بسازید، مثلاً C:\Harnes، و زیپ را داخل همان پوشه باز کنید (Extract). سپس Harnes.exe را اجرا کنید.

    فایل‌ها بدون پوشه‌ی جدا از زیپ بیرون می‌آیند؛ برای همین حتماً اول یک پوشه‌ی خالی بسازید. برای دسترسی راحت، روی Harnes.exe راست‌کلیک کنید و میان‌بر (Shortcut) روی دسکتاپ بسازید.

    در اولین اجرا ممکن است پنجره‌ی آبی SmartScreen ویندوز بیاید، چون برنامه امضای دیجیتال ندارد. روی More info و بعد Run anyway بزنید.

  4. ۴

    وارد کردن کلید

    روی آیکن چرخ‌دنده در پایین نوار کناری بزنید. آدرس سرویس از قبل روی ۲۹۲۸ تنظیم شده و لازم نیست تغییرش دهید. فقط این دو مورد را وارد کنید:

    کلید API
    sk-...
    مدل پیش‌فرض
    claude-sonnet-5

    دکمه‌ی تست اتصال را بزنید. اگر «اتصال برقرار است» آمد، ذخیره را بزنید.

  5. ۵

    انتخاب پروژه و شروع

    از نوار کناری پوشه‌ی پروژه‌ی خود را انتخاب کنید و درخواستتان را به فارسی بنویسید. ایجنت فایل‌ها را می‌خواند، ویرایش می‌کند و دستورها را اجرا می‌کند. با کلیک روی نشان کنار نام مدل، حالت مجوزها را عوض کنید: خودکار (بدون پرسیدن)، ویرایش خودکار یا برنامه‌ریزی (فقط نقشه، بدون تغییر فایل).

    برای پیوست فایل یا عکس، فایل را روی کادر گفتگو بکشید و رها کنید.

  6. ۶

    ساخت تصویر

    دکمه‌ی تصویر را در کادر گفتگو بزنید، مدل gpt-image-2 را انتخاب کنید و توضیح تصویر را بنویسید. برای ویرایش یک عکس، آن را به‌عنوان تصویر پایه بکشید و رها کنید. تصویرها در پوشه‌ی generated داخل پروژه ذخیره می‌شوند.

    ساخت هر تصویر معمولاً ۲۰ تا ۴۵ ثانیه طول می‌کشد و هزینه‌اش برای هر تصویر ثابت است (صفحه‌ی «مدل‌ها»).

خطاهای رایج

401 (Unauthorized)
کلید اشتباه است یا ناقص چسبانده شده. کلید کامل را دوباره وارد کنید و مطمئن شوید فاصله یا خط جدید اضافه ندارد.
403 (اعتبار تمام شده)
اعتبار حساب تمام یا منقضی شده است. از صفحه‌ی «خرید اعتبار» بسته بخرید یا تمدید کنید.
503 — model_not_found
نام مدل اشتباه است. نام را دقیقاً از صفحه‌ی «مدل‌ها» کپی کنید.
«Claude Code پیدا نشد» (ویندوز)
Claude Code نصب نیست یا ویندوز مسیرش را نمی‌شناسد. در PowerShell دستور npm install -g @anthropic-ai/claude-code را اجرا کنید و Harnes را دوباره باز کنید. اگر باز هم پیدا نشد، مسیر claude.exe را در تنظیمات ← پیشرفته وارد کنید.
This model is not supported on the Chat Completions endpoint
یک مدل ساخت عکس (مثل gpt-image-2) را برای چت انتخاب کرده‌اید. مدل‌های عکس فقط از بخش ساخت تصویر برنامه کار می‌کنند، نه از صفحه‌ی چت؛ برای گفتگو یک مدل Claude یا GPT انتخاب کنید.
پاسخ دیر شروع می‌شود
مدل‌های بزرگ (Opus، GPT-6 و Sol) گاهی چند ثانیه تا ده‌ها ثانیه قبل از شروع پاسخ فکر می‌کنند؛ برای کارهای سریع از Sonnet یا Haiku استفاده کنید. وضعیت لحظه‌ای مدل‌ها در صفحه‌ی «وضعیت سرویس» است.
کمک لازم دارید؟

بگویید در کدام قدم ماندید و متن خطا را بفرستید.

تماس با پشتیبانی