اتصال به برنامهها
سیستمعامل و برنامهتان را انتخاب کنید؛ راهنمای قدمبهقدم با کلید و مدل خودتان آماده میشود.
۱ سیستمعامل
۲ برنامه
برای اپ رسمی Claude فقط مدلهای Claude قابل استفاده است؛ برای گفتگو با GPT روی دسکتاپ از Cherry Studio استفاده کنید.
کلید فقط در مرورگر شما جایگزین میشود و جایی ارسال نمیشود.
وارد شوید تا بتوانید همینجا کلید بسازید.
ضریب مصرف هر مدل در صفحهی مدلها آمده است.
راهنمای اتصال Harnes
Windows · ۶ قدم-
۱
انتخاب یا ساخت کلید API
از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمهی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر میشوند.
کلید کامل فقط یک بار، هنگام ساخت، نمایش داده میشود. آن را در جای امنی نگه دارید و در گروهها یا اسکرینشاتها منتشر نکنید.
-
۲
پیشنیاز: Node.js و Claude Code
Harnes رابط فارسی و گرافیکی ایجنت Claude Code است و برای کار به خود Claude Code نیاز دارد. اگر Node.js ندارید، نسخهی LTS را از
nodejs.orgنصب کنید. سپس PowerShell را باز کنید و Claude Code را نصب کنید:PowerShellnpm install -g @anthropic-ai/claude-code claude --version
اگر دستور دوم شمارهی نسخه را نشان داد، نصب درست است.
-
۳
دانلود و اجرای Harnes
فایل زیپ (حدود ۱۶۰ مگابایت) را دانلود کنید. یک پوشهی جدید بسازید، مثلاً
C:\Harnes، و زیپ را داخل همان پوشه باز کنید (Extract). سپسHarnes.exeرا اجرا کنید.فایلها بدون پوشهی جدا از زیپ بیرون میآیند؛ برای همین حتماً اول یک پوشهی خالی بسازید. برای دسترسی راحت، روی
Harnes.exeراستکلیک کنید و میانبر (Shortcut) روی دسکتاپ بسازید.در اولین اجرا ممکن است پنجرهی آبی SmartScreen ویندوز بیاید، چون برنامه امضای دیجیتال ندارد. روی
More infoو بعدRun anywayبزنید. -
۴
وارد کردن کلید
روی آیکن چرخدنده در پایین نوار کناری بزنید. آدرس سرویس از قبل روی ۲۹۲۸ تنظیم شده و لازم نیست تغییرش دهید. فقط این دو مورد را وارد کنید:
کلید APIsk-...مدل پیشفرضclaude-sonnet-5
دکمهی
تست اتصالرا بزنید. اگر «اتصال برقرار است» آمد،ذخیرهرا بزنید. -
۵
انتخاب پروژه و شروع
از نوار کناری پوشهی پروژهی خود را انتخاب کنید و درخواستتان را به فارسی بنویسید. ایجنت فایلها را میخواند، ویرایش میکند و دستورها را اجرا میکند. با کلیک روی نشان کنار نام مدل، حالت مجوزها را عوض کنید:
خودکار(بدون پرسیدن)،ویرایش خودکاریابرنامهریزی(فقط نقشه، بدون تغییر فایل).برای پیوست فایل یا عکس، فایل را روی کادر گفتگو بکشید و رها کنید.
-
۶
ساخت تصویر
دکمهی تصویر را در کادر گفتگو بزنید، مدل
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 استفاده کنید. وضعیت لحظهای مدلها در صفحهی «وضعیت سرویس» است.
بگویید در کدام قدم ماندید و متن خطا را بفرستید.