نصب و پیکربندی

پیش‌نیازها

• Node.js نسخه ۱۸ یا بالاتر
• npm یا pnpm (برای نصب)
• یک کلید API معتبر از پنل توسعه‌دهندگان اهور

روش‌های نصب

۱. نصب با npm (پیشنهادی)

npm install -g ahur-cli

پس از نصب، دستور ahur در دسترس خواهد بود:

ahur --version

۲. اجرای مستقیم با npx

بدون نیاز به نصب، می‌توانید مستقیماً اجرا کنید:

npx ahur-cli launch claude

تنظیم کلید API

پس از نصب، اولین قدم تنظیم کلید API است:

ahur config set api_key ak_38d1b7fc6a7ac5a37d051820bba4427438e2896111015c8484047bfaeb5fbf57

کلید در ~/.config/ahur/config.json ذخیره می‌شود.

تنظیمات اختیاری

تنظیم آدرس سرور (در صورت نیاز به سرور اختصاصی):

ahur config set base_url https://api.ahur.ir/v1

تنظیم مدل پیش‌فرض:

ahur config set model ahur/general

اجرای دستیار

اجرای Claude Code

ahur launch claude

اهور CLI به صورت خودکار:

1. وجود Claude Code در سیستم را بررسی می‌کند
2. در صورت نیاز آن را نصب می‌کند
3. لیست مدل‌های اهور را دریافت می‌کند
4. یک مدل به شما نمایش می‌دهد تا انتخاب کنید
5. Claude Code را با API اهور راه‌اندازی می‌کند

اجرا با مدل مشخص

ahur launch claude --model ahur/general

ادامه گفتگوی قبلی

برای ادامه یک گفتگوی قبلی، شناسه آن را با --resume وارد کنید:

ahur launch claude --resume sess_abc123

این آرگومان مستقیماً به دستیار مقصد ارسال می‌شود.

اجرای Codex CLI

ahur launch codex

مدیریت تنظیمات

ahur config show              # نمایش تمام تنظیمات
ahur config get api_key       # نمایش کلید API
ahur config set model <name>  # تنظیم مدل پیش‌فرض

عیب‌یابی

خطای «No API key configured»

ahur config set api_key ak_your_key_here

خطای «Failed to fetch models»

• اتصال اینترنت خود را بررسی کنید
• آدرس سرور را بررسی کنید: ahur config get base_url
• از درستی کلید API مطمئن شوید

خطای نصب دستیار

اگر نصب خودکار Claude Code یا Codex CLI با شکست مواجه شد، می‌توانید دستی را نصب کنید:

npm install -g @anthropic-ai/claude-code
# یا
npm install -g @openai/codex

سپس دوباره ahur launch claude را اجرا کنید.

منابع

• مستندات API اهور
• راهنمای استفاده در Claude Code
• صفحه قیمت‌گذاری